Copier un raster (Gestion des données)

Synthèse

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

Utilisation

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

  • 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. Pour enregistrer le jeu de données raster dans un format de fichier, spécifiez l’extension de fichier comme suit :

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

  • Cet outil permet de mettre à l’échelle le type de pixel d’une profondeur de bits à une autre. Lorsque vous mettez à l’échelle l’espace par pixel, le raster s’affiche de la même façon, mais les valeurs sont mises à l’échelle selon la nouvelle profondeur de bits spécifiée.

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

  • Si vous cochez la case Utiliser le fichier de géoréférencement pour définir les coordonnées du raster dans les options Raster et imagerie, un fichier de géoréférencement est créé. Si un fichier de géoréférencement existe, il est 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, le paramètre Ignorer la valeur d’arrière-plan doit être défini avec la même valeur que celle du paramètre Valeur 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 enregistrez un jeu de données raster dans un fichier JPEG, un fichier JPEG 2000 ou une géodatabase, vous pouvez spécifier une valeur dans Compression Type (Type de compression) et une valeur dans Compression Quality (Qualité de compression) dans les environnements de géotraitement.

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

  • Une fois créé, un fichier .mrf ne peut pas être copié, renommé ou supprimé dans ArcGIS AllSource. Un fichier .mrf pointe vers des données résidant ailleurs et déterminer le statut en lecture ou écriture des fichiers n’est pas toujours possible.

  • Le paramètre Type de pixel détermine la profondeur de bits du jeu de données raster en sortie. Une remise à l’échelle des valeurs 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 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 de bits pour les formats d’exportation pris en charge, reportez-vous à la rubrique Liste des capteurs pris en charge.

  • La création d’un fichier au format Cloud Optimized GeoTIFF (COG) à partir d’un raster par cet outil est une procédure à deux étapes qui implique l’organisation appropriée de la structure interne GeoTIFF avec les spécifications COG. La première étape consiste à générer un fichier temporaire au format GeoTIFF à partir du raster en entrée avec des pyramides, des statistiques et d’autres métadonnées. Ce fichier GeoTIFF temporaire est ensuite copié pour générer un fichier au format COG.

    La configuration requise pour le disque en vue de la génération au format COG est d’au moins deux fois l’espace de l’image source, qui dépend également de la compression du raster en entrée et du fichier au format COG en sortie.

  • Le type de format NetCDF pris en charge pour la sortie adhère aux conventions de métadonnées NetCDF CF (Climate and Forecast).

  • Le format NetCDF ne prend en charge que les données monobande. Pour les données multidimensionnelles et multibandes telles que les données satellites, la première bande est utilisée.

  • Le paramètre Build Multidimensional Transpose (Créer une transposition multidimensionnelle) est destiné à l’optimisation de l’accès aux données. Par défaut, un fichier .crf stocke chaque tranche multidimensionnelle dans un dossier séparé, chaque tranche étant divisée en tuiles. Lorsque vous effectuez une transposition, les données sont divisées selon les dimensions plutôt qu’en tranches et en tuiles, ce qui accélère les analyses telles que le profilage temporel.

  • Lorsque vous spécifiez une étendue en dehors des limites du jeu de données raster, la zone ne comportant pas de données est renseignée à l’aide de valeurs NoData.

Paramètres

ÉtiquetteExplicationType de données
Raster en entrée

Jeu de données raster ou jeu de données mosaïque à copier.

Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; File; Image Service
Jeu de données raster en sortie

Nom et format du jeu de données raster qui est créé.

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

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 format JPEG, JPEG 2000 ou TIFF, ou dans une géodatabase, vous pouvez spécifier un type de compression et une qualité de compression.

