ラスター プロパティを設定 (Set Raster Properties) (データ管理)

サマリー

ラスターまたはモザイク データセットに対して、データ タイプ、統計情報、および NoData 値を設定します。

使用法

  • このツールを使用すると、ラスターまたはモザイク データセットの統計情報を定義できます。 通常、このツールを使用するのは、統計情報が自動的に計算されないようにする場合です。 各バンドの最小、最大、標準偏差、平均値を設定できです。 これらの統計情報は、*.xml ファイルから読み取ることができます。

  • このツールで設定できるプロパティは、ArcGIS Pro のデフォルトのレンダリング設定と、他のツールで使用される統計情報を決定します。

    次のプロパティを設定できます。

    • [データ ソース タイプ] - セル値が標高データとカテゴリ データのどちらを表すかや、この値が他の方法によって処理され、データを表示するときにストレッチが必要ないかどうかを定義します。
    • [バンドごとの統計情報] - 各バンドに対して、最小、最大、平均、標準偏差の各値を定義できます。
    • [NoData 値のバンド] - 各バンドに対して、NoData 値を定義できます。

パラメーター

ラベル説明データ タイプ
入力ラスター

プロパティを設定するラスターまたはモザイク データセット。

Mosaic Layer ; Raster Layer
データ ソース タイプ
(オプション)

モザイク データセット内の画像の種類を指定します。

  • 一般モザイク データセットのデータ タイプは指定されません。
  • 標高モザイク データセットには、標高データが含まれています。
  • 主題モザイク データセットには、土地被覆のような不連続な値を持つ主題データが含まれます。
  • 指数データには科学的情報が含まれており、それらはデフォルトで赤〜青のカラー ランプで表示されます。
  • ベクトルの UV 成分データは、ベクター フィールド データの U 成分と V 成分を含む 2 バンド ラスターです。
  • 強度と方向データは、ベクター フィールド データの大きさと方向を含む 2 バンド ラスターです。
  • 処理済みモザイク データセットは色調整されています。
String
バンドごとの統計情報
(オプション)

バンドと、最小、最大、平均値、標準偏差の各値。

Value Table
ファイルから統計情報をインポート
(オプション)

統計情報を含む *.xml ファイル。

File
NoData 値のバンド
(オプション)

各バンドの NoData 値。 各バンドに一意な NoData 値を定義するか、すべてのバンドに対して同じ値を指定できます。

[NoData] ドロップダウン矢印をクリックして、リストからバンドを選択し、[追加] ボタンをクリックしてバンドをテーブルに追加します。 その後、1 つまたは複数の値を入力します。 複数の NoData 値を選択する場合は、各値をスペースで区切ります。

Value Table
キー プロパティ
(オプション)

ネイティブにサポートされているプロパティ。 データには、次のリストにないその他のプロパティも含めることができます。 プロパティでは大文字と小文字は区別されません。

  • AcquisitionDate
  • BandName
  • BlockName
  • CloudCover
  • DatasetTag
  • Dimensions
  • FlowDirection
  • Footprint
  • HighCellSize
  • LowCellSize
  • MinCellSize
  • MaxCellSize
  • OffNadir
  • ParentRasterType
  • ParentTemplate
  • PerspectiveX
  • PerspectiveY
  • PerspectiveZ
  • ProductName
  • RadianceBias
  • RadianceGain
  • ReflectanceBias
  • RefelctanceGain
  • Segmented
  • SensorAzimuth
  • SensorElevation
  • SensorName
  • SolarIrradiance
  • SourceBandIndex
  • StdPressure
  • StdPressure_Max
  • StdTemperature
  • StdTemperature_Max
  • StdTime
  • StdTime_Max
  • StdZ
  • StdZ_max
  • SunAzimuth
  • SunElevation
  • ThermalConstant_K1
  • ThermalConstant_K2
  • Variable
  • VerticalAccuracy
  • WavelengthMin
  • WavelengthMax
Value Table
マルチディメンション情報
(オプション)

ラスター データセットのディメンション情報。 ディメンション情報を設定すると、ディメンションのないラスターがマルチディメンション ラスターに変換されます。

ディメンションが時間の場合、ディメンション名は StdTime にする必要があります。 時間の形式は、年-月-日 (2021-10-01) または年-月-日T時:分:秒 (2021-10-01T01:00:00) のいずれかです。

時間と標高の両方を含む変数を定義するには、最初に時間を含む変数を追加してから、Z ディメンションを含む同じ変数を追加します。

