Registrar ráster

Resumen

Alinea automáticamente un ráster con una imagen de referencia o utiliza un archivo de puntos de control para el georregistro. Si el dataset de entrada es un dataset de mosaico, la herramienta funcionará con cada elemento del dataset de mosaico. Para registrar automáticamente la imagen, el ráster de entrada y el ráster de referencia deben estar en un área geográfica relativamente cerca. La herramienta se ejecutará más rápido si los datasets ráster están en estrecha alineación. Es posible que necesite crear un archivo de vínculos, también conocido como archivo de control de puntos, con algunos vínculos para que el ráster de entrada se encuentre en el mismo espacio del mapa.

Uso

• El ráster de entrada tendrá la información de georreferenciación actualizada.

• Una tabla de vínculos se puede crear mediante la barra de herramientas Georreferenciación.

• La palabra clave Restablecer (register_mode = "RESET" en Python) le permite quitar cualquier transformación geográfica que se haya aplicado con esta herramienta.

• Esta herramienta permite registrar todos los elementos de un dataset de mosaico, un subconjunto de elementos o un solo elemento de un dataset de mosaico. Si solo desea registrar un elemento específico, deberá introducir la ruta completa del dataset de mosaico y después una consulta única para el elemento que desea actualizar.

  A continuación, se muestran algunos ejemplos sobre cómo elegir un elemento dentro de un dataset de mosaico como ráster de entrada:

  • \\Myserver\MyFolder\MyMosaicDataset\OBJECTID=1
  • \\Myserver\MyFolder\MyMosaicDataset\NAME='tileName01'

  Si desea elegir un subconjunto de elementos, puede realizar una selección en la capa del dataset de mosaico.

• Cuando el ráster de entrada es un dataset de mosaico con elementos con refinado panorámico, esta herramienta puede registrar el ráster multiespectral con el ráster pancromático al elegir la palabra clave REGISTER_MS dentro del parámetro Modo de registro. Asegúrese de dejar vacíos los parámetros Ráster de referencia y Archivo de vínculos de entrada.

Sintaxis

arcpy.management.RegisterRaster(in_raster, register_mode, {reference_raster}, {input_link_file}, {transformation_type}, {output_cpt_link_file}, {maximum_rms_value})

Parámetro	Explicación	Tipo de datos
in_raster	El ráster que desea realinear. El registro de un elemento de dataset de mosaico actualizará ese elemento concreto dentro del dataset de mosaico. Un elemento de dataset de mosaico tendrá la ruta al dataset de mosaico seguida del ID de objeto del elemento. Por ejemplo, el primer elemento del dataset de mosaico tendrá la siguiente ruta: .\mosaicDataset\objectid=1.	Mosaic Layer; Raster Dataset; Raster Layer
register_mode	Especifica el modo de registro. Puede registrar el ráster con una transformación o restablecer la transformación. REGISTER —Aplica una transformación geométrica al ráster de entrada. REGISTER_MS —Registra la entrada multiespectral con la entrada pancromática. Esto solo se utiliza para datasets de mosaico con una diferencia de alineación entre los dos. RESET —Quita la transformación geométrica que se haya agregado previamente con esta herramienta. CREATE_LINKS —Crea un archivo de vínculos con los vínculos que se han generado automáticamente.	String
reference_raster (Opcional)	El dataset ráster que se alineará con el dataset ráster de entrada. Deje vacío este parámetro si desea registrar los elementos del dataset de mosaico multiespectrales en los datasets ráster pancromáticos asociados.	Image Service; Internet Tiled Layer; Map Server Layer; Map Server; Mosaic Layer; Raster Dataset; Raster Layer; WMS Map
input_link_file (Opcional)	El archivo que tiene las coordenadas con las que se va a vincular el dataset ráster de entrada con la referencia. La tabla de enlaces de entrada trabaja con un elemento de mosaico de la capa de mosaico. La entrada debe especificar qué elemento se está procesando, ya sea seleccionando el elemento o especificando el ObjectID en la entrada. Deje vacío este parámetro si desea registrar los elementos del dataset de mosaico multiespectrales con los datasets ráster pancromáticos asociados.	Feature Class; Text File
transformation_type (Opcional)	Especifica el método para convertir el dataset ráster. POLYORDER0 —Este método utiliza un polinomio de orden cero para convertir los datos. Esto se utiliza generalmente cuando los datos ya están georreferenciados, pero un pequeño cambio alinea mejor los datos. Solo se necesita un vínculo para realizar un cambio con polinomio de orden cero. POLYSIMILARITY —Es la transformación de primer orden que intenta conservar la forma del ráster original. El error RMS tiende a ser superior que el de otras transformaciones polinómicas dado que preservar la forma es más importante que conseguir el mejor ajuste. POLYORDER1 —Un polinomio de primer orden (afín) fija un plano chato en los puntos de entrada. POLYORDER2 —Un polinomio de segundo orden fija una superficie algo más complicada en los puntos de entrada. POLYORDER3 —Un polinomio de tercer orden fija una superficie más complicada en los puntos de entrada. ADJUST —Este método combina una transformación polinómica y utiliza una técnica de interpolación de red irregular de triángulos (TIN) para optimizar la precisión global y local. SPLINE —Este método transforma de manera precisa los puntos de control de origen en puntos de control de destino. En la salida, los puntos de control serán precisos, pero los píxeles de ráster que están entre los puntos de control no lo serán. PROJECTIVE —Este método comba las líneas para que permanezcan rectas. Al hacerlo, es posible que las líneas que una vez fueron paralelas ya no sigan siendo paralelas. La transformación proyectiva es especialmente útil para las imágenes oblicuas, mapas escaneados y para algunos productos de imágenes.	String
output_cpt_link_file (Opcional)	Si se especifica, se escribirá un archivo de texto con los vínculos creados mediante esta herramienta. Este archivo se puede utilizar en la herramienta Combar desde el archivo. La tabla de enlaces de salida trabaja con un elemento de dataset de mosaico de la capa de mosaico. La entrada debe especificar qué elemento se está procesando, ya sea seleccionando el elemento o especificando el ObjectID en la entrada.	Text File
maximum_rms_value (Opcional)	La cantidad de errores modelados (en píxeles) que desea en la salida. El valor predeterminado es 0,5. No se recomiendan valores inferiores a 0,3 porque provocan un exceso de ajuste.	Double

Salida derivada

Nombre	Explicación	Tipo de datos
out_raster	El dataset ráster de salida.	Raster Dataset

Muestra de código

Ejemplo 1 de RegisterRaster (ventana de Python)

Esta es una muestra de Python para la herramienta RegisterRaster.

import arcpy
arcpy.RegisterRaster_management(
     "\\cpu\data\nonref.tif", "REGISTER", "\\cpu\data\yesref.tif",
     "\\cpu\data\links.txt", "POLYORDER1", "#")

Ejemplo 2 de RegisterRaster (script independiente)

Esta es una muestra de script de Python para la herramienta RegisterRaster.

# Register raster using only control points

import arcpy
arcpy.env.workspace = "C:/Workspace"
    
rdname = "irs_ps.img"
mode = "REGISTER"
refrd = ""
linkfile = "C:/Workspace/irs_controls_13.txt"
order = "POLYORDER2"
    
arcpy.RegisterRaster_management(
     rdname, mode, refrd, linkfile, order)

Entornos

• Factor de procesamiento en paralelo

Información de licenciamiento

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