De ASCII 3D a clase de entidad (Herramientas de 3D Analyst)

Resumen

Importa entidades 3D desde uno o más archivos ASCII almacenados en los formatos XYZ, XYZI o GENERATE, a una clase de entidad.

Ilustración

Ejemplo de ASCII 3D a clase de entidad

Uso

Todos los archivos de entrada deben ser del mismo formato y tipo de geometría.
XYZ y los formatos XYZI admiten líneas de encabezado y tratan la primera fila que comienza con tres números consecutivos como el inicio de los registros de puntos. Ambos formatos pueden almacenar puntos, líneas y polígonos, pero cada archivo puede contener solo una línea o entidad de polígono de una sola parte. Las entidades de polígono deben cerrarse, siendo las coordenadas del último vértice idénticas a las del primero, y no deben autointersecarse.
XYZ Los archivos almacenan coordenadas x, y y z como valores de punto flotante, donde cada fila representa un registro puntual distinto. Las coordenadas XYZ pueden ir seguidas de entradas alfanuméricas, pero esta información no se transferirá a la clase de entidad resultante.
XYZI Los archivos almacenan las x, y, y z y medidas de intensidad. Los valores de intensidad se almacenan en un campo binario de objeto grande (BLOB) para salidas multiparche.

Nota:

Si el archivo ASCII está en formato XYZI, pero no se desean las medidas de intensidad, elija XYZ. Esto omitirá el valor de intensidad al leer los archivos.
El formato GENERATE no soporta líneas de encabezado, pero proporciona un Id. para cada punto junto con coordenadas XYZ, y la última línea del archivo se indica opcionalmente usando la palabra clave END:

<!--```nohighlight Id. x y z Id. x y z . . END

El formato GENERATE soporta múltiples entidades por archivo. Para líneas y polígonos, la palabra clave END indica el final de una entidad, y cada entidad debe ser una entidad de una sola parte. Dos palabras clave END seguidas indican el final del archivo.

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


> [!NOTE]
> Los polígonos deben estar orientados en sentido horario, no tener autointersecciones y estar cerrados (es decir, el último vértice es igual al primero). Si no se cumplen estas condiciones, el polígono de salida no será válido. La herramienta [**Comprobar Geometría**](../data-management/check-geometry.yml) puede usarse para validar las entidades resultantes, y la herramienta [**Reparar Geometría**](../data-management/repair-geometry.yml) puede emplearse para corregir los errores.

Etiqueta	Explicación	Tipo de datos
Datos ASCII 3D	Los archivos ASCII o las carpetas que contengan datos en formato XYZ, XYZI (con intensidad lidar) o 3D GENERATE. Todos los archivos de entrada deben tener el mismo formato. Si se especifica una carpeta, el parámetro Sufijo de archivo pasa a ser obligatorio, y se procesarán todos los archivos que tengan la misma extensión que el sufijo especificado. En el panel Geoprocesamiento, también se puede especificar una carpeta como entrada seleccionando la carpeta en el Explorador de archivos y arrastrándola al cuadro de entrada del parámetro.	Folder; File
Formato de archivo	El formato de los archivos ASCII que se convertirán en una clase de entidad. 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
Clase de entidad de salida	Clase de entidad que se generará.	Feature Class
Tipo de clase de entidad de salida	El tipo de geometría de la clase de entidad de salida. 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
Factor Z (Opcional)	El factor por el que se multiplicarán los valores z. Esto se utiliza generalmente para convertir las unidades lineales z para que coincidan con las unidades lineales x,y. El valor predeterminado es 1, que no altera los valores de elevación. Este parámetro no está disponible si la referencia espacial de la superficie de entrada tiene un datum z con una unidad lineal especificada.	Double
Sistema de coordenadas (Opcional)	El sistema de coordenadas de los datos de entrada El valor predeterminado es un Sistema de coordenadas desconocido. Si se especifica, la salida puede o no proyectarse en un sistema de coordenadas diferente. Esto depende de si el entorno de geoprocesamiento tiene un sistema de coordenadas definido para la ubicación de la clase de entidad de destino.	Coordinate System
Espaciado de punto promedio (Opcional)	La distancia planimétrica promedio entre los puntos de la entrada. Este parámetro solo se utiliza cuando la geometría de salida está configurada como MULTIPOINT, y su función es proporcionar un medio para agrupar los puntos. Este valor se utiliza junto con los puntos según el límite de forma para crear un sistema de teselas virtual utilizado para agrupar los puntos. El origen del sistema de teselas se basa en el dominio de la clase de entidades de destino. Especifique el espaciado en las unidades horizontales de la clase de entidad de destino.	Double
Sufijo del archivo (Opcional)	Sufijo de los archivos que se importarán desde una carpeta de entrada. Este parámetro es necesario cuando se especifica una carpeta como entrada.	String
Separador decimal (Opcional)	Carácter decimal que se va a utilizar en el archivo de texto para diferenciar al entero de un número de su parte fraccionaria. 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})

Nombre	Explicación	Tipo de datos
input [input,...]	Los archivos ASCII o las carpetas que contengan datos en formato XYZ, XYZI (con intensidad lidar) o 3D GENERATE. Todos los archivos de entrada deben tener el mismo formato. Si se especifica una carpeta, el parámetro Sufijo de archivo pasa a ser obligatorio, y se procesarán todos los archivos que tengan la misma extensión que el sufijo especificado. En el panel Geoprocesamiento, también se puede especificar una carpeta como entrada seleccionando la carpeta en el Explorador de archivos y arrastrándola al cuadro de entrada del parámetro.	Folder; File
in_file_type	El formato de los archivos ASCII que se convertirán en una clase de entidad. `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	Clase de entidad que se generará.	Feature Class
out_geometry_type	El tipo de geometría de la clase de entidad de salida. `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 (Opcional)	El factor por el que se multiplicarán los valores z. Esto se utiliza generalmente para convertir las unidades lineales z para que coincidan con las unidades lineales x,y. El valor predeterminado es 1, que no altera los valores de elevación. Este parámetro no está disponible si la referencia espacial de la superficie de entrada tiene un datum z con una unidad lineal especificada.	Double
input_coordinate_system (Opcional)	El sistema de coordenadas de los datos de entrada El valor predeterminado es un Sistema de coordenadas desconocido. Si se especifica, la salida puede o no proyectarse en un sistema de coordenadas diferente. Esto depende de si el entorno de geoprocesamiento tiene un sistema de coordenadas definido para la ubicación de la clase de entidad de destino.	Coordinate System
average_point_spacing (Opcional)	La distancia planimétrica promedio entre los puntos de la entrada. Este parámetro solo se utiliza cuando la geometría de salida está configurada como MULTIPOINT, y su función es proporcionar un medio para agrupar los puntos. Este valor se utiliza junto con los puntos según el límite de forma para crear un sistema de teselas virtual utilizado para agrupar los puntos. El origen del sistema de teselas se basa en el dominio de la clase de entidades de destino. Especifique el espaciado en las unidades horizontales de la clase de entidad de destino.	Double
file_suffix (Opcional)	Sufijo de los archivos que se importarán desde una carpeta de entrada. Este parámetro es necesario cuando se especifica una carpeta como entrada.	String
decimal_separator (Opcional)	Carácter decimal que se va a utilizar en el archivo de texto para diferenciar al entero de un número de su parte fraccionaria. `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

Muestra de código

Ejemplo 1 de ASCII3DToFeatureClass (ventana de Python)

El siguiente ejemplo muestra cómo usar esta herramienta en la ventana de 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)

Ejemplo 2 de ASCII3DToFeatureClass (secuencia de comandos independiente)

El siguiente ejemplo muestra cómo usar esta herramienta en un script independiente de Python:

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

Entornos

Espacio de trabajo actual, Extensión, Sistema de coordenadas de salida, Transformaciones geográficas, Resolución XY, Tolerancia XY, Resolución Z, Tolerancia Z, Palabra clave CONFIG de salida, Auto ejecución

Información de licenciamiento

Basic: Sí
Standard: Sí
Avanzado: Sí