Raster vers réels (Conversion)

Synthèse

Convertit un jeu de données raster en un fichier de valeurs binaires à virgule flottante représentant les données raster.

Utilisation

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

• Deux sorties sont créées : un fichier binaire de nombres à virgule flottante IEEE, 32 bits, avec une extension .flt et un fichier d’en-tête ASCII avec une extension .hdr. Ces deux fichiers utilisent le même nom de fichier raster de type flottant en sortie.

• Le fichier ASCII se compose d'informations d'en-tête contenant un ensemble de mots-clés.

  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
      BYTEORDER <MSBFIRST | LSBFIRST>

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

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

    L’utilisation de XLLCENTER et de YLLCENTER n’est pas prise en charge par l’outil Raster vers réels.

  • CELLSIZE est la taille de cellule du raster.

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

  • BYTEORDER représente la manière dont les nombres binaires à plusieurs octets sont stockés sur le système où le fichier binaire a été généré. Sur les systèmes dotés de processeurs Intel, l’ordre des octets est LSBFIRST (également connu sous le nom Little Endian ou primauté des octets de poids faible). Sur la plupart des autres architectures (la majorité des systèmes UNIX, à l’exception d’Alpha, et les Macintosh antérieurs avec processeurs Motorola), l’ordre des octets est MSBFIRST (également connu sous le nom de Big Endian ou primauté des octets de poids fort).

• La valeur NODATA_VALUE est la valeur du fichier en sortie attribuée à toutes les cellules NoData du raster en entrée. Normalement, cette valeur est réservée aux cellules dont la valeur vraie est inconnue.

• Par défaut, les valeurs NoData du raster en entrée sont égales à -9999 dans le fichier de type flottant en sortie. Pour utiliser une autre valeur pour représenter NoData, appliquez la procédure suivante :

  1. Exécutez l’outil IsNull de l’Extension ArcGIS Spatial Analyst sur le raster d’origine. Vous obtiendrez en sortie un raster de valeurs binaires, où 1 correspond à NoData sur le raster d'origine et 0 à toute autre valeur.
  2. Exécutez l’outil Con de l’Extension ArcGIS Spatial Analyst, en indiquant le résultat de la fonction IsNull comme la condition à vérifier dans le raster de condition en entrée (option Input Conditional Raster), la nouvelle valeur à attribuer aux cellules de valeur NoData pour lesquelles la condition est vraie en entrée (Input True), le raster d’origine comme raster faux en entrée (Input False) et une expression de condition de « valeur = 1 ».
  3. Convertissez le raster en sortie Con en un fichier binaire à virgule flottante avec l’outil Raster vers réels.
  4. Modifiez la valeur du paramètre NODATA_VALUE dans le fichier d’en-tête ASCII par la valeur obtenue après conversion de la valeur NoData.

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

Paramètres

Boîte de dialogue

Étiquette	Explication	Type 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 maillé de réels en sortie	Fichier maillé de réels en sortie. Le nom de fichier doit porter l'extension .flt.	File

Python

arcpy.conversion.RasterToFloat(in_raster, out_float_file)

Nom	Explication	Type 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_float_file	Fichier maillé de réels en sortie. Le nom de fichier doit porter l'extension .flt.	File

Exemple de code

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

Convertit un jeu de données raster en un fichier de valeurs binaires à virgule flottante représentant les données raster.

import arcpy
arcpy.env.workspace = "C:/data"
inRaster = "elevation"
outFloat = "c:/output/elevation.flt"
arcpy.conversion.RasterToFloat("elevation", "c:/output/elevation.flt")

Exemple 2 d’utilisation de la fonction RasterToFloat (script autonome)

Convertit un jeu de données raster en un fichier de valeurs binaires à virgule flottante représentant les données raster.

# Name: RasterToFloat_Ex_02.py
# Description: Converts a raster dataset to a file of binary floating-point
#     values representing raster data.
# Requirements: None

# Import system modules
import arcpy

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

# Set local variables
inRaster = "elevation"
outFloat = "c:/output/elevation.flt"

# Run RasterToFloat
arcpy.conversion.RasterToFloat(inRaster, outFloat)

Environnements

Validation automatique, Taille de cellule, Méthode de projection de la taille de cellule, Espace de travail courant, Étendue, Transformations géographiques, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Espace de travail temporaire