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.
Sintaxis
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})
Parámetro | 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.
| 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.
| String |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_master_control_points | Los puntos de control actualizados. | Clase de entidad; Capa de entidades |
Muestra de código
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")
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.AppendControlPoints_management(target, in_controlPoints, "", dem, "", "", "", AOI, appOpt)
Entornos
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí