Copier un raster (Gestion des données)

Résumé

Enregistre une copie d'un jeu de données raster ou convertit une mosaïque en un seul jeu de données raster.

Utilisation

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

  • Pour enregistrer un jeu de données raster dans une géodatabase, vous ne devez ajouter aucune extension de fichier au nom du jeu de données raster. Pour enregistrer le jeu de données raster dans un format de fichier, vous devez spécifier une extension de fichier :

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

  • Cet outil permet de mettre à l'échelle le type de pixel d'un espace par pixel à un autre. Lorsque vous mettez à l'échelle l'espace par pixel, votre raster s'affichera de la même façon, mais les valeurs sont mises à l'échelle selon le nouvel espace par pixel spécifié.

  • Cet outil génère toujours un jeu de données raster. Lorsque cet outil accepte une mosaïque en entrée, la sortie reste un jeu de données raster (le contenu de la mosaïque est mosaïqué de manière à créer un jeu de données raster).

  • Si vous avez coché la case Use world file to define the coordinates of the raster (Utiliser le fichier de géoréférencement pour définir les coordonnées du raster) dans Options, un fichier de géoréférencement est créé. Si un fichier de géoréférencement existe déjà, il sera remplacé. Un décalage d'un demi-pixel peut aussi se produire dans la référence spatiale en sortie.

  • Pour les rasters basés sur des fichiers, l'option Ignorer la valeur d'arrière-plan doit être définie avec la même valeur que NoData pour que la valeur d'arrière-plan soit ignorée. Les rasters de géodatabase fichier et les rasters de géodatabase d'entreprise fonctionneront sans cette étape supplémentaire.

  • Lorsque vous stockez un jeu de données raster dans un fichier JPEG, un fichier JPEG 2000 ou une géodatabase, vous pouvez spécifier un type de compression et une qualité de compression dans les environnements.

  • Le format GIF prend uniquement en charge des jeux de données raster monocanaux.

  • Le paramètre Pixel Type (Type de pixel) détermine la profondeur binaire du jeu de données raster en sortie. Une remise à l'échelle des valeurs de raster a lieu lorsqu'un type de pixel différent est choisi. Si le type de pixel est rétrogradé (remplacé par un type inférieur), les valeurs de raster situées en dehors de la plage autorisée pour cet espace par pixel sont tronquées et perdues. Pour en savoir plus sur la capacité de profondeur des couleurs pour les formats d'exportation pris en charge, reportez-vous à la rubrique Liste des capteurs pris en charge.

  • Le paramètre Build Multidimensional Transpose (Créer une transposition multidimensionnelle) permet d’optimiser l’accès aux données. Par défaut, les fichiers CRF stockent chaque tranche multidimensionnelle dans un dossier séparé, chaque tranche étant divisée en tuiles. Lorsque vous effectuez une transposition, les données seront divisées selon les dimensions plutôt qu’en tranches et en tuiles, ce qui facilite et accélère les analyses telles que le profilage temporel.

Syntaxe

CopyRaster(in_raster, out_rasterdataset, {config_keyword}, {background_value}, {nodata_value}, {onebit_to_eightbit}, {colormap_to_RGB}, {pixel_type}, {scale_pixel_value}, {RGB_to_Colormap}, {format}, {transform}, {process_as_multidimensional}, {build_multidimensional_transpose})
ParamètreExplicationType de données
in_raster

Jeu de données raster ou mosaïque que vous souhaitez copier.

Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; File; Image Service
out_rasterdataset

Nom et format du jeu de données raster que vous créez.

  • .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 votre jeu de données raster dans une géodatabase, un fichier JPEG, JPEG 2000 ou TIFF, vous pouvez spécifier un type de compression et une qualité de compression.

Raster Dataset
config_keyword
(Facultatif)

Spécifie les paramètres de stockage (configuration) d’une géodatabase. Les mots-clés de configuration sont définis par l'administrateur de la base de données.

String
background_value
(Facultatif)

