Añadir puntos de control (Administración de datos)

Resumen

Combina los puntos de control en una tabla de puntos de control existente.

Los puntos que se van a incorporar son los resultados de la herramienta Calcular puntos de enlace, la herramienta Calcular puntos de control o una clase de entidad de puntos.

Uso

  • Si se ha establecido tanto el parámetro Nombre de campo del valor Z como el parámetro DEM de entrada, el Nombre de campo del valor Z tiene prioridad. Si no se han establecido ni el parámetro Nombre de campo del valor Z ni el parámetro DEM de entrada, el valor Z se establece en 0 para todos los puntos de control del terreno (GCP) y los puntos de verificación..

  • Tenga cuidado al invocar la Opción de incorporación; solo se aplica cuando los puntos de enlace de las tablas de puntos de control de entrada y de destino tienen la misma transformación.

Parámetros

EtiquetaExplicaciónTipo de datos
Puntos de control de destino

Tabla de los puntos de control de entrada. Esta es generalmente la salida de la herramienta Calcular puntos de enlace.

Feature Class; Feature Layer
Puntos de control de entrada

Clase de entidad de puntos que almacena puntos de control. Podría ser la tabla de puntos de control creada desde la herramienta Calcular puntos de control, la herramienta Calcular puntos de enlace o una clase de entidad de puntos que tiene puntos de control del terreno.

Feature Class; Feature Layer; File; String
Nombre de campo del valor Z
(Opcional)

Campo que almacena los valores z del punto de control.

Si se han establecido tanto el parámetro Nombre de campo del valor Z como el parámetro DEM de entrada, se utiliza el campo del valor Z. Si no se han establecido ni el parámetro Nombre de campo del valor Z ni el parámetro DEM de entrada, el valor Z se establece en 0 para todos los puntos de control del terreno y los puntos de verificación.

Field
Nombre de campo de etiqueta
(Opcional)

Campo de la tabla de puntos de control de entrada que tiene un valor único. Este campo se agregará a la tabla de puntos de control de destino, donde el campo de etiqueta puede utilizarse para incluir identificadores asociados con puntos de control del terreno.

Field
DEM de entrada
(Opcional)

DEM que se utilizará para obtener el valor z de los puntos de control en la tabla de puntos de control de entrada.

Si se han establecido tanto el parámetro Nombre de campo del valor Z como el parámetro DEM de entrada, se utiliza el campo del valor Z. Si no se han establecido ni el parámetro Nombre de campo del valor Z ni el parámetro DEM de entrada, el valor Z se establece en 0 para todos los puntos de control del terreno y los puntos de verificación.

Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
Exactitud de XY
(Opcional)

La exactitud de la entrada para las coordenadas x, y. La exactitud se expresa en las mismas unidades que los Puntos de control de entrada.

Esta información debería proporcionarla el proveedor de datos. Si la información de exactitud no está disponible, deje este parámetro opcional en blanco.

Double
Exactitud de Z
(Opcional)

La exactitud de la entrada para las coordenadas verticales. La exactitud se expresa en las unidades de los Puntos de control de entrada.

Esta información debería proporcionarla el proveedor de datos. Si la información de exactitud no está disponible, deje este parámetro opcional en blanco.

Double
Geoide
(Opcional)

La corrección geoide es necesaria en los coeficientes polinómicos racionales (RPC) que hacen referencia a alturas elipsoidales. La mayoría de los datasets de elevación hacen referencia a alturas ortométricas, por lo que en estos casos esta corrección sería necesaria para convertir a alturas elipsoidales.

  • Desactivada: no se realiza una corrección geoide. Utilice esta opción solamente si su DEM ya está expresado en alturas elipsoidales. Esta es la opción predeterminada.
  • Activada: se realizará una corrección geoide para convertir alturas ortométricas en alturas elipsoidales (basándose en el geoide EGM96).
Boolean
Área de interés
(Opcional)

Define la extensión de un área de interés al introducir coordenadas x e y mínimas y máximas en la referencia espacial de la tabla de puntos de control de entrada.

Envelope; Feature Layer; Feature Class
Opción de incorporación
(Opcional)

Especifica cómo se incorporan los puntos de control a la tabla de puntos de control.

  • Agregar todos los puntosAgregue todos los puntos de la tabla de puntos de control de entrada a la tabla de puntos de control de destino, incluidos GCP, puntos de comprobación y todos los puntos de enlace. Esta es la opción predeterminada.
  • Agregar solo GCPAgregue solo los GCP de la tabla de puntos de entrada a la tabla de puntos de control de destino.
  • Agregar GCP y puntos de enlaceAgregue GCP y puntos de enlace asociados específicamente con los GCP a la tabla de puntos de control de destino.Tenga cuidado con esta opción; solo se aplica cuando los puntos de enlace de las tablas de puntos de control de entrada y de destino tienen la misma transformación. Es posible que los puntos de enlace no se encuentren en las posiciones deseadas si se calcularon con un proceso de ajuste distinto.
String

Salida derivada

EtiquetaExplicaciónTipo de datos
Puntos de control actualizados

Los puntos de control actualizados.

Clase de entidad; Capa de entidades

arcpy.management.AppendControlPoints(in_master_control_points, in_input_control_points, {in_z_field}, {in_tag_field}, {in_dem}, {in_xy_accuracy}, {in_z_accuracy}, {Geoid}, {area_of_interest}, {append_option})
NombreExplicaciónTipo de datos
in_master_control_points

Tabla de los puntos de control de entrada. Esta es generalmente la salida de la herramienta Calcular puntos de enlace.

Feature Class; Feature Layer
in_input_control_points

Clase de entidad de puntos que almacena puntos de control. Podría ser la tabla de puntos de control creada desde la herramienta Calcular puntos de control, la herramienta Calcular puntos de enlace o una clase de entidad de puntos que tiene puntos de control del terreno.

Feature Class; Feature Layer; File; String
in_z_field
(Opcional)

Campo que almacena los valores z del punto de control.

Si se han establecido tanto el parámetro Nombre de campo del valor Z como el parámetro DEM de entrada, se utiliza el campo del valor Z. Si no se han establecido ni el parámetro Nombre de campo del valor Z ni el parámetro DEM de entrada, el valor Z se establece en 0 para todos los puntos de control del terreno y los puntos de verificación.

Field
in_tag_field
(Opcional)

Campo de la tabla de puntos de control de entrada que tiene un valor único. Este campo se agregará a la tabla de puntos de control de destino, donde el campo de etiqueta puede utilizarse para incluir identificadores asociados con puntos de control del terreno.

Field
in_dem
(Opcional)

DEM que se utilizará para obtener el valor z de los puntos de control en la tabla de puntos de control de entrada.

Si se han establecido tanto el parámetro Nombre de campo del valor Z como el parámetro DEM de entrada, se utiliza el campo del valor Z. Si no se han establecido ni el parámetro Nombre de campo del valor Z ni el parámetro DEM de entrada, el valor Z se establece en 0 para todos los puntos de control del terreno y los puntos de verificación.

Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
in_xy_accuracy
(Opcional)

La exactitud de la entrada para las coordenadas x, y. La exactitud se expresa en las mismas unidades que los in_input_control_points.

Esta información debería proporcionarla el proveedor de datos. Si la información de exactitud no está disponible, omita este parámetro opcional.

Double
in_z_accuracy
(Opcional)

La exactitud de la entrada para las coordenadas verticales. La exactitud se expresa en las unidades de los in_input_control_points.

Esta información debería proporcionarla el proveedor de datos. Si la información de exactitud no está disponible, omita este parámetro opcional.

Double
Geoid
(Opcional)

La corrección geoide es necesaria en los coeficientes polinómicos racionales (RPC) que hacen referencia a alturas elipsoidales. La mayoría de los datasets de elevación hacen referencia a alturas ortométricas, por lo que en estos casos esta corrección sería necesaria para convertir a alturas elipsoidales.

  • NONENo se realiza una corrección geoide. Utilice NONE solamente si su DEM ya está expresado en alturas elipsoidales. Esta es la opción predeterminada.
  • GEOIDSe realizará una corrección geoide para convertir alturas ortométricas en alturas elipsoidales (basado en geoide EGM96).
Boolean
area_of_interest
(Opcional)

Define la extensión de un área de interés al introducir coordenadas x e y mínimas y máximas en la referencia espacial de la tabla de puntos de control de entrada.

Envelope; Feature Layer; Feature Class
append_option
(Opcional)

Especifica cómo se incorporan los puntos de control a la tabla de puntos de control.

  • ALLAgregue todos los puntos de la tabla de puntos de control de entrada a la tabla de puntos de control de destino, incluidos GCP, puntos de comprobación y todos los puntos de enlace. Esta es la opción predeterminada.
  • GCPAgregue solo los GCP de la tabla de puntos de entrada a la tabla de puntos de control de destino.
  • GCPSETAgregue GCP y puntos de enlace asociados específicamente con los GCP a la tabla de puntos de control de destino.Tenga cuidado con esta opción; solo se aplica cuando los puntos de enlace de las tablas de puntos de control de entrada y de destino tienen la misma transformación. Es posible que los puntos de enlace no se encuentren en las posiciones deseadas si se calcularon con un proceso de ajuste distinto.
String

Salida derivada

NombreExplicaciónTipo de datos
out_master_control_points

Los puntos de control actualizados.

Clase de entidad; Capa de entidades

Muestra de código

Ejemplo 1 de AppendControlPoints (ventana de Python)

Esta es una muestra de Python para la herramienta AppendControlPoints.

#===========================
#AppendControlPoints
'''Usage: AppendControlPoints_management(in_master_control_points, 
{in_z_field}, {in_tag_field}, {in_dem}, {in_xy_accuracy}, 
{in_z_accuracy}, {Geoid}, {area_of_interest}, {append_option}
'''

import arcpy
arcpy.env.workspace = "C:/Workspace"

arcpy.management.AppendControlPoints("calval_allpoints_dem1", 
    "C:\test\calval_allpoints_dem1", "Score", "Ways", "calval",1, 2, "NONE", 
"-79.6407162269889 43.4853802421312 -79.094324938576 44.0836924137218", "GCP")
Ejemplo 2 de AppendControlPoints (script independiente)

Esta es una muestra del script de Python para la herramienta AppendControlPoints.

#append control points

import arcpy
arcpy.env.workspace = "c:/workspace"

#append the control points and tie points
target = "BD.gdb/tiePoints"
in_controlPoints = "BD.gdb/controlPoints"
dem = "BD.gdb/dem"
AOI = "-79.6407162269889 43.4853802421312 -79.094324938576 44.0836924137218"
AppOpt = "GCP"


arcpy.management.AppendControlPoints(target, in_controlPoints, "", dem, "", "", "", AOI, appOpt)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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

Temas relacionados