Main Content

stripdims

Remove dlarray data format

Description

example

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

Examples

collapse all

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

collapse all

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

Output Arguments

collapse all

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

See Also

| |