Exporter l'attribut de l'entité en ASCII (Statistiques spatiales)

Résumé

Exporte les coordonnées et les valeurs attributaires des classes d’entités dans un fichier texte ASCII dont les valeurs sont séparées par des espaces, des virgules, des tabulations ou des points virgules.

Illustration

Illustration de l'outil Exporter l'attribut de l'entité en ASCII
Les coordonnées (X et Y) et les entités spécifiées par l'utilisateur sont écrites dans un fichier texte ASCII.

Utilisation

  • Cet outil peut être utilisé pour exporter des données à des fins d’analyse avec des progiciels externes.

  • Les valeurs des coordonnées X et Y sont écrites dans le fichier texte avec huit chiffres significatifs de précision. Les valeurs attributaires en virgule flottante sont écrites dans le fichier texte avec six chiffres significatifs.

  • Lorsque des valeurs Null sont rencontrées pour une valeur de champ, elles sont écrites dans le fichier texte en sortie comme étant NULL.

  • Attention :

    Lorsque vous utilisez des shapefiles, n'oubliez pas qu'ils ne peuvent pas stocker de valeurs Null. Il se peut que des outils ou autres procédures qui créent des fichiers de formes à partir d'entrées autres que des fichiers de formes stockent ou interprètent des valeurs Null comme étant égales à zéro. Dans certains cas, les valeurs Null sont stockées sous forme de valeurs négatives très élevées dans les fichiers de formes. Cela peut aboutir à des résultats inattendus. Reportez-vous à la rubrique Remarques concernant le géotraitement pour la sortie de fichiers de formes pour plus d'informations.

Paramètres

ÉtiquetteExplicationType de données
Classe d'entités en entrée

Classe d’entités à partir de laquelle les coordonnées d’entités et les valeurs attributaires sont exportées.

Feature Layer
Champ de valeur

Le ou les champs de la classe d'entités en entrée contenant les valeurs à exporter dans un fichier texte ASCII.

Field
Délimiteur

Spécifie de quelle façon les coordonnées d'entités et les valeurs attributaires seront séparées dans le fichier ASCII en sortie.

  • Espace — Les coordonnées d’entités et les valeurs attributaires seront séparées par un espace dans la sortie. Il s’agit de l’option par défaut.
  • Virgule — Les coordonnées d'entités et les valeurs attributaires seront séparées par une virgule dans la sortie.
  • Point-virgule — Les coordonnées d'entités et les valeurs attributaires seront séparées par un point-virgule dans la sortie.
  • Tabulation —Les coordonnées d’entités et les valeurs attributaires seront séparées par une tabulation dans la sortie.
String
Fichier ASCII en sortie

Fichier texte ASCII qui contiendra les coordonnées d’entités et les valeurs attributaires.

File
Ajouter des noms de champs en sortie

Indique si les noms de champ seront inclus en première ligne du fichier texte en sortie.

  • Activé : les noms de champ seront écrits dans le fichier texte en sortie.
  • Activé : les noms de champ ne seront pas écrits dans le fichier texte en sortie. Il s’agit de l’option par défaut.
Boolean

arcpy.stats.ExportXYv(Input_Feature_Class, Value_Field, Delimiter, Output_ASCII_File, Add_Field_Names_to_Output)
NomExplicationType de données
Input_Feature_Class

Classe d’entités à partir de laquelle les coordonnées d’entités et les valeurs attributaires sont exportées.

Feature Layer
Value_Field
[Value_Field,...]

Le ou les champs de la classe d'entités en entrée contenant les valeurs à exporter dans un fichier texte ASCII.

Field
Delimiter

Spécifie de quelle façon les coordonnées d'entités et les valeurs attributaires seront séparées dans le fichier ASCII en sortie.

  • SPACELes coordonnées d’entités et les valeurs attributaires seront séparées par un espace dans la sortie. Il s’agit de l’option par défaut.
  • COMMALes coordonnées d'entités et les valeurs attributaires seront séparées par une virgule dans la sortie.
  • SEMI-COLONLes coordonnées d'entités et les valeurs attributaires seront séparées par un point-virgule dans la sortie.
  • TABLes coordonnées d’entités et les valeurs attributaires seront séparées par une tabulation dans la sortie.
String
Output_ASCII_File

Fichier texte ASCII qui contiendra les coordonnées d’entités et les valeurs attributaires.

File
Add_Field_Names_to_Output

Indique si les noms de champ seront inclus en première ligne du fichier texte en sortie.

  • ADD_FIELD_NAMESLes noms de champ seront écrits dans le fichier texte en sortie.
  • NO_FIELD_NAMESLes noms de champ ne seront pas écrits dans le fichier texte en sortie. Il s’agit de l’option par défaut.
Boolean

Exemple de code

Exemple 1 d’utilisation de l’outil ExportFeatureAttributeToASCII (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l’utilisation de l’outil ExportFeatureAttributeToASCII :

import arcpy
arcpy.env.workspace = r"c:\data"
arcpy.ExportXYv_stats("AidsByCaCnty.shp", "HEPRATE", "SPACE", "aidsbycacnty.txt", 
                      "ADD_FIELD_NAMES")
Exemple 2 d’utilisation de l’outil ExportFeatureAttributeToASCII (script autonome)

Le script Python autonome ci-dessous illustre l’utilisation de l'outil ExportFeatureAttributeToASCII :

# Export feature locations and attributes to an ASCII text file
 
# Import system modules
import arcpy
 
# Local variables...
workspace = "c:/data"
input_features = "AidsByCaCnty.shp"
export_ASCII = "aidsbycacnty.txt"
# Set the current workspace (to avoid having to specify the full path to the 
# feature classes each time)
arcpy.env.workspace = workspace
# Process: Export Feature Attribute to ASCII...
arcpy.ExportXYv_stats(input_features, "HEPRATE", "SPACE", export_ASCII, 
                      "NO_FIELD_NAMES")

Rubriques connexes