Supprimer les valeurs non désirées créées autour des données raster. La valeur spécifiée est différenciée des autres valeurs utiles dans le jeu de données raster. Par exemple, une valeur zéro le long des bordures du jeu de données raster se différencie des valeurs zéro à l'intérieur du jeu de données raster.

La valeur du pixel spécifiée est définie sur NoData dans le jeu de données raster en sortie.

Pour les rasters basés sur des fichiers, l'option Ignorer la valeur d'arrière-plan doit être définie avec la même valeur que NoData pour que la valeur d'arrière-plan soit ignorée. Les rasters de géodatabase et d’entreprise fonctionnent sans cette étape supplémentaire.

Double
nodata_value
(Facultatif)

Tous les pixels ayant la valeur spécifiée auront la valeur NoData dans le jeu de données raster en sortie.

String
onebit_to_eightbit
(Facultatif)

Spécifiez si le jeu de données raster de 1 bit en entrée doit être converti en jeu de données raster de 8 bits. Si vous demandez cette conversion, la valeur 1 dans le jeu de données raster en entrée passera à 255 dans le jeu de données raster en sortie. Ceci est utile pour l'importation d'un jeu de données raster de 1 bit dans une géodatabase. Les jeux de données raster de 1 bit comportent des couches pyramidales de 8 bits lorsqu'ils sont stockés dans un système de fichiers. Toutefois, dans une géodatabase, les jeux de données raster de 1 bit comportent uniquement des couches pyramidales de 1 bit, d'où la médiocrité de l'affichage. Grâce à la conversion des données en 8 bits dans une géodatabase, les couches pyramidales sont construites sur 8 bits et non pas sur 1 bit, ce qui permet le bon affichage des jeux de données raster.

  • NONEAucune conversion ne sera effectuée. Il s’agit de l’option par défaut.
  • OneBitTo8BitLe raster en entrée sera converti.
Boolean
colormap_to_RGB
(Facultatif)

Si le jeu de données raster en entrée possède une palette de couleurs, le jeu de données raster en sortie peut être converti en jeu de données raster en sortie à trois canaux. Ceci est utile pour le mosaïquage des rasters avec différentes palettes de couleurs.

  • NONEAucune conversion n'est effectuée. Il s’agit de l’option par défaut.
  • ColormapToRGBLe jeu de données en entrée sera converti.
Boolean
pixel_type
(Facultatif)

Définissez la profondeur des couleurs, ou la résolution radiométrique, du jeu de données raster ou de la mosaïque. Dans le cas contraire, le premier jeu de données raster est utilisé.

  • 1_BITEntier non signé 1 bit. Les valeurs peuvent être 0 ou 1.
  • 2_BITEntier non signé 2 bits. Les valeurs prises en charge s'échelonnent de 0 à 3.
  • 4_BITEntier non signé 4 bits. Les valeurs prises en charge s'échelonnent de 0 à 15.
  • 8_BIT_UNSIGNEDType de données 8 bits non signé. Les valeurs prises en charge s'échelonnent de 0 à 255.
  • 8_BIT_SIGNEDType de données 8 bits signé. Les valeurs prises en charge sont comprises entre -128 et 127.
  • 16_BIT_UNSIGNEDType de données 16 bits non signé. Les valeurs s'échelonnent de 0 à 65 535.
  • 16_BIT_SIGNEDType de données 16 bits signé. Les valeurs s'échelonnent de -32 768 à 32 767.
  • 32_BIT_UNSIGNEDType de données 32 bits non signé. Les valeurs s'échelonnent de 0 à 4 294 967 295.
  • 32_BIT_SIGNEDType de données 32 bits signé. Les valeurs s'échelonnent de -2 147 483 648 à 2 147 483 647.
  • 32_BIT_FLOATType de données 32 bits prenant en charge les décimales.
  • 64_BITType de données 64 bits prenant en charge les décimales.
String
scale_pixel_value
(Facultatif)

Lorsque la sortie est un type de pixel différent de celui de l’entrée (par exemple, 16 bits à 8 bits), vous pouvez décider de mettre les valeurs à l’échelle afin de les adapter à la nouvelle plage. Dans le cas contraire, les valeurs qui ne sont pas contenues dans la nouvelle plage de pixels sont ignorées.

Lors de l'augmentation de l'échelle, par exemple de 8 bits à 16 bits, les valeurs minimale et maximale de 8 bits sont mises à l'échelle selon les valeurs minimale et maximale dans la plage de 16 bits. Lors de la réduction de l'échelle, par exemple de 16 bits à 8 bits, les valeurs minimale et maximale des valeurs 16 bits sont mises à l'échelle selon les valeurs minimale et maximale dans la plage de 8 bits.

  • NONELes valeurs de pixels restent identiques et ne sont pas mises à l'échelle. Tout valeur ne se trouvant pas dans la plage de valeurs est ignoré. Il s’agit de l’option par défaut.
  • ScalePixelValueLes valeurs des pixels sont mises à l'échelle selon le nouveau type de pixel. Lorsque vous mettez à l'échelle l'espace par pixel, votre raster s'affichera de la même façon, mais les valeurs sont mises à l'échelle selon le nouvel espace par pixel spécifié.
Boolean
RGB_to_Colormap
(Facultatif)

Indique si un jeu de données raster 8 bits à 3 bandes (RVB) est converti en un jeu de données raster monocanal avec une palette de couleurs. Cette opération supprime le bruit qui se produit souvent dans les images numérisées. Elle est idéale pour les captures d'écran, les cartes numérisées ou les documents numérisés. Elle n'est pas recommandée pour les images satellite ou aériennes, ni pour les données raster thématiques.

  • NONEPas de conversion RVB.
  • RGBToColormapConversion en palette de couleurs.
Boolean
format
(Facultatif)

Indique le format raster en sortie.

  • TIFFformat TIFF
  • COGFormat GeoTIFF optimisé pour le cloud
  • IMAGINE ImageERDAS IMAGINE
  • BMPformat BMP
  • GIFformat GIF
  • PNGFormat PNG
  • JPEGformat JPEG
  • JP2format JPEG 2000
  • GRID Format Grid Esri
  • BIL Esriformat BIL
  • BSQ Esriformat BSQ
  • BIP Esriformat BIP
  • ENVIformat ENVI
  • CRFformat CRF
  • MRFformat MRF
String
transform
(Facultatif)

Indique s’il convient d’appliquer à la sortie la transformation associée au raster en entrée. Le raster en entrée peut être associé à une transformation qui n’est pas enregistrée au sein de l’entrée, telle qu’un fichier de géoréférencement ou une fonction géométrique.

  • NONEN’appliquez aucune transformation associée à la sortie.
  • TransformAppliquez n’importe quelle transformation associée à la sortie.
Boolean
process_as_multidimensional
(Facultatif)

Spécifie si le jeu de données mosaïque en entrée doit être traité comme un jeu de données raster multidimensionnelles.

  • CURRENT_SLICEL’entrée ne sera pas traitée comme un jeu de données raster multidimensionnelles. Si l’entrée est multidimensionnelle, seule la tranche qui est actuellement affichée sera traitée. Il s’agit de l’option par défaut.
  • ALL_SLICESL’entrée sera traitée comme un jeu de données raster multidimensionnelles et toutes les tranches seront traitées, afin de générer un nouveau jeu de données raster multidimensionnelles. Pour utiliser cette option, définissez le format sur CRF.
Boolean
build_multidimensional_transpose
(Facultatif)

Spécifie si la transposition doit être appliquée pour le jeu de données raster multidimensionnelles, ce qui divisera les données selon chaque dimension de façon à optimiser les performances lors de l’accès aux valeurs de pixels dans toutes les tranches.

  • NO_TRANSPOSEAucune transposition n’est appliquée. Il s’agit de l’option par défaut.
  • TRANSPOSELe jeu de données raster multidimensionnelles en entrée est transposé. Pour utiliser cette option, définissez le paramètre process_as_multidimensional sur ALL_SLICES.
Boolean

Exemple de code

Exemple 1 d'utilisation de l'outil Copier un raster (fenêtre Python)

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

##====================================
##Copy Raster
##Usage: CopyRaster_management(
##			in_raster, out_rasterdataset, {config_keyword}, {background_value}, 
##			{nodata_value}, {NONE | OneBitTo8Bit}, {NONE | ColormapToRGB}, 
##			{1_BIT | 2_BIT | 4_BIT | 8_BIT_UNSIGNED | 8_BIT_SIGNED | 16_BIT_UNSIGNED | 
##			16_BIT_SIGNED | 32_BIT_UNSIGNED | 32_BIT_SIGNED | 32_BIT_FLOAT | 64_BIT}, 
##			{NONE | ScalePixelValue}, {NONE | RGBToColormap}, {TIFF | IMAGINE Image | 
##			BMP | GIF | PNG | JPEG | JPEG2000 | Esri Grid | Esri BIL | Esri BSQ | 
##			Esri BIP | ENVI | CRF | MRF}, {NONE | Transform}, {CURRENT_SLICE | ALL_SLICES}, {NO_TRANSPOSE | TRANSPOSE})


try:
    import arcpy
    arcpy.env.workspace = r"C:\PrjWorkspace"
    ##Copy Multidimensional Raster Dataset to a new multidimensional dataset in Cloud raster format and with transpose for faster data access
    arcpy.CopyRaster_management('SeaSurfaceTemp.nc',"https://s3.amazonaws.com/S3Storage/seasurfacetemp","","","","","","","","", format = "CRF",'NONE',process_as_multidimensional = 'ALL_SLICES', build_multidimensional_transpose='TRANSPOSE')
    ##Copy 1 BIT 
    arcpy.CopyRaster_management("1bit.tif","SDE94.sde\\bit8","DEFAULTS","","","OneBitTo8Bit","","")
    ##Copy File RasterDataset to GDB Dataset with Background and Nodata setting
    arcpy.CopyRaster_management("background.tif","CpRaster.gdb\\background","DEFAULTS","0","9","","","8_BIT_UNSIGNED")
except:
    print "Copy Raster example failed."
    print arcpy.GetMessages()
Exemple 2 d'utilisation de l'outil Copier un raster (script autonome)

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

##====================================
##Usage: CopyRaster_management(
##			in_raster, out_rasterdataset, {config_keyword}, {background_value}, 
##			{nodata_value}, {NONE | OneBitTo8Bit}, {NONE | ColormapToRGB}, 
##			{1_BIT | 2_BIT | 4_BIT | 8_BIT_UNSIGNED | 8_BIT_SIGNED | 16_BIT_UNSIGNED | 
##			16_BIT_SIGNED | 32_BIT_UNSIGNED | 32_BIT_SIGNED | 32_BIT_FLOAT | 64_BIT}, 
##			{NONE | ScalePixelValue}, {NONE | RGBToColormap}, {TIFF | IMAGINE Image | 
##			BMP | GIF | PNG | JPEG | JPEG2000 | Esri Grid | Esri BIL | Esri BSQ | 
##			Esri BIP | ENVI | CRF | MRF}, {NONE | Transform}, {CURRENT_SLICE | ALL_SLICES}, {NO_TRANSPOSE | TRANSPOSE})

import arcpy
arcpy.env.workspace = r"C:\PrjWorkspace"

##Copy to new multidimensional dataset in cloud raster format and with transpose for faster data access
arcpy.CopyRaster_management(
	"SeaSurfaceTemp.nc", "SST_Transpose.crf","","",-3.402823e+38,"NONE","NONE","","NONE","NONE", "CRF", "NONE", "ALL_SLICES", "TRANSPOSE")

Informations de licence

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

Rubriques connexes