Ré-échantillonner les spectres de bibliothèque (Outils de gestion des données)

Résumé

Ré-échantillonne les bandes d’une bibliothèque spectrale pour qu’elles correspondent aux bandes d’une image ou d’une bibliothèque spectrale cible, en générant un nouveau fichier de bibliothèque spectrale. L’image ou la bibliothèque spectrale cible peut être prédéfinie à partir d’une liste de capteurs cible, ou peut être basée sur une image personnalisée ou des spectres.

Utilisation

La valeur du paramètre Output Library Spectra (Spectres de bibliothèque en sortie) correspond à un spectre dont le nombre de bandes et la plage de longueurs d’onde sont identiques à ceux de la valeur du paramètre Target sensor (Capteur cible).
L’opération est effectuée sur des bandes avec des longueurs d’onde superposées. Si l’entrée contient une plage supérieure à la cible, les bandes excédentaires sont supprimées. Si la cible contient une plage supérieure à l’entrée, les bandes situées en dehors de la plage en entrée ne sont pas incluses et sont désignées à l’aide d’une valeur négative pouvant être définie comme NoData.
Pour l’option Band averaging (Calcul de la moyenne de bande) du paramètre Resampling Method (Méthode de rééchantillonnage), une bande en entrée est prise en compte dans le calcul si sa longueur d’onde centrale se situe dans la plage de longueurs d’onde minimale et maximale de la bande cible.
Pour l’option Gaussian convolution (Convolution gaussienne) du paramètre Resampling Method (Méthode de rééchantillonnage), l’inclusion ou non d’une bande en entrée dans le calcul est déterminée par le fait que sa longueur d’onde centrale se situe ou non dans la longueur d’onde centrale de la cible ± 3σ, comme suit :

où FWHM = WavelengthMax – WavelengthMin.

Etiqueter	Explication	Type de données
Spectres de bibliothèque en entrée	Bibliothèque spectrale Esri ou fichier de la bibliothèque d’outils d’analyse spectrale ENVI avec des informations sur la longueur d’onde.	File; String
Spectres de bibliothèque en sortie	Fichier de la bibliothèque d’outils d’analyse spectrale Esri en sortie avec les informations sur la longueur d’onde rééchantillonnées.	File
Capteur cible	Spécifie les spectres cible, ou une image ou un fichier de la bibliothèque de spectres personnalisé contenant les spectres cible. Landsat 9—Les spectres cible sont des données satellite Landsat 9 avec 7 bandes. Landsat 8—Les spectres cible sont des données satellite Landsat 8 avec 7 bandes. Landsat 7 (non thermique)—Les spectres cible sont des données satellite Landsat 7 avec 6 bandes. Landsat 5 (non thermique)—Les spectres cible sont des données satellite Landsat 5 avec 6 bandes. Landsat 4 (non thermique)—Les spectres cible sont des données satellite Landsat 4 avec 6 bandes. Sentinel-3—Les spectres cible sont des données satellite Sentinel-3 avec 21 bandes. Sentinel-2A—Les spectres cible sont des données satellite Sentinel-2A avec 13 bandes. Sentinel-2B—Les spectres cible sont des données satellite Sentinel-2B avec 13 bandes. Bandes ASTER 1 à 9—Les spectres cible sont des données satellite ASTER avec 10 bandes. Image cible personnalisée ou spectres—Une image ou un fichier de bibliothèque spectrale personnalisé contenant les spectres cible est utilisé. Il s’agit de l’option par défaut.	String
Image cible personnalisée ou spectres (Facultatif)	Image ou fichier de bibliothèque spectrale personnalisé avec des informations sur la longueur d’onde contenant les spectres cible. Ce paramètre est activé lorsque la valeur du paramètre Target sensor (Capteur cible) correspond à Custom target image or spectra (Image cible personnalisée ou spectres).	Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; File; Image Service; String
Méthode de ré-échantillonnage (Facultatif)	Spécifie la méthode de rééchantillonnage qui sera utilisée pour la valeur du paramètre Output Library Spectra (Spectres de bibliothèque en sortie). Calcul de la moyenne de bande—Une moyenne simple des spectres en entrée basée sur toutes les valeurs de bande situées dans la plage de longueurs d’onde de chaque bande cible est utilisée. Il s’agit de l’option par défaut. Convolution gaussienne—Un modèle gaussien est utilisé pour représenter la fonction de réponse spectrale du capteur et les valeurs de bande en entrée sont pondérées pour chaque plage de longueurs d’onde.	String

