De entidad a punto (Administración de datos)

Resumen

Crea una clase de entidad que contiene puntos generados a partir de los centroides de las entidades de entrada o ubicados dentro de las entidades de entrada.

Ilustración

Ilustración de la herramienta De entidad a punto

Uso

  • Los atributos de las entidades de entrada se mantendrán en la clase de entidad de salida. Se agregará un campo nuevo, ORIG_FID, a la clase de entidad de salida y se establecerá en los Id. de entidad de entrada.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Las entidades de entrada, que pueden ser multipunto, línea, polígono o anotación.

Feature Layer
Clase de entidad de salida

La clase de entidad de puntos de salida.

Feature Class
Dentro
(Opcional)

Especifica si un punto de salida se ubicará dentro de la entidad de entrada o en el centroide de la entidad de entrada.

  • Desactivado: el punto de salida se ubicará en el centroide de la entidad de entrada. Puede que el punto de salida no siempre esté contenido en la entidad de entrada. Esta es la opción predeterminada.
  • Activado: el punto de salida se ubicará dentro de la entidad de entrada.

Si el parámetro Dentro no está activado, la ubicación de cada punto de salida se determinará de la siguiente manera:

  • Entidades multipunto: el punto de salida estará ubicado en las coordenadas x e y medias de todos los puntos del multipunto.
  • Entidades de polilínea: el punto de salida estará ubicado en la coordenada x e y promedio ponderada de los puntos medios de todos los segmentos de línea de la línea, donde la ponderación de un punto medio en particular es la longitud del correspondiente segmento de línea. Las curvas paramétricas (verdaderas) se densificarán.
  • Entidades poligonales: el punto de salida estará ubicado en el centro de gravedad (centroide) del polígono.

Si el parámetro Dentro está activado, la ubicación del punto representativo de la entidad de entrada estará contenida en la entidad de entrada y se determinará del siguiente modo:

  • Entidades multipunto: el punto de salida coincidirá con uno de los puntos del multipunto.
  • Entidades de polilínea: el punto de salida estará en la línea. Si la línea es una curva paramétrica (verdadera), el punto de salida se encontrará en el punto medio de la línea.
  • Entidades poligonales: el punto de salida estará dentro del polígono.

Boolean

arcpy.management.FeatureToPoint(in_features, out_feature_class, {point_location})
NombreExplicaciónTipo de datos
in_features

Las entidades de entrada, que pueden ser multipunto, línea, polígono o anotación.

Feature Layer
out_feature_class

La clase de entidad de puntos de salida.

Feature Class
point_location
(Opcional)

Especifica si un punto de salida se ubicará dentro de la entidad de entrada o en el centroide de la entidad de entrada.

  • CENTROIDEl punto de salida se ubicará en el centroide de la entidad de entrada. Puede que el punto de salida no siempre esté contenido en la entidad de entrada. Esta es la opción predeterminada.
  • INSIDEEl punto de salida se ubicará dentro de la entidad de entrada.

Si el parámetro point_location se establece en CENTROID, la ubicación de cada punto de salida se determinará de la siguiente manera:

  • Entidades multipunto: el punto de salida estará ubicado en las coordenadas x e y medias de todos los puntos del multipunto.
  • Entidades de polilínea: el punto de salida estará ubicado en la coordenada x e y promedio ponderada de los puntos medios de todos los segmentos de línea de la línea, donde la ponderación de un punto medio en particular es la longitud del correspondiente segmento de línea. Las curvas paramétricas (verdaderas) se densificarán.
  • Entidades poligonales: el punto de salida estará ubicado en el centro de gravedad (centroide) del polígono.

Si el parámetro point_location se establece en INSIDE, la ubicación del punto representativo de la entidad de entrada estará contenida en la entidad de entrada y se determinará del siguiente modo:

  • Entidades multipunto: el punto de salida coincidirá con uno de los puntos del multipunto.
  • Entidades de polilínea: el punto de salida estará en la línea. Si la línea es una curva paramétrica (verdadera), el punto de salida se encontrará en el punto medio de la línea.
  • Entidades poligonales: el punto de salida estará dentro del polígono.

Boolean

Muestra de código

Ejemplo 1 de FeatureToPoint (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función FeatureToPoint de modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.FeatureToPoint("parcels.shp", "c:/data/output/parcels_center.shp", 
                                "CENTROID")
Ejemplo 2 de FeatureToPoint (script independiente)

El siguiente script independiente es un ejemplo simple de cómo aplicar la función FeatureToPoint en un entorno de scripts.

# Name: FeatureToPoint_Example2.py
# Description: Use FeatureToPoint function to find a point inside each park

# import system modules 
import arcpy

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

#  Set local variables
inFeatures = "parks.shp"
outFeatureClass = "c:/output/output.gdb/parks_pt"

# Use FeatureToPoint function to find a point inside each park
arcpy.management.FeatureToPoint(inFeatures, outFeatureClass, "INSIDE")