Générer un raster SAR avec masque (Image Analyst)

Synthèse

Génère un jeu de données SAR (radar à synthèse d’ouverture) en sortie qui conserve les mesures du radar pour l’intégralité de l’étendue en entrée d’origine tout en masquant une région d’intérêt spécifiée.

Utilisation

  • Les données SAR en sortie utilisent des pixels NoData pour masquer la région spécifiée.

  • Les pixels de l’océan correspondent souvent à la région à masquer.

  • Le masquage de la région d’intérêt spécifiée permet de réduire le bruit, de concentrer l’analyse sur les régions pertinentes et d’améliorer l’analyse suivante, telle que la classification, la détection des changements, l’estimation de la cohérence, la génération d’interférogramme et le déroulement de phase.

  • Lorsque le paramètre Entités de masque en entrée n’est pas spécifié, le modèle numérique d’élévation (MNE) en entrée est utilisé pour déterminer l’interface terre/eau afin de générer le masque NoData pour l’océan.

    Lorsque le paramètre Entités de masque en entrée est spécifié, l’entité de masque en entrée est utilisée afin de générer le masque NoData pour la région d’intérêt spécifiée. Dans ce cas, un raster MNE est requis uniquement pour les données SAR non orthorectifiées.

    Les données SAR, qu’elles soient orthorectifiées ou non, constituent des entrées valides.

Paramètres

ÉtiquetteExplicationType de données
Données radar en entrée

Données radar en entrée.

Raster Dataset; Raster Layer
Données radar en sortie

Données radar en sortie avec un masque NoData nouvellement défini.

Raster Dataset
Bandes de polarisation
(Facultatif)

Bandes de polarisation à traiter.

Par défaut, la première bande est sélectionnée.

Si la sortie est destinée à se trouver avec les outils Analyse SAR, sélectionnez toutes les bandes de polarisation.

String
Entités de masque en entrée
(Facultatif)

Entités en entrée qui définissent l’endroit où les pixels NoData seront créés.

Feature Layer
Zone de masque
(Facultatif)

Indique si les pixels qui se trouvent à l’intérieur ou les pixels qui se trouvent à l’extérieur de l’entité de masque en entrée seront utilisés pour générer le masque NoData. Ce paramètre est actif uniquement lorsque le paramètre Entités de masque en entrée est spécifié.

  • IntérieurLes pixels qui se trouvent à l’intérieur de la zone de masque en entrée seront des pixels NoData. Il s’agit de l’option par défaut.
  • ExtérieurLes pixels qui se trouvent à l’extérieur de la zone de masque en entrée seront des pixels NoData.
String
Raster MNE
(Facultatif)

Raster MNE en entrée.

Lorsque le paramètre Entités de masque en entrée n’est pas spécifié, ce MNE est utilisé afin de générer le masque NoData pour les zones océaniques.

Lorsque le paramètre Entités de masque en entrée est spécifié et que la valeur du paramètre Données radar en entrée n’est pas orthorectifiée, ce MNE doit transformer les coordonnées terrain de l’entité en coordonnées radar.

Raster Layer; Mosaic Layer 
Appliquer une correction géodésique
(Facultatif)

Indique si le système de référence verticale du MNE en entrée est transformé en hauteur ellipsoïdale. La plupart des jeux de données d’altitude étant référencés par rapport à la hauteur orthométrique au niveau de la mer, une correction est nécessaire dans ce cas pour effectuer la conversion en hauteur ellipsoïdale.

  • Activé : une correction de géoïde sera effectuée pour convertir la hauteur orthométriques en hauteur ellipsoïdale (en fonction de la géoïde EGM96). Il s’agit de l’option par défaut.
  • Désactivé : aucune correction de géoïde ne sera effectuée. Utilisez cette option uniquement si le MNE est exprimé en hauteur ellipsoïdale.

Boolean

GenerateMaskedSARRaster(in_radar_data, out_radar_data, {polarization_bands}, {in_mask_features}, {mask_area}, {in_dem_raster}, {geoid})
NomExplicationType de données
in_radar_data

Données radar en entrée.

Raster Dataset; Raster Layer
out_radar_data

Données radar en sortie avec un masque NoData nouvellement défini.

Raster Dataset
polarization_bands
[polarization_bands,...]
(Facultatif)

Bandes de polarisation à traiter.

Par défaut, la première bande est sélectionnée.

Si la sortie est destinée à se trouver avec les outils Analyse SAR, sélectionnez toutes les bandes de polarisation.

String
in_mask_features
(Facultatif)

Entités en entrée qui définissent l’endroit où les pixels NoData seront créés.

Feature Layer
mask_area
(Facultatif)

Indique si les pixels qui se trouvent à l’intérieur ou les pixels qui se trouvent à l’extérieur de l’entité de masque en entrée seront utilisés pour générer le masque NoData. Ce paramètre est valide uniquement lorsque le paramètre in_mask_features est spécifié.

  • INSIDELes pixels qui se trouvent à l’intérieur de la zone de masque en entrée seront des pixels NoData. Il s’agit de l’option par défaut.
  • OUTSIDELes pixels qui se trouvent à l’extérieur de la zone de masque en entrée seront des pixels NoData.
String
in_dem_raster
(Facultatif)

Raster MNE en entrée.

Lorsque le paramètre in_mask_features n’est pas spécifié, ce MNE est utilisé afin de générer le masque NoData pour les zones océaniques.

Lorsque le paramètre in_mask_features est spécifié et que la valeur du paramètre in_radar_data n’est pas orthorectifiée, ce MNE doit transformer les coordonnées terrain de l’entité en coordonnées radar.

Raster Layer; Mosaic Layer 
geoid
(Facultatif)

Indique si le système de référence verticale du MNE en entrée est transformé en hauteur ellipsoïdale. La plupart des jeux de données d’altitude étant référencés par rapport à la hauteur orthométrique au niveau de la mer, une correction est nécessaire dans ce cas pour effectuer la conversion en hauteur ellipsoïdale.

  • GEOIDUne correction de géoïde sera effectuée pour convertir la hauteur orthométrique en hauteur ellipsoïdale (en fonction de la géoïde EGM96). Il s’agit de l’option par défaut.
  • NONEAucune correction de géoïde ne sera effectuée. Utilisez cette option uniquement si le MNE est exprimé en hauteur ellipsoïdale.
Boolean

Exemple de code

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

Cet exemple masque une région d’intérêt en utilisant le MNE en entrée pour générer le masque NoData sur des étendues d’eau.

import arcpy
arcpy.env.workspace = r"C:\Data\SAR"

out_radar = arcpy.ia. GenerateMaskedSARRaster (
     "S1B_IW_GRDH_1SDV_20181014T014104_20181014T014129_013142_018486_D82E.SAFE\manifest.safe",
     "VV", "dem.tif", "GEOID") 
out_radar.save("IW_D82E_Mask.crf")
Exemple 2 d’utilisation de la fonction GenerateMaskedSARRaster (script autonome)

Cet exemple masque une région d’intérêt en utilisant une classe d’entités hydrographiques pour générer le masque NoData.

# Import system modules and check out ArcGIS Image Analyst extension license
import arcpy
arcpy.CheckOutExtension("ImageAnalyst")
from arcpy.ia import *

# Set local variables
in_raster=r"C:/Data/SAR/SAR_RTC.crf"
polarization="VV"
in_mask_features=r"C:/Data/SAR/water.shp"
mask_area="INSIDE"  
out_radar=r"C:/Data/SAR/IW_D82E_Mask.crf"

#Create output
out_Radar = arcpy.ia.GenerateMaskedSARRaster(in_raster, polarization, 
    in_mask_features, mask_area) 
out_Radar.save(out_radar)

Informations de licence

  • Basic: Nécessite Image Analyst
  • Standard: Nécessite Image Analyst
  • Advanced: Nécessite Image Analyst

Rubriques connexes