VectorTriple

class fuse.vectorisation.VectorTriple(base, dim=None, perm=True)

Bases: ElementTriple

A vector valued element formed from a scalar valued one.

The DOFs of the base element are repeated once per component, each restricted to that component, and the polynomial space gains a shape.

dim is the value shape, and defaults to the spatial dimension of the cell. It need not be the spatial dimension: an element carrying one scalar per chemical species, energy group or Fourier mode has as many components as the model has unknowns. A shape of rank two gives a full tensor valued element, without any symmetry constraint.

__init__(base, dim=None, perm=True)

Methods

__init__(base[, dim, perm])

compute_dense_matrix(ref_el, entity_ids, ...)

dict_id()

generate()

Clone each DOF once per component, tagging it with a ComponentKernel.

get_dof_info(dof[, tikz])

get_value_shape()

mapping(g)

A matrix describing how the symmetry g of the cell transforms the DOFs.

num_dofs()

plot([filename])

Generates Matplotlib code for the element diagrams.

pullback()

The name of the map taking the element from the reference cell to a physical cell.

reverse_dof_perms(matrices)

setup_ids_and_nodes()

setup_matrices()

Each component of a vector triple transforms as a scalar under the identity pullback, and an orientation acts on every component alike, so the matrices of the base element lift by a Kronecker product with the identity.

sobolev_space()

The name of the Sobolev space the element lies in.

sub_elements()

to_fiat()

to_tikz([show, scale])

Generates tikz code for the element diagram

to_ufl()

Attributes

degree

form_degree

The degree of differential form this element represents.

generate()

Clone each DOF once per component, tagging it with a ComponentKernel.

Builds (new_dofs, comp_map), where comp_map sends each new DOF id to the (original dof id, flat component position) it came from.

Components are enumerated in np.ndindex order, which is the order FIAT’s ONPolynomialSet lays out the members of a shaped space. Ordering is component innermost, matching the convention of finat.TensorFiniteElement with shape_innermost. Each clone keeps the entity of the DOF it came from, so the entity grouping of the original element carries over unchanged.

setup_matrices()

Each component of a vector triple transforms as a scalar under the identity pullback, and an orientation acts on every component alike, so the matrices of the base element lift by a Kronecker product with the identity.