ASCII vers raster (Conversion)

Synthèse

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

Héritage :

Il s’agit d’un outil obsolète. L’outil Copier un raster peut à présent être utilisé pour convertir un fichier ASCII représentant des données raster en un jeu de données raster.

Si vous utilisez la zone de texte du bouton Browse (Parcourir) dans l’outil Copy Raster (Copier un raster) et que le fichier en entrée ne possède pas d’extension .asc, vous pouvez renommer le fichier pour inclure cette extension ou modifier le filtre de la boîte de dialogue Input Raster (Raster en entrée) de All Supported Types (Tous les types pris en charge) en Files (Fichiers). L’option recommandée consiste à renommer le fichier.

Utilisation

• Le fichier en entrée correspond à un fichier texte au format ASCII.

• 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.

  Il existe deux variantes à la structure du fichier ASCII. L'une identifie l'origine par les coordonnées de l'angle inférieur gauche de la cellule inférieure gauche, l'autre comme le centre de la cellule inférieure gauche.

  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.

    Vous pouvez également utiliser XLLCENTER et YLLCENTER pour spécifier l’origine par les coordonnées du centre 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.

  • Les valeurs de cellule doivent être délimitées par des espaces. Aucun retour chariot n'est nécessaire à la fin de chaque ligne du fichier ASCII. Le nombre de colonnes dans l'en-tête permet de déterminer à quel moment une nouvelle ligne commence.

• 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 ...

• La valeur NODATA_VALUE correspond à la valeur du fichier ASCII qui sera affectée aux cellules NoData dans le raster en sortie. Cette valeur est généralement réservée aux cellules dont les valeurs vraies sont inconnues. Lorsque le raster en sortie est créé, une valeur NoData générée par le système est utilisée à la place de NODATA_VALUE.

• Le nombre de valeurs de cellule contenues dans le fichier doit être égal au nombre de lignes multiplié par le nombre de colonnes, faute de quoi le système renvoie une erreur.

• Il est possible d'avoir un réel simple ou un entier comme type de données en sortie.

• Une fois le raster en sortie créé, utilisez l’outil Définir une projection pour lui attribuer le système de coordonnées approprié.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Fichier raster ASCII en entrée	Fichier ASCII en entrée à convertir.	File
Raster en sortie	Jeu de données raster en sortie à créer. Si le raster en sortie n’est pas enregistré dans une géodatabase, indiquez l’extension .tif pour un format de fichier TIFF, .CRF pour un format de fichier CRF, .img pour un format de fichier ERDAS IMAGINE, ou aucune extension pour un format de raster Carroyage Esri.	Raster Dataset
Type de données en sortie (Facultatif)	Spécifie le type de données du jeu de données raster en sortie. Entier—Un jeu de données raster de type entier est créé. Flottant—Un jeu de données raster de type flottant est créé.	String

Python

arcpy.conversion.ASCIIToRaster(in_ascii_file, out_raster, {data_type})

Nom	Explication	Type de données
in_ascii_file	Fichier ASCII en entrée à convertir.	File
out_raster	Jeu de données raster en sortie à créer. Si le raster en sortie n’est pas enregistré dans une géodatabase, indiquez l’extension .tif pour un format de fichier TIFF, .CRF pour un format de fichier CRF, .img pour un format de fichier ERDAS IMAGINE, ou aucune extension pour un format de raster Carroyage Esri.	Raster Dataset
data_type (Facultatif)	Spécifie le type de données du jeu de données raster en sortie. INTEGER—Un jeu de données raster de type entier est créé. FLOAT—Un jeu de données raster de type flottant est créé.	String

Exemple de code

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

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

import arcpy
arcpy.conversion.ASCIIToRaster("c:/data/elevation.asc", "c:/output/elevation", 
                               "INTEGER")

Exemple 2 d'utilisation de l'outil ASCCIToRaster (script autonome)

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

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

# Import system modules
import arcpy

# Set local variables
inASCII = "c:/data/elevation.asc"
outRaster = "c:/output/elevation02"
rasterType = "INTEGER"

# Run ASCIIToRaster
arcpy.conversion.ASCIIToRaster(inASCII, outRaster, rasterType)

Environnements

Validation automatique, Compression, Espace de travail courant, Mot-clé CONFIG en sortie, Pyramide, Statistiques raster, Espace de travail temporaire, Taille de tuile

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui