stripdims

Remove dlarray data format

Since R2019b

Syntax

Y = stripdims(X)

Description

Y = stripdims(X) returns the dlarray X without any dimension labels. Y is an unformatted dlarray.

Examples

Remove Data Format from dlarray

Create a formatted dlarray.

dlX = dlarray(randn(3,2,1,2),'SSTU')

dlX = 
  3(S) x 2(S) x 1(T) x 2(U) dlarray


(:,:,1,1) =

    0.5377    0.8622
    1.8339    0.3188
   -2.2588   -1.3077


(:,:,1,2) =

   -0.4336    2.7694
    0.3426   -1.3499
    3.5784    3.0349

Create an array that is the same as dlX but has no dimension labels.

y = stripdims(dlX)

y = 
  3x2x1x2 dlarray


(:,:,1,1) =

    0.5377    0.8622
    1.8339    0.3188
   -2.2588   -1.3077


(:,:,1,2) =

   -0.4336    2.7694
    0.3426   -1.3499
    3.5784    3.0349

Input Arguments

X — Input data

dlarray object

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

Output Arguments

Y — Unformatted dlarray

unformatted dlarray object

Unformatted dlarray, returned as an unformatted dlarray object that is the same as the input array X, but without any dimension labels. If X is unformatted, then Y = X.

Tips

• Use stripdims to ensure that a dlarray behaves like a numeric array of the same size, without any special behavior due to dimension labels.

• ndims(X) can decrease after a stripdims call because the function removes trailing singleton dimensions.

  X = dlarray(ones(3,2), 'SCB');
  ndims(X)

  ans =
  
       3

  X = stripdims(X);
  ndims(X)

  ans =
  
       2

Extended Capabilities

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