Shape interpolieren

Zusammenfassung

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

Weitere Informationen zur Funktionsweise von "Shape interpolieren"

Abbildung

Verwendung

• 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 der Option Nur Stützpunkte interpolieren werden Features mit Stützpunkten, die aus der Datenfläche der Oberfläche herausfallen, nicht in die Ausgabe aufgenommen, es sei denn, die Eingabeoberfläche ist ein Raster und die Interpolationsmethode "Nächster Nachbar" wird verwendet.

Syntax

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

Parameter	Erklärung	Datentyp
in_surface	Die zum Interpolieren von Z-Werten verwendete Oberfläche.	LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
in_feature_class	Die zu verarbeitenden Eingabe-Features.	Feature Layer
out_feature_class	Die Feature-Class, die von diesem Werkzeug 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 deaktiviert, wenn der Raumbezug der Eingabe-Oberfläche über ein Z-Datum mit einer angegebenen linearen Einheit verfügt.	Double
method (optional)	Die Interpolationsmethode, die zum Ermitteln der Höhenwerte für Ausgabe-Features verwendet wird. Die verfügbaren Optionen hängen vom verwendeten Oberflächentyp ab. BILINEAR —Bestimmt den Wert des Abfragepunktes mit bilinearer Interpolation. Dies ist die Standardeinstellung, wenn es sich bei der Eingabe um eine Raster-Oberfläche handelt. NEAREST —Bestimmt den Wert des Abfragepunktes mit der Interpolationsmethode "Nächster Nachbar". Bei Verwendung 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 — Standardinterpolationsmethode für TIN-, Terrain- und LAS-Datasets. Ruft den Höhenwert von der Ebene ab, die durch das Dreieck definiert wird, das die XY-Position eines Abfragepunktes enthält. NATURAL_NEIGHBORS — Ruft den Höhenwert durch Anwenden von flächenbasierten Gewichtungen auf die natürlichen Nachbarn eines Abfragepunktes ab. CONFLATE_ZMIN — Ruft den Höhenwert vom kleinsten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes ab. CONFLATE_ZMAX — Ruft den Höhenwert vom größten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes ab. CONFLATE_NEAREST — Ruft den Höhenwert vom nächsten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes ab. CONFLATE_CLOSEST_TO_MEAN — Ruft den Höhenwert von dem Z-Wert ab, der dem Durchschnitt aller natürlichen Nachbarn eines Abfragepunktes am nächsten liegt.	String
vertices_only (optional)	Gibt an, ob die Interpolation nur an den Stützpunkten eines Eingabe-Features auftreten soll, wodurch die Option "Abtastschrittweite" ignoriert wird. DENSIFY —Interpoliert mit der Abtastschrittweite. Dies ist die Standardeinstellung. VERTICES_ONLY —Interpoliert an den Stützpunkten.	Boolean
pyramid_level_resolution (optional)	Die Auflösung der Z-Toleranz oder der Kachelung der Terrain-Pyramidenebene, die von diesem Werkzeug verwendet wird. 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ützpunkts, der aus der Raster-Oberfläche herausfällt, wird aus dem Trend der Z-Werte, die für die Stützpunkte in der Raster-Oberfläche berechnet werden, abgeleitet. 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)

Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.

import arcpy
from arcpy import env

arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.InterpolateShape_3d("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
from arcpy import env
import exceptions, sys, traceback

# Set local variables
inWorkspace = arcpy.GetParameterAsText(0)
surface = arcpy.GetParameterAsText(1)

try:
    arcpy.CheckOutExtension("3D")
    # Set default workspace
    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)
    arcpy.CheckInExtension('3D')
    
except arcpy.ExecuteError:
    print arcpy.GetMessages()
    
except:
    # Get the traceback object
    tb = sys.exc_info()[2]
    tbinfo = traceback.format_tb(tb)[0]
    # Concatenate error information into message string
    pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
          .format(tbinfo, str(sys.exc_info()[1]))
    msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
    # Return python error messages for script tool or Python Window
    arcpy.AddError(pymsg)
    arcpy.AddError(msgs)

Umgebungen

• Aktueller Workspace
• Scratch-Workspace
• Ausdehnung
• Ausgabe-Koordinatensystem
• Geographische Transformationen
• XY-Auflösung
• XY-Toleranz
• Z-Auflösung
• Z-Toleranz
• Ausgabe-CONFIG-Schlüsselwort
• Räumliches Gitter 1 der Ausgabe
• Räumliches Gitter 2 der Ausgabe
• Räumliches Gitter 3 der Ausgabe
• Auto-Commit

Lizenzinformationen

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