| Etiqueta | Explicación | Tipo de datos |
Tabla de entrada | La tabla que contiene las coordenadas x e y que definen las ubicaciones de las entidades de puntos que se crearán. | Table View |
Clase de entidad de salida | La clase de entidad que contiene las entidades de punto de salida. | Feature Class |
Campo X | El campo de la tabla de entrada que contiene las coordenadas X (o longitud). | Field |
Campo Y | El campo de la tabla de entrada que contiene las coordenadas Y (o latitud). | Field |
Campo Z (Opcional) | Campo de la tabla de entrada que contiene las coordenadas z. | Field |
Sistema de coordenadas (Opcional) | El sistema de coordenadas de las coordenadas x e y. Será el sistema de coordenadas de la clase de entidad de salida. | Spatial Reference |
Resumen
Crea una clase de entidad de punto basada en las coordenadas x, y y z de una tabla.
Uso
Los campos de atributos del valor del parámetro de la tabla de entrada se transferirán a la clase de entidad de salida.
El sistema de coordenadas especificado en el parámetro Sistema de coordenadas se aplicará a la salida. Este sistema de coordenadas determina cómo se interpretan las coordenadas x, y y z en la tabla de entrada. Como esta herramienta se suele utilizar con tablas que contienen valores de longitud y latitud, el sistema de coordenadas predeterminado es el sistema de coordenadas geográficas WGS84. Si las coordenadas x e y de la tabla de entrada contienen coordenadas proyectadas, especifique el sistema de coordenadas proyectadas adecuado.
Si el entorno Sistema de coordenadas de salida se ha definido, la clase de entidad de salida se reproyectará en este sistema de coordenadas desde el sistema de coordenadas especificado en el parámetro Sistema de coordenadas.
Al especificar el valor del parámetro Campo Z, el sistema de coordenadas predeterminado también incluye el sistema de coordenadas verticales WGS84. Si los valores z no están en metros, modifique el sistema de coordenadas para utilizar la unidad de elevación correcta.
Los valores de las coordenadas x e y de 0 o Nulo se consideran válidos y se incluirán en la salida. Las coordenadas de 0 tendrán entidades de puntos de salida colocadas en esa ubicación; las coordenadas que son nulas tendrán una geometría vacía.
Los valores de las coordenadas x e y en un sistema de coordenadas geográficas se consideran no válidos si son inferiores a -400 o mayores que 400. No se creará ningún registro de salida y se incluirá un mensaje de advertencia en los mensajes de la herramienta para indicar el Id. de entrada no válido.
Los campos de coordenadas x, y y z de entrada deben ser campos numéricos. Solo los valores de coordenadas en los siguientes formatos se deben utilizar como entrada para esta herramienta:
- Grados decimales en un sistema de coordenadas geográficas
- Mediciones lineales en un sistema de coordenadas proyectadas que utilizan números para indicar la posición con un desplazamiento x e y desde una ubicación de origen
Se pueden utilizar otros formatos o notaciones de coordenadas como entrada para la herramienta Convertir notación de coordenadas.
El delimitador estándar para los archivos de texto tabular con una extensión .csv o .txt es una coma; para los archivos con una extensión .tab, es una tabulación. Para usar una tabla de entrada con un delimitador no estándar, primero debe especificar el delimitador correcto utilizado en la tabla con un archivo schema.ini.
Parámetros
arcpy.management.XYTableToPoint(in_table, out_feature_class, x_field, y_field, {z_field}, {coordinate_system})| Nombre | Explicación | Tipo de datos |
in_table | La tabla que contiene las coordenadas x e y que definen las ubicaciones de las entidades de puntos que se crearán. | Table View |
out_feature_class | La clase de entidad que contiene las entidades de punto de salida. | Feature Class |
x_field | El campo de la tabla de entrada que contiene las coordenadas X (o longitud). | Field |
y_field | El campo de la tabla de entrada que contiene las coordenadas Y (o latitud). | Field |
z_field (Opcional) | Campo de la tabla de entrada que contiene las coordenadas z. | Field |
coordinate_system (Opcional) | El sistema de coordenadas de las coordenadas x e y. Será el sistema de coordenadas de la clase de entidad de salida. | Spatial Reference |
Muestra de código
El siguiente script de la ventana de Python muestra cómo utilizar la función XYTableToPoint.
import arcpy
arcpy.env.workspace = r"c:\output.gdb"
arcpy.management.XYTableToPoint(r"c:\data\tree.csv", "tree_points",
"longitude", "latitude", "elevation",
arcpy.SpatialReference(4759, 115700))El siguiente script independiente de Python muestra cómo utilizar la función XYTableToPoint.
# XYTableToPoint.py
# Description: Creates a point feature class from input table
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = r"c:\output.gdb"
# Set the local variables
in_table = r"c:\data\tree.csv"
out_feature_class = "tree_points"
x_coords = "longitude"
y_coords = "latitude"
z_coords = "elevation"
# Make the XY event layer...
arcpy.management.XYTableToPoint(in_table, out_feature_class,
x_coords, y_coords, z_coords,
arcpy.SpatialReference(4759, 115700))
# Print the total rows
print(arcpy.management.GetCount(out_feature_class))