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

Synthèse

Calcule l'étendue de chaque raster d'une mosaïque. Cet outil est utile lorsque vous avez ajouté ou supprimé des jeux de données raster d'une mosaïque et souhaitez recalculer les emprises.

Utilisation

Si des emprises sont sélectionnées sur la couche de mosaïque, 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.
Les outils Taille de zone minimale, Ratio de finesse minimum et Taille de micropolygone maximum permettent de supprimer les trous et les micropolygones dans l'emprise.
La fragmentation des bases de données et la manipulation fréquente des données peut augmenter considérablement la taille de votre mosaïque. Si la taille de votre base de données augmente en raison de constantes transactions, exécutez l’outil Compacter.

Paramètres

Étiquette	Explication	Type de données
Mosaïque	Mosaïque qui contient les jeux de données raster dont vous voulez calculer les emprises.	Mosaic Layer
Ensemble de définition (Facultatif)	Expression SQL permettant de sélectionner certains jeux de données raster au sein de la mosaïque.	SQL Expression
Méthode de calcul (Facultatif)	Affinez les emprises à l'aide de l'une des méthodes suivantes : Radiométrie— Excluez les pixels dont la valeur est en dehors d'une plage définie. Cette option permet généralement d'exclure les zones de bordure qui ne contiennent pas de données valides. Il s’agit de l’option par défaut. Géométrie— Restaurez la géométrie d'origine de l'emprise. Copier au même niveau— Remplacez l'emprise panchromatique par l'emprise multispectrale en cas d'utilisation d'un type raster amélioré. Cela peut se produire lorsque les images panchromatiques et multispectrales n'ont pas de géométries identiques. Aucun—Ne redéfinissez pas les emprises.	Boolean; String
Valeur minimale de données (Facultatif)	Excluez les pixels dont la valeur est inférieure à ce nombre.	Double
Valeur maximale de données (Facultatif)	Excluez les pixels dont la valeur est supérieure à ce nombre.	Double
Nombre approximatif de sommets (Facultatif)	Choisissez un nombre compris entre 4 et 10 000. Un plus grand nombre de sommets permet d'améliorer la précision, mais prolonge le temps de traitement. La valeur - 1 calcule tous les sommets. Un plus grand nombre de sommets augmente la précision, mais également le temps de traitement.	Long
Distance de contraction (Facultatif)	Découpez l'emprise selon cette distance. Ceci peut éviter aux artefacts d'utiliser la compression avec perte, qui entraîne la superposition des limites de l'image sur des zones NoData. 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
Conserver les bords des feuilles (Facultatif)	Modifiez les emprises des jeux de données raster tuilés et adjacents (alignés le long des raccords avec superposition réduite ou sans superposition). Désactivé : les bords des feuilles de toutes les emprises sont supprimés. Il s’agit de l’option par défaut. Activé : l'état d'origine des emprises est conservé.	Boolean
Ignorer les aperçus (Facultatif)	Ajustez les emprises des aperçus. Activé : les emprises des aperçus ne sont pas ajustées. Il s’agit de l’option par défaut. Désactivé : les emprises des aperçus et des jeux de données raster associés sont ajustées.	Boolean
Mettre à jour la limite (Facultatif)	Mettez à jour la limite de la mosaïque si vous avez modifié l'étendue en ajoutant ou supprimant des images. Activé : la limite est mise à jour. Il s’agit de l’option par défaut. Désactivé : la limite n'est pas mise à jour.	Boolean
Taille requise (Facultatif)	Définissez l'étendue rééchantillonnée (dans les colonnes et les lignes) du raster lors de la génération des emprises. Une meilleure résolution d'image fournit plus de détails dans le jeu de données raster, mais augmente le temps de traitement. La valeur - 1 calcule l'emprise selon la résolution d'origine.	Long
Taille de zone minimale (Facultatif)	Evitez les petites discontinuités dans votre imagerie lorsque vous utilisez des valeurs de pixel pour créer un masque. Par exemple, votre imagerie peut comprendre une plage de valeurs allant de 0 à 255. Pour masquer les nuages, vous avez exclu les valeurs comprises entre 245 et 255, ce qui peut également entraîner le masquage d'autres pixels qui ne sont pas des nuages. Si ces zones sont inférieures au nombre de pixels indiqué ici, elles ne sont pas masquées.	Long
Méthode de simplification (Facultatif)	Réduisez le nombre de sommets dans l'emprise afin d'optimiser les performances. Aucun—Ne limitez pas le nombre de sommets. Il s’agit de l’option par défaut. Enveloppe convexe—Utilisez le contour minimal pour simplifier l'emprise. Enveloppe—Utilisez l'enveloppe de chaque élément de mosaïque pour simplifier l'emprise.	String
Tolérance de tronçon (Facultatif)	Capturez l'emprise sur le bord de la feuille si elle se trouve dans cette tolérance. Les unités sont les mêmes que celles du système de coordonnées de la mosaïque. 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
Taille de micropolygone maximum (Facultatif)	Identifiez tous les polygones qui sont inférieurs au carré de cette valeur. La valeur est spécifiée en pixels et repose sur la taille requise, et non sur la résolution spatiale du raster source. Les régions inférieures à la (taille de micropolygone maximum)^2 et inférieures au ratio de finesse minimum sont considérées comme des micropolygones et seront supprimées.	Long
Ratio de finesse minimum (Facultatif)	Définissez la finesse des micropolygones sur une échelle allant de 0 à 1.0, où 1.0 représente un cercle et 0.0 représente un polygone qui s'approche d'une ligne droite. Les polygones situés en deçà de la taille de zone minimale et du ratio de finesse minimum sont supprimés de l'emprise.	Double

