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.
Sintaxis
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})| Parámetro | 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:
| 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).
| Boolean |
skip_derived_images (Opcional) | Ajusta las huellas de las vistas generales.
| Boolean |
update_boundary (Opcional) | Actualiza el límite del dataset de mosaico si ha agregado o quitado imágenes que cambian la extensión.
| 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.
| 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)2 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
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")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)Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí