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

Résumé

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.

Syntaxe

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})
ParamètreExplicationType 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.
  • NONENe 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_EDGESLes bords des feuilles de toutes les emprises sont supprimés. Il s’agit de l’option par défaut.
  • MAINTAIN_EDGESL'état d'origine des emprises est conservé.
Boolean
skip_derived_images
(Facultatif)

Ajustez les emprises des aperçus.

  • SKIP_DERIVED_IMAGESLes emprises des aperçus ne sont pas ajustées. Il s’agit de l’option par défaut.
  • NO_SKIP_DERIVED_IMAGESLes 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_BOUNDARYLa limite est mise à jour. Il s’agit de l’option par défaut.
  • NO_BOUNDARYLa 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.

  • NONENe limitez pas le nombre de sommets. Il s’agit de l’option par défaut.
  • CONVEX_HULLUtilisez le contour minimal pour simplifier l'emprise.
  • ENVELOPEUtilisez 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)2 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 dérivée

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

Informations de licence

  • Basic: Non
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes