3D-ASCII in Feature-Class (3D Analyst)
Zusammenfassung
Dient zum Importieren von 3D-Features aus einer oder mehreren ASCII-Dateien, die in den Formaten XYZ, XYZI oder GENERATE gespeichert sind, in eine neue Feature-Class.
Weitere Informationen zur Funktionsweise des Werkzeugs "3D-ASCII in Feature-Class" (3D Analyst)
Abbildung
Verwendung
-
Stellen Sie bei mehreren Eingabedateien sicher, dass alle Dateien das gleiche Format haben und den gleichen Geometrietyp aufweisen, bevor Sie dieses Werkzeug verwenden.
Polygone im Format GENERATE sollten im Uhrzeigersinn ausgerichtet sein, keine Selbstüberschneidungen aufweisen und geschlossen sein (d. h. der letzte Stützpunkt ist mit dem ersten identisch). Wenn eine dieser Bedingungen nicht erfüllt wird, ist das Ausgabe-Polygon ungültig. Das Werkzeug Geometrie überprüfen kann zum Validieren der resultierenden Features verwendet werden, und das Werkzeug Geometrie reparieren kann zum Beheben der Fehler verwendet werden.
Syntax
| Parameter | Erläuterung | Datentyp |
input <input; input...> |
Die ASCII-Dateien oder -Ordner, die die Daten im ASCII-Format XYZ, XYZI (mit Lidar-Intensität) oder 3-D GENERATE enthalten. Wenn ein Ordner angegeben wird, ist der Parameter Dateisuffix erforderlich, und es werden alle Dateien verwendet, die die gleiche Erweiterung aufweisen wie das angegebene Suffix. Wenn dies mehrere Dateien betrifft, müssen sie das gleiche Format aufweisen. | Folder; File |
in_file_type | String | |
out_feature_class |
The output feature class. | Feature Class |
out_geometry_type |
Der Geometrietyp der Ausgabe-Feature-Class.
| String |
z_factor (optional) |
The factor by which elevation values will be multiplied. This is typically used to convert Z linear units that match those of the XY linear units. The default is 1, which leaves elevation values unchanged. | Double |
input_coordinate_system (optional) |
Das Koordinatensystem der Eingabedaten. Der Standardwert ist ein unbekanntes Koordinatensystem. Falls angegeben, kann die Ausgabe möglicherweise (nicht) in ein anderes Koordinatensystem projiziert werden. Dies hängt davon ab, ob die Geoverarbeitungsumgebung über ein Koordinatensystem für den Speicherort der Ziel-Feature-Class verfügt. | Coordinate System |
average_point_spacing (optional) |
Die durchschnittliche planimetrische Entfernung zwischen den Eingabepunkten. Dieser Parameter wird nur verwendet, wenn für die Ausgabegeometrie MULTIPOINT festgelegt ist. Die Funktion des Parameters ist die Zusammengruppierung der Punkte. Dieser Wert wird zusammen mit den Punkten pro Shape-Grenzwert verwendet, um ein virtuelles Kachelungssystem zum Gruppieren der Punkte zu erstellen. Der Ursprung des Kachelsystems basiert auf der Domäne der Ziel-Feature-Class. Geben Sie den Abstand in den horizontalen Einheiten der Ziel-Feature-Class an. | Double |
file_suffix (optional) |
The suffix of the files to import from an input folder. This parameter is required when a folder is specified as input. | String |
decimal_separator (optional) | The decimal character used in the text file to differentiate the integer of a number from its fractional part.
| String |
Codebeispiel
The following sample demonstrates the use of this tool in the Python window:
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.Ascii3DToFeatureClass_3d("masspnts.txt", "GENERATE", "masspnts.shp", "POINT", 1, "Coordinate Systems/Projected Coordinate Systems/State Plane/NAD 1983 (Feet)/NAD 1983 StatePlane Massachusetts Mainland FIPS 2001 (Feet).prj")
The following sample demonstrates the use of this tool in a stand-alone Python script:
'''****************************************************************************
Name: ASCII3D_to_Feature_Class Example
Description: This script demonstrates how to use the
ASCII3D_to_Feature_Class tool to create a point feature class
from a set of text files in the specified workspace.
****************************************************************************'''
# Import system modules`
import arcpy
from arcpy import env
import exceptions, sys, traceback
try:
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")
# Set environment settings
env.workspace = "C:/data"
# Set Local Variables
inFormat = "GENERATE"
# Name of the output file
outFC = "Pts_from_ASCII.shp"
# Geometry of the output feature class
outType = "POINT"
zFactor = 1
# Coordinate system of the output feature class
CS = "Coordinate Systems/Geographic Coordinate Systems/World/WGS 1984.prj"
fileSuffix = "ascii.txt"
decSep = "DECIMAL_POINT" # Specifies the decimal delimeter
# Create list of ASCII files
txtList = arcpy.ListFiles("*" + fileSuffix)
# Verify the presence of TINs in the list
if len(txtList) > 0:
# Execute ASCII3D_to_Feature_Class
arcpy.ASCII3DToFeatureClass_3d(txtList, inFormat, outFC, outType,
zFactor, CS, fileSuffix, decSep)
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)