Récapitulatif
Crée un jeu de données raster vide
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, Grid Esri, GIF, 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 pyramids 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 les données raster à afficher.
Syntaxe
CreateRasterDataset_management (out_path, out_name, {cellsize}, pixel_type, {raster_spatial_reference}, number_of_bands, {config_keyword}, {pyramids}, {tile_size}, {compression}, {compression}, {pyramid_origin})| Paramètre | Explication | Type de données |
out_path | Emplacement en sortie devant stocker le jeu de données raster. | Workspace; Raster Catalog |
out_name | Nom, emplacement et format du jeu de données que vous créez. 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, n'ajoutez pas d'extension de fichier au nom du jeu de données raster. Lorsque vous enregistrez un jeu de données raster dans un fichier JPEG ou JPEG 2000, dans un fichier TIFF ou dans une géodatabase, vous pouvez spécifier un type de compression et une Qualité de compression dans les paramètres d'environnement. | String |
cellsize (Facultatif) | Taille de cellule du nouveau jeu de données raster. | Double |
pixel_type | Profondeur des couleurs (résolution radiométrique) du jeu de données raster en sortie. S'il n'est pas défini, votre jeu de données raster est créé avec le type de pixel par défaut 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 en sortie. 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 | Nombre de canaux que va détenir le jeu de données raster en sortie. | Long |
config_keyword (Facultatif) | Spécifie les paramètres de stockage (configuration) d'une géodatabase fichier ou d'entreprise. Les mots-clés de configuration 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 technique de rééchantillonnage de pyramide définit la façon dont les données seront rééchantillonnés lors de la génération des 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 et les géodatabases d'entreprise utilisent une taille de tuile. | Tile Size |
compression (Facultatif) | Définissez le type de compression pour stocker le jeu de données raster.
| String |
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 recommandé de spécifier ce point si vous envisagez de créer de grandes mosaïques dans une géodatabase fichier ou une géodatabase d'entreprise, 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 à l'angle supérieur gauche de votre jeu de données raster. Si vous définissez ce point pour une géodatabase fichier ou une géodatabase d'entreprise, 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 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. Toutefois, 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}
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")
Environnements
Informations de licence
- ArcGIS for Desktop Basic: Oui
- ArcGIS for Desktop Standard: Oui
- ArcGIS for Desktop Advanced: Oui