Generar huellas (Gestión de datos)

Nivel de licencia:BasicStandardAdvanced

Resumen

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

Uso

Sintaxis

BuildFootprints_management (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

Dataset de mosaico para el que se calcularán las huellas.

Image Service; Mosaic Layer; String
where_clause
(Opcional)

Puede definir una consulta con SQL o crearla con el Constructor de consultas.

SQL Expression
reset_footprint
(Opcional)

Elija qué método usar al redefinir las huellas.

  • RADIOMETRYRedefine la forma de la huella según un rango de valores de píxel. Esta opción generalmente se utiliza para redefinir las huellas de forma que excluyan las áreas del marco, las cuales no definen datos válidos. Esta es la opción predeterminada.
  • GEOMETRYRedefine la forma de la huella de vuelta a su geometría original.
  • COPY_TO_SIBLINGAl usar el tipo de ráster de refinado pancromático, la huella del elemento pancromático se reemplaza con la huella del elemento multiespectral. Esto ocurre con algunos tipos de ráster cuando las imágenes pancromática y multiespectral no tienen geometrías idénticas.
  • NONENo se redefinirán las huellas.

Boolean; String
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.

Un valor de -1 mostrará todos los vértices de la huella, por tanto la huella del polígono no se generalizará.

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_EDGESSe modificarán todas las huellas, independientemente de sus huellas vecinas. Esta es la opción predeterminada.
  • MAINTAIN_EDGESSe realiza un análisis de los ejes de la imagen para que no se quiten los ejes de hoja.
Boolean
skip_derived_images
(Opcional)

Ajusta las huellas de las imágenes derivadas, como las vistas generales de servicio.

  • SKIP_DERIVED_IMAGESNo se ajustarán las imágenes derivadas, como las vistas generales de servicio. Esta es la opción predeterminada.
  • NO_SKIP_DERIVED_IMAGESSe 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. Por defecto, el límite fusiona todos los polígonos de huella para crear un único límite que representa la extensión de los píxeles válidos.

  • UPDATE_BOUNDARYSe generará o se actualizará el límite. Esta es la opción predeterminada.
  • NO_BOUNDARYNo se generará ni se actualizará el límite.
Boolean
request_size
(Opcional)

El tamaño al que se volverá a muestrear el ráster cuando se examine mediante esta herramienta. El valor (como 2.000) define la dimensión usando filas y columnas.

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.

Un valor de -1 no volverá a muestrear la huella; por lo tanto, la huella se calculará en el tamaño de píxel de origen.

El tamaño de solicitud no puede ser mayor que el ráster incluido en las huellas. Si este es el caso, entonces el valor será automáticamente el mismo que el tamaño del ráster.

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
simplification_method
(Opcional)

La simplificación reducirá el número de vértices, debido que las huellas densas pueden afectar el rendimiento de visualización.

Elija qué método usar para simplificar las huellas.

  • NONENo se implementará ningún método de simplificación. Esta es la opción predeterminada.
  • CONVEX_HULLSe usará la geometría de delimitación mínima para cada huella para simplificarla.
  • ENVELOPEEl sobre de cada elemento del dataset de mosaico proporcionará la huella simplificada.
String
edge_tolerance
(Opcional)

El valor de tolerancia se especifica en las unidades del sistema de coordenadas del dataset de mosaico y es el valor por debajo del cual la huella se alinea con el borde de la hoja. 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)

Determina un filtro utilizado para identificar falsos en la huella.

Los polígonos por debajo de max_sliver_size se consideran falsos. 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
min_thinness_ratio
(Opcional)

Determina un filtro utilizado para eliminar falsos de la huella.

Los polígonos por debajo de max_sliver_size y min_thinness_ratio se consideran falsos y se eliminarán de la huella.

Double

Ejemplo de código

Ejemplo de BuildFootprints (ventana Python)

Éste es un ejemplo de la herramienta de Python de 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 (ventana independiente)

Éste es un ejemplo de secuencia de comandos de Python de 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)

Entornos

Temas relacionados

Información sobre licencias

ArcGIS for Desktop Basic: No
ArcGIS for Desktop Standard: Sí
ArcGIS for Desktop Advanced: Sí
5/12/2014