Footprints erstellen (Data Management)

Lizenzstufe:BasicStandardAdvanced

Zusammenfassung

Berechnet die Footprints für jedes Raster-Dataset in einem Mosaik-Dataset.

Verwendung

Syntax

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})
ParameterErläuterungDatentyp
in_mosaic_dataset

Das Mosaik-Dataset, für das die Footprints berechnet werden.

Mosaic Layer
where_clause
(optional)

Mit SQL können Sie eine Abfrage definieren oder den Abfrage-Generator verwenden, um eine Abfrage zu erstellen.

SQL Expression
reset_footprint
(optional)

Wählen Sie die Methode aus, die bei Neudefinition der Footprints verwendet werden soll.

  • RADIOMETRYBerechnet das Shape eines Footprints auf Grundlage eines Pixelwertbereichs neu. Diese Option wird allgemein verwendet, um Footprints neu zu definieren, sodass sie Rahmenflächen ausschließen, die keine gültigen Daten definieren. Dies ist die Standardeinstellung.
  • GEOMETRYBerechnet das Shape des Footprints zurück zu seiner ursprünglichen Geometrie.
  • COPY_FROM_SIBLINGWenn ein Pan-Sharpened-Raster-Typ verwendet wird, wird der Footprint des panchromatischen Elements durch den Footprint des multispektralen Elements ersetzt. Dies tritt bei einigen Raster-Typen auf, wenn die panchromatischen und multispektralen Bilder keine identischen Geometrien haben.
  • NONEDie Footprints werden nicht neu definiert.

Boolean; String
min_data_value
(optional)

Der niedrigste Pixelwert, der gültige Bilddaten darstellt. Dieser Wert wird von der Bittiefe des Raster-Datasets bestimmt.

Bei 8-Bit-Daten können die Werte z. B. zwischen 0 und 255 liegen. Ein Wert um 0 stellt sehr dunkle Farben dar (beispielsweise schwarze Rahmenpixel). Wenn Sie 1 angeben, ist 0 der einzige Wert kleiner als 1. Daher werden alle 0-Werte als ungültige Daten angesehen und aus dem Umfang des Footprints entfernt. Wenn die Bilder mit einer verlustbehafteten Komprimierungsmethode komprimiert werden, sollten Sie einen Wert größer als 1 definieren, um alle schwarzen Pixel zu entfernen. Legen Sie einen geringeren als den festgelegten Wert fest, wenn dunkle Flächen (z. B. Schatten) falsch aus dem Footprint entfernt wurden.

Double
max_data_value
(optional)

Höchster Wert, der gültige Daten darstellt. Dieser Wert wird von der Bittiefe des Raster-Datasets bestimmt.

Bei 8-Bit-Daten können die Werte z. B. zwischen 0 und 255 liegen. Ein Wert um 255 stellt sehr helle Farben dar (beispielsweise weiße Wolken und Schnee). Wenn Sie 245 angeben, werden alle Werte zwischen 246 und 255 aus dem Umfang des Footprints entfernt.

Double
approx_num_vertices
(optional)

Ungefähre Anzahl von Stützpunkten, mit der das neue Footprint-Polygon erstellt wird.

Der Mindestwert ist 4. Der Höchstwert ist 10.000. Je größer dieser Wert, desto genauer und unregelmäßiger das Polygon und umso länger die Verarbeitungszeit.

Bei einem Wert von -1 werden alle Stützpunkte im Footprint gezeigt. Daher wird der Polygon-Footprint nicht generalisiert.

Long
shrink_distance
(optional)

Entfernungswert, der in den Einheiten des Koordinatensystems für das Mosaik-Dataset angegeben wurde, und durch den die Größe des gesamten Polygons reduziert wird.

Polygone werden verkleinert, um einer verlustbehafteten Komprimierung entgegenzuwirken, durch die die Kanten des Bildes in NoData-Flächen überlappen.

Double
maintain_edges
(optional)

Verwenden Sie diesen Parameter bei Raster-Datasets, die gekachelt wurden und an ihren Stümpfen verbunden sind (oder mit geringer bzw. keiner Überlappung entlang der Grenzen aufgereiht sind).

  • NO_MAINTAIN_EDGESAlle Footprints werden unabhängig von ihren benachbarten Footprints geändert. Dies ist die Standardeinstellung.
  • MAINTAIN_EDGESEine Analyse der Bildkanten wird ausgeführt, damit die Blattkanten nicht entfernt werden.
Boolean
skip_derived_images
(optional)

Passen Sie die Footprints für abgeleitete Bilder, z. B. Service-Übersichten, an.

  • SKIP_DERIVED_IMAGESAbgeleitete Bilder, z. B. Service-Übersichten, werden nicht angepasst. Dies ist die Standardeinstellung.
  • NO_SKIP_DERIVED_IMAGESFootprints von abgeleiteten Bildern werden mit den Basisbildern angepasst.
Boolean
update_boundary
(optional)

Generiert oder aktualisiert das Grenzpolygon eines Mosaik-Datasets. Standardmäßig führt die Grenze alle Footprint-Polygone zusammen, um eine einzelne Grenze zu erstellen, die die Ausdehnung der gültigen Pixel darstellt.

  • UPDATE_BOUNDARYDie Grenze wird generiert oder aktualisiert. Dies ist die Standardeinstellung.
  • NO_BOUNDARYDie Grenze wird nicht generiert oder aktualisiert.
Boolean
request_size
(optional)

Die Größe, auf die das Raster mit Resampling gebracht wird, wenn es mit diesem Werkzeug untersucht wird. Der Wert (z. B. 2000) definiert die Dimension anhand von Zeilen und Spalten.

Sie können diesen Wert auf Grundlage der Komplexität Ihrer Raster-Daten erhöhen oder reduzieren. Eine größere Bildauflösung liefert mehr Details im Raster-Dataset, wodurch die Verarbeitungszeit verlängert wird.

Bei einem Wert von -1 wird kein Resampling für den Footprint durchgeführt. Daher wird der Footprint mit der nativen Pixelgröße berechnet.

Die Anforderungsgröße darf nicht größer als das in den Footprints enthaltene Raster sein. Ist dies der Fall, dann ist der Wert automatisch der gleiche wie die Rastergröße.

Long
min_region_size
(optional)

Bestimmt einen Filter, der verwendet wird, um im Footprint erstellte Löcher zu entfernen.

Dieser Wert wird in Pixel angegeben und bezieht sich direkt auf die Anforderungsgröße und nicht auf die Pixelauflösung des Quell-Rasters.

Long
simplification_method
(optional)

Die Vereinfachung reduziert die Anzahl der Stützpunkte, da dichte Footprints die Darstellungs-Performance beeinträchtigen können.

Wählen Sie die Methode aus, die zur Vereinfachung der Footprints verwendet werden soll.

  • NONEKeine Vereinfachungsmethode wird implementiert. Dies ist die Standardeinstellung.
  • CONVEX_HULLDie minimale Begrenzungsgeometrie für jeden Footprint wird verwendet, um den Footprint zu vereinfachen.
  • ENVELOPEDer Envelope jedes Mosaik-Dataset-Elements stellt den vereinfachten Footprint bereit.
String
edge_tolerance
(optional)

Der Toleranzwert wird in den Einheiten des Koordinatensystems für das Mosaik-Dataset angegeben, unter dem das Footprint an der Blattkante gefangen wird. Diese Vorgehensweise wird verwendet, wenn maintain_edges auf "MAINTAIN_EDGES" eingestellt ist.

Der Wert, für den die Toleranz auf Grundlage der Pixelgröße entsprechend des Rasters berechnet wird, für das ein Resampling durchgeführt wurde, ist standardmäßig leer.

Bei einem Wert von -1 wird die Toleranz anhand der durchschnittlichen Pixelgröße des Mosaik-Datasets berechnet.

Double

Codebeispiel

BuildFootprints – Beispiel 1 (Python-Fenster)

Dies ist ein Python-Beispiel für das Werkzeug "BuildFootprints".

import arcpy
arcpy.BuildFootprints_management(
     "c:/data/Footprints.gdb/md", "#","RADIOMETRY",
     "1", "254", "25", "0", "#", "SKIP_DERIVED_IMAGES", 
     "UPDATE_BOUNDARY", "#", "#", "CONVEX_HULL")
BuildFootprints – Beispiel 2 (eigenständiges Fenster)

Dies ist ein Python-Skriptbeispiel für das Werkzeug "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)

Umgebung

Verwandte Themen

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Nein
ArcGIS for Desktop Standard: Ja
ArcGIS for Desktop Advanced: Ja
9/11/2013