Value Table

派生した出力

ラベル説明データ タイプ
更新されたラスター データセット

出力ラスター データセット。

Raster Dataset

arcpy.management.SetRasterProperties(in_raster, {data_type}, {statistics}, {stats_file}, {nodata}, {key_properties}, {multidimensional_info})
名前説明データ タイプ
in_raster

プロパティを設定するラスターまたはモザイク データセット。

Mosaic Layer ; Raster Layer
data_type
(オプション)

モザイク データセット内の画像の種類を指定します。

  • GENERICモザイク データセットのデータ タイプは指定されません。
  • ELEVATIONモザイク データセットには、標高データが含まれています。
  • THEMATICモザイク データセットには、土地被覆のような不連続な値を持つ主題データが含まれます。
  • PROCESSEDモザイク データセットは色調整されています。
  • SCIENTIFICデータには科学的情報が含まれており、それらはデフォルトで赤〜青のカラー ランプで表示されます。
  • VECTOR_UVデータは、ベクター フィールド データの U 成分と V 成分を含む 2 バンド ラスターです。
  • VECTOR_MAGDIRデータは、ベクター フィールド データの大きさと方向を含む 2 バンド ラスターです。
String
statistics
[[band_index, min, max, mean, std_dev],...]
(オプション)

バンドと、最小、最大、平均値、標準偏差の各値。

Value Table
stats_file
(オプション)

統計情報を含む *.xml ファイル。

File
nodata
[[band index, nodata_value],...]
(オプション)

各バンドの NoData 値。 各バンドに一意な NoData 値を定義するか、すべてのバンドに対して同じ値を指定できます。 各バンド選択に対して複数の NoData 値を定義するには、bands_for_nodata_value パラメーターで各 NoData 値をスペースで区切ります。

Value Table
key_properties
[key_properties,...]
(オプション)

ネイティブにサポートされているプロパティ。 データには、次のリストにないその他のプロパティも含めることができます。 プロパティでは大文字と小文字は区別されません。

  • AcquisitionDate
  • BandName
  • BlockName
  • CloudCover
  • DatasetTag
  • Dimensions
  • FlowDirection
  • Footprint
  • HighCellSize
  • LowCellSize
  • MinCellSize
  • MaxCellSize
  • OffNadir
  • ParentRasterType
  • ParentTemplate
  • PerspectiveX
  • PerspectiveY
  • PerspectiveZ
  • ProductName
  • RadianceBias
  • RadianceGain
  • ReflectanceBias
  • RefelctanceGain
  • Segmented
  • SensorAzimuth
  • SensorElevation
  • SensorName
  • SolarIrradiance
  • SourceBandIndex
  • StdPressure
  • StdPressure_Max
  • StdTemperature
  • StdTemperature_Max
  • StdTime
  • StdTime_Max
  • StdZ
  • StdZ_max
  • SunAzimuth
  • SunElevation
  • ThermalConstant_K1
  • ThermalConstant_K2
  • Variable
  • VerticalAccuracy
  • WavelengthMin
  • WavelengthMax
Value Table
multidimensional_info
[multidimensional_info,...]
(オプション)

ラスター データセットのディメンション情報。 ディメンション情報を設定すると、ディメンションのないラスターがマルチディメンション ラスターに変換されます。

ディメンションが時間の場合、ディメンション名は StdTime にする必要があります。 時間の形式は、年-月-日 (2021-10-01) または年-月-日T時:分:秒 (2021-10-01T01:00:00) のいずれかです。

時間と標高の両方を含む変数を定義するには、最初に時間を含む変数を追加してから、Z ディメンションを含む同じ変数を追加します。

Value Table

派生した出力

名前説明データ タイプ
out_raster

出力ラスター データセット。

Raster Dataset

コードのサンプル

SetRasterProperties の例 1 (Python ウィンドウ)

以下は、SetRasterProperties 関数を実行する Python サンプルです。

import arcpy
arcpy.SetRasterProperties_management("\\cpu\data\srtm.tif", "ELEVATION", 
                                     "1 50 400 5 28" , "#" , "#")
SetRasterProperties の例 2 (スタンドアロン スクリプト)

以下は、SetRasterProperties 関数を実行する Python スクリプト サンプルです。

#Set raster dataset type and statistics

import arcpy
arcpy.env.workspace = "C:/Workspace"
    
arcpy.SetRasterProperties_management("srtmraster.tif", "ELEVATION", 
                                         "1 50 400 5 28", "#", "#")

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes