6.3.2 Создание массивов ячеек

В примере введения (см. Основное использование массивов ячеек) показано, как создать массив ячеек, содержащий текущие доступные переменные. Однако во многих ситуациях полезно создать массив ячеек и затем заполнить его данными.

Функция cell возвращает массив ячеек заданного размера, содержащий пустые матрицы. Эта функция аналогична функции zeros для создания новых числовых массивов. В следующем примере создается 2x2 массив ячеек, содержащий пустые матрицы

c = cell (2,2)
     ⇒ c =

         {
           [1,1] = [](0x0)
           [2,1] = [](0x0)
           [1,2] = [](0x0)
           [2,2] = [](0x0)
         }

Как и числовые массивы, массивы ячеек могут быть многомерными. Функция cell принимает любое количество положительных целых чисел для описания размера возвращаемого массива ячеек. Также можно установить размер массива ячеек с помощью вектора положительных целых чисел. В следующем примере создаются два массива ячеек равного размера, и отображается размер первого из них

c1 = cell (3, 4, 5);
c2 = cell ( [3, 4, 5] );
size (c1)
     ⇒ ans =
         3   4   5

Как видно, функция size также работает с массивами ячеек. Как и другие функции, описывающие размер объекта, такие как length, numel, rows и columns.

cell (n)

cell (m, n)

cell (m, n, k, …)

cell ([m n …])

Создать новый объект массива ячеек.

Если вызывается с одним скалярным целочисленным аргументом, возвращает квадратный массив ячеек NxN. Если вызывается с двумя или более скалярными целочисленными аргументами или вектором целых значений, возвращает массив с заданными размерами.

См. также: cellstr, mat2cell, num2cell, struct2cell.

В качестве альтернативы созданию пустых массивов ячеек и их последующему заполнению можно преобразовать числовые массивы в массивы ячеек, используя функции num2cell, mat2cell и cellslices.

C = num2cell (A)

C = num2cell (A, dim)

Преобразовать числовую матрицу A в массив ячеек.

Если dim не указан, каждый элемент A становится элементом 1x1 в выходном C.

Если dim определен, отдельные элементы C содержат все элементы из A по указанному измерению. dim также может быть вектором измерений с применением того же правила.

Например:

x = [1,2;3,4]
⇒
    1    2
    3    4

## each element of A becomes a 1x1 element of C
num2cell (x)
   ⇒
      {
        [1,1] =  1
        [2,1] =  3
        [1,2] =  2
        [2,2] =  4
      }
## all rows (dim 1) of A appear in each element of C
num2cell (x, 1)
   ⇒
      {
        [1,1] =
           1
           3
        [1,2] =
           2
           4
      }
## all columns (dim 2) of A appear in each element of C
num2cell (x, 2)
   ⇒
      {
        [1,1] =
           1   2
        [2,1] =
           3   4
      }
## all rows and cols appear in each element of C
## (hence, only 1 output)
num2cell (x, [1, 2])
   ⇒
      {
        [1,1] =
           1   2
           3   4
      }

См. также: mat2cell.

C = mat2cell (A, dim1, dim2, …, dimi, …, dimn)

C = mat2cell (A, rowdim)

Преобразовать матрицу A в массив ячеек.

Каждый аргумент измерения (dim1, dim2 и т. д.) — это вектор целых чисел, который определяет, как разделить элементы этого измерения между новыми элементами в выходном C. Количество элементов в i-м измерении — это size (A, i). Поскольку все элементы в A должны быть разделены, существует требование, что sum (dimi) == size (A, i). Размер выходного массива ячеек C равен numel (dim1) x numel (dim2) x … x numel (dimn).

При задании одного одномерного аргумента rowdim, вывод разбивается на строки, как указано. Все другие измерения не делятся, и поэтому все столбцы (измерение 2), страницы (измерение 3) и т. д. появляются в каждом выходном элементе.

Примеры

x = reshape (1:12, [3, 4])'
⇒
    1    2    3
    4    5    6
    7    8    9
   10   11   12

## The 4 rows (dim1) are divided in to two cell elements
## with 2 rows each.
## The 3 cols (dim2) are divided in to three cell elements
## with 1 col each.
mat2cell (x, [2,2], [1,1,1])
⇒
{
  [1,1] =

     1
     4

  [2,1] =

      7
     10

  [1,2] =

     2
     5

  [2,2] =
      8
     11

  [1,3] =

     3
     6

  [2,3] =
      9
     12
}


## The 4 rows (dim1) are divided in to two cell elements
## with a 3/1 split.
## All columns appear in each output element.
mat2cell (x, [3,1])
⇒
{
  [1,1] =

     1   2   3
     4   5   6
     7   8   9

  [2,1] =

     10   11   12
}

См. также: num2cell, cell2mat.

sl = cellslices (x, lb, ub, dim)

Для заданного массива x эта функция создает массив ячеек из срезов массива, определяемых векторами индексов lb, ub для нижних и верхних границ соответственно.

Другими словами, она эквивалентна следующему коду:

n = length (lb);
sl = cell (1, n);
for i = 1:length (lb)
  sl{i} = x(:,…,lb(i):ub(i),…,:);
endfor

Положение индекса определяется dim. Если не указано, срез выполняется по первому неединичному измерению.

См. также: cell2mat, cellindexmat, cellfun.