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.