Multidimensional Filter function

Overview

Creates a raster layer from a multidimensional raster dataset or a multidimensional raster layer by slicing data along defined variables and dimensions.

Notes

This tool creates a multidimensional raster layer by filtering and extracting a subset of variables from a multidimensional raster. For example, you have a multidimensional dataset that contains 30 years of monthly precipitation data, and you only want to extract data for each January to see how precipitation has changed for that month.

Use the Dimension Definition parameter to slice dimensions using an interval, a value, or a range of values. For example, if you have 10 years of ocean salinity data, collected monthly and at every 2 meters depth up to 500 meters, you can use the different dimension definition options for the following scenarios:

  • Extract salinity data for the month of January over the 10-year period. Choose By Values, set Dimension to StdTime, and set Values to January.
  • Slice salinity data over a depth range from 0 to 150 meters. Choose By Ranges, set Dimension to StdZ, and set Minimum Value to -150 and Maximum Value to 0.
  • Extract salinity data for the first 10 days of January over a 10-year period. Choose By Iteration, set Dimension to StdTime, set Start of first iteration and End of first iteration to the corresponding start and end of the iteration period, set Step to 1, and set Unit to Years.

Parameters

Parameter nameDescription

Raster

The input multidimensional raster.

Variables

The variables that will be included in the output multidimensional raster layer. If no variable is specified, the first variable will be used.

Dimension Definition

Specifies the method that will be used to slice the dimension.

  • All—The full range for each dimension will be used. This is the default.
  • By Values—The dimension will be sliced using a dimension value or list of values.
  • By Ranges—The dimension will be sliced using a range or a list of ranges.
  • By Iteration—The dimension will be sliced over a specified interval size.

Dimension

The dimension from which to extract variables.

Value

The value for the specified dimension. This parameter is required when the Dimension Definition parameter is set to By Values.

Minimum Value

The minimum value for the range. This parameter is required when the Dimension Definition parameter is set to By Ranges.

Maximum Value

The maximum value for the range. This parameter is required when the Dimension Definition parameter is set to By Ranges.

Start of first iteration

The beginning of the first interval. This interval is used to iterate through the dataset. This parameter is required when the Dimension Definition parameter is set to By Iteration.

End of first iteration

The end of the first interval. This interval is used to iterate through the dataset. This parameter is required when the Dimension Definition parameter is set to By Iteration.

Step

The frequency with which the data will be sliced. This parameter is required when the Dimension Definition parameter is set to By Iteration. The default is 3.

Unit

Specifies the iteration unit. This parameter is required when the Dimension Definition parameter is set to By Iteration and the Dimension parameter is set to StdTime.

Dimensionless

Specifies whether the layer should have dimension values. This option is only available if a single slice is selected to create a layer.

  • Checked—The layer will not have dimension values.
  • Unchecked—The layer will have a dimension value. This is the default.

Related topics


In this topic
  1. Overview
  2. Notes
  3. Parameters