Generar huellas (Administración de datos)

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ámetroExplicaciónTipo 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.
  • NONENo 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_EDGESQuita los bordes de la hoja de todas las huellas. Esta es la opción predeterminada.
  • MAINTAIN_EDGESMantiene las huellas en su estado original.
Boolean
skip_derived_images
(Opcional)

Ajusta las huellas de las vistas generales.

  • SKIP_DERIVED_IMAGESNo ajusta las huellas de las vistas generales. Esta es la opción predeterminada.
  • NO_SKIP_DERIVED_IMAGESAjusta 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_BOUNDARYActualiza el límite. Esta es la opción predeterminada.
  • NO_BOUNDARYNo 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.

  • NONENo limitar el número de vértices. Esta es la opción predeterminada.
  • CONVEX_HULLUtilizar la caja de límite mínima para simplificar la huella.
  • ENVELOPEUtilizar 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)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

NombreExplicaciónTipo 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)

Información de licenciamiento

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

Temas relacionados