子集化多维栅格 (多维工具)

汇总

可沿定义的变量和维度对数据进行分割，从而创建多维栅格的子集。

用法

此工具通过提取变量子集来从多维栅格或镶嵌数据集创建多维栅格图层。例如，您的镶嵌数据集中包含 30 年的月降水量数据，而且您只想提取每年 1 月的数据，以查看该月份降水的变化。
受支持的多维栅格数据集包括云栅格格式 (CRF)、多维镶嵌数据集或者由 netCDF、GRIB 或 HDF 格式文件生成的多维栅格图层。
该工具将生成云栅格格式 (CRF) 的多维栅格数据集。目前，尚不支持其他输出格式。
使用维度定义参数可按间隔、值或值范围分割维度。例如，如果您具有每 2 米深度（最深达 500 米）按月采集的 10 年海洋盐度数据，则可以考虑在以下情景中使用不同的维度定义选项：
- 提取这 10 年间的 1 月份盐度数据。选择按值，将维度设置为 StdTime，并将值设置为 1 月。
- 在 0 至 150 米的深度范围内分割盐度数据。选择按范围，将维度设置为 StdZ，将最小值设置为 -150 并将最大值设置为 0。
- 提取这 10 年中 1 月份前 10 天的盐度数据。选择按迭代，将维度设置为 StdTime，将第一次迭代的开始和第一次迭代的结束设置为相应迭代周期的开始和结束，将步长设置为 1，并将单位设置为年。
默认情况下，将使用 LZ77 压缩类型对多维栅格输出进行压缩。但是，建议将压缩类型更改为 LERC 并根据数据来调整最大误差值。例如，如果您希望分析结果精确到三位小数，对于最大误差值，请使用 0.001。避免不必要的精度要求，因为它们将增加处理时间和存储大小。

要更改压缩类型，请修改压缩环境设置。

标注	说明	数据类型
输入多维栅格	输入多维栅格数据集。受支持的输入包括 netCDF、GRIB、HDF 或 CRF 文件、多维镶嵌数据集或多维栅格图层。	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
输出多维栅格	输出多维栅格数据集。	Raster Dataset
变量（可选）	将包含在输出多维栅格中的变量。如果未指定变量，则将使用所有变量。	String
维度定义（可选）	指定将用于分割维度的方法。所有—将使用每个维度的完整范围。这是默认设置。按范围—将使用范围或范围列表对维度进行分割。按迭代—将以指定的间隔大小对维度进行分割。按值—将使用一系列维度值对维度进行分割。	String
范围（可选）	指定维度的范围或范围列表。将根据维度名称以及范围的最小值和最大值对数据进行分割。当维度定义参数设置为按范围时，此参数为必需项。值表列： Dimension—The dimension from which to extract ranges. Minimum Value—The minimum value for the range. Maximum Value—The maximum value for the range.	Value Table
值（可选）	指定维度的值列表。当维度定义参数设置为按值时，此参数为必需项。值表列： Dimension—The dimension from which to extract values. Values—The specified dimension values.	Value Table
维度（可选）	分割变量时使用的维度。当维度定义参数设置为按迭代时，此参数为必需项。	String
第一次迭代的开始（可选）	第一个间隔的开始。此间隔将用于遍历数据集。当维度定义参数设置为按迭代时，此参数为必需项。	String
第一次迭代的结束（可选）	第一个间隔的结束。此间隔将用于遍历数据集。当维度定义参数设置为按迭代时，此参数为必需项。	String
步骤（可选）	分割数据时使用的频率。当维度定义参数设置为按迭代时，此参数为必需项。	Double
单位（可选）	指定将使用的迭代单位。当维度定义参数设置为按迭代且维度参数设置为 StdTime 时，此参数为必需项。小时—指定的时间单位将为小时。天—指定的时间单位将为天。周—指定的时间单位将为周。月—指定的时间单位将为月。年—指定的时间单位将为年。	String

arcpy.md.SubsetMultidimensionalRaster(in_multidimensional_raster, out_multidimensional_raster, {variables}, {dimension_def}, {dimension_ranges}, {dimension_values}, {dimension}, {start_of_first_iteration}, {end_of_first_iteration}, {iteration_step}, {iteration_unit})

名称	说明	数据类型
in_multidimensional_raster	输入多维栅格数据集。受支持的输入包括 netCDF、GRIB、HDF 或 CRF 文件、多维镶嵌数据集或多维栅格图层。	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
out_multidimensional_raster	输出多维栅格数据集。	Raster Dataset
variables [variables,...] （可选）	将包含在输出多维栅格中的变量。如果未指定变量，则将使用所有变量。	String
dimension_def （可选）	指定将用于分割维度的方法。 `ALL`—将使用每个维度的完整范围。这是默认设置。 `BY_RANGES`—将使用范围或范围列表对维度进行分割。 `BY_ITERATION`—将以指定的间隔大小对维度进行分割。 `BY_VALUE`—将使用一系列维度值对维度进行分割。	String
dimension_ranges [dimension_ranges,...] （可选）	指定维度的范围或范围列表。将根据维度名称以及范围的最小值和最大值对数据进行分割。当 `dimension_def` 参数设置为 `BY_RANGES` 时，此参数为必需项。值表列： `Dimension`—The dimension from which to extract ranges. `Minimum Value`—The minimum value for the range. `Maximum Value`—The maximum value for the range.	Value Table
dimension_values [dimension_values,...] （可选）	指定维度的值列表。当 `dimension_def` 参数设置为 `BY_VALUE` 时，此参数为必需项。值表列： `Dimension`—The dimension from which to extract values. `Values`—The specified dimension values.	Value Table
dimension （可选）	分割变量时使用的维度。当 `dimension_def` 参数设置为 `BY_ITERATION` 时，此参数为必需项。	String
start_of_first_iteration （可选）	第一个间隔的开始。此间隔将用于遍历数据集。当 `dimension_def` 参数设置为 `BY_ITERATION` 时，此参数为必需项。	String
end_of_first_iteration （可选）	第一个间隔的结束。此间隔将用于遍历数据集。当 `dimension_def` 参数设置为 `BY_ITERATION` 时，此参数为必需项。	String
iteration_step （可选）	分割数据时使用的频率。当 `dimension_def` 参数设置为 `BY_ITERATION` 时，此参数为必需项。	Double
iteration_unit （可选）	指定将使用的迭代单位。当 `dimension_def` 参数设置为 `BY_ITERATION` 且 `dimension` 参数设置为 `StdTime` 时，此参数为必需项。 `HOURS`—指定的时间单位将为小时。 `DAYS`—指定的时间单位将为天。 `WEEKS`—指定的时间单位将为周。 `MONTHS`—指定的时间单位将为月。 `YEARS`—指定的时间单位将为年。	String

代码示例

SubsetMultidimensionalRaster 示例 1（Python 窗口）

使用 BY_RANGES 方法从多维栅格中提取变量子集。

# Import system modules
import arcpy

# Run
arcpy.md.SubsetMultidimensionalRaster(
    "C:\\data\\Ocean_Data.crf", "C:\\data\\Ocean_Data_Subset.crf",
    "salinity", "BY_RANGES", "StdZ -500 -100")

SubsetMultidimensionalRaster 示例 2（独立脚本）

使用 BY_VALUE 方法从多维栅格中提取水温变量

# Import system modules
import arcpy

# Define input parameters
in_multidimensional_raster = r"C:\data\MD_Ocean_data.crf"
out_multidimensional_raster = r"C:\data\Temp_slice.crf"
variables = "water_temp"
dimension_def = "BY_VALUE"
dimension_values = "StdZ -50;StdZ -100"

#Run

arcpy.md.SubsetMultidimensionalRaster(
    in_multidimensional_raster, out_multidimensional_raster,
    variables, dimension_def, dimension_values)

SubsetMultidimensionalRaster 示例 3（独立脚本）

使用 BY_ITERATION 方法从多维栅格中提取“盐度”变量。

# Import system modules
import arcpy

# Set local variables
in_multidimensional_raster = r"C:\data\MD_Ocean_data.crf"
out_multidimensional_raster =  r"C:\data\salinity_slice.crf"
variables = "salinity"
dimension_def = "BY_ITERATION"
dimension = "StdTime"
start_of_first_iteration = "2009-01-01"
end_of_first_iteration = "2009-01-10"
iteration_step = "1"
iteration_unit = "YEARS"

#Run

arcpy.md.SubsetMultidimensionalRaster(in_multidimensional_raster, out_multidimensional_raster, variables, dimension_def, dimension, start_of_first_iteration, end_of_first_iteration, iteration_step, iteration_unit)

环境

像元大小, 压缩, 当前工作空间, 地理变换, NoData, 输出配置关键字, 输出坐标系, 范围, 并行处理因子, 金字塔, 栅格统计, 重采样方法, 临时工作空间, 捕捉栅格, 切片大小

许可信息

基本: 是
标准: 是
高级: 是

子集化多维栅格 (多维工具)

汇总

用法

参数

环境

许可信息

相关主题