Sortie obtenue

Étiquette	Explication	Type de données
Mosaïque mise à jour	Jeu de données mosaïque mis à jour.	Couche de mosaïque

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

Nom	Explication	Type de données
in_mosaic_dataset	Mosaïque qui contient les jeux de données raster dont vous voulez calculer les emprises.	Mosaic Layer
where_clause (Facultatif)	Expression SQL permettant de sélectionner certains jeux de données raster au sein de la mosaïque.	SQL Expression
reset_footprint (Facultatif)	Affinez les emprises à l'aide de l'une des méthodes suivantes : RADIOMETRY— Excluez les pixels dont la valeur est en dehors d'une plage définie. Cette option permet généralement d'exclure les zones de bordure qui ne contiennent pas de données valides. Il s’agit de l’option par défaut. GEOMETRY— Restaurez la géométrie d'origine de l'emprise. COPY_TO_SIBLING— Remplacez l'emprise panchromatique par l'emprise multispectrale en cas d'utilisation d'un type raster amélioré. Cela peut se produire lorsque les images panchromatiques et multispectrales n'ont pas de géométries identiques. NONE—Ne redéfinissez pas les emprises.	Boolean; String
min_data_value (Facultatif)	Excluez les pixels dont la valeur est inférieure à ce nombre.	Double
max_data_value (Facultatif)	Excluez les pixels dont la valeur est supérieure à ce nombre.	Double
approx_num_vertices (Facultatif)	Choisissez un nombre compris entre 4 et 10 000. Un plus grand nombre de sommets permet d'améliorer la précision, mais prolonge le temps de traitement. La valeur - 1 calcule tous les sommets. Un plus grand nombre de sommets augmente la précision, mais également le temps de traitement.	Long
shrink_distance (Facultatif)	Découpez l'emprise selon cette distance. Ceci peut éviter aux artefacts d'utiliser la compression avec perte, qui entraîne la superposition des limites de l'image sur des zones NoData. 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 adjacents (alignés le long des raccords avec superposition réduite ou sans superposition). NO_MAINTAIN_EDGES—Les bords des feuilles de toutes les emprises sont supprimés. Il s’agit de l’option par défaut. MAINTAIN_EDGES—L'état d'origine des emprises est conservé.	Boolean
skip_derived_images (Facultatif)	Ajustez les emprises des aperçus. SKIP_DERIVED_IMAGES—Les emprises des aperçus ne sont pas ajustées. Il s’agit de l’option par défaut. NO_SKIP_DERIVED_IMAGES—Les emprises des aperçus et des jeux de données raster associés sont ajustées.	Boolean
update_boundary (Facultatif)	Mettez à jour la limite de la mosaïque si vous avez modifié l'étendue en ajoutant ou supprimant des images. UPDATE_BOUNDARY—La limite est mise à jour. Il s’agit de l’option par défaut. NO_BOUNDARY—La limite n'est pas mise à jour.	Boolean
request_size (Facultatif)	Définissez l'étendue rééchantillonnée (dans les colonnes et les lignes) du raster lors de la génération des emprises. Une meilleure résolution d'image fournit plus de détails dans le jeu de données raster, mais augmente le temps de traitement. La valeur - 1 calcule l'emprise selon la résolution d'origine.	Long
min_region_size (Facultatif)	Evitez les petites discontinuités dans votre imagerie lorsque vous utilisez des valeurs de pixel pour créer un masque. Par exemple, votre imagerie peut comprendre une plage de valeurs allant de 0 à 255. Pour masquer les nuages, vous avez exclu les valeurs comprises entre 245 et 255, ce qui peut également entraîner le masquage d'autres pixels qui ne sont pas des nuages. Si ces zones sont inférieures au nombre de pixels indiqué ici, elles ne sont pas masquées.	Long
simplification_method (Facultatif)	Réduisez le nombre de sommets dans l'emprise afin d'optimiser les performances. NONE—Ne limitez pas le nombre de sommets. Il s’agit de l’option par défaut. CONVEX_HULL—Utilisez le contour minimal pour simplifier l'emprise. ENVELOPE—Utilisez l'enveloppe de chaque élément de mosaïque pour simplifier l'emprise.	String
edge_tolerance (Facultatif)	Capturez l'emprise sur le bord de la feuille si elle se trouve dans cette tolérance. Les unités sont les mêmes que celles du système de coordonnées de la mosaïque. 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)	Identifiez tous les polygones qui sont inférieurs au carré de cette valeur. La valeur est spécifiée en pixels et repose sur la request_size, et non sur la résolution spatiale du raster source. Les régions inférieures à (max_sliver_size)² et inférieures à min_thinness_ratio sont considérées comme des micropolygones et seront supprimées.	Long
min_thinness_ratio (Facultatif)	Définissez la finesse des micropolygones sur une échelle allant de 0 à 1.0, où 1.0 représente un cercle et 0.0 représente un polygone qui s'approche d'une ligne droite. Les polygones situés en deçà de max_sliver_size et de min_thinness_ratio sont supprimés de l'emprise.	Double

Sortie obtenue

Nom	Explication	Type de données
out_mosaic_dataset	Jeu de données mosaïque mis à jour.	Couche de mosaïque

Exemple de code

BuildFootprints, exemple (fenêtre Python)

Il s’agit d'un exemple Python d'utilisation de 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")

Exemple 2 d'utilisation de l'outil BuildFootPrints (script autonome)

Il s’agit d'un exemple de script Python d'utilisation de 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)