Dieses Werkzeug erstellt 3D-Features mithilfe von Höhenwerten, die aus überlappenden Teilen der Eingabe-Oberfläche abgeleitet werden. Ein 3D-Polygon speichert auf dem Umfang nur Z-Werte, da die Innenseite eines 3D-Polygons beim Rendern nach dem Zufallsprinzip definiert wird. Aus diesem Grund sind 3D-Polygone im Allgemeinen zum Darstellen nicht planarer Höheninformationen nicht geeignet. Um eine echte Darstellung der Oberfläche zu generieren, verwenden Sie das Werkzeug Polygon zu Multipatch interpolieren.
Alle geschwungenen Linien oder Polygonsegmente werden basierend auf dem Parameterwert Abtastschrittweite verdichtet. Wenn keine Abtastschrittweite definiert ist, wird dieser Wert von der Eingabe-Oberfläche abgeleitet. Bei einem Raster ist die standardmäßige Abtastgröße die Zellengröße des Rasters. Bei einem TIN-, Terrain- oder LAS-Dataset basiert die Standardabtastung auf den Kanten, die von der triangulierten Oberfläche erzeugt werden. Wenn die Kurve kürzer als die Abtastgröße ist, wird die Kurve mithilfe der Anfangs- und Endpunkte in eine 2-Punkt-Linie vereinfacht.
Wenn Sie die Interpolationsmethode "Natürliche Nachbarn" verwenden, sollten Sie eine Abtastschrittweite festlegen, die dem durchschnittlichen Punktabstand der Datenpunkte in der Oberfläche entspricht oder mehr als die Hälfte dieses Wertes beträgt.
Bei Verwendung des Parameters Nur Stützpunkte interpolieren werden Features mit Stützpunkten, die außerhalb der Datenfläche der Oberfläche liegen, nicht in die Ausgabe aufgenommen, es sei denn, die Eingabeoberfläche ist ein Raster und die Interpolationsmethode "Nächster Nachbar" wird verwendet.
Wenn die Eingabe-Feature-Class M-Werte enthält, enthält auch die Ausgabe-Feature-Class M-Werte, und die M-Werte der ursprünglichen Stützpunkte bleiben erhalten.
Die zum Interpolieren von Z-Werten verwendete Oberfläche.
LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer; Image Service
Eingabe-Features
Die Eingabe-Features, die verarbeitet werden.
Feature Layer
Ausgabe-Feature-Class
Die Feature-Class, die erstellt werden soll.
Feature Class
Abtastschrittweite
(Optional)
Der Abstand, bei dem Z-Werte interpoliert werden. Dies ist standardmäßig die Zellengröße eines Raster-Datasets oder die natürliche Verdichtung einer triangulierten Oberfläche.
Double
Z-Faktor
(Optional)
Der Faktor, mit dem Z-Werte multipliziert werden. Dieser wird in der Regel verwendet, um lineare Z-Einheiten zu konvertieren, sodass sie den linearen XY-Einheiten entsprechen. Der Standardwert ist 1, wodurch die Höhenwerte unverändert bleiben. Dieser Parameter ist nicht verfügbar, wenn der Raumbezug der Eingabe-Oberfläche über ein Z-Datum mit einer angegebenen linearen Einheit verfügt.
Double
Methode
(Optional)
Gibt die Interpolationsmethode an, die zum Ermitteln der Höhenwerte für Ausgabe-Features verwendet wird. Die verfügbaren Optionen hängen vom Oberflächentyp ab.
Bilinear—The value of the query point will be determined using bilinear interpolation. This is the default when the input is a raster surface.
Nearest Neighbor—The value of the query point will be determined using nearest neighbor interpolation. With this method, surface values will only be interpolated for the input feature's vertices. This option is only available for a raster surface.
Linear—Elevation values will be obtained from the plane defined by the triangle that contains the x,y-location of a query point. This is the default interpolation method for TIN, terrain, and LAS datasets.
Natural Neighbors—Elevation values will be obtained by applying area-based weights to the natural neighbors of a query point.
Conflate Minimum Z—Elevation values will be obtained from the smallest z-value found among the natural neighbors of a query point.
Conflate Maximum Z—Elevation values will be obtained from the largest z-value found among the natural neighbors of a query point.
Conflate Nearest Z—Elevation values will be obtained from the nearest value among the natural neighbors of a query point.
Conflate Z Closest To Mean—Elevation values will be obtained from the z-value that is closest to the average of all the natural neighbors of a query point.
String
Nur Stützpunkte interpolieren
(Optional)
Gibt an, ob die Interpolation nur entlang den Stützpunkten eines Eingabe-Features auftreten soll, wobei die Option "Abtastschrittweite" ignoriert wird.
Aktiviert—Interpolation will only occur along the vertices.
Deaktiviert—Interpolation will occur using the sampling distance. This is the default.
Boolean
Auflösung der Pyramidenebene
(Optional)
Die verwendete Auflösung der Z-Toleranz oder der Kachelung der Terrain-Pyramidenebene. Der Standardwert ist 0, also volle Auflösung.
Double
Features teilweise außerhalb von Oberfläche beibehalten
(Optional)
Gibt an, ob Features mit einem oder mehreren Stützpunkten, die aus der Datenfläche des Rasters herausfallen, in der Ausgabe beibehalten werden. Dieser Parameter ist nur verfügbar, wenn es sich bei der Eingabeoberfläche um ein Raster handelt und die Interpolationsmethode "Nächster Nachbar" verwendet wird.
Aktiviert—Each vertex that falls outside the raster surface will have its z-value derived from the trend of z-values calculated for the vertices within the raster surface and will be retained in the output.
Deaktiviert—Features with at least one vertex that falls outside the raster surface will be skipped in the output. This is the default.
Boolean
M-Werte für verdichtete Stützpunkte interpolieren
(Optional)
Legt fest, ob die M-Werte für Linien- und Polygon-Stützpunkte, die durch Verdichtung hinzugefügt wurden, aus den ursprünglichen Eingabe-Stützpunkten interpoliert werden.
Wenn diese Option verwendet wird, werden die M-Werte für verdichtete Stützpunkte entlang des ursprünglichen Segments zwischen zwei vorhandenen Stützpunkten, die über M-Werte verfügen, interpoliert. Fehlt bei einem der ursprünglichen Stützpunkte ein M-Wert, werden die M-Werte aller neu hinzugefügten Stützpunkte entlang dieses Segments auf "Keine" festgelegt.
Aktiviert—The m-values for densified vertices will be interpolated.
Deaktiviert—The m-values for densified vertices will not be interpolated. This is the default.
Die zum Interpolieren von Z-Werten verwendete Oberfläche.
LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer; Image Service
in_feature_class
Die Eingabe-Features, die verarbeitet werden.
Feature Layer
out_feature_class
Die Feature-Class, die erstellt werden soll.
Feature Class
sample_distance
(Optional)
Der Abstand, bei dem Z-Werte interpoliert werden. Dies ist standardmäßig die Zellengröße eines Raster-Datasets oder die natürliche Verdichtung einer triangulierten Oberfläche.
Double
z_factor
(Optional)
Der Faktor, mit dem Z-Werte multipliziert werden. Dieser wird in der Regel verwendet, um lineare Z-Einheiten zu konvertieren, sodass sie den linearen XY-Einheiten entsprechen. Der Standardwert ist 1, wodurch die Höhenwerte unverändert bleiben. Dieser Parameter ist nicht verfügbar, wenn der Raumbezug der Eingabe-Oberfläche über ein Z-Datum mit einer angegebenen linearen Einheit verfügt.
Double
method
(Optional)
Gibt die Interpolationsmethode an, die zum Ermitteln der Höhenwerte für Ausgabe-Features verwendet wird. Die verfügbaren Optionen hängen vom Oberflächentyp ab.
BILINEAR—The value of the query point will be determined using bilinear interpolation. This is the default when the input is a raster surface.
NEAREST—The value of the query point will be determined using nearest neighbor interpolation. With this method, surface values will only be interpolated for the input feature's vertices. This option is only available for a raster surface.
LINEAR—Elevation values will be obtained from the plane defined by the triangle that contains the x,y-location of a query point. This is the default interpolation method for TIN, terrain, and LAS datasets.
NATURAL_NEIGHBORS—Elevation values will be obtained by applying area-based weights to the natural neighbors of a query point.
CONFLATE_ZMIN—Elevation values will be obtained from the smallest z-value found among the natural neighbors of a query point.
CONFLATE_ZMAX—Elevation values will be obtained from the largest z-value found among the natural neighbors of a query point.
CONFLATE_NEAREST—Elevation values will be obtained from the nearest value among the natural neighbors of a query point.
CONFLATE_CLOSEST_TO_MEAN—Elevation values will be obtained from the z-value that is closest to the average of all the natural neighbors of a query point.
String
vertices_only
(Optional)
Gibt an, ob die Interpolation nur entlang den Stützpunkten eines Eingabe-Features auftreten soll, wobei die Option "Abtastschrittweite" ignoriert wird.
VERTICES_ONLY—Interpolation will only occur along the vertices.
DENSIFY—Interpolation will occur using the sampling distance. This is the default.
Boolean
pyramid_level_resolution
(Optional)
Die verwendete Auflösung der Z-Toleranz oder der Kachelung der Terrain-Pyramidenebene. Der Standardwert ist 0, also volle Auflösung.
Double
preserve_features
(Optional)
Gibt an, ob Features mit einem oder mehreren Stützpunkten, die aus der Datenfläche des Rasters herausfallen, in der Ausgabe beibehalten werden. Dieser Parameter ist nur verfügbar, wenn es sich bei der Eingabeoberfläche um ein Raster handelt und die Interpolationsmethode "Nächster Nachbar" verwendet wird.
PRESERVE—Each vertex that falls outside the raster surface will have its z-value derived from the trend of z-values calculated for the vertices within the raster surface and will be retained in the output.
EXCLUDE—Features with at least one vertex that falls outside the raster surface will be skipped in the output. This is the default.
Boolean
interpolate_m_value
(Optional)
Legt fest, ob die M-Werte für Linien- und Polygon-Stützpunkte, die durch Verdichtung hinzugefügt wurden, aus den ursprünglichen Eingabe-Stützpunkten interpoliert werden.
Wenn diese Option verwendet wird, werden die M-Werte für verdichtete Stützpunkte entlang des ursprünglichen Segments zwischen zwei vorhandenen Stützpunkten, die über M-Werte verfügen, interpoliert. Fehlt bei einem der ursprünglichen Stützpunkte ein M-Wert, werden die M-Werte aller neu hinzugefügten Stützpunkte entlang dieses Segments auf "Keine" festgelegt.
INTERPOLATE_M_VALUE—The m-values for densified vertices will be interpolated.
NO_INTERPOLATE_M_VALUE—The m-values for densified vertices will not be interpolated. This is the default.
Boolean
Codebeispiel
InterpolateShape: Beispiel 1 (Python-Fenster)
Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht:
InterpolateShape: Beispiel 2 (eigenständiges Skript)
Im folgenden Beispiel wird die Verwendung dieses Werkzeugs in einem eigenständigen Python-Skript veranschaulicht:
'''*********************************************************************
Name: InterpolateShape Example
Description: This script demonstrates how to use InterpolateShape
on all 2D features in a target workspace.
*********************************************************************'''
# Import system modules
import arcpy
# Set local variables
inWorkspace = arcpy.GetParameterAsText(0)
surface = arcpy.GetParameterAsText(1)
try:
# Set default workspace
arcpy.env.workspace = inWorkspace
# Create list of feature classes in target workspace
fcList = arcpy.ListFeatureClasses()
if fcList:
for fc in fcList:
desc = arcpy.Describe(fc)
# Find 2D features
if not desc.hasZ:
# Set Local Variables
outFC = "{0}_3D.shp".format(desc.basename)
method = "BILINEAR"
# Run InterpolateShape
arcpy.ddd.InterpolateShape(surface, fc, outFC,
10, 1, method, True)
else:
print("{0} is not a 2D feature.".format(fc))
else:
print("No feature classes were found in {0}.".format(env.workspace))
except arcpy.ExecuteError:
print(arcpy.GetMessages())
except Exception as err:
print(err)
