Shape

Размер неизвестной оси или общий неизвестный размер неизвестной формы.

Возвращает новую фигуру с добавленным новым последним размером. Чтобы этот вызов завершился успешно, isUnknown() должно иметь значение false .

Возвращает новую фигуру с добавленными размерами других фигур. И для этой фигуры, и для другой формы isUnknown() должен возвращать false. Например, @code Shape.of(3,4).append(Shape.of(1,2)) => Shape.of(3,4,1,2) }

Возвращает защитную копию осей этой формы. Изменения в возвращаемом массиве, чтобы не изменить состояние этой фигуры. Возвращает значение null, если isUnknown() имеет значение true.

Равно реализации для фигур. Две фигуры считаются равными, если:

• количество измерений определено и одинаково для обоих
• размер каждого измерения определен и равен для обоих

Если какая-либо фигура имеет неизвестные размеры (даже если они одинаковы в обеих) или если какая-либо фигура имеет неизвестное количество измерений (даже если обе фигуры возвращают true для isUnknown() ), они не считаются равными! Однако форма всегда будет равна самой себе, даже если она неизвестна или содержит неизвестные размеры.

Возвращает, имеют ли одно или несколько измерений этой фигуры неизвестный размер.

Возвращает одномерную фигуру, первое измерение которой соответствует первому измерению этой фигуры.

Проверьте, совместимы ли два размера фигуры.

Размеры совместимы, если любой размер равен Shape.UNKNOWN_SIZE или оба размера равны.

Определяет, совместима ли с этой фигура другая фигура.

Две возможно частично определенные фигуры совместимы, если существует полностью определенная форма, которую могут представлять обе фигуры. Таким образом, совместимость позволяет коду вывода формы рассуждать о частично определенных формах. Например:

• Shape.unknown() совместим со всеми фигурами.
• Shape(UNKNOWN_SIZE, UNKNOWN_SIZE) совместим со всеми двумерными фигурами, такими как Shape(32, 784) , а также Shape.unknown() . Он несовместим, например, с Shape(UNKNOWN_SIZE) или Shape(UNKNOWN_SIZE, UNKNOWN_SIZE, UNKNOWN_SIZE) .
• Shape(32, UNKNOWN_SIZE) совместим со всеми двумерными фигурами размером 32 в 0-м измерении, а также Shape(UNKNOWN_SIZE, UNKNOWN_SIZE) и Shape.unknown() . Он несовместим, например, с Shape(32) , Shape(32, UNKNOWN_SIZE, 1) или Shape(64, UNKNOWN_SIZE) .
• Shape(32, 784) совместим сам с собой, а также Shape(32, UNKNOWN_SIZE) , Shape(UNKNOWN_SIZE, 784) , Shape(UNKNOWN_SIZE, UNKNOWN_SIZE) и Shape.unknown() . Он несовместим, например, с Shape(32, 1, 784) или Shape(UNKNOWN_SIZE) .

Отношение совместимости рефлексивно и симметрично, но не транзитивно. Например, Shape(32, 784) совместим с Shape.unknown() , а Shape.unknown() совместим с Shape(4, 4) , но Shape(32, 784) не совместим с Shape(4, 4) .

Совместимость — это не то же самое, что вещание. Совместимые фигуры должны иметь одинаковое количество размеров, и для каждой пары размеров один размер должен равняться другим размерам или хотя бы один из размеров в паре должен быть UNKNOWN_SIZE.

Трансляция допускает использование разных размеров, но парные измерения должны быть либо равны, либо одно измерение должно быть равно 1. Если одна фигура имеет меньшие размеры, чем другая, меньшая фигура «растягивается» до размеров 1.

Возвращает, является ли эта форма формой матрицы.

Возвращает, представляет ли эта форма скаляр.

Возвращает, неизвестно ли количество измерений этой фигуры.

Возвращает, является ли эта форма формой вектора.

Возвращает количество измерений этой фигуры. -1, если неизвестно, 0 для скаляра, 1 для вектора, 2 для матрицы и т. д.

Создайте форму, представляющую скалярное или N-мерное значение.

Создает Shape, представляющий скалярное или N-мерное значение (N не менее 1), с указанным размером для каждого измерения. -1 указывает, что размер соответствующего измерения неизвестен. Если размеры не указаны, создается форма, представляющая скаляр. Например:

// A 2-element vector.
 Shape vector = Shape.of(2);

 // A 2x3 matrix.
 Shape matrix = Shape.of(2, 3);

 // A matrix with 4 columns but an unknown number of rows.
 // This is typically used to indicate the shape of tensors that represent
 // a variable-sized batch of values. The Shape below might represent a
 // variable-sized batch of 4-element vectors.
 Shape batch = Shape.of(-1, 4);

 // A scalar. For readability, you should prefer calling Shape.scalar()
 Shape scalar = Shape.of()
 

Возвращает новую фигуру с добавленными к ней размерами другой фигуры. И для этой фигуры, и для другой формы isUnknown() должен возвращать false. Например Shape.of(3,4).prepend(Shape.of(1,2)) => Shape.of(1,2,3,4)

Возвращает новую фигуру с добавленным новым первым измерением. Чтобы этот вызов завершился успешно, isUnknown() должно иметь значение false .

Создает форму, представляющую скалярное значение.

Размер измерения с данным индексом.

Если isUnknown() имеет значение true или размер измерения с данным индексом имеет неизвестный размер, возвращается UNKNOWN_SIZE .

Возвращает общее количество элементов, которые будет иметь тензор с этой формой.

Если isUnknown() имеет значение true или hasUnknownDimension() имеет значение true, возвращается UNKNOWN_SIZE .

Возвращает размерную фигуру end - begin с размерами, соответствующими этой фигуре от begin до end .

Возвращает новую фигуру с удаленным первым измерением этой фигуры.

Возвращает n-мерную фигуру с размерами, соответствующими первым n измерениям этой фигуры.

Возвращает n-мерную фигуру, размеры которой соответствуют последним n измерениям этой фигуры.

Краткое описание формы, предназначенной для отладки.

Создает фигуру, представляющую неизвестное количество измерений.