arcpy.management.ResampleLibrarySpectra(in_library_spectra, out_library_spectra, target_sensor, {custom_target_image_or_spectra}, {resampling_method})

Nom	Explication	Type de données
in_library_spectra	Bibliothèque spectrale Esri ou fichier de la bibliothèque d’outils d’analyse spectrale ENVI avec des informations sur la longueur d’onde.	File; String
out_library_spectra	Fichier de la bibliothèque d’outils d’analyse spectrale Esri en sortie avec les informations sur la longueur d’onde rééchantillonnées.	File
target_sensor	Spécifie les spectres cible, ou une image ou un fichier de la bibliothèque de spectres personnalisé contenant les spectres cible. `LANDSAT-9`—Les spectres cible sont des données satellite Landsat 9 avec 7 bandes. `LANDSAT-8`—Les spectres cible sont des données satellite Landsat 8 avec 7 bandes. `LANDSAT-7_NO_THERMAL`—Les spectres cible sont des données satellite Landsat 7 avec 6 bandes. `LANDSAT-5_NO_THERMAL`—Les spectres cible sont des données satellite Landsat 5 avec 6 bandes. `LANDSAT-4_NO_THERMAL`—Les spectres cible sont des données satellite Landsat 4 avec 6 bandes. `SENTINEL-3`—Les spectres cible sont des données satellite Sentinel-3 avec 21 bandes. `SENTINEL-2A`—Les spectres cible sont des données satellite Sentinel-2A avec 13 bandes. `SENTINEL-2B`—Les spectres cible sont des données satellite Sentinel-2B avec 13 bandes. `ASTER_BANDS_1_TO_9`—Les spectres cible sont des données satellite ASTER avec 10 bandes. `CUSTOM_TARGET_IMAGE_OR_SPECTRA`—Une image ou un fichier de bibliothèque spectrale personnalisé contenant les spectres cible est utilisé. Il s’agit de l’option par défaut.	String
custom_target_image_or_spectra (Facultatif)	Image ou fichier de bibliothèque spectrale personnalisé avec des informations sur la longueur d’onde contenant les spectres cible. Ce paramètre est actif lorsque la valeur du paramètre `target_sensor` correspond à `CUSTOM_TARGET_IMAGE_OR_SPECTRA`.	Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; File; Image Service; String
resampling_method (Facultatif)	Spécifie la méthode de rééchantillonnage qui sera utilisée pour la valeur du paramètre `out_library_spectra`. `BAND_AVERAGING`—Une moyenne simple des spectres en entrée basée sur toutes les valeurs de bande situées dans la plage de longueurs d’onde de chaque bande cible est utilisée. Il s’agit de l’option par défaut. `GAUSSIAN_CONVOLUTION`—Un modèle gaussien est utilisé pour représenter la fonction de réponse spectrale du capteur et les valeurs de bande en entrée sont pondérées pour chaque plage de longueurs d’onde.	String

Exemple de code

Exemple 1 d’utilisation de ResampleLibrarySpectra (fenêtre Python)

Cet exemple utilise l’option LANDSAT-8 pour le paramètre target_spectra.

# Import system modules
import arcpy
from arcpy.management import *

# Run ResampleLibrarySpectra
arcpy.management.ResampleLibrarySpectra(r"c:\library\aspen.esl", r"C:\library\aspen_resampled.esl", "LANDSAT-8", "BAND_AVERAGING")

Exemple 2 d’utilisation de ResampleLibrarySpectra (script autonome)

Cet exemple utilise l’option CUSTOM_TARGET_IMAGE_OR_SPECTRA pour le paramètre target_spectra.

# Import system modules
import arcpy
from arcpy.management import *

# Define variables
input_library = r"c:\library\hematite.sli"
out_library = r"c:\library\hematite_resampled.esl"
target_sensor = "CUSTOM_TARGET_IMAGE_OR_SPECTRA"
custom_target_image_or_spectra= r"c\image\landsat_7_bands.tif"
method = "GAUSSIAN_CONVOLUTION"

# Run ResampleLibrarySpectra
arcpy.management.ResampleLibrarySpectra(
    in_library_spectra=input_library,
    out_library_spectra=out_library,
    target_sensor=target_sensor,
    custom_target_image_or_spectra=custom_target_image_or_spectra,
    resampling_method = method
)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence