De entidad a punto (Administración de datos)

Resumen

Crea una clase de entidad que contiene puntos generados a partir de las ubicaciones representativas de las entidades de entrada.

Ilustración

Ilustración de 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.

  • Si la opción Dentro del cuadro de diálogo está desactivada (el parámetro point_location está definido como CENTROID), la ubicación del punto de salida se determinará del siguiente modo:

    • Para una entidad multipunto de entrada: el punto de salida estará ubicado en las coordenadas x e y promedio de todos los puntos que haya en la entidad multipunto.
    • Para una entidad de línea de entrada: el punto de salida se situará en la media ponderada de las coordenadas x e y de los puntos medios de todos los segmentos de línea de la entidad de línea; donde la ponderación de un punto medio concreto es la longitud del correspondiente segmento de línea. En primer lugar, se densifican las curvas paramétricas (verdaderas).
    • Para una entidad de polígono de entrada: el punto de salida estará ubicado en el centro de gravedad (centroide) del polígono.

    Si la opción Dentro del cuadro de diálogo está activada (el parámetro point_location está definido como 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:

    • Para un multipunto de entrada: el punto de salida coincidirá con uno de los puntos del multipunto.
    • Para una línea de entrada: 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.
    • Para un polígono de entrada: el punto de salida se encontrará dentro del polígono.

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 se utilizarán centros representativos de ubicaciones o entidades de entrada contenidos por las entidades de entrada como las ubicaciones de puntos de salida.

  • Desactivada: utiliza el centro representativo de una entidad de entrada como su ubicación de punto de salida. Puede que esta ubicación no siempre esté contenida en la entidad de entrada. Esta es la opción predeterminada.
  • Activada: utiliza una ubicación contenida por una entidad de entrada como su ubicación de punto de salida.

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 se utilizarán centros representativos de ubicaciones o entidades de entrada contenidos por las entidades de entrada como las ubicaciones de puntos de salida.

  • CENTROIDUtiliza el centro representativo de una entidad de entrada como su ubicación de punto de salida. Puede que esta ubicación de punto no siempre esté contenida en la entidad de entrada. Esta es la opción predeterminada.
  • INSIDEUtiliza una ubicación contenida por una entidad de entrada como su ubicación de punto de salida.
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.FeatureToPoint_management("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.FeatureToPoint_management(inFeatures, outFeatureClass, "INSIDE")