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ètre | 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 :
| 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).
| Boolean |
skip_derived_images (Facultatif) | Ajustez les emprises des aperçus.
| Boolean |
update_boundary (Facultatif) | Mettez à jour la limite de la mosaïque si vous avez modifié l'étendue en ajoutant ou supprimant des images.
| 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.
| 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
| 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)
Environnements
Informations de licence
- Basic: Non
- Standard: Oui
- Advanced: Oui