Générer les emprises (Gestion des données)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Calcule les emprises pour chaque jeu de données raster dans une mosaïque.

Utilisation

Syntaxe

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})
ParamètreExplicationType de données
in_mosaic_dataset

Mosaïque pour laquelle les emprises seront calculées.

Image Service; Mosaic Layer; String
where_clause
(Facultatif)

A l'aide du SQL, vous pouvez définir une requête ou utiliser le Générateur de requêtes pour créer une requête.

SQL Expression
reset_footprint
(Facultatif)

Choisissez la méthode à utiliser lors de la redéfinition des emprises.

  • RADIOMETRYRedéfinit la forme de l'emprise en fonction d'une plage de valeurs des pixels. Cette option permet généralement de redéfinir les emprises afin qu'elles excluent les zones de bordure ne définissant pas de données valides. Il s'agit de l'option par défaut.
  • GEOMETRYRedéfinit la forme de l'emprise à sa géométrie originale.
  • COPY_TO_SIBLINGLors de l'utilisation d'un type raster amélioré, l'emprise de l'élément panchromatique sera remplacée par l'emprise de l'élément multispectral. Ce phénomène se produit avec certains types raster lorsque les images panchromatiques et multispectrales n'ont pas de géométries identiques.
  • NONELes emprises ne seront pas redéfinies.

Boolean; String
min_data_value
(Facultatif)

Valeur minimale de pixel représentant des données d'image valides. Cette valeur est déterminée par la profondeur de couleur du jeu de données raster.

Par exemple, avec des données 8 bits, les valeurs peuvent varier de 0 à 255. Une valeur autour de 0 correspond à des couleurs très sombres, comme des pixels de bordure noirs. Lorsque vous spécifiez 1, la seule valeur inférieure étant alors 0, toutes les valeurs 0 sont considérées comme données non valides et sont supprimées du périmètre de l'emprise. Si l'imagerie est compressée à l'aide d'une méthode de compression avec perte, il faut alors définir une valeur légèrement plus grande que 1 pour supprimer tous les pixels noirs. Lorsque des zones sombres, telles que des ombres, n'ont pas été correctement supprimées de l'emprise, cette valeur doit être réduite.

Double
max_data_value
(Facultatif)

Valeur maximale représentant des données valides. Cette valeur est déterminée par la profondeur de couleur du jeu de données raster.

Par exemple, avec des données 8 bits, les valeurs peuvent varier de 0 à 255. Une valeur proche de 255 représente des couleurs très claires, celles de nuages blancs ou de la neige, par exemple. Si vous spécifiez 245, toutes les valeurs entre 246 et 255 seront supprimées du périmètre de l'emprise.

Double
approx_num_vertices
(Facultatif)

Nombre approximatif de sommets nécessaires pour créer un nouveau polygone d'emprise.

La valeur minimale est 4 et la valeur maximale 10 000. Plus cette valeur est importante, plus le polygone est irrégulier et précis et plus le temps de traitement est long.

Une valeur équivalente à -1 indique tous les sommets de l'emprise. Votre polygone d'emprise n'est donc pas généralisé.

Long
shrink_distance
(Facultatif)

Valeur de distance spécifiée dans les unités du système de coordonnées de la mosaïque par laquelle la taille du polygone entier sera réduite.

La réduction du polygone permet de compenser les effets de la compression avec perte entraînant la superposition des limites de l'image sur des zones NoData.

Double
maintain_edges
(Facultatif)

Utilisez ce paramètre lorsque vous travaillez avec des jeux de données raster tuilés et assemblés côte à côte (ou alignés le long des raccords avec superposition réduite ou sans superposition).

  • NO_MAINTAIN_EDGESToutes les emprises sont modifiées, indépendamment des emprises avoisinantes. Il s'agit de l'option par défaut.
  • MAINTAIN_EDGESUne analyse des limites de l'image est exécutée afin que les limites de feuille ne soient pas supprimés.
Boolean
skip_derived_images
(Facultatif)

Ajuste les emprises pour les images dérivées, telles que les vues d'ensemble de service.

  • SKIP_DERIVED_IMAGESLes images dérivées, comme les vues d'ensemble de service, ne sont pas ajustées. Il s'agit de l'option par défaut.
  • NO_SKIP_DERIVED_IMAGESLes emprises des images dérivées sont ajustées en même temps que les images de base.
Boolean
update_boundary
(Facultatif)

Génère ou met à jour le polygone d'emprise d'une mosaïque. Par défaut, la limite fusionne tous les polygones d'emprise pour créer une limite unique qui représente l'étendue des pixels valides.

  • UPDATE_BOUNDARYLa limite est générée ou mise à jour. Il s'agit de l'option par défaut.
  • NO_BOUNDARYLa limite n'est pas générée ou mise à jour.
Boolean
request_size
(Facultatif)

Taille à laquelle le raster est ré-échantillonné lorsqu'il est examiné à l'aide de cet outil. La valeur (2 000, par exemple) définit la dimension à l'aide de lignes et de colonnes.

Vous pouvez augmenter ou diminuer cette valeur en fonction de la complexité des données raster. Une meilleure résolution d'image fournit plus de détail dans le jeu de données raster et augmente donc le temps de traitement.

Une valeur équivalente à -1 ne permet pas de ré-échantillonner l'emprise ; elle est par conséquent calculée à la taille des pixels d'origine.

La taille demandée ne peut pas être supérieure à celle du raster contenu dans les emprises. Si c'est le cas, la valeur est automatiquement identique à celle de la taille du raster.

Long
min_region_size
(Facultatif)

Détermine un filtre de suppression des trous créés dans l'emprise.

Cette valeur est spécifiée dans les pixels et est directement liée à la taille de la demande, pas à la résolution en pixels du raster source.

Long
simplification_method
(Facultatif)

La simplification réduira le nombre de sommets, puisque les emprises denses peuvent affecter la performance d'affichage.

Choisissez la méthode de simplification à utiliser pour simplifier l'emprise.

  • NONEAucune méthode de simplification ne sera implémentée. Il s'agit de l'option par défaut.
  • CONVEX_HULLLa géométrie d'emprise minimale pour chaque emprise permettra de simplifier l'emprise.
  • ENVELOPEL'enveloppe de chaque élément de mosaïque fournira l'emprise simplifiée.
String
edge_tolerance
(Facultatif)

La valeur de tolérance est spécifiée dans les unités du système de coordonnées de la mosaïque ci-dessous, que l'emprise va accrocher au bord de la feuille. Ce paramètre est utilisé lorsque le paramètre maintain_edges est défini sur MAINTAIN_EDGES.

Par défaut, la valeur est vide pour laquelle la tolérance est calculée en fonction de la taille de pixel correspondant au raster rééchantillonné demandé.

La valeur -1 calculera la tolérance à l'aide de la taille de pixel moyenne de la mosaïque.

Double
max_sliver_size
(Facultatif)

Détermine un filtre permettant d'identifier des micropolygones dans l'emprise.

Les polygones situés en-deçà de la max_sliver_size sont considérés comme des polygones. Cette valeur est spécifiée dans les pixels et est directement liée à la taille de la demande, pas à la résolution en pixels du raster source.

Long
min_thinness_ratio
(Facultatif)

Détermine un filtre permettant de supprimer des micropolygones dans l'emprise.

Les polygones situés en-deçà de max_sliver_size et de min_thinness_ratio sont considérés comme des micropolygones et sont supprimés de l'emprise.

Double

Exemple de code

BuildFootprints, exemple (fenêtre Python)

Exemple en Python pour l'outil BuildFootprints.

import arcpy
arcpy.BuildFootprints_management(
     "c:/data/Footprints.gdb/md", "#","RADIOMETRY",
     "1", "254", "25", "0", "#", "SKIP_DERIVED_IMAGES", 
     "UPDATE_BOUNDARY", "#", "#", "CONVEX_HULL")
BuildFootPrints, exemple 2 (fenêtre autonome)

Exemple de script en Python pour l'outil 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)

Environnements

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Annuler
ArcGIS for Desktop Standard: Oui
ArcGIS for Desktop Advanced: Oui
6/5/2014