Shape interpolieren (3D Analyst)—ArcGIS Pro

Mit der 3D Analyst-Lizenz verfügbar.

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

Erstellt 3D-Features, indem Z-Werte aus einer Oberfläche interpoliert werden.

Weitere Informationen zur Funktionsweise von "Shape interpolieren"

Abbildung

Verwendung

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.

Parameter

Beschriftung	Erläuterung	Datentyp
Eingabe-Oberfläche	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 wird.	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. Der 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—Der Wert des Abfragepunktes wird mit bilinearer Interpolation bestimmt. Dies ist die Standardeinstellung, wenn es sich bei der Eingabe um eine Raster-Oberfläche handelt. Nächster Nachbar—Der Wert des Abfragepunktes wird mit der Interpolationsmethode "Nächster Nachbar" bestimmt. Mit dieser Methode werden die Oberflächenwerte nur für die Stützpunkte des Eingabe-Features interpoliert. Diese Option ist nur für eine Raster-Oberfläche verfügbar. Linear—Höhenwerte werden von der Ebene abgerufen, die durch das Dreieck definiert wird, das die XY-Position eines Abfragepunktes enthält. Dies ist die Standardinterpolationsmethode für TIN-, Terrain- und LAS-Datasets. Natürliche Nachbarn—Höhenwerte werden durch Anwenden von flächenbasierten Gewichtungen auf die natürlichen Nachbarn eines Abfragepunktes abgerufen. Z-Minimum abrufen—Höhenwerte werden vom kleinsten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes abgerufen. Z-Maximum abrufen—Höhenwerte werden vom größten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes abgerufen. Nächstgelegenen Z-Wert abrufen—Höhenwerte werden vom nächsten Wert unter den natürlichen Nachbarn eines Abfragepunktes abgerufen. Am nächsten zum Mittelwert gelegenen Z-Wert abrufen—Höhenwerte werden von dem Z-Wert abgerufen, der dem Durchschnitt aller natürlichen Nachbarn eines Abfragepunktes am nächsten liegt.	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. Wenn es sich bei der Eingabeoberfläche um ein Raster handelt und die Interpolationsmethode "Nächster Nachbar" ausgewählt wird, können die Z-Werte nur an den Feature-Stützpunkten interpoliert werden. Aktiviert: Die Interpolation erfolgt nur an den Stützpunkten. Deaktiviert: Die Interpolation wird mit der Abtastschrittweite durchgeführt. Dies ist die Standardeinstellung.	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: Der Z-Wert jedes Stützpunktes, der außerhalb der Raster-Oberfläche liegt, wird aus dem Trend der Z-Werte, die für die Stützpunkte in der Raster-Oberfläche berechnet werden, abgeleitet und in der Ausgabe beibehalten. Deaktiviert: Features mit mindestens einem Stützpunkt, der aus der Raster-Oberfläche herausfällt, werden in der Ausgabe übersprungen. Dies ist die Standardeinstellung.	Boolean

arcpy.ddd.InterpolateShape(in_surface, in_feature_class, out_feature_class, {sample_distance}, {z_factor}, {method}, {vertices_only}, {pyramid_level_resolution}, {preserve_features})

Name	Erläuterung	Datentyp
in_surface	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 wird.	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. Der 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—Der Wert des Abfragepunktes wird mit bilinearer Interpolation bestimmt. Dies ist die Standardeinstellung, wenn es sich bei der Eingabe um eine Raster-Oberfläche handelt. NEAREST—Der Wert des Abfragepunktes wird mit der Interpolationsmethode "Nächster Nachbar" bestimmt. Mit dieser Methode werden die Oberflächenwerte nur für die Stützpunkte des Eingabe-Features interpoliert. Diese Option ist nur für eine Raster-Oberfläche verfügbar. LINEAR—Höhenwerte werden von der Ebene abgerufen, die durch das Dreieck definiert wird, das die XY-Position eines Abfragepunktes enthält. Dies ist die Standardinterpolationsmethode für TIN-, Terrain- und LAS-Datasets. NATURAL_NEIGHBORS—Höhenwerte werden durch Anwenden von flächenbasierten Gewichtungen auf die natürlichen Nachbarn eines Abfragepunktes abgerufen. CONFLATE_ZMIN—Höhenwerte werden vom kleinsten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes abgerufen. CONFLATE_ZMAX—Höhenwerte werden vom größten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes abgerufen. CONFLATE_NEAREST—Höhenwerte werden vom nächsten Wert unter den natürlichen Nachbarn eines Abfragepunktes abgerufen. CONFLATE_CLOSEST_TO_MEAN—Höhenwerte werden von dem Z-Wert abgerufen, der dem Durchschnitt aller natürlichen Nachbarn eines Abfragepunktes am nächsten liegt.	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. DENSIFY—Die Interpolation wird mit der Abtastschrittweite durchgeführt. Dies ist die Standardeinstellung. VERTICES_ONLY—Die Interpolation erfolgt nur an den Stützpunkten.	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—Der Z-Wert jedes Stützpunktes, der außerhalb der Raster-Oberfläche liegt, wird aus dem Trend der Z-Werte, die für die Stützpunkte in der Raster-Oberfläche berechnet werden, abgeleitet und in der Ausgabe beibehalten. EXCLUDE—Features mit mindestens einem Stützpunkt, der aus der Raster-Oberfläche herausfällt, werden in der Ausgabe übersprungen. Dies ist die Standardeinstellung.	Boolean

Codebeispiel

InterpolateShape: Beispiel 1 (Python-Fenster)

Im folgenden Beispiel wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht:

arcpy.env.workspace = "C:/data"
arcpy.ddd.InterpolateShape("my_tin", "roads.shp", "roads_interp.shp")

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"
                # Execute 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)

Umgebungen

Aktueller Workspace, Scratch-Workspace, Ausdehnung, Ausgabe-Koordinatensystem, Geographische Transformationen, XY-Auflösung, XY-Toleranz, Z-Auflösung, Z-Toleranz, Ausgabe-CONFIG-Schlüsselwort, Auto-Commit

Lizenzinformationen

Basic: Erfordert 3D Analyst
Standard: Erfordert 3D Analyst
Advanced: Erfordert 3D Analyst