differential_geometry.dependence.TensorDependenceMixin.raise_index#

TensorDependenceMixin.raise_index(axis: int, /, *, as_field: bool = False)[source]#

Raise a tensor index along the specified axis using the inverse metric tensor.

Parameters:

  • axis (int) – The index axis to raise.

  • as_field (bool, optional) – If True, return a symbolic expression. If False, return a new dependence object.

Returns:

Symbolic tensor with raised index or a new dependence object.

Return type:

_GenericFieldType or _DepT

Raises:

ValueError – If the tensor is scalar (rank 0).