Añadir puntos de control (Representación cartográfica de realidad)

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

Cuadro de diálogo

Etiqueta	Explicación	Tipo 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 puntos—Agregue 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 GCP—Agregue solo los GCP de la tabla de puntos de entrada a la tabla de puntos de control de destino. Agregar GCP y puntos de enlace—Agregue 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

Etiqueta	Explicación	Tipo de datos
Puntos de control actualizados	Los puntos de control actualizados.	Feature Class; Feature Layer

Python

arcpy.rm.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})

Nombre	Explicación	Tipo 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. NONE—No se realiza una corrección geoide. Utilice NONE solamente si su DEM ya está expresado en alturas elipsoidales. Esta es la opción predeterminada. GEOID—Se 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. ALL—Agregue 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. GCP—Agregue solo los GCP de la tabla de puntos de entrada a la tabla de puntos de control de destino. GCPSET—Agregue 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

Nombre	Explicación	Tipo de datos
out_master_control_points	Los puntos de control actualizados.	Feature Class; Feature Layer

Muestra de código

Ejemplo 1 de AppendControlPoints (ventana de Python)

Esta es una muestra de Python para la herramienta AppendControlPoints.

#===========================
#AppendControlPoints
'''Usage: AppendControlPoints_rm(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.rm.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 de 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.rm.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í