Spec-Zone.ru › TensorFlow C++ 2.9

tensorflow::Tensor

#include <tensor.h>

Представляет n-мерный массив значений.

Summary

Конструкторы и деструкторы
Tensor()
Создаёт одномерный тензор без элементов типа float.
Tensor(DataType type, const TensorShape & shape)
Создаёт тензор Tensor заданного type и shape.
Tensor(Allocator *a, DataType type, const TensorShape & shape)
Создаёт тензор с входными type и shape, используя аллокатор a для выделения базового буфера.
Tensor(Allocator *a, DataType type, const TensorShape & shape, const AllocationAttributes & allocation_attr)
Создаёт тензор с входными type и shape, используя аллокатор a и заданный "allocation_attr" для выделения базового буфера.
Tensor(DataType type, const TensorShape & shape, TensorBuffer *buf)
Создаёт тензор с входным типом данных, формой и буфером.
Tensor(DataType type, TensorShape shape, core::RefCountPtr< TensorBuffer > buf)
Создаёт тензор с входным типом данных, формой и буфером.
Tensor(DataType type)
Создаёт пустой тензор Tensor заданного типа данных.
Tensor(float scalar_value)
Tensor(double scalar_value)
Tensor(int32_t scalar_value)
Tensor(uint32 scalar_value)
Tensor(uint16 scalar_value)
Tensor(uint8 scalar_value)
Tensor(int16_t scalar_value)
Tensor(int8_t scalar_value)
Tensor(tstring scalar_value)
Tensor(complex64 scalar_value)
Tensor(complex128 scalar_value)
Tensor(int64_t scalar_value)
Tensor(uint64 scalar_value)
Tensor(bool scalar_value)
Tensor(qint8 scalar_value)
Tensor(quint8 scalar_value)
Tensor(qint16 scalar_value)
Tensor(quint16 scalar_value)
Tensor(qint32 scalar_value)
Tensor(bfloat16 scalar_value)
Tensor(Eigen::half scalar_value)
Tensor(ResourceHandle scalar_value)
Tensor(const char *scalar_value)
Tensor(const Tensor & other)
Конструктор копирования.
Tensor(Tensor && other)
Конструктор перемещения.
Tensor(T *t)
~Tensor()
Общедоступные функции
AllocatedBytes() const
size_t
AsProtoField(TensorProto *proto) const
void
Заполняет proto содержимым тензора *this.
AsProtoTensorContent(TensorProto *proto) const
void
BitcastFrom(const Tensor & other, DataType dtype, const TensorShape & shape)
Status
Копирует содержимое другого тензора в этот тензор, изменяет его форму и переинтерпретирует тип данных буфера.
CopyFrom(const Tensor & other, const TensorShape & shape) TF_MUST_USE_RESULT
bool
Копирует содержимое другого тензора в этот тензор и изменяет его форму.
DebugString(int num_values) const
std::string
Читаемое человеком описание тензора, подходящее для отладки.
DebugString() const
std::string
DeviceSafeDebugString() const
std::string
FillDescription(TensorDescription *description) const
void
Заполняет прото TensorDescription метаданными о тензоре, полезными для мониторинга и отладки.
FromProto(const TensorProto & other) TF_MUST_USE_RESULT
bool
Парсит other и создает тензор.
FromProto(Allocator *a, const TensorProto & other) TF_MUST_USE_RESULT
bool
GetMemoryType() const
AllocatorMemoryType
IsAligned() const
bool
Возвращает true, если этот тензор выровнен.
IsInitialized() const
bool
Если необходимо, был ли инициализирован этот тензор Tensor?
IsSameSize(const Tensor & b) const
bool
NumElements() const
int64_t
Удобный доступ к форме тензора.
RefCountIsOne() const
bool
SharesBufferWith(const Tensor & b) const
bool
Slice(int64_t dim0_start, int64_t dim0_limit) const
Tensor
Вырезает этот тензор по первому измерению.
SubSlice(int64_t index) const
Tensor
Выбирает подвырезку из этого тензора по первому измерению.
SummarizeValue(int64_t max_entries, bool print_v2) const
std::string
Отображает первые max_entries значения в *this в виде строки.
TotalBytes() const
size_t
Возвращает предполагаемое использование памяти этим тензором.
UnsafeCopyFromInternal(const Tensor & other, DataType dtype, const TensorShape & shape)
void
Как BitcastFrom, но CHECK возвращает ошибку, если не выполняются предварительные условия.
bit_casted_shaped(gtl::ArraySlice< int64_t > new_sizes)
TTypes< T, NDIMS >::Tensor
Возвращает данные тензора в Eigen::Tensor с новой формой, указанной в new_sizes, и преобразует их в новый тип данных T.
bit_casted_shaped(gtl::ArraySlice< int64_t > new_sizes) const
TTypes< T, NDIMS >::ConstTensor
Возвращает данные тензора в Eigen::Tensor с новой формой, указанной в new_sizes, и преобразует их в новый тип данных T.
bit_casted_tensor()
TTypes< T, NDIMS >::Tensor
Возвращает данные тензора в Eigen::Tensor с тем же размером, но с побитовым преобразованием в указанный тип данных T.
bit_casted_tensor() const
TTypes< T, NDIMS >::ConstTensor
Возвращает данные тензора в Eigen::Tensor с тем же размером, но с побитовым преобразованием в указанный тип данных T.
data() const
void *
dim_size(int d) const
int64_t
Удобный доступ к форме тензора.
dims() const
int
Удобный доступ к форме тензора.
dtype() const
DataType
Возвращает тип данных.
flat()
TTypes< T >::Flat
Возвращает данные тензора как Eigen::Tensor указанного типа данных и формы.
flat() const
TTypes< T >::ConstFlat
flat_inner_dims()
TTypes< T, NDIMS >::Tensor
Возвращает данные как Eigen::Tensor с NDIMS измерениями, сводя все измерения тензора Tensor, кроме последнего NDIMS-1, в первое измерение результата.
flat_inner_dims() const
TTypes< T, NDIMS >::ConstTensor
flat_inner_outer_dims(int64_t begin)
TTypes< T, NDIMS >::Tensor
Возвращает данные как Eigen::Tensor с NDIMS измерениями, сводя первые 'begin' измерений тензора Tensor в первое измерение результата и измерения тензора dims() - 'begin' - NDIMS в последнее измерение результата.
flat_inner_outer_dims(int64_t begin) const
TTypes< T, NDIMS >::ConstTensor
flat_outer_dims()
TTypes< T, NDIMS >::Tensor
Возвращает данные как Eigen::Tensor с NDIMS измерениями, сводя все измерения тензора Tensor, кроме первых NDIMS-1, в последнее измерение результата.
flat_outer_dims() const
TTypes< T, NDIMS >::ConstTensor
matrix()
TTypes< T >::Matrix
matrix() const
TTypes< T >::ConstMatrix
operator=(const Tensor & other)
Tensor &
Оператор присваивания. Этот тензор разделяет хранилище другого.
operator=(Tensor && other)
Tensor &
Оператор перемещения. См. конструктор перемещения для подробностей.
reinterpret_last_dimension()
TTypes< T, NDIMS >::Tensor
Возвращает данные тензора в Eigen::Tensor с элементами последнего измерения, преобразованными в отдельные элементы большего типа.
reinterpret_last_dimension() const
TTypes< T, NDIMS >::ConstTensor
Возвращает данные тензора в Eigen::Tensor с элементами последнего измерения, преобразованными в отдельные элементы большего типа.
scalar()
TTypes< T >::Scalar
Возвращает данные Tensor как TensorMap фиксированного размера 1: TensorMap>.
scalar() const
TTypes< T >::ConstScalar
shape() const
const TensorShape &
Возвращает форму тензора.
shaped(gtl::ArraySlice< int64_t > new_sizes)
TTypes< T, NDIMS >::Tensor
shaped(gtl::ArraySlice< int64_t > new_sizes) const
TTypes< T, NDIMS >::ConstTensor
tensor()
TTypes< T, NDIMS >::Tensor
tensor() const
TTypes< T, NDIMS >::ConstTensor
tensor_data() const
StringPiece
Возвращает StringPiece отображение буфера текущего тензора.
unaligned_flat()
TTypes< T >::UnalignedFlat
unaligned_flat() const
TTypes< T >::UnalignedConstFlat
unaligned_shaped(gtl::ArraySlice< int64_t > new_sizes)
TTypes< T, NDIMS >::UnalignedTensor
unaligned_shaped(gtl::ArraySlice< int64_t > new_sizes) const
TTypes< T, NDIMS >::UnalignedConstTensor
vec()
TTypes< T >::Vec
Возвращает данные тензора как Eigen::Tensor с типом и размерами этого Tensor.
vec() const
TTypes< T >::ConstVec
Константные версии всех вышеуказанных методов.
Общедоступные статические функции
BuildTensor(DataType type, const TensorShape & shape, Tensor *out_tensor)
Status
Инициализирует тензор входными данными type и shape, или возвращает ошибку и оставляет out_tensor без изменений.

Общедоступные функции

AllocatedBytes

size_t AllocatedBytes() const 

AsProtoField

void AsProtoField(
  TensorProto *proto
) const 

Заполняет proto содержимым тензора *this.

AsProtoField() заполняет повторяющееся поле для proto.dtype(), в то время как AsProtoTensorContent() кодирует содержимое в proto.tensor_content() в компактной форме.

AsProtoTensorContent

void AsProtoTensorContent(
  TensorProto *proto
) const 

BitcastFrom

Status BitcastFrom(
  const Tensor & other,
  DataType dtype,
  const TensorShape & shape
)

Копирует содержимое другого тензора в этот тензор, изменяет его форму и переинтерпретирует тип данных буфера.

Если Status::OK() возвращается, два тензора теперь используют одно и то же хранилище.

Этот вызов требует, чтобы тензор other и указанный тип и форма были «совместимы» (т.е. занимали одинаковое количество байтов).

В частности:

shape.num_elements() * DataTypeSize(type)

должно быть равно

other.num_elements() * DataTypeSize(other.dtype())

Кроме того, эта функция требует:

  • DataTypeSize(other.dtype()) != 0
  • DataTypeSize(type) != 0

Если любое из требований не выполняется, возвращается error::InvalidArgument.

END_OF_DOCUMENT_MARKER

CopyFrom

bool CopyFrom(
  const Tensor & other,
  const TensorShape & shape
) TF_MUST_USE_RESULT

Скопировать другой тензор в этот тензор и изменить его форму.

Этот тензор разделяет с другим тензором базовое хранилище. Возвращает true если other.shape() имеет то же количество элементов, что и указанный shape.

DebugString

std::string DebugString(
  int num_values
) const 

Человеко-читаемый сводный вывод тензора, подходящий для отладки.

DebugString

std::string DebugString() const 

DeviceSafeDebugString

std::string DeviceSafeDebugString() const 

FillDescription

void FillDescription(
  TensorDescription *description
) const 

Заполнить TensorDescription протокол метаданными о тензоре, которые полезны для мониторинга и отладки.

FromProto

bool FromProto(
  const TensorProto & other
) TF_MUST_USE_RESULT

Проанализировать other и создать тензор.

Возвращает true если разбор успешен. Если разбор завершился ошибкой, состояние *this не изменяется.

FromProto

bool FromProto(
  Allocator *a,
  const TensorProto & other
) TF_MUST_USE_RESULT

GetMemoryType

AllocatorMemoryType GetMemoryType() const 

IsAligned

bool IsAligned() const 

Возвращает true, если этот тензор выровнен.

IsInitialized

bool IsInitialized() const 

Если необходимо, был ли инициализирован этот Тензор?

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

IsSameSize

bool IsSameSize(
  const Tensor & b
) const 

NumElements

int64_t NumElements() const 

Удобный доступ к форме тензора.

RefCountIsOne

bool RefCountIsOne() const 

SharesBufferWith

bool SharesBufferWith(
  const Tensor & b
) const 

Slice

Tensor Slice(
  int64_t dim0_start,
  int64_t dim0_limit
) const 

Извлечение среза из этого тензора по первому измерению.

То есть, возвращаемый тензор удовлетворяет условию returned[i, ...] == this[dim0_start + i, ...]. Возвращаемый тензор разделяет буфер базового тензора с этим тензором.

