Créer un jeu de données raster (Gestion des données)

Récapitulatif

Crée un jeu de données raster sous forme de fichier ou dans une géodatabase.

Utilisation

Syntaxe

CreateRasterDataset_management (out_path, out_name, {cellsize}, {pixel_type}, {raster_spatial_reference}, {number_of_bands}, {config_keyword}, {pyramids}, {tile_size}, {compression}, {pyramid_origin})
ParamètreExplicationType de données
out_path

Emplacement en sortie devant contenir le jeu de données raster.

Workspace; Raster Catalog
out_name

Nom du jeu de données raster à créer.

Pour enregistrer le jeu de données raster dans un format de fichier, vous devez spécifier une extension de fichier :

  • .bil—ESRI BIL
  • .bip—ESRI BIP
  • .bmp—BMP
  • .bsq—ESRI BSQ
  • .dat—ENVI DAT
  • .gif—GIF
  • .img—Fichier ERDAS IMAGINE
  • .jpg—JPEG
  • .jp2—JPEG 2000
  • .png—PNG
  • .tif—TIFF
  • Aucune extension—ESRI GRID

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.

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

String
cellsize
(Facultatif)

Taille de cellule du nouveau jeu de données raster.

Double
pixel_type
(Facultatif)

Spécifie le type de données des valeurs de cellules. La valeur par défaut est un entier non signé 8 bits.

Tous les types de données ne sont pas pris en charge par tous les formats raster. Reportez-vous à la rubrique Formats de fichiers de jeux de données raster pris en charge dans l'aide pour vérifier que le format utilisé prend en charge le type de données dont vous avez besoin.

  • 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
raster_spatial_reference
(Facultatif)

Système de coordonnées du jeu de données raster.

S'il n'est pas défini, le système de coordonnées spécifié dans les paramètres d'environnement est utilisé.

Coordinate system
number_of_bands
(Facultatif)

Nombre de bandes que contiendra le jeu de données raster.

Long
config_keyword
(Facultatif)

Spécifie les paramètres de stockage (configuration) pour une géodatabase fichier et une géodatabase ArcSDE. Les géodatabases personnelles n'utilisent pas les mots-clés de configuration.

Les mots-clés de configuration ArcSDE sont définis par l'administrateur de la base de données.

String
pyramids
(Facultatif)

Utilisez cette option pour créer des pyramides.

Pour les niveaux de pyramide, sélectionnez une valeur égale ou supérieure à -1. Une valeur de 0 ne crée aucune pyramide et une valeur de -1 sélectionne automatiquement le nombre correct de couches pyramidales à créer.

La méthode de ré-échantillonnage des pyramides définit le mode de ré-échantillonnage des données lors de la génération de pyramides.

  • NEAREST : la méthode du voisin le plus proche doit être adoptée pour traiter les jeux de données nominales ou raster avec palettes de couleurs, telles que l'utilisation du sol ou des images en pseudo-couleurs.
  • BILINEAR : la méthode d'interpolation bilinéaire est recommandée pour traiter les données continues, telles que les images satellite ou les photographies aériennes.
  • CUBIC : la convolution cubique est recommandée pour traiter les données continues, telles que les images satellite ou les photographies aériennes. Cette méthode est semblable à l'interpolation bilinéaire, à la différence qu'elle ré-échantillonne les données à l'aide d'une matrice plus grande.

Le type de compression pyramidale définit la méthode utilisée lors de la compression des pyramides.

  • DEFAULT : cette méthode applique la compression utilisée généralement par le format du jeu de données raster.
  • LZ77 : compression sans perte. Les valeurs des cellules du raster ne sont pas modifiées.
  • JPEG : compression avec perte.
  • NONE : aucune compression de données.
Pyramid
tile_size
(Facultatif)

La largeur de tuile contrôle le nombre de pixels que vous pouvez stocker dans chaque tuile. Elle est exprimée en nombre de pixels en x. Par défaut, la largeur de tuile est 128.

La hauteur de tuile contrôle le nombre de pixels que vous pouvez stocker dans chaque tuile. Elle est exprimée en nombre de pixels en y. Par défaut, la hauteur de tuile est 128.

Seules les géodatabases fichier et les géodatabases ArcSDE utilisent une taille de tuile.

Tile Size
compression
(Facultatif)

