Известные косвенные подклассы |
Статически типизированный многомерный массив.
В 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 | |
абстрактный статический <T расширяет TType > T | |
абстрактный статический <T расширяет TType > T | |
абстрактный статический <T расширяет TType > T | |
абстрактный статический <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 для вычисления размера по форме |
dataInitializer | метод получения доступа к выделенным тензорным данным для инициализации |
Возврат
- выделенный и инициализированный тензор
Броски
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 | если тензору не удалось выделить заданные параметры |