Build Multidimensional Info (Data Management)

Summary

Generates multidimensional metadata in the mosaic dataset, including information regarding variables and dimensions.

Legacy:

This is a deprecated tool. The Build Multidimensional Info tool has been moved to the Multidimensional toolbox.

Usage

  • When you create a mosaic dataset from netCDF, GRIB, or HDF files, the multidimensional information is built into the mosaic dataset, and you can view the information in the dataset properties. The Build Multidimensional Info tool creates multidimensional information for a mosaic dataset that contains images collected at multiple times, depths, or heights, but was not created from netCDF files.

  • This tool creates the following two text fields in the mosaic dataset:

    • Variable—Stores the names of the variables. For example, this field will store the string Temperature for all the images with temperature data, and Salinity for all the images containing salinity data.
    • Dimensions—Stores the names of the dimensions. For example, if your temperature data has a corresponding Date dimension field representing the day it was captured, and your salinity data has a Depth dimension field representing the depth at which it was measured, the Dimensions field for that variable would be Date, Depth. The two fields, Date and Depth, must exist and be populated in the mosaic dataset.

Parameters

LabelExplanationData Type
Mosaic Dataset

The input multidimensional mosaic dataset.

Mosaic Layer
Variable Field
(Optional)

The field in the mosaic dataset that stores the variable names and is used to populate a new field named Variable. If all rasters in the mosaic dataset represent the same variable, type the name of the variable, for example, Temperature.

If the Variable field does not already exist, an existing field or string value must be specified. If the Variable field exists, the tool will update the multidimensional information only.

String
Dimension Fields
(Optional)

The fields in the mosaic dataset that store the dimension information and are used to populate a new field named Dimensions.

If the Dimensions field already exists, the tool will update the multidimensional information only.

Value Table
Variable Info
(Optional)

Specify additional information about the Variable field.

Value Table

Derived Output

LabelExplanationData Type
Mosaic Dataset

The updated mosaic dataset.

Mosaic Layer

arcpy.management.BuildMultidimensionalInfo(in_mosaic_dataset, {variable_field}, {dimension_fields}, {variable_desc_units})
NameExplanationData Type
in_mosaic_dataset

The input multidimensional mosaic dataset.

Mosaic Layer
variable_field
(Optional)

The field in the mosaic dataset that stores the variable names and is used to populate a new field named Variable. If all rasters in the mosaic dataset represent the same variable, type the name of the variable, for example, Temperature.

If the Variable field does not already exist, an existing field or string value must be specified. If the Variable field exists, the tool will update the multidimensional information only.

String
dimension_fields
[[dimension field, description, units],...]
(Optional)

The fields in the mosaic dataset that store the dimension information and are used to populate a new field named Dimensions.

If the Dimensions field already exists, the tool will update the multidimensional information only.

Value Table
variable_desc_units
[[variable name, description, units],...]
(Optional)

Specify additional information about the Variable field.

Value Table

Derived Output

NameExplanationData Type
out_mosaic_dataset

The updated mosaic dataset.

Mosaic Layer

Code sample

BuildMultidimensionalInfo example 1 (Python window)

This is a Python sample for BuildMultidimensionalInfo.

## Build multidimensional information for a time series mosaic dataset 
## with Landsat 7 imagery.

import arcpy
arcpy.BuildMultidimensionalInfo_md(
	"C:/data/input.gdb/L7TimeSeriesMosaic", "Landsat7", 'AcquisitionDate')
BuildMultidimensionalInfo example 2 (stand-alone script)

This is a Python script sample for BuildMultidimensionalInfo.

## Build multidimensional information for a mosaic dataset 
## containing sea ice extent imagery over time and water depth.

import arcpy
arcpy.env.workspace = "C:/data"

## Define the input parameters
inputmosaicdataset = "input.gdb/seaice_1982_2019"
variable_field = "measurement"
dimension_fields= "AcquisitionDate;Depth"

arcpy.BuildMultidimensionalInfo_md(
	inputmosaicdataset, variable_field, 
	dimension_fields)

Environments

This tool does not use any geoprocessing environments.

Licensing information

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

Related topics