FormAction

class fuse.actions.FormAction(k=None, proxy='scalar')

Bases: KernelAction

The value is a k-form, identified with a scalar or vector by proxy.

proxy is one of

  • "scalar": a 0-form, or a top form (a density);

  • "flat": a vector v read as the form v♭, or on an edge the scalar coefficient of its 1-form;

  • "hodge": a vector v read as ★v♭, or on an entity of dimension n the scalar coefficient of its n-form.

On the entity the kernel is defined on, the action depends only on k. The proxy matters when the DOF is immersed: a flat form lifts along the entity (a tangent), a hodge form across it (a normal), which needs k = d - 1 for the cell it lands in.

k=None means k is determined by the entity:

the top degree for a scalar, one less for a vector.

__init__(k=None, proxy='scalar')

Methods

__init__([k, proxy])

act(A, value)

The value transformed by a symmetry with action matrix A.

dict_id()

lift_matrix(cell, entity, rank)

Matrix taking the value on entity to its value in cell when the DOF is immersed, or None when the value is unchanged.

lifted()

The action on the value once it is lifted into the cell.

matches(other)

Whether this action is the one other describes.

pullback(dimension)

The name of the map taking functions from the reference cell to a physical cell of dimension that this (resolved) action induces.

resolve(entity, rank)

This action on a kernel of rank defined on entity, with anything that depends on the entity filled in.

sobolev_space(dimension)

The Sobolev space a conforming element with this (resolved) action lies in, in a cell of dimension, and the dimension of the entities that must carry DOFs for it to conform (None for L2).

trace(cell, entity, rank, value)

The trace: a value in cell restricted to entity.

Attributes

PROXIES

act(A, value)

The value transformed by a symmetry with action matrix A.

lift_matrix(cell, entity, rank)

Matrix taking the value on entity to its value in cell when the DOF is immersed, or None when the value is unchanged.

lifted()

The action on the value once it is lifted into the cell.

matches(other)

Whether this action is the one other describes.

pullback(dimension)

The name of the map taking functions from the reference cell to a physical cell of dimension that this (resolved) action induces.

resolve(entity, rank)

This action on a kernel of rank defined on entity, with anything that depends on the entity filled in.

sobolev_space(dimension)

The Sobolev space a conforming element with this (resolved) action lies in, in a cell of dimension, and the dimension of the entities that must carry DOFs for it to conform (None for L2).