Résumé
Divise un jeu de données raster en parties de plus petites tailles, par tuiles ou entités d'un polygone.
Utilisation
Les fichiers en sortie partagent la plupart des propriétés du raster source en entrée, comme la référence spatiale, le type de source, le type de pixel, l'espace par pixel et la taille de cellule.
La méthode de tuilage identifie les paramètres facultatifs qui sont utilisés pour déterminer les dimensions et l'emplacement des tuiles en sortie. Dans les deux cas, les valeurs NoData permettent de remplir les tuiles sans données source correspondantes. Le format de données dépend des limites des spécifications du format et du type de données de l'image source. Les combinaisons non valides génèrent un message d'erreur approprié.
Si une tuile existe déjà (si un fichier portant le même nom existe), elle n'est pas remplacée.
Si une tuile contient uniquement des valeurs de pixels NoData, elle n'est pas créée.
Syntaxe
arcpy.management.SplitRaster(in_raster, out_folder, out_base_name, split_method, format, {resampling_type}, {num_rasters}, {tile_size}, {overlap}, {units}, {cell_size}, {origin}, {split_polygon_feature_class}, {clip_type}, {template_extent}, {nodata_value})| Paramètre | Explication | Type de données |
in_raster | Raster à fractionner. | Mosaic Dataset; Mosaic Layer; Raster Layer |
out_folder | Destination des nouveaux jeu de données raster. | Folder |
out_base_name | Préfixe de chacun des jeux de données raster que vous allez créer. Un nombre sera ajouté à chaque préfixe, à partir de 0. | String |
split_method | Détermine le mode de fractionnement du jeu de données raster.
| String |
format | Format pour les jeux de données raster en sortie.
| String |
resampling_type (Facultatif) | Choisissez une technique appropriée en fonction du type de données.
| String |
num_rasters (Facultatif) | Nombre de colonnes (x) et de lignes (y) dans lesquelles fractionner le jeu de données raster. Il s'agit d'un point dont les coordonnées X et Y définissent le nombre de lignes et de colonnes. La coordonnée X correspond au nombre de colonnes et la coordonnée Y correspond au nombre de lignes. | Point |
tile_size (Facultatif) | Dimensions x et y des tuiles en sortie. L'unité de mesure par défaut est en pixels. Vous pouvez modifier cette unité à l'aide du paramètre units. Il s'agit d'un point dont les coordonnées X et Y définissent les dimensions des tuiles en sortie. La coordonnée X correspond à la dimension horizontale de la sortie et la coordonnée Y correspond à la dimension verticale de la sortie. | Point |
overlap (Facultatif) | Il n'est pas nécessaire d'aligner les tuiles parfaitement. Définissez le degré de superposition entre les tuiles à l'aide de ce paramètre. L'unité de mesure par défaut est en pixels. Vous pouvez modifier cette unité à l'aide du paramètre units. | Double |
units (Facultatif) | Définissez les unités de mesure des paramètres tile_size et overlap.
| String |
cell_size (Facultatif) | Résolution spatiale du raster en sortie. Si cette valeur n'est pas renseignée, la taille de cellule en sortie correspond au raster en entrée. Lorsque vous modifiez les valeurs de taille de cellule, la taille de tuile est réinitialisée sur la taille d'image et le nombre de tuiles est réinitialisé sur 1. | Point |
origin (Facultatif) | Modifiez les coordonnées du point d'origine dans l'angle inférieur gauche, où la structure de tuile va commencer. Si cette valeur n'est pas renseignée, l'origine dans l'angle inférieur gauche est identique au raster en entrée. | Point |
split_polygon_feature_class (Facultatif) | Classe d'entités qui servira à fractionner le jeu de données raster. | Feature Layer |
clip_type (Facultatif) | Limite l'étendue de votre jeu de données raster avant son fractionnement.
| String |
template_extent (Facultatif) | Etendue ou jeu de données utilisés pour définir la limite de découpage. Le jeu de données peut être un raster ou une classe d'entités. | Extent |
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 |
Sortie dérivée
| Nom | Explication | Type de données |
| derived_out_folder | Dossier en sortie. | Dossier |
Exemple de code
Exemple 1 d'utilisation de l'outil SplitRaster (fenêtre Python)
Il s’agit d'un exemple Python d'utilisation de l'outil SplitRaster.
import arcpy
arcpy.SplitRaster_management("c:/source/large.tif", "c:/output/splitras",
"ras", "NUMBER_OF_TILES", "TIFF", "NEAREST",
"2 2", "#", "10", "PIXELS", "#", "#")
Exemple 2 d'utilisation de l'outil SplitRaster (script autonome)
Il s’agit d'un exemple de script Python d'utilisation de l'outil SplitRaster.
##====================================
##Split Raster
##Usage: SplitRaster_management in_raster out_folder out_base_name SIZE_OF_TILE
## | NUMBER_OF_TILES | TIFF | BMP | ENVI | ESRI BIL |
## ESRI BIP | ESRI BSQ | GIF | GRID | IMAGINE IMAGE |
## JP2 | JPG | PNG {NEAREST | BILINEAR | CUBIC |
## MAJORITY} {num_rasters} {tile_size} {overlap}
## {PIXELS | METERS | FEET | DEGREES | KILOMETERS |
## MILES} {cell_size} {origin}
import arcpy
arcpy.env.workspace = r"\\myServer\PrjWorkspace\RasGP"
##Equally split a large TIFF image by number of images
arcpy.SplitRaster_management("large.tif", "splitras", "number", "NUMBER_OF_TILES",\
"TIFF", "NEAREST", "2 2", "#", "4", "PIXELS",\
"#", "#")
##Equally split a large TIFF image by size of images
arcpy.SplitRaster_management("large.tif", "splitras", "size2", "SIZE_OF_TILE",\
"TIFF", "BILINEAR", "#", "3500 3500", "4", "PIXELS",\
"#", "-50 60")
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui