Classe d'entités Z vers fichier ASCII (3D Analyst)
Récapitulatif
Exporte des entités 3D vers des fichiers texte ASCII au format XYZ, GENERATE ou PROFILE.
Utilisation
Les entrées prises en charge sont des entités ponctuelles, multi-points, polylinéaires et surfaciques.
-
Cet outil exporte également des polylignes dans un format de sortie ASCII du profil. Le fichier texte pour le format de sortie du profil contient la distance pour y et z pour x. Le format de profil permet l'exportation de données 3D dans des applications graphiques plus spécialisées.
Le nom du fichier est utilisé comme modèle lors de l'exportation d'une classe d'entités contenant des lignes ou des polygones au format XYZ. Cela s'explique par le fait que le format XYZ, de par sa simplicité, ne prend en charge qu'une seule ligne ou qu'un seul polygone par fichier. Cette restriction concerne en fait les parties. Par conséquent, si une entité comporte plusieurs parties, chacune d'entre elles est écrite dans un fichier distinct. Le préfixe et le suffixe spécifiés dans la boîte de dialogue sont attribués aux fichiers, de même que l'OID de chaque entité, complétés par des caractères supplémentaires, si nécessaire, pour rendre chaque nom de fichier unique.
Le format décimal des valeurs à virgule flottante en sortie peut être défini en tant qu'entrée ou déterminé automatiquement, lorsque le logiciel définit le nombre de chiffres requis pour conserver la précision disponible tout en supprimant les zéros de fin inutiles.
Syntaxe
| Paramètre | Explication | Type de données |
in_feature_class |
Classe d'entités 3D ponctuelles, multi-points, polylignes ou surfaciques exportée vers un fichier ASCII. | Feature Layer |
output_location |
Dossier dans lequel les fichiers en sortie sont écrits. | Folder |
out_file |
Indique le nom du fichier en sortie. Le nom du fichier est utilisé comme modèle lors de l'exportation d'une classe d'entités contenant des lignes ou des polygones au format XYZ. Cela s'explique par le fait que le format XYZ, de par sa simplicité, ne prend en charge qu'une seule ligne ou qu'un seul polygone par fichier. Cette restriction concerne en fait les parties. Par conséquent, si une entité comporte plusieurs parties, chacune d'entre elles est écrite dans un fichier distinct. Le préfixe et le suffixe spécifiés dans la boîte de dialogue sont attribués aux fichiers, de même que l'OID de chaque entité, complétés par des caractères supplémentaires, si nécessaire, pour rendre chaque nom de fichier unique. | File; Folder |
format (Facultatif) |
Format du fichier ASCII créé.
| String |
delimiter (Facultatif) |
The field delimeter used in the text file.
| String |
decimal_format (Facultatif) |
Spécifie la méthode utilisée pour déterminer le nombre de chiffres significatifs stocké dans les fichiers en sortie.
| String |
digits_after_decimal (Facultatif) |
Utilisé lorsque la valeur Notation décimale est définie sur FIXED. Cela détermine le nombre de chiffres après la virgule des valeurs à virgule flottante écrites dans les fichiers en sortie. | Long |
decimal_separator (Facultatif) | The decimal character used in the text file to differentiate the integer of a number from its fractional part.
| String |
Exemple de code
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.FeatureClassZToASCII_3d("LidarPts.shp", "", "ASCII_LidarPts.txt",
"GENERATE", "COMMA", "FIXED", 6, "DECIMAL_POINT")
The following sample demonstrates the use of this tool in a stand-alone Python script:
'''****************************************************************************
Name: FeatureClassZToASCII Example
Description: This script demonstrates how to use the
FeatureClassZToASCII tool to create generate files for all
z-aware point features in a given workspace.
****************************************************************************'''
import arcpy
import exceptions, sys, traceback
from arcpy import env
try:
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension('3D')
# Set environment settings
env.workspace = 'C:/data'
# List all points in the target workspace
fcList = arcpy.ListFeatureClasses("*", "POINT")
if fcList:
# Set Local Variables
outFolder = "C:/output"
outFormat = "GENERATE"
delimeter = "SPACE"
decimal = "FIXED"
digits = 3
dec_sep = "DECIMAL_POINT"
for fc in fcList:
# Use Describe method to evaluate whether the feature class is z-aware
desc = arcpy.Describe(fc)
if desc.hasZ == True:
# Define the output file name by replacing '.shp' with _ascii.txt
outName = fc.replace('.shp', '') + "_ascii.txt"
#Execute FeatureClassZToASCII_3d
arcpy.FeatureClassZToASCII_3d(fc, outFolder, outName, outFormat, delimeter, decimal, digits, dec_sep)
else:
print "There are no feature classes in the " + env.workspace + " directory."
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)