TensorLibrary

Create a new empty tensor library (static method).

Initializes an empty library ready for registering tensor structures. The library automatically manages internal tensor IDs.

from symbolica.community.spenso import TensorLibrary
lib = TensorLibrary.construct()

Register a tensor in the library.

Adds a tensor template to the library that can be referenced by name in tensor networks and symbolic expressions. The tensor must have a name set in its structure.

from symbolica.community.spenso import Tensor, TensorLibrary, TensorName, Representation
lib = TensorLibrary()
rep = Representation.euc(3)
name = TensorName("my_tensor")
structure = name(rep, rep)
tensor = Tensor.dense(structure, [1.0, 0.0, 0.0, 1.0, 0.0, 0.0, 1.0, 0.0, 0.0])
lib.register(tensor)
tensor_ref = lib[name]

Retrieve a registered tensor structure by name.

Looks up a previously registered tensor by its name and returns a reference structure that can be used to create new tensor instances.

exact = lib[TensorName("T")(1, Representation.euc(3))]
unique_by_name = lib["T"]

Create a library pre-loaded with High Energy Physics tensor definitions.

Returns a library containing standard HEP tensors such as gamma matrices, color generators, metric tensors, and other commonly used structures in particle physics calculations. They are floating point tensors with f64 precision.

import symbolica
from symbolica.community.spenso import TensorLibrary, TensorName
hep_lib = TensorLibrary.hep_lib()
gamma_structure = hep_lib[symbolica.S("spenso::gamma")]

Create a library pre-loaded with High Energy Physics tensor definitions.

Returns a library containing standard HEP tensors such as gamma matrices, color generators, metric tensors, and other commonly used structures in particle physics calculations. They are tensors with atom numeric entries.

import symbolica
from symbolica.community.spenso import TensorLibrary, TensorName
hep_lib = TensorLibrary.hep_lib_atom()
gamma_structure = hep_lib[symbolica.S("spenso::gamma")]