ASCII 3D vers classe d’entités (Outils 3D Analyst)

Résumé

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 ASCII 3D vers classe d’entité

Utilisation

Tous les fichiers en entrée doivent avoir les mêmes format et type de géométrie.
XYZ et XYZI prennent en charge les lignes d’en-tête et considèrent la première ligne commençant par trois numéros consécutifs comme le début des enregistrements de points. Ces deux formats peuvent stocker des points, des lignes et des polygones, mais chaque fichier ne peut contenir qu’une entité linéaire ou surfacique en une seule partie. Les entités surfaciques doivent être fermées, avec les coordonnées du dernier sommet identiques à celles du premier, et ne doivent pas être auto-sécantes.
XYZ Les fichiers stockent les coordonnées x, y et z sous forme de valeurs à virgule flottante, chaque ligne représentant un enregistrement de point distinct. Les coordonnées XYZ peuvent être suivies d’entrées alphanumériques, mais ces informations ne seront pas transférées vers la classe d’entités résultante.
XYZI Les fichiers stockent x, y, z et des mesures d’intensité. Les valeurs d’intensité sont stockées dans un champ BLOB (grand objet binaire) pour les sorties multipatch.

Remarque :

Si le fichier ASCII est au format XYZI mais que les mesures d’intensité ne sont pas souhaitées, choisissez XYZ. La valeur d’intensité sera ignorée lors de la lecture des fichiers.
Le format GENERATE ne prend pas en charge les lignes d’en-tête, mais il fournit un ID pour chaque point le long des coordonnées XYZ, et la dernière ligne du fichier peut être indiquée à l’aide du mot-clé END :

<!--```nohighlight 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 indique la fin d’une entité, et chaque entité doit être composée d’une seule partie. Deux mots-clés END consécutifs indiquent la fin du fichier.

<!--```nohighlight id x y z x y z x y z END id x y z x y z END END


> [!NOTE]
> Les polygones doivent être orientés dans le sens horaire, ne comporter aucune auto-intersection et être fermés (le dernier sommet est égal au premier). Si l’une de ces conditions n’est pas remplie, le polygone en sortie ne sera pas valide. L’outil [**Vérifier les géométries**](../data-management/check-geometry.yml) peut être utilisé pour valider les entités résultantes, et l’outil [**Réparer les géométries**](../data-management/repair-geometry.yml) peut être utilisé pour corriger les erreurs.

Etiqueter	Explication	Type de données
Données ASCII 3D	Fichiers ou dossiers ASCII contenant des données au format XYZ, XYZI (avec intensité lidar) ou 3D GENERATE. Tous les fichiers en entrée doivent être au même format. Si un dossier est spécifié, le paramètre File Suffix (Suffixe de fichier) devient obligatoire, et tous les fichiers qui ont la même extension que le suffixe spécifié sont traités. Dans la fenêtre Geoprocessing (Géotraitement), vous pouvez également spécifier le dossier en entrée en le sélectionnant dans l’Explorateur de fichiers et en le faisant glisser vers la zone de saisie du paramètre.	Folder; File
Format de fichier	Format des fichiers ASCII à convertir en classe d’entités. XYZ—Text file that contain geometry information stored as XYZ coordinates. XYZI—Text files that contain XYZ coordinates alongside intensity measurements. Generate—Text files structured in the Generate format.	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. Multipoint features—Multipoints are recommended the input data contains a large number of points and attributes per feature are not required. Point features—Each XYZ coordinate will produce one point feature. Polyline features—The output will contain polyline features. Polygon features—The output will contain polygon features.	String
Facteur Z (Facultatif)	Facteur par lequel les valeurs z sont multipliées. Il permet généralement de convertir des unités linéaires z afin de les apparier 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 avec une unité linéaire 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 les points de l’entrée. Ce paramètre n’est utilisé que lorsque la géométrie en sortie est définie sur MULTI-POINT, et sa fonction est de fournir un moyen de regrouper les points. Cette valeur est utilisée conjointement avec la limite de points par forme afin de créer un système de tuiles virtuelles utilisé pour regrouper les points. L’origine du système de tuiles dépend du domaine de la classe d’entités cible. Spécifiez l’espacement dans les unités horizontales de la classe d’entités cible.	Double
Suffixe de fichier (Facultatif)	Suffixe des fichiers qui seront importés à 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)	Caractère décimal qui sera utilisé dans le fichier texte pour différencier la partie entière d’un nombre de sa partie fractionnaire. Point—A point will be used as the decimal character. This is the default. Comma—A comma will be used as the decimal character.	String

arcpy.3d.ASCII3DToFeatureClass(input, in_file_type, out_feature_class, out_geometry_type, {z_factor}, {input_coordinate_system}, {average_point_spacing}, {file_suffix}, {decimal_separator})

Nom	Explication	Type de données
input [input,...]	Fichiers ou dossiers ASCII contenant des données au format XYZ, XYZI (avec intensité lidar) ou 3D GENERATE. Tous les fichiers en entrée doivent être au même format. Si un dossier est spécifié, le paramètre File Suffix (Suffixe de fichier) devient obligatoire, et tous les fichiers qui ont la même extension que le suffixe spécifié sont traités. Dans la fenêtre Geoprocessing (Géotraitement), vous pouvez également spécifier le dossier en entrée en le sélectionnant dans l’Explorateur de fichiers et en le faisant glisser vers la zone de saisie du paramètre.	Folder; File
in_file_type	Format des fichiers ASCII à convertir en classe d’entités. `XYZ`—Text file that contain geometry information stored as XYZ coordinates. `XYZI`—Text files that contain XYZ coordinates alongside intensity measurements. `GENERATE`—Text files structured in the Generate format.	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. `MULTIPOINT`—Multipoints are recommended the input data contains a large number of points and attributes per feature are not required. `POINT`—Each XYZ coordinate will produce one point feature. `POLYLINE`—The output will contain polyline features. `POLYGON`—The output will contain polygon features.	String
z_factor (Facultatif)	Facteur par lequel les valeurs z sont multipliées. Il permet généralement de convertir des unités linéaires z afin de les apparier 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 avec une unité linéaire 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 les points de l’entrée. Ce paramètre n’est utilisé que lorsque la géométrie en sortie est définie sur MULTI-POINT, et sa fonction est de fournir un moyen de regrouper les points. Cette valeur est utilisée conjointement avec la limite de points par forme afin de créer un système de tuiles virtuelles utilisé pour regrouper les points. L’origine du système de tuiles dépend du domaine de la classe d’entités cible. Spécifiez l’espacement dans les unités horizontales de la classe d’entités cible.	Double
file_suffix (Facultatif)	Suffixe des fichiers qui seront importés à 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)	Caractère décimal qui sera utilisé dans le fichier texte pour différencier la partie entière d’un nombre de sa partie fractionnaire. `DECIMAL_POINT`—A point will be used as the decimal character. This is the default. `DECIMAL_COMMA`—A comma will be used as the decimal character.	String

Exemple de code

Exemple 1 d’utilisation de 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.ddd.ASCII3DToFeatureClass("masspntz.gen", "GENERATE", "elevation_points.shp",
                                "MULTIPOINT", z_factor=3.28,
                                input_coordinate_system=sr, average_point_spacing=2.5)

Exemple 2 d’utilisation de 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")

Environnements

Espace de travail courant, Etendue, Système de coordonnées en sortie, Transformations géographiques, Résolution XY, Tolérance XY, Résolution Z, Tolérance Z, Mot-clé CONFIG en sortie, Validation automatique

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui