Struct CubeTensor 

pub struct CubeTensor<R>
where
    R: CubeRuntime,
{
    pub client: ComputeClient<<R as Runtime>::Server>,
    pub handle: Handle,
    pub shape: Shape,
    pub device: <R as Runtime>::Device,
    pub strides: Vec<usize>,
    pub dtype: DType,
    pub qparams: Option<QParams<QParamTensor>>,
}

The basic tensor primitive struct.

Fields

client: ComputeClient<<R as Runtime>::Server>

Compute client for the runtime.

handle: Handle

The buffer where the data are stored.

shape: Shape

The shape of the tensor.

device: <R as Runtime>::Device

The device of the tensor.

strides: Vec<usize>

The strides of the tensor.

dtype: DType

The datatype of the tensor.

qparams: Option<QParams<QParamTensor>>

Runtime quantization parameters, if applicable

Implementations

impl<R> CubeTensor<R>

where R: CubeRuntime,

pub fn new( client: ComputeClient<<R as Runtime>::Server>, handle: Handle, shape: Shape, device: <R as Runtime>::Device, strides: Vec<usize>, dtype: DType, ) -> CubeTensor<R>

Create a new standard tensor

pub fn new_contiguous( client: ComputeClient<<R as Runtime>::Server>, device: <R as Runtime>::Device, shape: Shape, handle: Handle, dtype: DType, ) -> CubeTensor<R>

Create a new tensor with a contiguous memory layout.

pub fn to_client( &self, client: ComputeClient<<R as Runtime>::Server>, device: <R as Runtime>::Device, ) -> CubeTensor<R>

Change the context of the current tensor and return the newly transferred tensor.

pub fn as_handle_ref(&self) -> TensorHandleRef<'_, R>

Return the reference to a tensor handle.

pub fn elem_size(&self) -> usize

Returns the element size of this tensor

pub fn as_tensor_arg<'a, E>(&'a self, line_size: u8) -> TensorArg<'a, R>

where E: CubeElement,

Return the reference to a tensor argument.

pub fn as_array_arg<E>(&self, vectorisation: u8) -> ArrayArg<'_, R>

where E: CubeElement,

Return the reference to an array argument.

pub fn copy(&self) -> CubeTensor<R>

Copy the current tensor.

pub fn can_mut(&self) -> bool

Check if the tensor is safe to mutate.

pub fn assert_is_on_same_device(&self, other: &CubeTensor<R>)

Assert that both tensors are on the same device.

pub fn is_contiguous(&self) -> bool

Check if the current tensor is contiguous.

A tensor is contiguous if the elements are stored in memory if the strides in non-increasing order and the strides at position k is equal to the product of the shapes at all positions greater than k. However, all axes with a shape of 1 are ignored.

pub fn is_contiguous_buffer(&self) -> bool

Check if the current tensor has a contiguous backing buffer (no overlap and no empty memory regions within the shape).

impl<R> CubeTensor<R>

where R: CubeRuntime,

pub fn new_quantized( client: ComputeClient<<R as Runtime>::Server>, handle: Handle, shape: Shape, device: <R as Runtime>::Device, strides: Vec<usize>, dtype: DType, qparams: QParams<QParamTensor>, ) -> CubeTensor<R>

Create a new quantized tensor

pub fn quantized_handles(&self) -> Option<(CubeTensor<R>, CubeTensor<R>)>

Returns the two tensors: (values, params) for a quantized tensor.

pub fn scales(&self) -> Option<CubeTensor<R>>

Construct a separate tensor for the quantization scales, if present

Trait Implementations

impl<R> Clone for CubeTensor<R>

where R: CubeRuntime,

fn clone(&self) -> CubeTensor<R>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<R> Debug for CubeTensor<R>

where R: CubeRuntime,

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<R> QTensorPrimitive for CubeTensor<R>

where R: CubeRuntime,

fn scheme(&self) -> &QuantScheme

Returns the quantization settings for the given tensor.

fn acc_precision(&self) -> QuantAcc

The precision used for the accumulation in various kernels.

fn propagation(&self) -> QuantPropagation

How quantization is propagated during computation.

fn default_scheme() -> QuantScheme

Returns the default tensor quantization scheme.

impl<R> TensorMetadata for CubeTensor<R>

where R: CubeRuntime,

fn dtype(&self) -> DType

The dtype of the tensor.

fn shape(&self) -> Shape

The shape of the tensor.

fn rank(&self) -> usize

The number of dimensions of the tensor.

impl<R> AutotuneOutput for CubeTensor<R>

where R: CubeRuntime,