概要
ラスター データセットを、ラスター データを表すバイナリ浮動小数点数値のファイルに変換します。
使用法
有効な任意のラスター データセットを入力ラスター データセットとして指定できます。
出力として生成されるファイルは、*.flt 拡張子の付いた IEEE 浮動小数点形式の 32 ビット符号付きバイナリ ファイルと *.hdr 拡張子の付いた ASCII ヘッダー ファイルの 2 つです。両方に同じ出力浮動小数点ラスター ファイル名が使用されます。
ASCII ファイルは、一連のキーワードを含むヘッダー情報から構成されます。
通常、ファイルの形式は以下のとおりです。
NCOLS xxx NROWS xxx XLLCORNER xxx YLLCORNER xxx CELLSIZE xxx NODATA_VALUE xxx BYTEORDER <MSBFIRST | LSBFIRST>
キーワードの定義は以下のとおりです。
NCOLS と NROWS は、バイナリ ファイルによって定義されるラスターのカラムの数とロウの数です。
XLLCORNER と YLLCORNER は左下側セルの左下隅の座標です。
XLLCENTER と YLLCENTER の使用は、[ラスター → 浮動小数点ファイル (.flt) (Raster to Float)] ではサポートされていません。
CELLSIZE はラスターのセル サイズです。
NODATA_VALUE は NoData セルを表す値です。
BYTEORDER は、バイナリ ファイルが生成されたシステム上にマルチバイトのバイナリ数値がどのような状態で格納されているかを表します。Intel CPU ベースのシステムでは、バイト オーダーは LSBFIRST(リトル エンディアンとも呼ばれる) になります。その他の大部分のアーキテクチャ (Alpha を除くほとんどの UNIX システム、Motorola CPU 搭載の旧モデルの Macintosh) では、バイト オーダーは MSBFIRST(ビッグ エンディアンとも呼ばれる) になります。
NODATA_VALUE は出力ファイル内の値で、NoData を含む入力ラスター内のセルに割り当てられます。この値は、通常、true の値が不明であるセル用に予約されています。
デフォルトでは入力ラスター内の NoData 値は、出力浮動小数点ファイル内で -9999 の値を取ります。NoData を別の値で表したい場合、下記のような手順を適用できます。
- 元のラスターに対して ArcGIS Spatial Analyst エクステンション の [IsNull] ツールを実行します。出力は、バイナリ値 (1 は元のラスター側の NoData に対応し、0 は他の任意の値) のラスターです。
- ArcGIS Spatial Analyst エクステンション の [Con] ツールを実行します。その際、[IsNull] の結果を [入力条件ラスター] として指定し、NoData 値に割り当てる新しい値を [条件式が TRUE のときの入力ラスター] 値として指定し、元のラスターを [条件式が FALSE のときの入力ラスター] ラスターとして指定し、条件の [式] に「value = 1」を指定します。
- [ラスター → 浮動小数点ファイル (.flt) (Raster to Float)] を使用して、[Con] 出力ラスターを浮動小数点バイナリ ファイルに変換します。
- ASCII ヘッダー ファイル内の NODATA_VALUE の値を、NoData が変換された後の値に変更します。
このツールは、原点を左下側セルの左下隅としてのみ書き込みます。[ラスターのコピー (Copy Raster)] ツールでは、原点が左下側セルの中心としてもサポートされています。
構文
arcpy.conversion.RasterToFloat(in_raster, out_float_file)
パラメーター | 説明 | データ タイプ |
in_raster | 入力ラスター データセット。 ラスターは、整数タイプまたは浮動小数点タイプのいずれかになります。 | Raster Layer |
out_float_file | 出力の浮動小数点ラスター ファイル。 ファイル名には *.flt 拡張子を付ける必要があります。 | File |
コードのサンプル
ラスター データセットを、ラスター データを表すバイナリ浮動小数点数値のファイルに変換します。
import arcpy
from arcpy import env
env.workspace = "C:/data"
inRaster = "elevation"
outFloat = "c:/output/elevation.flt"
arcpy.RasterToFloat_conversion("elevation", "c:/output/elevation.flt")
ラスター データセットを、ラスター データを表すバイナリ浮動小数点数値のファイルに変換します。
# 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
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inRaster = "elevation"
outFloat = "c:/output/elevation.flt"
# Execute RasterToFloat
arcpy.RasterToFloat_conversion(inRaster, outFloat)
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい