Tensor

публичный интерфейс Тензор
Известные косвенные подклассы

Статически типизированный многомерный массив.

В TensorFlow Java есть две категории тензоров: typed tensors и raw tensors . Первый сопоставляет собственную память тензора с n-мерным типизированным пространством данных, позволяя осуществлять прямые операции ввода-вывода из JVM, а второй представляет собой всего лишь ссылку на собственный тензор, обеспечивающий базовые операции и плоский доступ к данным.

ВНИМАНИЕ: Ресурсы, потребляемые объектом Tensor, должны быть явно освобождены путем вызова метода close() , когда объект больше не нужен. Например, используя блок try-with-resources:

try (Tensor t = Tensor.of(...)) {
   doSomethingWith(t);
 
 }

Экземпляры Tensor не являются потокобезопасными.

Публичные методы

абстрактный RawTensor
асРоТензор ()
Возвращает необработанное (нетипизированное) представление этого тензора.
абстрактная пустота
закрывать ()
Освободите ресурсы, связанные с Тензором.
абстрактный тип данных
тип данных ()
Возвращает DataType элементов, хранящихся в тензоре.
абстрактный длинный
числобайт ()
Возвращает размер тензорных данных в байтах.
абстрактный статический <T расширяет TType > T
of (тип Class<T>, форма Shape , длинный размер, Consumer<T> dataInitializer)
Выделяет тензор заданного типа данных, формы и размера.
абстрактный статический <T расширяет TType > T
of (тип Class<T>, форма Shape )
Выделяет тензор заданного типа данных и формы.
абстрактный статический <T расширяет TType > T
of (тип Class<T>, форма Shape , длинный размер)
Выделяет тензор заданного типа данных, формы и размера.
абстрактный статический <T расширяет TType > T
of (тип Class<T>, форма Shape, Consumer<T> dataInitializer)
Выделяет и инициализирует тензор заданного типа данных и формы.
абстрактный статический <T расширяет TType > T
of (тип Class<T>, форма Shape , ByteDataBuffer rawData)
Создает тензор любого типа из необработанных данных, предоставленных данным буфером.
абстрактная форма
форма ()
Возвращает форму тензора.

Унаследованные методы

Публичные методы

публичный абстрактный RawTensor asRawTensor ()

Возвращает необработанное (нетипизированное) представление этого тензора.

публичная абстрактная пустота закрыть ()

Освободите ресурсы, связанные с Тензором.

ВНИМАНИЕ: это необходимо вызвать для всех тензоров, которые не были созданы в результате активной операции, иначе произойдет утечка памяти.

Объект Tensor больше нельзя использовать после close возврата.

общедоступный абстрактный тип данных dataType ()

Возвращает DataType элементов, хранящихся в тензоре.

публичный абстрактный длинный numBytes ()

Возвращает размер тензорных данных в байтах.

общедоступная статическая абстракция T of (тип Class<T>, форма Shape , длинный размер, Consumer<T> dataInitializer)

Выделяет тензор заданного типа данных, формы и размера.

Этот метод идентичен of(Class, Shape, Consumer) , за исключением того, что окончательный размер тензора может быть задан явно, а не вычисляться на основе типа данных и формы.

Это может быть полезно для типов тензоров, которые хранят данные, а также метаданные в тензорной памяти, например, таблицу поиска в тензоре строк.

Параметры
тип класс типа тензора
форма форма тензора
размер размер тензора в байтах или -1 для вычисления размера по форме
инициализатор данных метод получения доступа к выделенным тензорным данным для инициализации
Возврат
  • выделенный и инициализированный тензор
Броски
IllegalArgumentException если size меньше минимального пространства, необходимого для хранения данных тензора
IllegalArgumentException если size установлено значение -1, но элементы данного type имеют переменную длину (например, строки)
IllegalArgumentException если shape полностью или частично unknown
IllegalStateException если тензор не удалось выделить

общедоступная статическая абстракция T of (тип Class<T>, форма Shape )

Выделяет тензор заданного типа данных и формы.

Объем выделяемой памяти определяется типом данных и формой тензора и остается неинициализированным.

Параметры
тип класс типа тензора
форма форма тензора
Возврат
  • выделенный, но неинициализированный тензор
Броски
IllegalArgumentException если элементы данного type имеют переменную длину (например, строки)
IllegalArgumentException если shape полностью или частично unknown
IllegalStateException если тензор не удалось выделить

общедоступная статическая абстракция T of (тип Class<T>, форма Shape , длинный размер)

Выделяет тензор заданного типа данных, формы и размера.

Этот метод идентичен of(Class, Shape) , за исключением того, что окончательный размер тензора может быть задан явно вместо вычисления его на основе типа данных и формы, которые могут быть больше, чем фактическое пространство, необходимое для хранения данных, но не меньше. .

Параметры
тип класс типа тензора
форма форма тензора
размер размер тензора в байтах или -1 для вычисления размера по форме
Возврат
  • выделенный, но неинициализированный тензор
Броски
IllegalArgumentException если size меньше минимального пространства, необходимого для хранения данных тензора
IllegalArgumentException если size установлено значение -1, но элементы данного type имеют переменную длину (например, строки)
IllegalArgumentException если shape полностью или частично unknown
IllegalStateException если тензор не удалось выделить
См. также

общедоступная статическая абстракция T of (тип Class<T>, форма Shape , Consumer<T> dataInitializer)

Выделяет и инициализирует тензор заданного типа данных и формы.

Объем выделяемой памяти определяется типом данных и формой тензора. Данные тензора инициализируются путем вызова dataInitializer , который получает в качестве аргумента значение, возвращаемое функцией ERROR(/#data()) для выделенного тензора. Например:

FloatNdArray data = ...
 try (TFloat32 t = Tensor.of(TFloat32.class, Shape.of(2, 2), data::copyTo)) {
   ...
 
 }

Если dataInitializer завершится сбоем и выдаст исключение, выделенный тензор будет автоматически освобожден перед повторной выдачей того же исключения.

Параметры
тип класс типа тензора
форма форма тензора
инициализатор данных метод получения доступа к выделенным тензорным данным для инициализации
Возврат
  • выделенный и инициализированный тензор
Броски
IllegalArgumentException если элементы данного type имеют переменную длину (например, строки)
IllegalArgumentException если shape полностью или частично unknown
IllegalStateException если тензор не удалось выделить

общедоступная статическая абстракция T of (тип Class<T>, форма Shape , ByteDataBuffer rawData)

Создает тензор любого типа из необработанных данных, предоставленных данным буфером.

Данные должны быть закодированы в data согласно спецификации TensorFlow C API .

Параметры
тип класс типа тензора
форма тензорная форма.
сырые данные буфер, содержащий необработанные данные тензора.
Броски
IllegalArgumentException если rawData недостаточно велик, чтобы содержать тензорные данные
IllegalArgumentException если shape полностью или частично unknown
IllegalStateException если тензору не удалось выделить заданные параметры

общедоступная абстрактная форма формы ( )

Возвращает форму тензора.