Générer les emprises (Outils de gestion des données)

Résumé

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

Utilisation

Si une sélection a été effectuée sur la couche du jeu de données mosaïque, seules les emprises sélectionnées sont recalculées.
L’emprise est utilisée pour calculer la limite. Si vous modifiez la forme des emprises le long du périmètre du jeu de données mosaïque, vous devez recalculer la limite. Si vous choisissez de ne pas utiliser cet outil, vous pourrez le faire plus tard en utilisant l’outil Générer la limite.
Vous ne pouvez pas recréer des emprises pour un jeu de données mosaïque référencé.
Le paramètre Approximate Number of Vertices (Nombre approximatif de sommets) est utilisé pour 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 valides sont comprises entre 4 et 10 000. Vous pouvez définir la valeur sur -1 afin qu’aucune généralisation n’ait lieu, mais l’emprise comportera alors un très grand nombre de sommets.
Les paramètres Minimum Region Size (Taille de zone minimale), Minimum Thinness Ratio (Ratio de finesse minimum) et Maximum Sliver Size (Taille de micropolygone maximum) sont utilisés pour supprimer les trous et micropolygones de l’emprise.
La fragmentation des bases de données et la manipulation fréquente des données peut augmenter considérablement la taille d’une mosaïque. Si la taille de la base de données est volumineuse en raison de la constance des transactions, exécutez l’outil Compacter.

Etiqueter	Explication	Type de données
Mosaïque	Jeu de données 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 du jeu de données mosaïque.	SQL Expression
Méthode de calcul (Facultatif)	Affiner les emprises à l’aide de l’une des méthodes suivantes : Radiométrie—Exclure les pixels dont la valeur se situe 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—Restaurer la géométrie d’origine de l’emprise. Copier au même niveau—Remplacez l’emprise panchromatique par l’emprise multispectrale lors de l’utilisation d’un type de raster amélioré. Cela peut se produire lorsque les images panchromatique et multispectrale n’ont pas les mêmes géométries. Aucun—N’affinez 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. Une valeur de -1 calcule tous les sommets. Un plus grand nombre de sommets augmente la précision, mais aussi le temps de traitement.	Long
Distance de contraction (Facultatif)	Découpez l’emprise selon cette distance. Ceci peut éliminer les artefacts liés à l’utilisation de la compression avec perte, qui entraîne la superposition des contours 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)	Utilisez ce paramètre lorsque vous utilisez des jeux de données raster tuilés et adjacents (alignés le long des raccords avec superposition réduite ou sans superposition). Activé—L’état d’origine des emprises est conservé. Décoché—Les bords des feuilles de toutes les emprises sont supprimés. Il s’agit de l’option par défaut.	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écoché—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écoché—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—Le nombre de sommets n’est pas limité. 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 jeu de données 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 du jeu de données mosaïque. Par défaut, la valeur pour laquelle la tolérance est calculée en fonction de la taille de pixel correspondant au raster rééchantillonné demandé est vide. La valeur -1 calculera la tolérance à l’aide de la taille de pixel moyenne du jeu de données 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 le paramètre Request Size (Taille requise), et non sur la résolution spatiale du raster source. Les régions inférieures à la valeur des paramètres (Maximum Sliver Size [Taille de micropolygone maximum])^2 et Minimum Thinness Ratio (Ratio de finesse minimum) sont considérées comme des micropolygones et sont supprimées.	Long
Ratio de finesse minimum (Facultatif)	Définissez la finesse des micropolygones sur une échelle allant de 0,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 qui sont inférieurs à la valeur des paramètres Maximum Sliver Size (Taille de micropolygone maximum) et Minimum Thinness Ratio (Ratio de finesse minimum) sont supprimés de l’emprise.	Double

Sortie dérivée

Etiqueter	Explication	Type de données
Mosaïque mise à jour	Jeu de données mosaïque mis à jour.	Mosaic Layer

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	Jeu de données 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 du jeu de données mosaïque.	SQL Expression
reset_footprint (Facultatif)	Affiner les emprises à l’aide de l’une des méthodes suivantes : `RADIOMETRY`—Exclure les pixels dont la valeur se situe 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`—Restaurer la géométrie d’origine de l’emprise. `COPY_TO_SIBLING`—Remplacez l’emprise panchromatique par l’emprise multispectrale lors de l’utilisation d’un type de raster amélioré. Cela peut se produire lorsque les images panchromatique et multispectrale n’ont pas les mêmes géométries. `NONE`—N’affinez 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. Une valeur de -1 calcule tous les sommets. Un plus grand nombre de sommets augmente la précision, mais aussi le temps de traitement.	Long
shrink_distance (Facultatif)	Découpez l’emprise selon cette distance. Ceci peut éliminer les artefacts liés à l’utilisation de la compression avec perte, qui entraîne la superposition des contours 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 utilisez des jeux de données raster tuilés et adjacents (alignés le long des raccords avec superposition réduite ou sans superposition). `MAINTAIN_EDGES`—L’état d’origine des emprises est conservé. `NO_MAINTAIN_EDGES`—Les bords des feuilles de toutes les emprises sont supprimés. Il s’agit de l’option par défaut.	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`—Le nombre de sommets n’est pas limité. 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 jeu de données 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 du jeu de données mosaïque. Ceci est utilisé lorsque `maintain_edges` est défini sur `MAINTAIN_EDGES`. Par défaut, la valeur pour laquelle la tolérance est calculée en fonction de la taille de pixel correspondant au raster rééchantillonné demandé est vide. La valeur -1 calculera la tolérance à l’aide de la taille de pixel moyenne du jeu de données 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 le paramètre `request_size`, et non sur la résolution spatiale du raster source. Les régions inférieures à la valeur des paramètres (`max_sliver_size`)² et `min_thinness_ratio` sont considérées comme des micropolygones et sont supprimées.	Long
min_thinness_ratio (Facultatif)	Définissez la finesse des micropolygones sur une échelle allant de 0,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 qui sont inférieurs à la valeur des paramètres `max_sliver_size` et `min_thinness_ratio` sont supprimés de l’emprise.	Double

Sortie dérivée

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

Exemple de code

Exemple 1 d’utilisation de la fonction BuildFootPrints (fenêtre Python)

Il s’agit d’un exemple Python d’utilisation de l’outil BuildFootprints.

import arcpy
arcpy.management.BuildFootprints(
     "c:/data/Footprints.gdb/md", "#","RADIOMETRY",
     "1", "254", "25", "0", "#", "SKIP_DERIVED_IMAGES",
     "UPDATE_BOUNDARY", "#", "#", "CONVEX_HULL")

Exemple 2 d’utilisation de la fonction 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.management.BuildFootprints(
     mdname, query, method, minval, maxval, nvertice, shrinkdis,
     maintainedge, skipovr, updatebnd, requestsize, minregsize,
     simplify)

Environnements

Facteur de traitement parallèle

Informations de licence

Basic: Non
Standard: Oui
Advanced: Oui

Générer les emprises (Outils de gestion des données)

Résumé

Utilisation

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes