Generar huellas (Administración de datos)—ArcGIS Pro

Resumen

Calcula la extensión de todos los rásteres en un dataset de mosaico. Esta herramienta se utiliza cuando ha agregado o quitado datasets ráster de un dataset de mosaico y desea volver a calcular las huellas.

Uso

Si existe alguna selección en la capa del dataset de mosaico, solo se volverán a calcular esas huellas seleccionadas.
La huella se utiliza para calcular el límite. Si modifica la forma de las huellas a lo largo del perímetro del dataset de mosaico, tendrá que recalcular el límite. Si decide no utilizar esta herramienta, podrá hacerlo más tarde mediante la herramienta Crear límite.
No puede regenerar huellas para un dataset de mosaico al que se hace referencia.
El parámetro Cantidad aproximada de vértices se utiliza para definir la complejidad de las huellas. Cuanto mayor sea el número de vértices, más precisa e irregular será la huella. Los valores válidos varían de 4 a 10.000. Puede establecer el valor en -1, de modo que no se produzca ninguna generalización, pero esto puede significar que su huella tendrá un número muy grande de vértices.
Para quitar orificios y falsos de la huella, se utilizan Tamaño mínimo de región, Relación de grosor mínima y Tamaño máximo de falso.
La fragmentación de la base de datos y la manipulación de datos frecuentes puede aumentar enormemente el tamaño del dataset de mosaico. Si el tamaño de la base de datos se incrementa debido a la realización constante de transacciones, ejecute la herramienta Compactar.

Parámetros

Etiqueta	Explicación	Tipo de datos
Dataset de mosaico	El dataset de mosaico que contiene los datasets ráster cuyas huellas desea calcular.	Mosaic Layer
Definición de consulta (Opcional)	Expresión SQL para seleccionar datasets ráster específicos en el dataset de mosaico.	SQL Expression
Método de cálculo (Opcional)	Delimite las huellas utilizando uno de los siguientes métodos: Radiometría— Excluye los píxeles cuyo valor queda fuera de un rango definido. Esta opción normalmente se utiliza para excluir áreas del borde que no contienen datos válidos. Esta es la opción predeterminada. Geometría— Restaura la geometría original de la huella. Copiar en hermano— Reemplaza la huella pancromática por la huella multiespectral al utilizar un tipo de ráster con fusión de imágenes. Esto puede ocurrir cuando las imágenes pancromáticas y multiespectrales no tienen geometrías idénticas. Ninguna—No redefina las huellas.	Boolean; String
Valor mínimo de datos (Opcional)	Excluye los píxeles cuyo valor es inferior a este número.	Double
Valor máximo de datos (Opcional)	Excluye los píxeles cuyo valor es superior a este número.	Double
Cantidad aproximada de vértices (Opcional)	Elija entre 4 y 10.000. Una cantidad superior de vértices mejorará la precisión, pero puede aumentar el tiempo de procesamiento. Un valor de -1 calculará todos los vértices. Una cantidad superior de vértices aumentará la precisión, pero también el tiempo de procesamiento.	Long
Reducir distancia (Opcional)	Sujeta la huella según esta distancia. Se puede evitar la utilización de la compresión con pérdida de información en los elementos, que hace que los bordes de la imagen se superpongan en áreas NoData. La reducción del polígono se utiliza para contrarrestar los efectos de la compresión con pérdida de información, que hace que los ejes de la imagen se superpongan en áreas NoData.	Double
Mantener ejes de hoja (Opcional)	Modifica las huellas de datasets ráster que se han creado en teselas y que son adyacentes (o alineados a lo largo de los rebordes con una ligera superposición o sin ella). Desactivado: quita los bordes de la hoja de todas las huellas. Esta es la opción predeterminada. Activado: mantiene el estado original de las huellas.	Boolean
Omitir vistas generales (Opcional)	Ajusta las huellas de las vistas generales. Activado: no ajusta las huellas de las vistas generales. Esta es la opción predeterminada. Desactivado: ajusta las huellas de las vistas generales y de los datasets ráster asociados.	Boolean
Actualizar límite (Opcional)	Actualiza el límite del dataset de mosaico si ha agregado o quitado imágenes que cambian la extensión. Activado: actualiza el límite. Esta es la opción predeterminada. Desactivado: no actualiza el límite.	Boolean
Solicitar tamaño (Opcional)	Define la extensión remuestreada (en columnas y filas) del ráster cuando se crean huellas. Una mayor resolución de imagen proporciona más detalle en el dataset ráster, pero aumenta el tiempo de procesamiento. Un valor de -1 calculará la huella con la resolución original.	Long
Tamaño mínimo de región (Opcional)	Evita pequeños orificios en las imágenes cuando se utilizan valores de píxel para crear una máscara. Por ejemplo, puede que sus imágenes estén en un rango comprendido entre 0 y 255 y, para las máscaras de nubes, ha excluido valores comprendidos entre 245 y 255, lo que puede provocar que también se enmascaren otros píxeles que no son de nube. Si estas áreas son más pequeñas que el número de píxeles especificado aquí, no se enmascararán.	Long
Método de simplificación (Opcional)	Reducir el número de vértices en la huella para mejorar el rendimiento. Ninguna—No limitar el número de vértices. Esta es la opción predeterminada. Envoltura convexa—Utilizar la caja de límite mínima para simplificar la huella. Contorno—Utilizar el sobre de cada elemento del dataset de mosaico para simplificar la huella.	String
Tolerancia de eje (Opcional)	Alinea la huella con el borde de la hoja si está dentro de la tolerancia. Las unidades son las mismas que las del sistema de coordenadas del dataset de mosaico. De manera predeterminada, el valor está vacío y su tolerancia se calcula en función del tamaño de píxel correspondiente al ráster remuestreado solicitado. Un valor de -1 calcula la tolerancia usando el tamaño de píxel promedio del dataset de mosaico.	Double
Tamaño máximo de polígono falso (Opcional)	Identifica todos los polígonos menores que el cuadro de este valor. El valor se especifica en píxeles y está basado en el Tamaño de solicitud, no en la resolución espacial del ráster de origen. Las regiones por debajo del (Tamaño máximo de falso)^2 y de la Relación de grosor mínima se consideran falsas y se quitarán.	Long
Relación de grosor mínima (Opcional)	Define el grosor de los falsos en una escala de 0 a 1,0, donde 1,0 representa un círculo y 0,0 representa un polígono que se acerca a una línea recta. Los polígonos por debajo del Tamaño máximo de falso y de la Relación de grosor mínima se consideran falsos y se quitarán de la huella.	Double

Salida derivada

Etiqueta	Explicación	Tipo de datos
Dataset de mosaico actualizado	El dataset de mosaico actualizado.	Capa de mosaico

arcpy.management.BuildFootprints(in_mosaic_dataset, {where_clause}, {reset_footprint}, {min_data_value}, {max_data_value}, {approx_num_vertices}, {shrink_distance}, {maintain_edges}, {skip_derived_images}, {update_boundary}, {request_size}, {min_region_size}, {simplification_method}, {edge_tolerance}, {max_sliver_size}, {min_thinness_ratio})

Nombre	Explicación	Tipo de datos
in_mosaic_dataset	El dataset de mosaico que contiene los datasets ráster cuyas huellas desea calcular.	Mosaic Layer
where_clause (Opcional)	Expresión SQL para seleccionar datasets ráster específicos en el dataset de mosaico.	SQL Expression
reset_footprint (Opcional)	Delimite las huellas utilizando uno de los siguientes métodos: RADIOMETRY— Excluye los píxeles cuyo valor queda fuera de un rango definido. Esta opción normalmente se utiliza para excluir áreas del borde que no contienen datos válidos. Esta es la opción predeterminada. GEOMETRY— Restaura la geometría original de la huella. COPY_TO_SIBLING— Reemplaza la huella pancromática por la huella multiespectral al utilizar un tipo de ráster con fusión de imágenes. Esto puede ocurrir cuando las imágenes pancromáticas y multiespectrales no tienen geometrías idénticas. NONE—No redefina las huellas.	Boolean; String
min_data_value (Opcional)	Excluye los píxeles cuyo valor es inferior a este número.	Double
max_data_value (Opcional)	Excluye los píxeles cuyo valor es superior a este número.	Double
approx_num_vertices (Opcional)	Elija entre 4 y 10.000. Una cantidad superior de vértices mejorará la precisión, pero puede aumentar el tiempo de procesamiento. Un valor de -1 calculará todos los vértices. Una cantidad superior de vértices aumentará la precisión, pero también el tiempo de procesamiento.	Long
shrink_distance (Opcional)	Sujeta la huella según esta distancia. Se puede evitar la utilización de la compresión con pérdida de información en los elementos, que hace que los bordes de la imagen se superpongan en áreas NoData. La reducción del polígono se utiliza para contrarrestar los efectos de la compresión con pérdida de información, que hace que los ejes de la imagen se superpongan en áreas NoData.	Double
maintain_edges (Opcional)	Emplee este parámetro cuando utilice datasets ráster teselados y que están adyacentes (o alineados a lo largo de los bordes con una ligera o ninguna superposición). NO_MAINTAIN_EDGES—Quita los bordes de la hoja de todas las huellas. Esta es la opción predeterminada. MAINTAIN_EDGES—Mantiene las huellas en su estado original.	Boolean
skip_derived_images (Opcional)	Ajusta las huellas de las vistas generales. SKIP_DERIVED_IMAGES—No ajusta las huellas de las vistas generales. Esta es la opción predeterminada. NO_SKIP_DERIVED_IMAGES—Ajusta las huellas de las vistas generales y de los datasets ráster asociados.	Boolean
update_boundary (Opcional)	Actualiza el límite del dataset de mosaico si ha agregado o quitado imágenes que cambian la extensión. UPDATE_BOUNDARY—Actualiza el límite. Esta es la opción predeterminada. NO_BOUNDARY—No actualiza el límite.	Boolean
request_size (Opcional)	Define la extensión remuestreada (en columnas y filas) del ráster cuando se crean huellas. Una mayor resolución de imagen proporciona más detalle en el dataset ráster, pero aumenta el tiempo de procesamiento. Un valor de -1 calculará la huella con la resolución original.	Long
min_region_size (Opcional)	Evita pequeños orificios en las imágenes cuando se utilizan valores de píxel para crear una máscara. Por ejemplo, puede que sus imágenes estén en un rango comprendido entre 0 y 255 y, para las máscaras de nubes, ha excluido valores comprendidos entre 245 y 255, lo que puede provocar que también se enmascaren otros píxeles que no son de nube. Si estas áreas son más pequeñas que el número de píxeles especificado aquí, no se enmascararán.	Long
simplification_method (Opcional)	Reducir el número de vértices en la huella para mejorar el rendimiento. NONE—No limitar el número de vértices. Esta es la opción predeterminada. CONVEX_HULL—Utilizar la caja de límite mínima para simplificar la huella. ENVELOPE—Utilizar el sobre de cada elemento del dataset de mosaico para simplificar la huella.	String
edge_tolerance (Opcional)	Alinea la huella con el borde de la hoja si está dentro de la tolerancia. Las unidades son las mismas que las del sistema de coordenadas del dataset de mosaico. Se utiliza cuando maintain_edges se define como MAINTAIN_EDGES. De manera predeterminada, el valor está vacío y su tolerancia se calcula en función del tamaño de píxel correspondiente al ráster remuestreado solicitado. Un valor de -1 calcula la tolerancia usando el tamaño de píxel promedio del dataset de mosaico.	Double
max_sliver_size (Opcional)	Identifica todos los polígonos menores que el cuadro de este valor. El valor se especifica en píxeles y está basado en el request_size, no en la resolución espacial del ráster de origen. Las regiones por debajo de (max_sliver_size)² y de min_thinness_ratio se consideran falsas y se quitarán.	Long
min_thinness_ratio (Opcional)	Define el grosor de los falsos en una escala de 0 a 1,0, donde 1,0 representa un círculo y 0,0 representa un polígono que se acerca a una línea recta. Los polígonos por debajo de max_sliver_size y de min_thinness_ratio se consideran falsos y se quitarán de la huella.	Double

Salida derivada

Nombre	Explicación	Tipo de datos
out_mosaic_dataset	El dataset de mosaico actualizado.	Capa de mosaico

Muestra de código

Ejemplo de BuildFootprints (ventana Python)

Esta es una muestra de Python para la herramienta BuildFootprints.

import arcpy
arcpy.BuildFootprints_management(
     "c:/data/Footprints.gdb/md", "#","RADIOMETRY",
     "1", "254", "25", "0", "#", "SKIP_DERIVED_IMAGES", 
     "UPDATE_BOUNDARY", "#", "#", "CONVEX_HULL")

Ejemplo 2 de BuildFootPrints (script independiente)

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

# Build Footprint by setting the valid pixel value range from 1 to 254
# Allow 25 vertices to be used to draw a single footprint polygon
# Skip the overviews image
# Build new boundary afterwards
# Build footprints based on minimum bounding geometry

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

    
mdname = "Footprints.gdb/md"
query = "#"
method = "RADIOMETRY"
minval = "1"
maxval = "254"
nvertice = "25"
shrinkdis = "0"
maintainedge = "#"
skipovr = "SKIP_DERIVED_IMAGES"
updatebnd = "UPDATE_BOUNDARY"
requestsize = "#"
minregsize = "#"
simplify = "#"

arcpy.BuildFootprints_management(
     mdname, query, method, minval, maxval, nvertice, shrinkdis,
     maintainedge, skipovr, updatebnd, requestsize, minregsize, 
     simplify)