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

Récapitulatif

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

Utilisation

• Si des emprises sont sélectionnées, seules celles-ci seront recalculées.

• L'emprise permet de calculer la limite. Si vous modifiez la forme des emprises le long du périmètre de la mosaïque, vous devez recalculer la limite. Si vous n'utilisez pas cet outil, vous pouvez le faire ultérieurement à l'aide de l'outil Générer la limite.

• Il n'est pas possible de récréer les emprises d'une mosaïque référencée.

• Le paramètre Nombre approximatif de sommets permet de définir la complexité des emprises. Plus le nombre de sommets est élevé, plus l'emprise est précise et irrégulière. Les valeurs correctes sont comprises entre 4 et 10,000. Vous pouvez définir la valeur sur -1 pour qu'aucune généralisation n'intervienne mais cela peut conduire à la multiplication des sommets de l'emprise.

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})

Paramètre	Explication	Type de données
in_mosaic_dataset	Mosaïque pour laquelle les emprises seront calculées.	Mosaic Layer
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. RADIOMETRY —Redé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. GEOMETRY —Redéfinit la forme de l'emprise à sa géométrie originale. COPY_FROM_SIBLING —Lors 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. NONE —Les 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_EDGES —Toutes les emprises sont modifiées, indépendamment des emprises avoisinantes. Il s'agit de l'option par défaut. MAINTAIN_EDGES —Une 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_IMAGES —Les 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_IMAGES —Les 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_BOUNDARY —La limite est générée ou mise à jour. Il s'agit de l'option par défaut. NO_BOUNDARY —La 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. Ainsi, elle est 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. NONE —Aucune méthode de simplification ne sera implémentée. Il s'agit de l'option par défaut. CONVEX_HULL —La géométrie d'emprise minimale pour chaque emprise permettra de simplifier l'emprise. ENVELOPE —L'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

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

Etendue, Facteur de traitement parallèle