ASCII 3D vers classe d'entité (3D Analyst)

Synthèse

Importe des entités 3D à partir d'un ou plusieurs fichiers ASCII stockés aux formats XYZ, XYZI ou GENERATE vers une nouvelle classe d'entités.

Illustration

Exemple d'utilisation de l'outil ASCII 3D vers classe d'entités

Utilisation

  • Tous les fichiers en entrée doivent avoir le même format et le même type de géométrie.

  • Les formats XYZ et XYZI prennent en charge les lignes d'en-tête et traitent la première ligne commençant par trois nombres consécutifs comme le début des enregistrements de points. Les deux formats peuvent stocker des points, des lignes et des polygones, mais chaque fichier ne peut contenir qu'une entité surfacique ou linéaire en une partie. Les entités surfaciques doivent être fermées, les coordonnées du dernier sommet étant identiques à celles du premier, et elles ne doivent pas se croiser.

  • Les fichiers XYZ stockent les coordonnées x, y et z sous forme de valeurs à virgule flottante où chaque ligne représente un enregistrement de points distinct. Les coordonnées XYZ peuvent être suivies d'entrées alphanumériques, mais ces informations ne sont pas transmises à la classe d'entités résultante.

  • Les fichiers XYZI stockent les coordonnées x, y, z, ainsi que les mesures d'intensité. Les valeurs d'intensité sont stockées dans un champ de grand objet binaire (BLOB) pour les sorties multipatch.

    Remarque :

    Si le fichier ASCII est au format XYZI mais que les mesures d'intensité ne sont pas nécessaires, choisissez XYZ. Le système ignore alors la valeur d'intensité lors de la lecture des fichiers.

  • Le format GENERATE ne prend pas en charge les lignes d'en-tête, mais il fournit pour chaque point un identifiant, ainsi que les coordonnées XYZ. En outre, la dernière ligne du fichier peut être signalée par le mot-clé END :

    id x y z
    id x y z
    .
    .
    END
  • Le format GENERATE prend en charge plusieurs entités par fichier. Pour les lignes et les polygones, le mot-clé END signale la fin d'une entité, chacune devant être une entité en une partie. Deux mots-clé END dans une ligne indiquent la fin du fichier.

    id
    x y z
    x y z
    x y z
    END
    id
    x y z
    x y z
    END
    END
    Remarque :

    Les polygones doivent être orientés dans le sens horaire, ne présenter aucune auto-intersection et être fermés (autrement dit, le dernier sommet et le premier sommet sont identiques). Si l'une de ces conditions n'est pas satisfaite, le polygone en sortie n'est pas valide. L'outil Vérifier les géométries permet de valider les entités obtenues, tandis que l'outil Réparer les géométries permet de corriger les erreurs.

Paramètres

ÉtiquetteExplicationType de données
Données ASCII 3D

Fichiers ou dossiers ASCII comportant des données au format XYZ, XYZI (avec intensité lidar) ou 3D GENERATE. Tous les fichiers en entrée doivent présenter le même format. Si un dossier est spécifié, le paramètre Suffixe de fichier est requis et tous les fichiers portant la même extension que le suffixe indiqué sont traités.

Dans la fenêtre Géotraitement, vous pouvez également spécifier le dossier en entrée en le sélectionnant dans File Explorer et en le faisant glisser vers la zone de saisie du paramètre.

Folder; File
Format de fichier

Format des fichiers ASCII qui seront convertis en classe d'entités.

  • XYZFichier texte qui contient des informations de géométrie stockées sous la forme de coordonnées XYZ.
  • XYZIFichiers texte contenant des coordonnées XYZ et des mesures d'intensité.
  • GénérerFichiers texte structurés au format adapté à l'outil Générer.
String
Classe d’entités en sortie

Classe d’entités qui va être produite.

Feature Class
Type de classe d'entités en sortie

Type de géométrie de la classe d'entités en sortie.

  • Entités multi-ponctuellesDes multi-points sont recommandés si les données en entrée contiennent un grande nombre de points et que des attributs par entité ne sont pas requis.
  • Entités ponctuellesChaque coordonnée XYZ produira une entité ponctuelle.
  • Entités polylignesLa sortie contient des entités polylignes.
  • Entités surfaciquesLa sortie contiendra des entités surfaciques.
String
Facteur Z
(Facultatif)

Facteur par lequel les valeurs z sont multipliées. Cette option permet généralement de convertir les unités linéaires z afin qu’elles correspondent aux unités linéaires x,y. La valeur par défaut est 1, qui laisse les valeurs d'altitude inchangées. Ce paramètre n’est pas disponible si la référence spatiale de la surface en entrée possède un datum z dont l’unité linéaire est spécifiée.

Double
Système de coordonnées
(Facultatif)

Système de coordonnées des données en entrée. La valeur par défaut est un système de coordonnées inconnu. Si une valeur est spécifiée, la sortie peut être projetée dans un système de coordonnées différent. Cela dépend si un système de coordonnées de l'environnement de géotraitement est défini pour l'emplacement de la classe d'entités cible.

Coordinate System
Espacement moyen des points
(Facultatif)

Distance planimétrique moyenne entre des points de l'entrée. Ce paramètre est utilisé uniquement lorsque la géométrie en sortie est définie surMULTIPOINT : il permet de regrouper des points. Cette valeur est utilisée avec la limite de points par forme afin de construire un système de tuiles virtuel permettant de regrouper les points. L'origine du système de tuiles est basé sur le domaine de la classe d'entités cible. Indiquez l'espacement dans les unités horizontales de la classe d'entités cible.

Double
Suffixe de fichier
(Facultatif)