Raster Dataset
Mot-clé de configuration
(Facultatif)

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
Ignorer la valeur d’arrière-plan
(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 de 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 celle du paramètre Valeur NoData pour que la valeur d’arrière-plan soit ignorée. Les rasters de géodatabase et d’entreprise fonctionneront sans cette étape supplémentaire.

Double
Valeur NoData
(Facultatif)

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

String
Convertir les données 1 bit en 8 bits
(Facultatif)

Indique 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, ce qui entraîne un affichage de qualité médiocre. 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.

  • Désactivé : aucune conversion n’est effectuée. Il s’agit de l’option par défaut.
  • Activé : le raster en entrée sera converti.
Boolean
Palette vers RVB
(Facultatif)

Indique si le jeu de données raster en entrée est converti en jeu de données raster en sortie à trois bandes lorsque le jeu de données raster en entrée inclut une palette de couleurs. Ceci est utile pour le mosaïquage des rasters avec différentes palettes de couleurs.

  • Désactivé : aucune conversion n’est effectuée. Il s’agit de l’option par défaut.
  • Activé : le jeu de données en entrée sera converti.
Boolean
Type de pixel
(Facultatif)

Spécifie la profondeur de bits ou la résolution radiométrique à utiliser pour le jeu de données raster ou le jeu de données mosaïque. Si ce paramètre n’est pas défini, la valeur issue du premier jeu de données raster est utilisée.

  • 1 bitLe type de pixel sera un entier non signé 1 bit. Les valeurs peuvent être 0 ou 1.
  • 2 bitsLe type de pixel sera un entier non signé 2 bits. Les valeurs prises en charge s’échelonnent de 0 à 3.
  • 4 bitsLe type de pixel sera un entier non signé 4 bits. Les valeurs prises en charge s’échelonnent de 0 à 15.
  • non signé 8 bitsLe type de pixel sera un type de données 8 bits non signé. Les valeurs prises en charge s’échelonnent de 0 à 255.
  • signé 8 bitsLe type de pixel sera un type de données 8 bits signé. Les valeurs prises en charge s’échelonnent de -128 à 127.
  • non signé 16 bitsLe type de pixel sera un type de données 16 bits non signé. Les valeurs s’échelonnent de 0 à 65 535.
  • signé 16 bitsLe type de pixel sera un type de données 16 bits signé. Les valeurs s’échelonnent de -32 768 à 32 767.
  • non signé 32 bitsLe type de pixel sera un type de données 32 bits non signé. Les valeurs s’échelonnent de 0 à 4 294 967 295.
  • signé 32 bitsLe type de pixel sera un type de données 32 bits signé. Les valeurs s’échelonnent de -2 147 483 648 à 2 147 483 647.
  • flottant 32 bitsLe type de pixel sera un type de données 32 bits prenant en charge les décimales.
  • 64 bitsLe type de pixel sera un type de données 64 bits prenant en charge les décimales.
String
Mettre à l’échelle les valeurs de pixel
(Facultatif)

Spécifie si les valeurs de pixel sont mises à l’échelle. Lorsque la sortie est un type de pixel différent de celui de l’entrée (par exemple, de 16 bits à 8 bits), vous pouvez mettre les valeurs à l’échelle afin de les adapter à la nouvelle plage. Dans le cas contraire, les valeurs qui ne correspondent pas à 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.

  • Désactivé : les valeurs de pixel restent identiques et ne sont pas mises à l’échelle. Toute valeur ne se trouvant pas dans la plage de valeurs est ignorée. Il s’agit de l’option par défaut.
  • Activé : les valeurs de pixel sont mises à l’échelle selon le nouveau type de pixel. Lorsque vous mettez à l’échelle l’espace par pixel, le raster s’affiche de la même façon, mais les valeurs sont mises à l’échelle selon la nouvelle profondeur de bits spécifiée.
Boolean
RVB vers palette de couleurs
(Facultatif)

Indique si un jeu de données raster 8 bits à 3 bandes (RVB) est converti en un jeu de données raster monobande 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 satellites ou aériennes, ni pour les données raster thématiques.

  • Désactivé : le jeu de données raster RVB n’est pas converti.
  • Activé : le jeu de données raser RVB est converti en palette de couleurs.
Boolean
Format
(Facultatif)

Indique le format raster en sortie.

  • Format TIFFLe format en sortie est TIFF.
  • Format Cloud Optimized GeoTIFFLe format en sortie est Cloud Optimized GeoTIFF.
  • Format ERDAS IMAGINELe format en sortie est ERDAS IMAGINE.
  • Format BMPLe format en sortie est BMP.
  • Format GIFLe format en sortie est GIF.
  • Format PNGLe format en sortie est PNG.
  • Format JPEGLe format en sortie est JPEG.
  • Format JPEG 2000Le format en sortie est JPEG 2000.
  • Format Esri GridLe format en sortie est Esri Grid.
  • Format Esri BILLe format en sortie est Esri BIL.
  • Format Esri BSQLe format en sortie est Esri BSQ.
  • Format Esri BIPLe format en sortie est Esri BIP.
  • Format ENVI DATLe format en sortie est ENVI DAT.
  • Format Cloud Raster FormatLe format en sortie est CRF.
  • Format Meta Raster FormatLe format en sortie est MRF.
  • Format NetCDFLe format en sortie est NetCDF.
  • Format ZarrLe format en sortie est Zarr.
String
Appliquer la transformation
(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 dans l’entrée, telle qu’un fichier de géoréférencement ou une fonction géométrique.

  • Désactivé : aucune transformation associée n’est appliquée à la sortie.
  • Activé : toute transformation associée est appliquée à la sortie.

  • Ne pas appliquer la transformationAucune transformation associée n’est appliquée à la sortie.
  • Appliquer la transformationToute transformation associée est appliquée à la sortie
Boolean
Traiter comme multidimensionnel
(Facultatif)

Spécifie si le jeu de données mosaïque sera traité comme un jeu de données raster multidimensionnelles.

  • Désactivé : l’entrée ne sera pas traitée comme un jeu de données raster multidimensionnelles. Si l’entrée est multidimensionnelle, seule la tranche actuellement affichée sera traitée. Il s’agit de l’option par défaut.
  • Activé : l’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. Définissez le paramètre Format sur Cloud raster format pour utiliser cette option.
Boolean
Créer une transposition multidimensionnelle
(Facultatif)

Indique si la transposition pour le jeu de données raster multidimensionnelles est générée afin d’optimiser l’accès aux données. La transposition divise les données multidimensionnelles le long de chaque dimension de façon à optimiser les performances lors de l’accès aux valeurs de pixel dans toutes les tranches.

  • Désactivé : aucune transposition n’est générée. Il s’agit de l’option par défaut.
  • Activé : le jeu de données raster multidimensionnelles en entrée est transposé. Le paramètre Process As Multidimensional (Traiter comme multidimensionnel) doit être activé pour que cette option soit utilisée.
Boolean

arcpy.management.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})
NomExplicationType de données
in_raster

