Générer les lignes de raccord (Gestion des données)

Résumé

Génère ou met à jour des lignes de raccord pour une mosaïque. Les lignes de raccord permettent de trier l'imagerie superposée et de produire une mosaïque plus homogène.

Vous pouvez utiliser cet outil pour réaliser les opérations suivantes :

  • Générer des lignes de raccord pour tous les éléments de la mosaïque.
  • Générer des lignes de raccord pour les éléments sélectionnés à l'aide d'une requête ou par zone d'intérêt.
  • Mettre à jour des lignes de raccord existantes si des éléments sont ajoutés ou supprimés de la mosaïque.

Utilisation

  • Les lignes de raccord sont générées de manière qu'il y ait une ligne de raccord par emprise.

  • Vous ne pouvez pas créer de lignes de raccord pour une mosaïque référencée.

  • Si vous prévoyez d'effectuer une correction des couleurs sur votre mosaïque, il est recommandé d'appliquer la correction avant de créer des lignes de raccord. La correction des couleurs est particulièrement importante si la méthode de calcul est définie sur Radiométrie, car la couleur est prise en compte lors de la génération des lignes de raccord.

  • Les paramètres Méthode de tri et Tri croissant sont désactivés si l'option Mettre à jour les lignes de raccord existantes est sélectionnée.

Syntaxe

arcpy.management.BuildSeamlines(in_mosaic_dataset, cell_size, {sort_method}, {sort_order}, {order_by_attribute}, {order_by_base_value}, {view_point}, {computation_method}, {blend_width}, {blend_type}, {request_size}, {request_size_type}, {blend_width_units}, {area_of_interest}, {where_clause}, {update_existing}, {min_region_size}, {min_thinness_ratio}, {max_sliver_size})
ParamètreExplicationType de données
in_mosaic_dataset

Sélectionne la mosaïque sur laquelle générer les lignes de raccord.

Mosaic Layer
cell_size
[cell_size,...]

Génère des lignes de raccord pour les jeux de données raster situés dans la plage suivante des résolutions spatiales.

Vous pouvez laisser ce paramètre vide ; l’outil crée automatiquement des lignes de raccord aux niveaux appropriés.

Les unités de ce paramètre sont identiques à celles de la référence spatiale de la mosaïque en entrée.

Double
sort_method
(Facultatif)

Définissez une règle qui détermine quel raster sera utilisé pour générer les lignes de raccord en cas de superposition des images.

  • NORTH_WEST Sélectionnez les jeux de données raster dont les points centraux sont les plus proches de l'angle nord-ouest de la limite. Il s’agit de l’option par défaut.
  • CLOSEST_TO_VIEWPOINT Sélectionnez les jeux de données raster selon une position du point nadiral et une position définie par l'utilisateur pour les jeux de données raster à l'aide de l'outil Point de vue.
  • BY_ATTRIBUTE Sélectionnez les jeux de données raster selon un attribut issu de la table attributaire d'emprise. Les attributs couramment utilisés sont notamment la date d'acquisition, la couverture nuageuse ou l'angle de vue.
String
sort_order
(Facultatif)

Choisissez de trier les rasters dans l'ordre croissant ou décroissant.

  • ASCENDING Trie les rasters dans l'ordre croissant. Il s’agit de l’option par défaut.
  • DESCENDING Trie les rasters dans l'ordre décroissant.
Boolean
order_by_attribute
(Facultatif)

Classez les jeux de données raster en fonction de ce champ lorsque la méthode de tri est BY_ATTRIBUTE. L’attribut par défaut est ObjectID.

Field
order_by_base_value
(Facultatif)

Triez les rasters selon leur différence entre cette valeur et leur valeur dans le paramètre order_by_attribute.

Variant
view_point
(Facultatif)

Définissez la position de coordonnées à utiliser lorsque sort_method est CLOSEST_TO_VIEWPOINT.

Point
computation_method
(Facultatif)

Choisissez le mode de génération des lignes de raccord.

  • GEOMETRYGénère des lignes de raccord pour les zones superposées en fonction de l'intersection des emprises. Les zones sans imagerie superposée sont fusionnées avec les emprises. Il s’agit de l’option par défaut.
  • RADIOMETRYGénère des lignes de raccord en fonction des modèles spectraux des entités au sein de l'imagerie.
  • COPY_FOOTPRINTGénère des lignes de raccord directement à partir des emprises.
  • COPY_TO_SIBLINGApplique les lignes de raccord d'une autre mosaïque. Les mosaïques doivent se trouver dans le même groupe. Par exemple, l'étendue du canal panchromatique ne correspond pas toujours à l'étendue du canal multispectral. Cette option s'assure qu'ils partagent la même ligne de raccord.
  • EDGE_DETECTIONGénère des lignes de raccord sur les zones d'intersection en fonction des tronçons des entités dans la zone.
  • VORONOIGénère des lignes de raccord à l'aide du diagramme de Voronoï de surface.
  • DISPARITYGénère des lignes de raccord en fonction des images de disparité de couples stéréoscopiques. Cette méthode permet d'éviter la présence de lignes de raccord dans des bâtiments.

Le paramètre Méthode de tri s'applique à chaque méthode de calcul.

String
blend_width
(Facultatif)

La fusion (estompage) se produit le long de la ligne de raccord entre les pixels lorsqu'il existe des rasters superposés. La largeur de fusion définit le nombre de pixels à fusionner.

Si la valeur de largeur de fusion est 10, et que vous utilisez BOTH en tant que type de fusion, 5 pixels sont fusionnés à l'intérieur et à l'extérieur de la ligne de raccord. Si la valeur est 10, et que le type de fusion est INSIDE, 10 pixels sont fusionnés à l'intérieur de la ligne de raccord.

Double
blend_type
(Facultatif)

Déterminez comment fusionner une image dans une autre, sur les lignes de raccord. Il est possible de fusionner des images à l'intérieur des lignes de raccord, à l'extérieur des lignes de raccord, ou les deux à la fois.

  • BOTH Fusionne à l'aide des pixels des deux côtés des lignes de raccord. Par exemple, si le paramètre Largeur de fusion est égal à 10 pixels, cinq pixels sont fusionnés à l'intérieur et à l'extérieur de la ligne de raccord. Il s’agit de l’option par défaut.
  • INSIDEFusionne à l'intérieur de la ligne de raccord.
  • OUTSIDEFusionne à l'extérieur de la ligne de raccord.
String
request_size
(Facultatif)

Spécifiez le nombre de colonnes et de lignes pour le rééchantillonnage. La valeur maximale est 5 000. Augmentez ou diminuez cette valeur en fonction de la complexité des données raster. Une meilleure résolution d'image fournit plus de détails dans le jeu de données raster, mais augmente également le temps de traitement.

Long
request_size_type
(Facultatif)

Définissez les unités de Taille requise.

  • PIXELSModifie la taille requise en fonction de la taille de pixel.C'est l'option par défaut qui rééchantillonne l'image la plus proche en fonction de la taille de pixel du raster.
  • PIXELSIZE_FACTORModifie la taille requise en spécifiant un facteur d'échelle. Cette option rééchantillonne l'image la plus proche en multipliant la taille de pixel du raster (à partir de la table de niveaux de taille de cellule) avec le facteur de taille de pixel.
String
blend_width_units
(Facultatif)

Spécifiez l'unité de mesure de la largeur de fusion.

  • PIXELSMesure à l'aide du nombre de pixels. Il s’agit de l’option par défaut.
  • GROUND_UNITSMesure à l'aide des mêmes unités que la mosaïque.
String
area_of_interest
(Facultatif)

Générez des lignes de raccord sur tous les rasters qui intersectent ce polygone. Pour sélectionner une zone d'intérêt, utilisez une classe d'entités en entrée.

Feature Set
where_clause
(Facultatif)

Expression SQL permettant de générer des lignes de raccord sur certains jeux de données raster au sein de la mosaïque.

SQL Expression
update_existing
(Facultatif)

Mettre à jour des lignes de raccord qui sont affectées par l'ajout ou la suppression des éléments de mosaïque.

  • IGNORE_EXISTINGRégénère les lignes de raccord de tous les éléments et ignore les lignes de raccord existantes, le cas échéant. Il s’agit de l’option par défaut.
  • UPDATE_EXISTINGMet uniquement à jour les éléments non pourvus de lignes de raccord. Si de nouveaux éléments se superposent aux lignes de raccord créées précédemment, les lignes de raccord existantes peuvent être affectées.

Ce paramètre est ignoré si aucune ligne de raccord n'existe.

Boolean
min_region_size
(Facultatif)

Spécifie la taille minimum de la région, en pixels. Les polygones dont la taille est inférieure à ce seuil spécifié seront supprimés de la ligne de raccord résultante. La valeur par défaut est 100 pixels.

La valeur de ce paramètre doit être plus petite que la zone du micropolygone, qui est (max_sliver_size) * (max_sliver_size).

Long
min_thinness_ratio
(Facultatif)

Définissez le degré de finesse d'un polygone avant qu'il soit considéré comme un micropolygone. L'échelle de base est comprise entre 0 et 1,0, où la valeur 0,0 correspond à un polygone qui représente presque une ligne droite et la valeur 1,0 correspond à un polygone qui représente un cercle.

Les micropolygones sont supprimés lors de la création de lignes de raccord.

Double
max_sliver_size
(Facultatif)

Indiquez la taille maximum d'un polygone pour qu'il soit considéré comme un micropolygone. Ce paramètre est spécifié en pixels et repose sur la request_size, et non sur la résolution spatiale du raster source. Les polygones dont la taille est inférieure au carré de cette valeur sont considérés comme des micropolygones. Les régions de taille inférieure à la (max_sliver_size)2 sont considérées comme des micropolygones.

Les micropolygones sont supprimés lors de la création de lignes de raccord.

Long

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

Exemple 1 d'utilisation de l'outil BuildSeamlines (fenêtre Python)

Il s'agit d'un exemple de script Python pour BuildSeamlines.

import arcpy
arcpy.BuildSeamlines_management("c:/data/Seamlines.gdb/md", "40",
                                "NORTH_WEST", "#", "#", "#", "#",
                                "RADIOMETRY", "5", "INSIDE", "#", 
                                "#", "GROUND_UNITS")
Exemple 2 d'utilisation de l'outil BuildSeamlines (script autonome)

Ceci est un exemple de script Python pour BuildSeamlines.

# Build seamlines using the  NORTH_WEST sort method

import arcpy
arcpy.env.workspace = "C:/Workspace"

mdname = "Seamlines.gdb/md"
cellsize = "40"
sortmethod = "NORTH_WEST"
sortorder = "#"
orderattribute = "#"
orderbase = "#"
viewpnt = "#"
computemethod = "RADIOMETRY"
blendwidth = "5"
blendtype = "INSIDE"
requestsize = "#"

arcpy.BuildSeamlines_management(
    mdname, cellsize, sortmethod, sortorder, orderattribute, 
    orderbase, viewpnt, computemethod, blendwidth, blendtype, 
    requestsize)

Informations de licence

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

Rubriques connexes