ПРИМЕЧАНИЕ: Возвращаемый тензор может не соответствовать требованиям выравнивания этого тензора в зависимости от формы. Вызывающий код должен проверить выравнивание возвращаемого тензора перед вызовом определенных методов, имеющих требования к выравниванию (например, flat(), tensor()).

ПРИМЕЧАНИЕ: При подаче N-мерного тензора этот метод возвращает тензор также с N измерениями. Если требуется выбрать подтензор, обратитесь к SubSlice.

ТРЕБОВАНИЕ: dims() >= 1 ТРЕБОВАНИЕ: 0 <= dim0_start <= dim0_limit <= dim_size(0)

SubSlice

Tensor SubSlice(
  int64_t index
) const 

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

При подаче N-мерного тензора этот метод возвращает тензор с N-1 измерениями, где возвращаемый тензор является подсрезом входного тензора по первому измерению. N-1 измерения возвращаемого тензора представляют собой последние N-1 измерения входного тензора.

ПРИМЕЧАНИЕ: Возвращаемый тензор может не соответствовать требованиям выравнивания этого тензора в зависимости от формы. Вызывающий код должен проверить выравнивание возвращаемого тензора перед вызовом определенных методов, имеющих требования к выравниванию (например, flat(), tensor()).

ТРЕБОВАНИЕ: dims() >= 1 ТРЕБОВАНИЕ: 0 <= index < dim_size(0)

SummarizeValue

std::string SummarizeValue(
  int64_t max_entries,
  bool print_v2
) const 

Отображение первых max_entries значений в *this в строку.

Tensor

Tensor()

Создаёт одномерный тензор с 0 элементами типа float.

Возвращаемый Тензор не является скаляром (форма {}), а представляет собой пустой одномерный Тензор (форма {0}, NumElements() == 0). Так как он не содержит элементов, ему не нужно назначать значение, и он инициализируется по умолчанию (IsInitialized() истинно). Если это нежелательно, рассмотрите создание скаляра с одним элементом, требующего инициализации:

Tensor(DT_FLOAT, TensorShape({}))

Tensor

 Tensor(
  DataType type,
  const TensorShape & shape
)

Создаёт Тензор заданного type и shape.

Если LogMemory::IsEnabled(), выделение памяти регистрируется как происходящее из неизвестного ядра и шага. Прямой вызов конструктора Tensor внутри операции устарел: используйте методы allocate_* в OpKernelConstruction/OpKernelContext для выделения нового тензора, которые записывают ядро и шаг.

Базовый буфер выделяется с помощью CPUAllocator.

Tensor

 Tensor(
  Allocator *a,
  DataType type,
  const TensorShape & shape
)

Создаёт тензор с входным type и shape, используя аллокатор a для выделения базового буфера.

Если LogMemory::IsEnabled(), выделение памяти регистрируется как происходящее из неизвестного ядра и шага. Прямой вызов конструктора Tensor внутри операции устарел: используйте методы allocate_* в OpKernelConstruction/OpKernelContext для выделения нового тензора, которые записывают ядро и шаг.

a должен существовать дольше, чем этот Тензор.

Tensor

 Tensor(
  Allocator *a,
  DataType type,
  const TensorShape & shape,
  const AllocationAttributes & allocation_attr
)

Создаёт тензор с входным type и shape, используя аллокатор a и указанный "allocation_attr" для выделения базового буфера.

Если ядро и шаг известны, allocation_attr.allocation_will_be_logged должно быть установлено в true, и LogMemory::RecordTensorAllocation должно быть вызвано после создания тензора. Прямой вызов конструктора Tensor внутри операции устарел: используйте методы allocate_* в OpKernelConstruction/OpKernelContext для выделения нового тензора, которые записывают ядро и шаг.

a должен существовать дольше, чем этот Тензор.

Tensor

 Tensor(
  DataType type,
  const TensorShape & shape,
  TensorBuffer *buf
)

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

Получает ссылку на буфер, принадлежащий этому Тензору.

Tensor

 Tensor(
  DataType type,
  TensorShape shape,
  core::RefCountPtr< TensorBuffer > buf
)

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

Принимает владение буфером от указателя с подсчетом ссылок.

Tensor

 Tensor(
  DataType type
)

Создаёт пустой Тензор заданного типа данных.

Как и Tensor(), возвращает одномерный Тензор с 0 элементами, при котором IsInitialized() возвращает True. Смотрите документацию Tensor() для подробностей.

Tensor

 Tensor(
  float scalar_value
)

Tensor

 Tensor(
  double scalar_value
)

Tensor

 Tensor(
  int32_t scalar_value
)

Tensor

 Tensor(
  uint32 scalar_value
)

Tensor

 Tensor(
  uint16 scalar_value
)

Tensor

 Tensor(
  uint8 scalar_value
)

Tensor

 Tensor(
  int16_t scalar_value
)

Tensor

 Tensor(
  int8_t scalar_value
)

Tensor

 Tensor(
  tstring scalar_value
)

Tensor

 Tensor(
  complex64 scalar_value
)
END_OF_DOCUMENT_MARKER

Тензор

 Tensor(
  complex128 scalar_value
)

Тензор

 Tensor(
  int64_t scalar_value
)

Тензор

 Tensor(
  uint64 scalar_value
)

Тензор

 Tensor(
  bool scalar_value
)

Тензор

 Tensor(
  qint8 scalar_value
)

Тензор

 Tensor(
  quint8 scalar_value
)

Тензор

 Tensor(
  qint16 scalar_value
)

Тензор

 Tensor(
  quint16 scalar_value
)

Тензор

 Tensor(
  qint32 scalar_value
)

Тензор

 Tensor(
  bfloat16 scalar_value
)

Тензор

 Tensor(
  Eigen::half scalar_value
)

Тензор

 Tensor(
  ResourceHandle scalar_value
)

Тензор

 Tensor(
  const char *scalar_value
)

Тензор

 Tensor(
  const Tensor & other
)

Конструктор копирования.

Тензор

 Tensor(
  Tensor && other
)

Конструктор перемещения.

После этого вызова, безопасно уничтожаем, можно присваивать, и можно вызвать IsInitialized(), который вернёт false. Другие вызовы к (например, изменение формы) недопустимы.

Тензор

 Tensor(
  T *t
)=delete

Общий объём байт

size_t TotalBytes() const 

Возвращает приблизительный объём памяти, используемой этим тензором.

UnsafeCopyFromInternal

void UnsafeCopyFromInternal(
  const Tensor & other,
  DataType dtype,
  const TensorShape & shape
)

Подобно BitcastFrom, но CHECK вызывает ошибку, если не выполнены какие-либо предварительные условия.

Устарело. Используйте BitcastFrom вместо этого и проверьте возвращаемый Status.

bit_casted_shaped

TTypes< T, NDIMS >::Tensor bit_casted_shaped(
  gtl::ArraySlice< int64_t > new_sizes
)

Возвращает данные тензора в виде Eigen::Tensor, с новой формой, заданной в new_sizes, и приведённые к новому типу T.

Использование bitcast полезно для операций перемещения и копирования. Разрешённый bitcast - единственное отличие от shaped().

bit_casted_shaped

TTypes< T, NDIMS >::ConstTensor bit_casted_shaped(
  gtl::ArraySlice< int64_t > new_sizes
) const 

Возвращает данные тензора в виде Eigen::Tensor, с новой формой, заданной в new_sizes, и приведённые к новому типу T.

Использование bitcast полезно для операций перемещения и копирования. Разрешённый bitcast - единственное отличие от shaped().

bit_casted_tensor

TTypes< T, NDIMS >::Tensor bit_casted_tensor()

Возвращает данные тензора в виде Eigen::Tensor с таким же размером, но с битовым преобразованием в указанный тип T.

Использование bitcast полезно для операций перемещения и копирования. ПРИМЕЧАНИЕ: это то же самое, что и tensor() за исключением разрешённого bitcast.

bit_casted_tensor

TTypes< T, NDIMS >::ConstTensor bit_casted_tensor() const 

Возвращает данные тензора в виде Eigen::Tensor с таким же размером, но с битовым преобразованием в указанный тип T.

Использование bitcast полезно для операций перемещения и копирования. ПРИМЕЧАНИЕ: это то же самое, что и tensor() за исключением разрешённого bitcast.

данные

void * data() const 

размер_размерности

int64_t dim_size(
  int d
) const 

Удобный доступ к форме тензора.

размерности

int dims() const 

Удобный доступ к форме тензора.

Для всех доступа к форме, см. комментарии к соответствующим методам TensorShape в tensor_shape.h.

тип_данных

DataType dtype() const 

Возвращает тип данных.

плоский

TTypes< T >::Flat flat()

Возвращает данные тензора как Eigen::Tensor типа данных и заданной формы.

Эти методы позволяют получить доступ к данным с произвольными размерностями и размерами. Вам не нужно знать количество размерностей Тензора для их вызова. Однако они CHECK что тип совпадает, и запрошенные размерности создают Eigen::Tensor с таким же количеством элементов, что и у тензора.

Пример:

  
typedef float T;
Tensor my_ten(...built with Shape{planes: 4, rows: 3, cols: 5}...);
// 1D Eigen::Tensor, size 60:
auto flat = my_ten.flat();
// 2D Eigen::Tensor 12 x 5:
auto inner = my_ten.flat_inner_dims();
// 2D Eigen::Tensor 4 x 15:
auto outer = my_ten.shaped({4, 15});
// CHECK fails, bad num elements:
auto outer = my_ten.shaped({4, 8});
// 3D Eigen::Tensor 6 x 5 x 2:
auto weird = my_ten.shaped({6, 5, 2});
// CHECK fails, type mismatch:
auto bad   = my_ten.flat();

плоский

TTypes< T >::ConstFlat flat() const 

плоские_внутренние_размерности

TTypes< T, NDIMS >::Tensor flat_inner_dims()

Возвращает данные как Eigen::Tensor с NDIMS размерностями, сворачивая все размерности Тензора кроме последней NDIMS-1 в первую размерность результата.

Если NDIMS > dims(), то добавляются ведущие размерности размером 1, чтобы ранг выходного значения стал NDIMS.

плоские_внутренние_размерности

TTypes< T, NDIMS >::ConstTensor flat_inner_dims() const 

плоские_внутренние_внешние_размерности

TTypes< T, NDIMS >::Tensor flat_inner_outer_dims(
  int64_t begin
)

Возвращает данные как Eigen::Tensor с NDIMS размерностями, сворачивая первые 'begin' размерностей Тензора в первую размерность результата, и размерности Тензора от последней dims() - 'begin' - NDIMS в последнюю размерность результата.

Если 'begin' < 0, то добавляются |'begin'| ведущих размерностей размером 1. Если 'begin' + NDIMS > dims(), то добавляются 'begin' + NDIMS - dims() последующих размерностей размером 1.

плоские_внутренние_внешние_размерности

TTypes< T, NDIMS >::ConstTensor flat_inner_outer_dims(
  int64_t begin
) const 

плоские_внешние_размерности

TTypes< T, NDIMS >::Tensor flat_outer_dims()

Возвращает данные как Eigen::Tensor с NDIMS размерностями, сворачивая все размерности Тензора кроме первых NDIMS-1 в последнюю размерность результата.

Если NDIMS > dims(), то добавляются последующие размерности размером 1, чтобы ранг выходного значения стал NDIMS.

плоские_внешние_размерности

TTypes< T, NDIMS >::ConstTensor flat_outer_dims() const 

матрица

TTypes< T >::Matrix matrix()

матрица

TTypes< T >::ConstMatrix matrix() const 

оператор =

Tensor & operator=(
  const Tensor & other
)

Оператор присваивания. Этот тензор разделяет хранилище данных с другим тензором.

оператор =

Tensor & operator=(
  Tensor && other
)

Оператор перемещения. См. конструктор перемещения для получения подробностей.

переинтерпретация_последней_размерности

TTypes< T, NDIMS >::Tensor reinterpret_last_dimension()

Возвращает данные тензора в виде Eigen::Tensor с элементами последней размерности, преобразованными в отдельные элементы большего типа.

Например, это полезно для ядер, которые могут обрабатывать тензоры NCHW_VECT_C int8 как тензоры NCHW int32. sizeof(T) должно быть равно размеру исходного элементарного типа * количеству элементов в исходной последней размерности. NDIMS должен быть на 1 меньше, чем исходное количество размерностей.

END_OF_DOCUMENT_MARKER

переинтерпретация_последнего_измерения

TTypes< T, NDIMS >::ConstTensor reinterpret_last_dimension() const 

Возвращает данные тензора в Eigen::Tensor с элементами последнего измерения, преобразованными в отдельные элементы большего типа.

Это полезно, например, для ядер, которые могут обрабатывать тензоры NCHW_VECT_C int8 как тензоры NCHW int32. Значение sizeof(T) должно равняться размеру исходного типа элементов * числу элементов в исходном последнем измерении. NDIMS должен быть на 1 меньше, чем исходное количество измерений.

скаляр

TTypes< T >::Scalar scalar()

Возвращает данные тензора как TensorMap фиксированного размера 1: TensorMap>.

Использование scalar() позволяет компилятору выполнять оптимизации, поскольку размер тензора известен на этапе компиляции.

скаляр

TTypes< T >::ConstScalar scalar() const 

форма

const TensorShape & shape() const 

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

с_формой

TTypes< T, NDIMS >::Tensor shaped(
  gtl::ArraySlice< int64_t > new_sizes
)

с_формой

TTypes< T, NDIMS >::ConstTensor shaped(
  gtl::ArraySlice< int64_t > new_sizes
) const 

тензор

TTypes< T, NDIMS >::Tensor tensor()

тензор

TTypes< T, NDIMS >::ConstTensor tensor() const 

данные_тензора

StringPiece tensor_data() const 

Возвращает StringPiece отображающее буфер текущего тензора.

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

ПРИМЕЧАНИЕ: базовый буфер тензора имеет счетчик ссылок, поэтому срок жизни содержимого, отображенного StringPiece, соответствует сроку жизни буфера; вызывающие стороны должны позаботиться о том, чтобы буфер не был уничтожен, пока StringPiece все еще используется.

ТРЕБУЕТСЯ: DataTypeCanUseMemcpy(dtype()).

невыровненная_плоская

TTypes< T >::UnalignedFlat unaligned_flat()

невыровненная_плоская

TTypes< T >::UnalignedConstFlat unaligned_flat() const 

невыровненная_с_формой

TTypes< T, NDIMS >::UnalignedTensor unaligned_shaped(
  gtl::ArraySlice< int64_t > new_sizes
)

невыровненная_с_формой

TTypes< T, NDIMS >::UnalignedConstTensor unaligned_shaped(
  gtl::ArraySlice< int64_t > new_sizes
) const 

вектор

TTypes< T >::Vec vec()

Возвращает данные тензора как Eigen::Tensor с типом и размерами этого Tensor.

Используйте эти методы, когда вы знаете тип данных и количество измерений тензора и хотите Eigen::Tensor автоматически с размером, соответствующим Tensor размерам. Реализация завершается ошибкой, если типы или размеры не совпадают.

Пример:

  
typedef float T;
Tensor my_mat(...built with Shape{rows: 3, cols: 5}...);
auto mat = my_mat.matrix();    // 2D Eigen::Tensor, 3 x 5.
auto mat = my_mat.tensor(); // 2D Eigen::Tensor, 3 x 5.
auto vec = my_mat.vec();       // CHECK fails as my_mat is 2D.
auto vec = my_mat.tensor(); // CHECK fails as my_mat is 2D.
auto mat = my_mat.matrix();// CHECK fails as type mismatch.

вектор

TTypes< T >::ConstVec vec() const 

Константные версии всех вышеперечисленных методов.

~Tensor

~Tensor()

Открытые статические функции

СоздатьТензор

Status BuildTensor(
  DataType type,
  const TensorShape & shape,
  Tensor *out_tensor
)

Инициализирует тензор с входными type и shape, или возвращает ошибку и оставляет out_tensor неизменным.

Этот фабричный метод следует использовать вместо соответствующего конструктора, если вызывающий код не может проверить, что DataType является допустимым и поддерживаемым.

Базовый буфер выделяется с помощью CPUAllocator.

© 2022 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 4.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.9/api_docs/cc/class/tensorflow/tensor

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API