Generar huellas (Administración de datos)

Resumen

Calcula las huellas de cada dataset ráster de un dataset de mosaico.

Uso

• Si hay una selección, solo se recalculan 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 van de 4 a 10.000. Puede establecer su 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.

• Esta herramienta no admite la configuración del entorno.

Sintaxis

BuildFootprints_management (in_mosaic_dataset, {where_clause}, {min_data_value}, {max_data_value}, {approx_num_vertices}, {shrink_distance}, {maintain_edges}, {reset_footprint}, {skip_derived_images}, {update_boundary}, {request_size}, {min_region_size})

Parámetro	Explicación	Tipo de datos
in_mosaic_dataset	Dataset de mosaico para el que se calcularán las huellas.	Mosaic Layer
where_clause (Opcional)	Con SQL, puede definir una consulta o utilizar el Generador de consultas para crear una.	SQL Expression
min_data_value (Opcional)	Valor de píxel más bajo que representa datos de imagen válidos. La profundidad de bit del dataset ráster determina este valor. Por ejemplo, con datos de 8 bits, los valores pueden ir de 0 a 255. Un valor alrededor de 0 representa colores muy oscuros, como píxeles de borde negro. Al especificar 1, el único valor menor que 1 es 0, de modo que todos los valores 0 se considerarán datos no válidos y se quitarán del perímetro de la huella. Si las imágenes se comprimen mediante un método de compresión con pérdida de información, debería definir un valor ligeramente mayor que 1 para quitar todos los píxeles negros. Si se han quitado por error áreas oscuras, como sombras, de la huella, se debería reducir este valor.	Double
max_data_value (Opcional)	Valor máximo que representa datos válidos. La profundidad de bit del dataset ráster determina este valor. Por ejemplo, con datos de 8 bits, los valores pueden ir de 0 a 255. Un valor alrededor de 255 representa colores muy brillantes, como nubes blancas y nieve. Si especifica 245, todos los valores entre 246 y 255 se quitarán del perímetro de la huella.	Double
approx_num_vertices (Opcional)	Número aproximado de vértices con los que se creará el nuevo polígono de huella. El valor mínimo es 4 y el máximo es 10.000. Cuanto mayor sea este valor, más preciso e irregular será el polígono y mayor será el tiempo de procesamiento. Puede optar por especificar un valor de -1, que no generalizará su huella de polígono.	Long
shrink_distance (Opcional)	Valor de distancia especificado en las unidades del sistema de coordenadas del dataset de mosaico por el que se reducirá el tamaño del polígono general. 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 unidos por los extremos (o alineados a lo largo de los bordes con una ligera o ninguna superposición). NO_MAINTAIN_EDGES —Se modificarán todas las huellas, independientemente de sus huellas vecinas. Este es el valor predeterminado. MAINTAIN_EDGES —Se realiza un análisis de los ejes de la imagen para que no se quiten los ejes de hoja.	Boolean
reset_footprint (Opcional)	Las huellas se redefinirán mediante los parámetros originales empleados para generarlas cuando se agregaron los rásteres. NO_RESET_FOOTPRINT —Las huellas no se devolverán a su geometría original. Este es el valor predeterminado. RESET_FOOTPRINT —Las huellas se devolverán a su geometría original.	Boolean
skip_derived_images (Opcional)	Ajusta las huellas de las imágenes derivadas, como las vistas generales de servicio. SKIP_DERIVED_IMAGES —No se ajustarán las imágenes derivadas, como las vistas generales de servicio. Este es el valor predeterminado. NO_SKIP_DERIVED_IMAGES —Se ajustarán las huellas de cualquier imagen derivada junto con las imágenes base.	Boolean
update_boundary (Opcional)	Genera o actualiza el polígono de límite de un dataset de mosaico. De forma predeterminada, el límite fusiona todos los polígonos de huella para crear un límite único que representa la extensión de los píxeles válidos. UPDATE_BOUNDARY —Se generará o actualizará el límite. Este es el valor predeterminado. NO_BOUNDARY —No se generará ni actualizará el límite.	Boolean
request_size (Opcional)	Tamaño al que se volverá a muestrear el ráster cuando se examine mediante este proceso. El valor (como 2.000) define la dimensión de filas y columnas. El valor mínimo es 0 y el máximo es 5.000. Puede aumentar o disminuir este valor en función de la complejidad de sus datos ráster. Una mayor resolución de imagen proporciona más detalle en el dataset ráster y por tanto aumenta el tiempo de procesamiento. Si el tamaño especificado es mayor que el ráster incluido en las huellas, se sobremuestreará.	Long
min_region_size (Opcional)	Determina un filtro utilizado para quitar agujeros creados en la huella. Este valor se especifica en píxeles y se relaciona directamente con el Tamaño de solicitud, no con la resolución de píxel del ráster de origen.	Long

Ejemplo de código

Ejemplo de BuildFootprints (ventana Python)

Éste es un ejemplo de Python de BuildFootprints.

import arcpy
arcpy.BuildFootprints_management("c:/workspace/fGDB.gdb/md_1", "#",\
                                 "NO_RESET_FOOTPRINT", "1", "254", "25", "0",\
                                 "#", "SKIP_DERIVED_IMAGES", "BUILD_BOUNDARY",\
                                 "#", "#")

Ejemplo 2 de BuildFootPrints (ventana independiente)

Éste es un ejemplo de secuencia de comandos de Python de BuildFootprints.

#===========================
#Build Footprints
#Usage: BuildFootprints_management in_mosaic_dataset {where_clause} {NO_RESET_FOOTPRINT
#                                  | RESET_FOOTPRINT} {min_data_value} {max_data_value}
#                                  {approx_num_vertices} {shrink_distance} 
#                                  {NO_MAINTAIN_EDGES | MAINTAIN_EDGES} {SKIP_DERIVED_IMAGES
#                                  | NO_SKIP_DERIVED_IMAGES} {UPDATE_BOUNDARY | 
#                                  NO_BOUNDARY} {request_size} {min_region_size}

try:
    import arcpy
    arcpy.env.workspace = r"C:\Workspace"
    # 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
    arcpy.BuildFootprints_management("Footprints.gdb/md", "#", "NO_RESET_FOOTPRINT",\
                                     "1", "254", "25", "0", "#", "SKIP_DERIVED_IMAGES",\
                                     "UPDATE_BOUNDARY", "#", "#")
    
    # Reset the footprint to default
    arcpy.BuildFootprints_management("Footprints.gdb/md", "#", "RESET_FOOTPRINT",\
                                     "#", "#", "#", "#", "#", "#", "UPDATE_BOUNDARY",\
                                     "#", "#")
    
    
    # Shrink distance while maintaining sheet edge
    # Define request size for resampling
    # Define the minimum region size
    arcpy.BuildFootprints_management("Footprints.gdb/md16b", "#", "NO_RESET_FOOTPRINT",\
                                     "1", "65534", "25", "5", "MAINTAIN_EDGES",\
                                     "#", "UPDATE_BOUNDARY", "2000", "10")
    
except:
    print "Build Footprints example failed."
    print arcpy.GetMessages()

Entornos

Extensión