Raster vers ASCII (Conversion)

Synthèse

Convertit un jeu de données raster en un fichier ASCII représentant des données raster.

Utilisation

  • Le jeu de données raster en entrée peut correspondre à tout jeu de données raster.

  • La structure du fichier ASCII se compose d'informations d'en-tête contenant un ensemble de mots-clés, suivies de valeurs de cellules classées par ordre d'importance des lignes.

    En règle générale, le format du fichier est le suivant :

        NCOLS xxx
        NROWS xxx
        XLLCORNER xxx
        YLLCORNER xxx
        CELLSIZE xxx
        NODATA_VALUE xxx
        row 1
        row 2
        .
        .
        row n

    Les définitions des mots-clés sont les suivantes :

    • NCOLS et NROWS correspondent au nombre de colonnes et de lignes dans le raster défini par le fichier ASCII.

    • XLLCORNER et YLLCORNER sont les coordonnées du coin inférieur gauche de la cellule inférieure gauche.

    • CELLSIZE est la taille de cellule du raster.

    • NODATA_VALUE est la valeur qui doit représenter les cellules NoData.

    • Dans le flux de données des valeurs de cellules, la ligne 1 des données se trouve au sommet du raster, la ligne 2 au-dessous de la ligne 1, et ainsi de suite.

  • Voici un exemple de fichier raster ASCII :

        NCOLS 480
        NROWS 450
        XLLCORNER 378922
        YLLCORNER 4072345
        CELLSIZE 30
        NODATA_VALUE -32768
        43 2 45 7 3 56 2 5 23 65 34 6 32 54 57 34
        35 45 65 34 2 6 78 4 2 6 89 3 2 7 45 23 5 ...

    Dans l’exemple ci-dessus, la valeur NODATA_VALUE du fichier ASCII sert à représenter les cellules NoData qui se trouvent dans le raster en entrée. Normalement, cette valeur est réservée aux cellules dont la valeur vraie est inconnue.

  • La fin de chaque ligne de données provenant du raster se termine par un caractère de retour chariot dans le fichier.

  • Les rasters à virgule flottante et les rasters d’entiers peuvent être convertis en fichiers raster ASCII.

  • Cet outil enregistre l’origine uniquement par les coordonnées du coin inférieur gauche de la cellule inférieure gauche. L’outil Copier un raster identifie également l’origine comme le centre de la cellule inférieure gauche.

  • Avec ArcGIS AllSource 3.2 et version ultérieure, la sortie par défaut de l’outil est un fichier ASCII portant une extension .asc, et non une extension .txt. Il est recommandé de renommer les fichiers ASCII existants portant une extension .txt avec l’extension .asc.

Paramètres

ÉtiquetteExplicationType de données
Raster en entrée

Jeu de données raster en entrée.

Le raster peut être de type entier ou à virgule flottante.

Raster Layer
Fichier raster ASCII en sortie

Fichier raster ASCII en sortie.

File

arcpy.conversion.RasterToASCII(in_raster, out_ascii_file)
NomExplicationType de données
in_raster

Jeu de données raster en entrée.

Le raster peut être de type entier ou à virgule flottante.

Raster Layer
out_ascii_file

Fichier raster ASCII en sortie.

File

Exemple de code

Exemple 1 d’utilisation de l’outil RasterToASCII (fenêtre Python)

Convertit un jeu de données raster en un fichier ASCII représentant des données raster.

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.conversion.RasterToASCII("elevation", "c:/output/sa500.asc")
Exemple 2 d’utilisation de la fonction RasterToASCII (script autonome)

Convertit un jeu de données raster en un fichier ASCII représentant des données raster.

# Name: RasterToASCII_Ex_02.py
# Description: Converts a raster dataset to an ASCII file representing 
#    raster data. 
# Requirements: None

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set local variables
inRaster = "elevation"
outASCII = "c:/output/elevation.asc"

# Run RasterToASCII
arcpy.conversion.RasterToASCII(inRaster, outASCII)

Rubriques connexes