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.