De tabla XY a punto (Administración de datos)

Resumen

Crea una nueva clase de entidad de punto basada en las coordenadas x, y y z de una tabla.

Uso

• El delimitador estándar para los archivos de texto tabular con extensiones .csv o .txt es una coma y, para los archivos con una extensión .tab, una pestaña. 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.

• 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 WGS 1984. 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 un parámetro Campo Z, el sistema de coordenadas predeterminado también incluye el sistema de coordenadas verticales WGS 1984. Si los valores z no están en metros, modifique el sistema de coordenadas para utilizar la unidad de elevación correcta.

• Si cualquiera de las coordenadas x o y (o z, si se ha especificado) de entrada de una entidad son valores nulos o no numéricos, la entidad correspondiente será una geometría nula. La herramienta Verificar geometría se puede utilizar para comprobar la existencia de geometrías nulas en la salida.

• La herramienta creará entidades de punto para todos los registros válidos en la tabla de entrada, incluso cuando la tabla tenga una selección. Si solo se debe utilizar un subconjunto de registros, utilice la herramienta Copiar filas para copiar los registros seleccionados a una tabla nueva, y utilice la tabla nueva como entrada.

Sintaxis

arcpy.management.XYTableToPoint(in_table, out_feature_class, x_field, y_field, {z_field}, {coordinate_system})

Parámetro	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

Ejemplo de XYTableToPoint (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la herramienta 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))

Ejemplo 2 de XYTableToPoint (script independiente)

El siguiente script de Phython independiente muestra cómo utilizar la herramienta 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.GetCount_management(out_feature_class))

Entornos

Espacio de trabajo actual, Sistema de coordenadas de salida, Extensión

Información de licenciamiento

• Basic: Sí
• Standard: Sí
• Advanced: Sí