LandXML in TIN (3D Analyst)
Zusammenfassung
Dieses Werkzeug importiert eine oder mehrere TIN-Oberflächen (Triangulated Irregular Network, trianguliertes unregelmäßiges Netzwerk) aus einer LandXML-Datei in Ausgabe-Esri-TINs.
Verwendung
-
Wenn die Eingabe-LandXML-Datei ausgewählt wird, wird der Parameter "Zu importierende TINs" mit allen in der LandXML-Datei gefundenen TIN-Oberflächen gefüllt.
Ein Constrained-Delaunay-TIN aus der LandXML-Datei wird als Constrained-Delaunay-TIN erstellt.
-
Wenn mehrere TINs aus der LandXML-Datei exportiert werden, wird der Basisname wiederholt, um den Namen des Ausgabe-TINs auf die folgende Weise zu definieren: <basename>, <basename>2, <basename>3 usw. Wenn <basename> bereits vorhanden ist, erstellt das Werkzeug keine Einträge. Wenn <basename> nicht existiert, aber <basename>2 vorhanden ist, erstellt das Werkzeug <basename> und <basename>2_1 statt <basename>2.
Im Skriptmodus können die Namen im Parameter tinnames einfachheitshalber in Kurzform (nur Zahl oder Name) angegeben werden. Statt "1. Site0445; 2. <unnamed>; 3. <unnamed>; 4. Site_09" können Sie "1;2;3;4" oder "Site0445; Site_09;2;3" angeben. Das Schlüsselwort <unnamed> kann nicht alleine verwendet werden, da das TIN eindeutig identifiziert werden muss.
Syntax
| Parameter | Erläuterung | Datentyp |
in_landxml_path |
Die Eingabe-LandXML-Datei. | File |
out_tin_folder |
Der Ordner, in dem die TINs erstellt werden. | Folder |
tin_basename |
Der Name der Ausgabe-TINs. | String |
tinnames (optional) |
Gibt die für LandXML-Dateien zu importierenden TINS an, die mehrere TINS enthalten. Jedes TIN kann durch einen Namen (z. B. "Tin01") oder die Position in der Liste der verfügbaren LandXML-TINs (z. B. 1 für das erste TIN) angegeben werden. Die Liste der zu importierenden TINs kann als durch Semikolons getrennte Zeichenfolge (z. B. "1. Tin01; 2. Tin02"), eine Liste von Zeichenfolgen, (z. B. ["1. Tin01", "2. Tin02"]) oder eine Liste von numerischen Werten, die die Position der gewünschten TINs angeben (z. B. [1, 2, 3]), eingegeben werden. | 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.LandXMLToTin_3d("surfaces.xml", "TINs", "_", "1;2")
The following sample demonstrates the use of this tool in a stand-alone Python script:
'''****************************************************************************
Name: LandXMLToTin Example
Description: This script demonstrates how to use the
ListFiles method to collect all LandXML (*.xml) files in a
workspace as input for the Import3DFiles tool.
****************************************************************************'''
# 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"
# Use ListFiles method to grab all xml files (assumedly LandXML files)
landList = arcpy.ListFiles("*.xml")
if landList:
for landFile in landList:
# Set Local Variables
outputFolder = "TINs" # The folder that the TINs will be created in
outputBase = "Madagascar_" # Base name will be applied to all output TINs
grab = "1" # TIN selection can be chosen by enumerated values (e.g. 1;2)
# Execute Import3DFiles
arcpy.LandXMLToTin_3d(landFile, outputFolder, outputBase, grab)
print "Completed creating TIN(s) from {0}.".format(landFile)
else:
"There are no xml files in {0}.".format(env.workspace)
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)