Suffixe des fichiers à importer à partir d’un dossier en entrée. Ce paramètre est requis lorsqu'un dossier est spécifié en entrée.

String
Séparateur décimal
(Facultatif)

Le caractère décimal qui est utilisé dans le fichier texte pour différencier la partie entière d’un nombre de sa partie fractionnaire.

  • DECIMAL_POINTUn point sert de caractère décimal. Il s’agit de l’option par défaut.
  • DECIMAL_COMMAUne virgule sert de caractère décimal.
String

arcpy.ddd.ASCII3DToFeatureClass(input, in_file_type, out_feature_class, out_geometry_type, {z_factor}, {input_coordinate_system}, {average_point_spacing}, {file_suffix}, {decimal_separator})
NomExplicationType de données
input
[input,...]

Fichiers ou dossiers ASCII comportant des données au format XYZ, XYZI (avec intensité lidar) ou 3D GENERATE. Tous les fichiers en entrée doivent présenter le même format. Si un dossier est spécifié, le paramètre Suffixe de fichier est requis et tous les fichiers portant la même extension que le suffixe indiqué sont traités.

Dans la fenêtre Géotraitement, vous pouvez également spécifier le dossier en entrée en le sélectionnant dans File Explorer et en le faisant glisser vers la zone de saisie du paramètre.

Folder; File
in_file_type

Format des fichiers ASCII qui seront convertis en classe d'entités.

  • XYZFichier texte qui contient des informations de géométrie stockées sous la forme de coordonnées XYZ.
  • XYZIFichiers texte contenant des coordonnées XYZ et des mesures d'intensité.
  • GENERATEFichiers texte structurés au format adapté à l'outil Générer.
String
out_feature_class

Classe d’entités qui va être produite.

Feature Class
out_geometry_type

Type de géométrie de la classe d'entités en sortie.

  • MULTIPOINTDes multi-points sont recommandés si les données en entrée contiennent un grande nombre de points et que des attributs par entité ne sont pas requis.
  • POINTChaque coordonnée XYZ produira une entité ponctuelle.
  • POLYLINELa sortie contient des entités polylignes.
  • POLYGONLa sortie contiendra des entités surfaciques.
String
z_factor
(Facultatif)

Facteur par lequel les valeurs z sont multipliées. Cette option permet généralement de convertir les unités linéaires z afin qu’elles correspondent aux unités linéaires x,y. La valeur par défaut est 1, qui laisse les valeurs d'altitude inchangées. Ce paramètre n’est pas disponible si la référence spatiale de la surface en entrée possède un datum z dont l’unité linéaire est spécifiée.

Double
input_coordinate_system
(Facultatif)

Système de coordonnées des données en entrée. La valeur par défaut est un système de coordonnées inconnu. Si une valeur est spécifiée, la sortie peut être projetée dans un système de coordonnées différent. Cela dépend si un système de coordonnées de l'environnement de géotraitement est défini pour l'emplacement de la classe d'entités cible.

Coordinate System
average_point_spacing
(Facultatif)

Distance planimétrique moyenne entre des points de l'entrée. Ce paramètre est utilisé uniquement lorsque la géométrie en sortie est définie surMULTIPOINT : il permet de regrouper des points. Cette valeur est utilisée avec la limite de points par forme afin de construire un système de tuiles virtuel permettant de regrouper les points. L'origine du système de tuiles est basé sur le domaine de la classe d'entités cible. Indiquez l'espacement dans les unités horizontales de la classe d'entités cible.

Double
file_suffix
(Facultatif)

Suffixe des fichiers à importer à partir d’un dossier en entrée. Ce paramètre est requis lorsqu'un dossier est spécifié en entrée.

String
decimal_separator
(Facultatif)

Le caractère décimal qui est utilisé dans le fichier texte pour différencier la partie entière d’un nombre de sa partie fractionnaire.

  • DECIMAL_POINTUn point sert de caractère décimal. Il s’agit de l’option par défaut.
  • DECIMAL_COMMAUne virgule sert de caractère décimal.
String

Exemple de code

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

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

arcpy.env.workspace = "C:/data"
#Create spatial reference object using WKID
sr = arcpy.SpatialReference(32136)
arcpy.ASCII3DToFeatureClass_3d("masspntz.gen", "GENERATE", "elevation_points.shp", 
                               "MULTIPOINT", z_factor=3.28, 
                               input_coordinate_system=sr, average_point_spacing=2.5)
2e exemple d'utilisation de l'outil ASCII3DToFeatureClass (script autonome)

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

'''****************************************************************************
Name: ASCII3D_to_Feature_Class Example
Description: Creates a TIN surface using XYZI files in a folder and breaklines
             imported from ASCII files.
****************************************************************************'''
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Define the spatial reference using the name
sr = arcpy.SpatialReference("Hawaii Albers Equal Area Conic")

# Create the elevation points
arcpy.ddd.ASCII3DToFeatureClass("Elevation Points", "XYZI",
                               "elevation_points.shp",
                               "MULTIPOINT", z_factor=3.28,
                               input_coordinate_system=sr,
                               average_point_spacing=2.5,
                               file_suffix="XYZ")

# Create the break lines
arcpy.ddd.ASCII3DToFeatureClass("brklines.gen", "GENERATE",
                               "breaklines.shp",
                               "POLYLINE", z_factor=3.28,
                               input_coordinate_system=sr)

arcpy.ddd.CreateTin("elevation_tin", sr,
                    [["breaklines.shp", "Shape", "hardline"],
                    ["elevation_points.shp", "Shape", "masspoints"]],
                    "CONSTRAINED_DELAUNAY")

Rubriques connexes