Struct Tensor 

pub struct Tensor { /* private fields */ }

The uniform tensor value: an n-dimensional array of scalar number cells.

A tensor is row-major (last axis varies fastest) and homogeneous: every cell shares the dtype number domain. An empty shape denotes a rank-0 scalar holding a single cell. Tensors are the value backing the numbers/tensor domain and are constructed through build_tensor_value rather than parsed from literals.

Implementations

impl Tensor

pub fn new_checked( cx: &mut Cx, shape: Vec<usize>, dtype: Symbol, data: Vec<Value>, ) -> Result<Self>

Builds a tensor after checking shape, scalar-cell, and promotion invariants against the loaded number-domain registry.

pub fn new_exact( shape: Vec<usize>, dtype: Symbol, data: Vec<Value>, ) -> Result<Self>

Builds a tensor whose cells already exactly match dtype.

Specialized tensor backends use this when converting packed storage into uniform tensor cells without needing a loaded registry. It is stricter than Tensor::new_checked: every cell must report exactly dtype.

pub fn shape(&self) -> &[usize]

The tensor shape, outermost axis first. Empty means a rank-0 scalar.

pub fn dtype(&self) -> &Symbol

The shared scalar number domain accepted by every tensor cell.

pub fn data(&self) -> &[Value]

Row-major scalar cell storage.

pub fn rank(&self) -> usize

The number of axes, i.e. the length of shape. Zero for a scalar.

pub fn flat_offset(shape: &[usize], indices: &[usize]) -> Result<usize>

Computes the row-major flat offset into data for a multi-dimensional indices coordinate against shape.

Returns an error if the index rank does not match shape or any component is out of bounds.

Examples

use sim_lib_numbers_tensor::Tensor;

// Row-major 2x3 tensor: element (1, 2) is at flat offset 5.
assert_eq!(Tensor::flat_offset(&[2, 3], &[1, 2]).unwrap(), 5);
assert_eq!(Tensor::flat_offset(&[2, 3], &[0, 0]).unwrap(), 0);
// Out-of-bounds and rank-mismatched indices are rejected.
assert!(Tensor::flat_offset(&[2, 3], &[2, 0]).is_err());
assert!(Tensor::flat_offset(&[2, 3], &[0]).is_err());

pub fn coordinates(shape: &[usize]) -> Vec<Vec<usize>>

Enumerates every multi-dimensional coordinate of shape in row-major order. An empty shape yields a single empty coordinate (the scalar cell).

Trait Implementations

impl Citizen for Tensor

fn citizen_symbol() -> Symbol

The citizen’s namespace/name class symbol.

fn citizen_version() -> u32

The citizen’s encoding version.

fn citizen_arity() -> usize

Number of constructor fields (excluding the version argument).

fn citizen_fields() -> &'static [&'static str]

The citizen’s field names, in constructor order.

impl Clone for Tensor

fn clone(&self) -> Tensor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl NumberValue for Tensor

fn number_domain(&self, _cx: &mut Cx) -> Result<Symbol>

The number domain this value reports membership in.

fn number_literal(&self, _cx: &mut Cx) -> Result<Option<NumberLiteral>, Error>

Canonical literal form, or Ok(None) when not representable.

impl Object for Tensor

fn display(&self, cx: &mut Cx) -> Result<String>

Render the object as a human-readable display string.

fn as_any(&self) -> &dyn Any

Expose the object for Rust downcasting.

fn header(&self) -> &ObjectHeader

Identity and trust header for the object; defaults to the shared anonymous header.

fn op(&self, _key: &OpKey) -> Option<&dyn Op>

Resolve the operation registered under key, if any.

fn claims( &self, _cx: &mut Cx, _pattern: &ClaimPattern, _sink: &mut dyn ClaimSink, ) -> Result<(), Error>

Emit the object’s claims matching pattern into sink.

fn snapshot(&self, _cx: &mut Cx) -> Result<Option<Datum>, Error>

Optional content-addressable snapshot of the object’s state.

impl ObjectCompat for Tensor

fn class(&self, cx: &mut Cx) -> Result<ClassRef>

Class object this value belongs to; defaults to nil.

fn as_expr(&self, cx: &mut Cx) -> Result<Expr>

Expression form of the object; defaults to an opaque extension node.

fn as_table(&self, cx: &mut Cx) -> Result<Value>

Project the object into a table value; the default exposes its display.

fn as_number_value(&self) -> Option<&dyn NumberValue>

Number-value view, if the object is a domain number.

fn as_object_encoder(&self) -> Option<&dyn ObjectEncode>

Object-encoder view, if the object encodes other objects.

fn as_callable(&self) -> Option<&dyn Callable>

Callable view, if the object can be invoked.

fn as_class(&self) -> Option<&dyn Class>

Class view, if the object is a class.

fn as_shape(&self) -> Option<&dyn Shape>

Shape view, if the object is a shape.

fn as_read_constructor(&self) -> Option<&dyn ReadConstructor>

Read-constructor view, if the object decodes data forms.

fn as_number_domain(&self) -> Option<&(dyn NumberDomain + 'static)>

Number-domain view, if the object is a number domain.

fn as_eval_fabric(&self) -> Option<&dyn EvalFabric>

Eval-fabric view, if the object is a distributed eval surface.

fn as_stream(&self) -> Option<&dyn Stream>

Stream view, if the object is a stream.

fn as_sequence(&self) -> Option<&dyn Sequence>

Sequence view, if the object is a sequence.

fn as_thunk(&self) -> Option<&dyn Thunk>

Thunk view, if the object is a deferred computation.

fn as_list(&self) -> Option<&(dyn ListValue + 'static)>

List view, if the object is a list value.

fn as_table_impl(&self) -> Option<&(dyn Table + 'static)>

Table-implementation view, if the object is a table.

fn as_dir(&self) -> Option<&(dyn Dir + 'static)>

Directory view, if the object is a directory.

fn truth(&self, _cx: &mut Cx) -> Result<bool, Error>

Truthiness of the object; defaults to true.

fn publish_shape_satisfaction_claims( &self, _cx: &mut Cx, _shape: &Ref, ) -> Result<bool, Error>

Publish claims asserting that the object satisfies shape; returns whether any were published.

impl ObjectEncode for Tensor

fn object_encoding(&self, cx: &mut Cx) -> Result<ObjectEncoding>

Returns the ObjectEncoding this object should be rendered as.