dims

R2026b

Data format of dlarray object

collapse all in page

Syntax

d = dims(X)

Description

The dims function returns the data format of the input.

A deep learning data format is a string of characters, where each character describes the type of the corresponding data dimension. The characters are:

  • "S" — Spatial

  • "C" — Channel

  • "B" — Batch

  • "T" — Time

  • "U" — Unspecified

For example, suppose you have an array that represents a batch of sequences where the first, second, and third dimensions correspond to channels, observations, and time steps, respectively. You can describe the data as having the format "CBT" (channel, batch, time).

d = dims(X) returns the data format of X as a character array. The data format provides the dimension labels for each dimension in X.

example

Examples

collapse all

Open Live Script

Obtain the dimension labels of a formatted dlarray.

dlX = dlarray(randn(3,4),'TS');
d = dims(dlX)
d = 
'ST'

Obtain the labels of an unformatted dlarray.

y = stripdims(dlX);
d = dims(y)
d =

  0×0 empty char array

Input Arguments

collapse all

Input data, specified as a formatted or unformatted dlarray object.

Output Arguments

collapse all

Dimension labels, returned as a character vector. If the input X is unformatted, d is empty.

Extended Capabilities

expand all

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

GPU Code Generation
Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.

Version History

Introduced in R2019b

See Also

| |