Définit la méthode de compression de données utilisée pour stocker le jeu de données raster.

  • LZ77Sans perte.
  • JPEGAvec perte. Utilise la qualité de compression.
  • JPEG 2000Avec perte. Utilise la qualité de compression.
  • PackBitsSans perte. Uniquement pour le format TIFF.
  • LZWSans perte.
  • RLESans perte.
  • CCITT GROUPE 3Sans perte. Uniquement pour le format TIFF.
  • CCITT GROUPE 4Sans perte. Uniquement pour le format TIFF.
  • CCITT (1D)Sans perte. Uniquement pour le format TIFF.
  • NONEAucune compression de données.

La qualité de compression JPEG et JPEG 2000 peut s'échelonner de 1 à 100. Une valeur supérieure permet d'obtenir une meilleure qualité d'image, mais une compression moindre.

Compression
pyramid_origin
(Facultatif)

Il s'agit de l'emplacement d'origine de la pyramide raster. Il est conseillé de spécifier ce point si vous envisagez de créer de grandes mosaïques dans une géodatabase fichier ou ArcSDE, notamment si vous avez l'intention de procéder à un mosaïquage à l'avenir (pour une mise à jour, par exemple).

Le point de référence de la pyramide doit être défini sur l'angle supérieur gauche de votre jeu de données raster.

Si vous définissez ce point pour une géodatabase fichier ou ArcSDE, les structures pyramidales partielles seront utilisées lors de la mise à jour avec un nouveau jeu de données raster mosaïqué. La structure pyramidale partielle met à jour les parties de la pyramide qui n'existent pas en raison des nouveaux jeux de données raster mosaïqués. Par conséquent, il est judicieux de définir votre point de référence de pyramide de sorte que la mosaïque raster entière se trouve en dessous et à droite de ce point. Notez toutefois que le point de référence de la pyramide ne doit pas être défini avec une valeur trop élevée.

Point

Exemple de code

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

Ceci est un exemple Python d'utilisation de l'outil CreateRasterDataset.

import arcpy
arcpy.CreateRasterDataset_management("c:/data", "EmptyTIFF.tif", "2",
                                     "8_BIT_UNSIGNED", "World_Mercator.prj",
                                     "3", "", "PYRAMIDS -1 NEAREST JPEG",
                                     "128 128", "NONE", "")
Exemple 2 d'utilisation de l'outil CreateRasterDataset (script autonome)

Ceci est un exemple de script Python d'utilisation de l'outil CreateRasterDataset.

##==================================
##Create Raster Dataset
##Usage: CreateRasterDataset_management out_path out_name {cellsize} 8_BIT_UNSIGNED | 1_BIT | 2_BIT | 4_BIT | 8_BIT_SIGNED 
##                                      | 16_BIT_UNSIGNED | 16_BIT_SIGNED | 32_BIT_UNSIGNED | 32_BIT_SIGNED | 32_BIT_FLOAT 
##                                      | 64_BIT {raster_spatial_reference} number_of_bands {config_keyword} {pyramids} {tile_size} 
##                                      {compression} {pyramid_origin}
try:
    import arcpy
    arcpy.env.workspace = r"\\workspace\PrjWorkspace\RasGP"
    ##Create a empty TIFF format Raster Dataset with the following parameters
    ##Cellsize: 2
    ##Pixel type: 8 Bit Unsigned Integer
    ##Number of Bands: 3
    ##Pyramid: Build full pyramids with NEAREST interpolation and JPEG compression
    ##Compression: NONE
    ##Projection: World_Mercator
    ##Tile size: 128 128
    arcpy.CreateRasterDataset_management("CreateRD","EmptyTIFF.tif","2","8_BIT_UNSIGNED","World_Mercator.prj", "3", "", "PYRAMIDS -1 NEAREST JPEG", "128 128", "NONE", "")
    
    ##Create a SDE Raster Dataset
    ##No Spatial Reference, with Pyramid Origin
    arcpy.CreateRasterDataset_management("CreateRD\\CreateRD.gdb","NewRD","10","16_BIT_UNSIGNED","", "1", "MAX_FILE_SIZE_4GB", "PYRAMIDS 3 BILINEAR DEFAULT", "128 128", "JPEG2000 80", "-20037508.34278775 30198185.16987658")
except:
    print "Create Raster Dataset example failed."
    print arcpy.GetMessages()

Environnements

Rubriques connexes


7/10/2012