Classe d’entités Z vers fichier ASCII—Aide

Récapitulatif
Utilisation
Syntaxe
Exemple de code
Environnements
Informations de licence

Récapitulatif

Exporte des entités 3D vers des fichiers texte ASCII en stockant des données GENERATE, XYZ ou de profil.

Utilisation

Le format Profile contient des informations de profil pour les entités linéaires 3D pouvant être importées dans des applications spécialisées de représentation de diagrammes. Chaque entité linéaire de la classe d'entités source est inscrite dans un fichier distinct dont le nom présente un suffixe représentant l'ID unique de la ligne. Chaque ligne de la table de profil indique la distance à partir de la position de départ de la ligne jusqu'au sommet (D), suivi par l'altitude de ce sommet.
```
0 z₁D₁ z₂D₂ z₃D₃ z₄
```
Le format XYZ stocke les coordonnées x, y et z sous forme de valeurs à virgule flottante où chaque ligne représente un enregistrement de point distinct.
```
x₁ y₁ z₁x₂ y₂ z₂x₃ y₃ z₃x₄ y₄ z₄
```
Remarque :
Les entités ponctuelles et multi-points sont inscrites dans le même fichier, alors que chaque entité surfacique et polyligne est inscrite dans un fichier texte distinct dont le suffixe ajouté au nom représente l'ID de l'entité. Chaque partie des entités qui en contiennent plusieurs est inscrite dans un fichier distinct et, dans le nom de fichier correspondant, la référence est ajoutée après l'ID de l'entité.
Le format GENERATE ne prend pas en charge les lignes d'en-tête, mais il stocke toutes les entités en entrée dans un fichier.
- Les entités ponctuelles sont stockées avec leur ID et coordonnées XYZ respectifs et la dernière ligne est identifiée par le mot-clé END :
```
id₁ x₁ y₁ z₁id₂ x₂ y₂ z₂id₃ x₃ y₃ z₃id₄ x₄ y₄ z₄END
```
  Remarque :
  Les entités multi-points provenant du même enregistrement dans la classe d'entités d'origine partagent le même ID.
- Les entités linéaires et surfaciques sont séparées par le mot-clé END et deux mots-clés END successifs indiquent la fin du fichier :
```
id₁x₁ y₁ z₁x₂ y₂ z₂x₃ y₃ z₃x₄ y₄ z₄END
id₂x₁ y₁ z₁x₂ y₂ z₂END
END
```
  Remarque :
  les premières et dernières coordonnées XYZ des entités surfaciques sont toujours identiques.

Syntaxe

FeatureClassZToASCII_3d (in_feature_class, output_location, out_file, {format}, {delimiter}, {decimal_format}, {digits_after_decimal}, {decimal_separator})

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	Nom du fichier ASCII résultant. Si une classe d'entités linéaires ou surfaciques est exportée au format XYZ, le nom du fichier est habituellement un nom de base. Chaque entité correspond à un fichier en sortie unique puisque le format XYZ ne prend en charge qu'une ligne ou un polygone par fichier. Chaque partie d'une entité multi-parties est également écrite dans un fichier distinct. Le nom de fichier ajouté comprend l'OID de chaque entité, ainsi que les caractères supplémentaires nécessaires pour le rendre unique.	String
format (Facultatif)	Format du fichier ASCII créé. GENERATE —Ecrit une sortie au format GENERATE. Il s'agit de l'option par défaut. XYZ —Ecrit les informations XYZ des entités en entrée. Un fichier est créé pour chaque ligne ou polygone de l'entité en entrée. PROFILE —Ecrit des informations de profil pour des entités linéaires pouvant être utilisées dans des applications externes de représentation de diagrammes.	String
delimiter (Facultatif)	Délimiteur utilisé pour indiquer la séparation des entrées dans les colonnes de la table de fichiers texte. SPACE —Un espace sera utilisé pour délimiter les valeurs de champ. Il s'agit de l'option par défaut. COMMA —Une virgule sera utilisée pour délimiter les valeurs de champ. Cette option n'est pas applicable si le séparateur décimal est également une virgule.	String
decimal_format (Facultatif)	Méthode utilisée pour déterminer le nombre de chiffres significatifs qui sont stockés dans les fichiers en sortie. AUTOMATIC —Le nombre de chiffres significatifs requis pour conserver la précision disponible, tout en supprimant les zéros de fin inutiles, est déterminé automatiquement. Il s'agit de l'option par défaut. FIXED —Le nombre de chiffres significatifs est défini dans le paramètre Nombre de décimales.	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)	Caractère décimal utilisé pour différencier la partie entière d'un nombre de sa partie fractionnaire. DECIMAL_POINT —Un point sert de caractère décimal. Il s'agit de l'option par défaut. DECIMAL_COMMA —Une virgule sert de caractère décimal.	String

Exemple de code

1er exemple d'utilisation de l'outil FeatureClassZToASCII (fenêtre Python)

L'exemple suivant illustre l'utilisation de cet outil dans la fenêtre Python.

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")

2e exemple d'utilisation de l'outil FeatureClassZToASCII (script autonome)

L'exemple suivant illustre l'utilisation de cet outil dans un script Python autonome.

'''****************************************************************************
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)