创建 NetCDF 栅格图层 (多维)

摘要

根据 NetCDF 文件创建栅格图层。

创建多维栅格图层工具提供了增强的功能或性能。

使用情况

  • 许多多维探索、数据管理和分析工具均不支持将此工具的输出用作输入。 它们将改为使用来自创建多维栅格图层工具的输出。

  • 此工具支持具有 .nc.nc4 扩展名的 netCDF 文件。 不支持 .nc4 文件中位于组内的组变量和维度。 仅支持组外的变量和维度。

  • 要根据 NetCDF 变量创建 NetCDF 栅格图层,则各个 x 坐标之间的间距必须相等,同时各个 y 坐标之间的间距也必须相等。 如果各坐标的间距不等,则需创建一个 netCDF 要素图层,然后插值为栅格。

  • 输出栅格图层类型是基于 NetCDF 变量类型的浮点型或整型。

  • 适用于创建栅格的 netCDF 文件中,第一个变量被选作默认变量。

  • 辅助坐标变量将在 X 维度Y 维度参数下拉列表中列出并在执行期间使用(如果指定)。 这些变量不会在维度值参数下拉列表中列出,并且不可在脚本中设置为此参数的值。

  • 指定波段维度参数值以创建多波段栅格。

  • 非空间维度的第一个值用于创建多维变量的默认视图。

  • 要保存输出图层,可右键单击ArcGIS AllSource 内容窗格中的图层,然后单击另存为图层文件,也可使用保存至图层文件工具。

  • 在 ArcGIS 中无法使用已分配给 netCDF 文件的时间坐标变量的日历属性值 noleap365_day

  • 使用像元配准参数(Python 中的 cell_registration)指定如何根据 x 维度和 y 维度值来计算 netCDF 栅格图层的范围。 无论使用什么选项,像元大小、行数、列数以及输出栅格的宽度和高度都保持不变。

参数

标注说明数据类型
输入 netCDF 文件

待输入的 NetCDF 文件。

File
变量

向输出栅格分配单元值时使用的 netCDF 文件的变量。 这是将会显示出来的变量,如温度或降雨量。

String
X 维度

定义输出图层的 x 坐标或经度坐标时使用的 netCDF 维度。

String
Y 维度

定义输出图层的 y 坐标或纬度坐标时使用的 netCDF 维度。

String
输出栅格图层

输出栅格图层的名称。

Raster Layer
波段维度
(可选)

在输出栅格中创建波段时所使用的 netCDF 维度。 如果需要多波段栅格图层,则请设置此维度值。 例如,可将高度设置为波段维度,从而使创建的多波段栅格中的每个波段都表示该高度上的温度。

String
纬度值
(可选)

在输出图层中显示变量时要使用的维度(如时间)的值(如 01/30/05)。 默认情况下,将使用维度的第一个值。

  • 维度 - netCDF 维度。
  • - 可用的维度值。
Value Table
值选择方法
(可选)

指定将使用的维度值选择方法。

  • 按值输入值将与实际维度值匹配。
  • 按索引输入值将与维度值的位置或索引匹配。 索引的第一个值为 0;即位置从 0 开始。
String
像元配准
(可选)

指定像元配准的位置。

  • CENTER在像元中心进行像元配准。 这是默认设置。
  • LOWER_LEFT在像元左下角进行像元配准。
  • UPPER_LEFT在像元左上角进行像元配准。
String

arcpy.management.MakeNetCDFRasterLayer(in_netCDF_file, variable, x_dimension, y_dimension, out_raster_layer, {band_dimension}, {dimension_values}, {value_selection_method}, {cell_registration})
名称说明数据类型
in_netCDF_file

待输入的 NetCDF 文件。

File
variable

向输出栅格分配单元值时使用的 netCDF 文件的变量。 这是将会显示出来的变量,如温度或降雨量。

String
x_dimension

定义输出图层的 x 坐标或经度坐标时使用的 netCDF 维度。

String
y_dimension

定义输出图层的 y 坐标或纬度坐标时使用的 netCDF 维度。

String
out_raster_layer

输出栅格图层的名称。

Raster Layer
band_dimension
(可选)

在输出栅格中创建波段时所使用的 netCDF 维度。 如果需要多波段栅格图层,则请设置此维度值。 例如,可将高度设置为波段维度,从而使创建的多波段栅格中的每个波段都表示该高度上的温度。

String
dimension_values
[[dimension, {value}],...]
(可选)

在输出图层中显示变量时要使用的维度(如时间)的值(如 01/30/05)。 默认情况下,将使用维度的第一个值。

  • dimension - netCDF 维度。
  • {value} - 可用的维度值。
Value Table
value_selection_method
(可选)

指定将使用的维度值选择方法。

  • BY_VALUE输入值将与实际维度值匹配。
  • BY_INDEX输入值将与维度值的位置或索引匹配。 索引的第一个值为 0;即位置从 0 开始。
String
cell_registration
(可选)

指定像元配准的位置。

  • CENTER在像元中心进行像元配准。 这是默认设置。
  • LOWER_LEFT在像元左下角进行像元配准。
  • UPPER_LEFT在像元左上角进行像元配准。
String

代码示例

MakeNetCDFRasterLayer 示例 1(Python 窗口)

根据 netCDF 文件创建栅格图层。

import arcpy
arcpy.MakeNetCDFRasterLayer_md("C:/data/netcdf/rainfall.nc","pptx",
                         "lon","lat","rainfall")
MakeNetCDFRasterLayer 示例 2(独立脚本)

根据 netCDF 文件创建栅格图层。

# Name: MakeNetCDFRasterLayer_Ex_02.py
# Description: Create a raster layer from a netCDF file.
# Requirements: None

# Import system modules
import arcpy


# Set local variables
inNetCDFFile = "C:/data/netcdf/rainfall.nc"
variable = "pptx"
XDimension = "lon"
YDimension = "lat"
outRasterLayer = "rainfall"
bandDimmension = ""
dimensionValues = ""
valueSelectionMethod = ""
cellRegistration = ""

# Execute MakeNetCDFRasterLayer
arcpy.md.MakeNetCDFRasterLayer(inNetCDFFile, variable, XDimension, YDimension,
                               outRasterLayer, bandDimmension, dimensionValues, 
                               valueSelectionMethod, cellRegistration)