LandXML in TIN (3D Analyst)
Zusammenfassung
Dieses Werkzeug importiert mindestens eine TIN-Oberfläche (Triangulated Irregular Network, trianguliertes unregelmäßiges Netzwerk) aus einer LandXML-Datei in Esri Ausgabe-TINs.
Verwendung
-
Bei Auswahl der LandXML-Datei 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.
Bei der Skripterstellung können die Namen im Parameter tinnames aus praktischen Gründen in der Kurzform (nur Zahl oder Name) angegeben werden. Anstelle von "1. Site0445; 2. <unnamed>; 3. <unnamed>; 4. Site_09" können Sie Folgendes angeben: "1;2;3;4" oder "Site0445; Site_09;2;3". 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 Ausgabe-TINs erstellt werden. | Folder |
tin_basename |
Der Basisname des resultierenden TINs. Wenn mehrere TINs aus der LandXML-Datei exportiert werden, wird der Basisname verwendet, um einen eindeutigen Namen für jedes Ausgabe-TIN zu definieren. Wenn <basename> bereits vorhanden ist, erstellt das Werkzeug keine Einträge. Wenn <basename> nicht vorhanden ist, <basename>2 dagegen schon, erstellt das Werkzeug <basename> und <basename>2_1 anstelle von <basename>2. | String |
tinnames [name,...] (optional) | Die LandXML-TIN-Oberflächen werden in ein Esri TIN exportiert. Jedes LandXML-TIN kann durch den Namen oder die Indexposition in der LandXML-Datei angegeben werden, wobei die Nummer 1 das erste TIN, die 2 das zweite TIN darstellt usw. | String |
Codebeispiel
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.LandXMLToTin_3d("surfaces.xml", "TINs", "_", "1;2")
Im folgenden Beispiel wird die Verwendung dieses Werkzeugs in einem eigenständigen Python-Skript veranschaulicht:
'''****************************************************************************
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)