Découper le raster (Gestion des données)

Synthèse

Découpe une portion d'un jeu de données raster, d'une mosaïque ou d'une couche de service d'imagerie.

Illustration

Illustration de l'outil Découper

Utilisation

  • Cet outil vous permet d’extraire une portion d’un jeu de données raster selon un modèle d’étendue. La sortie du découpage comprend tous les pixels qui croisent l’étendue du modèle. Pour extraire une partie d’un jeu de classes d’entités, utilisez l’outil Clip (Découper) dans la boîte à outils d’analyse.

  • La surface découpée est définie soit par une enveloppe rectangulaire à l’aide de coordonnées x et y minimum et maximum ou en utilisant un fichier d’étendue en sortie. Si l’étendue du découpage spécifiée n’est pas alignée avec le jeu de données raster en entrée, cet outil s’assure que l’alignement est correct. De ce fait, il se peut que la sortie ait une étendue légèrement différente de celle spécifiée dans l'outil.

  • Une couche vectorielle ou raster existante peut être utilisée comme étendue du découpage. Si vous utilisez une classe d’entités comme étendue en sortie, vous avez la possibilité de découper le raster par le rectangle d’emprise minimale de la classe d’entités ou par la géométrie des entités du polygone. Si vous utilisez la géométrie de découpage, l’espace par pixel de la sortie peut passer au niveau supérieur. Par conséquent, vérifiez que le format en sortie peut prendre en charge l’espace par pixel correct.

  • Vous pouvez également utiliser les entités sélectionnées dans l’affichage en tant qu’étendue de découpage. Si une entité est sélectionnée dans la classe d’entités et que l’option Use Input Features for Clipping Geometry (Utiliser les entités en entrée pour la géométrie de découpage) est cochée (clipping_geometry est défini sur ClippingGeometry dans Python), la sortie découpe les zones sélectionnées. Si une entité est sélectionnée dans la classe d’entités, mais que l’option Use Input Features for Clipping Geometry (Utiliser les entités en entrée pour la géométrie de découpage) n’est pas activée (définie sur NONE dans Python), la sortie découpe le rectangle d’emprise minimale pour cette entité.

  • Vous pouvez enregistrer la sortie au format BIL, BIP, BMP, BSQ, DAT, Grid Esri, GIF, IMG, JPEG, JPEG 2000, PNG, TIFF, MRF ou CRF, ou en tant que jeu de données raster de géodatabase.

  • Les valeurs d'étendue doivent être dans les mêmes coordonnées et unités spatiales que le jeu de données raster.

  • Cet outil prend en charge les données raster multidimensionnelles. Pour exécuter cet outil sur chaque tranche du raster multidimensionnel et générer une sortie raster multidimensionnelle, veillez à sauvegarder la sortie au format CRF.

    Les types de jeux de données multidimensionnels en entrée sont la couche raster multidimensionnelle, le jeu de données mosaïque, le service d’imagerie et CRF.

Paramètres

ÉtiquetteExplicationType de données
Raster en entrée

Jeu de données raster, mosaïque ou service d’imagerie à découper.

Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
Rectangle

Les quatre coordonnées qui définissent l’étendue de l’emprise utilisée pour découper le raster.

Si l’étendue du découpage spécifiée n’est pas alignée avec le jeu de données raster en entrée, l’outil Découper s’assure que l’alignement est correct. De ce fait, il se peut que la sortie ait une étendue légèrement différente de celle spécifiée dans l'outil.

Utilisez le bouton Clear (Effacer) pour réinitialiser l’étendue du rectangle à l’étendue du jeu de données raster en entrée.

Envelope; Feature Class; Feature Layer
Jeu de données raster en sortie

Nom, emplacement et format du jeu de données en cours de création. Veillez à ce qu’il puisse prendre en charge la profondeur de bit nécessaire.

Pour enregistrer le jeu de données raster dans un format de fichier, spécifiez l’extension de fichier comme suit :

  • .bil : Esri BIL
  • .bip : Esri BIP
  • .bmp : BMP
  • .bsq : Esri BSQ
  • .dat : ENVI DAT
  • .gif : GIF
  • .img : ERDAS IMAGINE
  • .jpg : JPEG
  • .jp2 : JPEG 2000
  • .png : PNG
  • .tif : TIFF
  • .mrf : MRF
  • .crf : CRF
  • Aucune extension pour Grid Esri

Pour enregistrer un jeu de données raster dans une géodatabase, n'ajoutez pas d'extension de fichier au nom du jeu de données raster.

Lorsque vous stockez un jeu de données raster dans un fichier au format JPEG, un fichier au format JPEG 2000, un fichier au format TIFF ou une géodatabase, vous pouvez spécifier les valeurs Type de compression et Qualité de compression dans les environnements de géotraitement.

Raster Dataset
Étendue en sortie
(Facultatif)

Jeu de données raster ou classe d’entités à utiliser comme étendue. Le découpage en sortie inclut tous les pixels qui croisent le rectangle d'emprise minimale.

Si une classe d’entités est utilisée comme étendue en sortie et que vous voulez découper le raster en fonction des entités surfaciques, activez le paramètre Use Input Features for Clipping Geometry (Utiliser les entités en entrée pour la géométrie de découpage). Si ce paramètre est activé, l’espace par pixel de la sortie peut passer au niveau supérieur. Par conséquent, vérifiez que le format en sortie peut prendre en charge l’espace par pixel correct.

Raster Layer; Feature Layer
Valeur NoData
(Facultatif)

Valeur des pixels à considérer comme NoData.

String
Utiliser les entités en entrée pour la géométrie de découpage
(Facultatif)

Spécifie si les données vont être découpées sur le rectangle d’emprise minimale ou sur la géométrie de la classe d’entités.

  • Désactivé : le rectangle d’emprise minimale est utilisé pour découper les données.
  • Activé : la géométrie de la classe d’entités sélectionnée est utilisée pour découper les données. L’espace par pixel de la sortie risque d’augmenter ; par conséquent, vérifiez que le format en sortie peut prendre en charge l’espace par pixel approprié.

Boolean
Conserver l’étendue de découpage
(Facultatif)

Désigne l’étendue à utiliser dans la sortie de découpage.

  • Activé : le nombre de colonnes et de lignes sera ajusté et les pixels de nouveau échantillonnés afin de respecter exactement l’étendue de découpage spécifiée.
  • Désactivé : l’alignement de cellule du raster en entrée est maintenu et l’étendue en sortie ajustée en conséquence.

Boolean

arcpy.management.Clip(in_raster, rectangle, out_raster, {in_template_dataset}, {nodata_value}, {clipping_geometry}, {maintain_clipping_extent})
NomExplicationType de données
in_raster

Jeu de données raster, mosaïque ou service d’imagerie à découper.

Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
rectangle

Les quatre coordonnées qui définissent l’étendue de l’emprise utilisée pour découper le raster dans cet ordre : X minimum Y minimum, X maximum, Y maximum.

Si l’étendue du découpage spécifiée n’est pas alignée avec le jeu de données raster en entrée, l’outil Découper s’assure que l’alignement est correct. De ce fait, il se peut que la sortie ait une étendue légèrement différente de celle spécifiée dans l'outil.

Envelope; Feature Class; Feature Layer
out_raster

Nom, emplacement et format du jeu de données en cours de création. Veillez à ce qu’il puisse prendre en charge la profondeur de bit nécessaire.

Pour enregistrer le jeu de données raster dans un format de fichier, spécifiez l’extension de fichier comme suit :

  • .bil : Esri BIL
  • .bip : Esri BIP
  • .bmp : BMP
  • .bsq : Esri BSQ
  • .dat : ENVI DAT
  • .gif : GIF
  • .img : ERDAS IMAGINE
  • .jpg : JPEG
  • .jp2 : JPEG 2000
  • .png : PNG
  • .tif : TIFF
  • .mrf : MRF
  • .crf : CRF
  • Aucune extension pour Grid Esri

Pour enregistrer un jeu de données raster dans une géodatabase, n'ajoutez pas d'extension de fichier au nom du jeu de données raster.

Lorsque vous stockez un jeu de données raster dans un fichier au format JPEG, un fichier au format JPEG 2000, un fichier au format TIFF ou une géodatabase, vous pouvez spécifier les valeurs Type de compression et Qualité de compression dans les environnements de géotraitement.

Raster Dataset
in_template_dataset
(Facultatif)

Jeu de données raster ou classe d’entités à utiliser comme étendue. Le découpage en sortie inclut tous les pixels qui croisent le rectangle d'emprise minimale.

Si une classe d’entités est utilisée comme étendue en sortie et que vous voulez découper le raster en fonction des entités surfaciques, définissez le paramètre clipping_geometry sur ClippingGeometry. Cette option peut faire passer l’espace par pixel de la sortie au niveau supérieur. Par conséquent, vérifiez que le format en sortie peut prendre en charge l’espace par pixel correct.

Raster Layer; Feature Layer
nodata_value
(Facultatif)

Valeur des pixels à considérer comme NoData.

String
clipping_geometry
(Facultatif)

Spécifie si les données vont être découpées sur le rectangle d’emprise minimale ou sur la géométrie de la classe d’entités.

  • NONELe rectangle d’emprise minimale sera utilisé pour découper les données. Il s’agit de l’option par défaut.
  • ClippingGeometryLa géométrie de la classe d’entités spécifiée sera utilisée pour découper les données. L’espace par pixel de la sortie risque d’augmenter ; par conséquent, vérifiez que le format en sortie peut prendre en charge l’espace par pixel approprié.
Boolean
maintain_clipping_extent
(Facultatif)

Désigne l’étendue à utiliser dans la sortie de découpage.

  • MAINTAIN_EXTENTLe nombre de colonnes et de lignes sera ajusté et les pixels de nouveau échantillonnés afin de respecter exactement l’étendue de découpage spécifiée.
  • NO_MAINTAIN_EXTENTL’alignement de cellule du raster en entrée est maintenu et l’étendue en sortie ajustée en conséquence.
Boolean

Exemple de code

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

Il s'agit d'un exemple Python d'utilisation de l'outil Clip.

import arcpy
arcpy.Clip_management(
    "c:/data/image.tif","1952602 294196 1953546 296176",
    "c:/data/clip.gdb/clip01", "#", "#", "NONE", "NO_MAINTAIN_EXTENT")
Exemple d'utilisation 2 de l'outil Clip (script autonome)

Il s'agit d'un exemple de script Python d'utilisation de l'outil Clip.

##Clip Raster Dataset by known extent - Left Bottom Right Top

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

arcpy.Clip_management(
    "image.tif","1952602.23 294196.279 1953546.23 296176.279",
    "clip.gdb/clip", "#", "#", "NONE")
Exemple 3 d’utilisation de l’outil Clip (script autonome)

Il s’agit d’un exemple de script Python pour l’outil Clip utilisant clipping_geometry.

##Clip while maintaining original extent



import arcpy

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



arcpy.Clip_management("c:\\test\\image.tif", "2536996.21761925 7365614.23930381 2537634.12209192 7366302.3861673", 
                      "c:\\output\\clip.tif", "c:\\test\\clipfeature.shp", "0", "ClippingGeometry", 
                      "MAINTAIN_EXTENT")

Informations de licence

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

Rubriques connexes