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
-
Lorsque vous créez un jeu de données raster, vous créez un emplacement vide pour contenir un seul jeu de données raster. Vous pouvez ensuite mosaïquer ou charger des jeux de données raster dans cet emplacement.
-
Vous pouvez enregistrer votre sortie au format BIL, BIP, BMP, BSQ, DAT, GIF, GRID, IMG, JPEG, JPEG 2000, PNG, TIFF ou en tant que jeu de données raster de géodatabase.
-
Lorsque vous enregistrez un jeu de données raster dans un fichier JPEG ou JPEG 2000, ou dans une géodatabase, vous pouvez spécifier un type de Compression et une Qualité de compression dans les paramètres d'environnement.
-
Le format GIF prend uniquement en charge des jeux de données raster monocanaux.
-
La création de pyramides améliore les performances d'affichage des jeux de données raster.
-
Le calcul des statistiques permet aux applications ArcGIS d'étirer et de symboliser correctement des données raster pour l'affichage.
Syntaxe
| Paramètre | Explication | Type 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 :
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.
| 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.
Le type de compression pyramidale définit la méthode utilisée lors de la compression des pyramides.
| 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.
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
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", "")
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()