Jeu de données raster ou jeu de données mosaïque à copier.

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

Nom et format du jeu de données raster qui est créé.

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

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 format JPEG, JPEG 2000 ou TIFF, ou dans une géodatabase, vous pouvez spécifier un type de compression et une qualité de compression.

Raster Dataset
config_keyword
(Facultatif)

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 de 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 celle du paramètre Valeur NoData pour que la valeur d’arrière-plan soit ignorée. Les rasters de géodatabase et d’entreprise fonctionneront 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)

Indique 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, ce qui entraîne un affichage de qualité médiocre. 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 n’est effectuée. Il s’agit de l’option par défaut.
  • OneBitTo8BitLe raster en entrée sera converti.
Boolean
colormap_to_RGB
(Facultatif)

Indique si le jeu de données raster en entrée est converti en jeu de données raster en sortie à trois bandes lorsque le jeu de données raster en entrée inclut une palette de couleurs. 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)

Spécifie la profondeur de bits ou la résolution radiométrique à utiliser pour le jeu de données raster ou le jeu de données mosaïque. Si ce paramètre n’est pas défini, la valeur issue du premier jeu de données raster est utilisée.

  • 1_BITLe type de pixel sera un entier non signé 1 bit. Les valeurs peuvent être 0 ou 1.
  • 2_BITLe type de pixel sera un entier non signé 2 bits. Les valeurs prises en charge s’échelonnent de 0 à 3.
  • 4_BITLe type de pixel sera un entier non signé 4 bits. Les valeurs prises en charge s’échelonnent de 0 à 15.
  • 8_BIT_UNSIGNEDLe type de pixel sera un type de données 8 bits non signé. Les valeurs prises en charge s’échelonnent de 0 à 255.
  • 8_BIT_SIGNEDLe type de pixel sera un type de données 8 bits signé. Les valeurs prises en charge s’échelonnent de -128 à 127.
  • 16_BIT_UNSIGNEDLe type de pixel sera un type de données 16 bits non signé. Les valeurs s’échelonnent de 0 à 65 535.
  • 16_BIT_SIGNEDLe type de pixel sera un type de données 16 bits signé. Les valeurs s’échelonnent de -32 768 à 32 767.
  • 32_BIT_UNSIGNEDLe type de pixel sera un type de données 32 bits non signé. Les valeurs s’échelonnent de 0 à 4 294 967 295.
  • 32_BIT_SIGNEDLe type de pixel sera un type de données 32 bits signé. Les valeurs s’échelonnent de -2 147 483 648 à 2 147 483 647.
  • 32_BIT_FLOATLe type de pixel sera un type de données 32 bits prenant en charge les décimales.
  • 64_BITLe type de pixel sera un type de données 64 bits prenant en charge les décimales.
String
scale_pixel_value
(Facultatif)

Spécifie si les valeurs de pixel sont mises à l’échelle. Lorsque la sortie est un type de pixel différent de celui de l’entrée (par exemple, de 16 bits à 8 bits), vous pouvez mettre les valeurs à l’échelle afin de les adapter à la nouvelle plage. Dans le cas contraire, les valeurs qui ne correspondent pas à 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 pixel restent identiques et ne sont pas mises à l’échelle. Toute valeur ne se trouvant pas dans la plage de valeurs est ignorée. Il s’agit de l’option par défaut.
  • ScalePixelValueLes valeurs de pixel sont mises à l’échelle selon le nouveau type de pixel. Lorsque vous mettez à l’échelle l’espace par pixel, le raster s’affiche de la même façon, mais les valeurs sont mises à l’échelle selon la nouvelle profondeur de bits spécifiée.
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 monobande 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 satellites ou aériennes, ni pour les données raster thématiques.

  • NONELe jeu de données raster RVB n’est pas converti.
  • RGBToColormapLe jeu de données raser RVB est converti en palette de couleurs.
Boolean
format
(Facultatif)

Indique le format raster en sortie.

  • TIFFLe format en sortie est TIFF.
  • COGLe format en sortie est Cloud Optimized GeoTIFF.
  • IMAGINE ImageLe format en sortie est ERDAS IMAGINE.
  • BMPLe format en sortie est BMP.
  • GIFLe format en sortie est GIF.
  • PNGLe format en sortie est PNG.
  • JPEGLe format en sortie est JPEG.
  • JP2Le format en sortie est JPEG 2000.
  • GRIDLe format en sortie est Esri Grid.
  • BILLe format en sortie est Esri BIL.
  • BSQLe format en sortie est Esri BSQ.
  • BIPLe format en sortie est Esri BIP.
  • ENVILe format en sortie est ENVI DAT.
  • CRFLe format en sortie est CRF.
  • MRFLe format en sortie est MRF.
  • NetCDFLe format en sortie est NetCDF.
  • ZARRLe format en sortie est Zarr.
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 dans l’entrée, telle qu’un fichier de géoréférencement ou une fonction géométrique.

  • NONEAucune transformation associée n’est appliquée à la sortie.
  • TransformToute transformation associée est appliquée à la sortie
Boolean
process_as_multidimensional
(Facultatif)

Spécifie si le jeu de données mosaïque sera 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 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. Définissez le paramètre format sur CRF pour utiliser cette option.
Boolean
build_multidimensional_transpose
(Facultatif)

Indique si la transposition pour le jeu de données raster multidimensionnelles est générée, ce qui divise les données le long de chaque dimension de façon à optimiser les performances lors de l’accès aux valeurs de pixel dans toutes les tranches.

  • NO_TRANSPOSEAucune transposition n’est générée. Il s’agit de l’option par défaut.
  • TRANSPOSELe jeu de données raster multidimensionnelles en entrée est transposé. Le paramètre process_as_multidimensional doit être défini sur ALL_SLICES pour utiliser cette option.
Boolean

Exemple de code

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

Il s’agit d’un exemple Python d’utilisation de la fonction 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.management.CopyRaster('SeaSurfaceTemp.nc',"https://s3.amazonaws.com/S3Storage/seasurfacetemp","","","","","","","","", format = "CRF",'NONE',process_as_multidimensional = 'ALL_SLICES', build_multidimensional_transpose='TRANSPOSE')
    
    ##Copy 1 BIT 
    arcpy.management.CopyRaster("1bit.tif","SDE94.sde\\bit8","DEFAULTS","","","OneBitTo8Bit","","")
    
    ##Copy File RasterDataset to GDB Dataset with Background and Nodata setting
    arcpy.management.CopyRaster("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 la fonction CopyRaster (script autonome)

Il s’agit d’un exemple de script Python d’utilisation de la fonction 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.management.CopyRaster(
	"SeaSurfaceTemp.nc", "SST_Transpose.crf","","",-3.402823e+38,"NONE","NONE","","NONE","NONE", "CRF", "NONE", "ALL_SLICES", "TRANSPOSE")

Rubriques connexes