sfepy.terms.terms_basic module¶

class sfepy.terms.terms_basic.IntegrateMatTerm(name, arg_str, integral, region, **kwargs)[source]¶

Evaluate material parameter $m$ in a volume region.

Depending on evaluation mode, integrate a material parameter over a volume region (‘eval’), average it in elements (‘el_avg’) or interpolate it into volume quadrature points (‘qp’).

Uses reference mapping of $y$ variable.

Supports ‘eval’, ‘el_avg’ and ‘qp’ evaluation modes.

Definition:

$\int_{\cal{D}} c$

Call signature:

ev_integrate_mat

(material, parameter)

Arguments:

material : $c$ (can have up to two dimensions)
parameter : $y$

arg_shapes = [{'material': 'N, N', 'parameter': 'N'}]¶

arg_types = ('material', 'parameter')¶

static function(out, mat, geo, fmode)[source]¶

get_eval_shape(mat, parameter, mode=None, term_mode=None, diff_var=None, **kwargs)[source]¶

get_fargs(mat, parameter, mode=None, term_mode=None, diff_var=None, **kwargs)[source]¶

integration = ('cell', 'facet')¶

name = 'ev_integrate_mat'¶

class sfepy.terms.terms_basic.IntegrateOperatorTerm(name, arg_str, integral, region, **kwargs)[source]¶

Integral of a test function weighted by a scalar function $c$ .

Definition:

$\int_{\cal{D}} q \mbox{ or } \int_{\cal{D}} c q$

Call signature:

dw_integrate

(opt_material, virtual)

Arguments:

material : $c$ (optional)
virtual : $q$

arg_shapes = [{'opt_material': '1, 1', 'virtual': (1, None)}, {'opt_material': None}]¶

arg_types = ('opt_material', 'virtual')¶

static function(out, material, bf, geo)[source]¶

get_fargs(material, virtual, mode=None, term_mode=None, diff_var=None, **kwargs)[source]¶

integration = ('cell', 'facet')¶

name = 'dw_integrate'¶

class sfepy.terms.terms_basic.IntegrateTerm(name, arg_str, integral, region, **kwargs)[source]¶

Evaluate (weighted) variable in a region.

Depending on evaluation mode, integrate a variable over a region (‘eval’), average it in elements (‘el_avg’) or interpolate it into quadrature points (‘qp’). For a surface region and vector variables, setting term_mode to ‘flux’ leads to computing corresponding fluxes for the three modes instead.

Supports ‘eval’, ‘el_avg’ and ‘qp’ evaluation modes.

Definition:

$\int_{\cal{D}} y \mbox{ , } \int_{\cal{D}} \ul{y} \mbox{ , } \int_\Gamma \ul{y} \cdot \ul{n}\\ \int_{\cal{D}} c y \mbox{ , } \int_{\cal{D}} c \ul{y} \mbox{ , } \int_\Gamma c \ul{y} \cdot \ul{n} \mbox{ flux }$

Call signature:

ev_integrate

(opt_material, parameter)

Arguments:

material : $c$ (optional)
parameter : $y$ or $\ul{y}$

arg_shapes = [{'opt_material': '1, 1', 'parameter': 'N'}, {'opt_material': None}]¶

arg_types = ('opt_material', 'parameter')¶

static function(out, val_qp, vg, fmode)[source]¶

get_eval_shape(material, parameter, mode=None, term_mode=None, diff_var=None, **kwargs)[source]¶

get_fargs(material, parameter, mode=None, term_mode=None, diff_var=None, **kwargs)[source]¶

integration = ('cell', 'facet')¶

name = 'ev_integrate'¶

class sfepy.terms.terms_basic.SumNodalValuesTerm(name, arg_str, integral, region, **kwargs)[source]¶

Sum nodal values.

Call signature:

ev_sum_vals

(parameter)

Arguments:

parameter : $p$ or $\ul{u}$

arg_shapes = {'parameter': 'N'}¶

arg_types = ('parameter',)¶

static function(out, vec)[source]¶

get_eval_shape(parameter, mode=None, term_mode=None, diff_var=None, **kwargs)[source]¶

get_fargs(parameter, mode=None, term_mode=None, diff_var=None, **kwargs)[source]¶

name = 'ev_sum_vals'¶

class sfepy.terms.terms_basic.SurfaceMomentTerm(name, arg_str, integral, region, **kwargs)[source]¶

Surface integral of the outer product of the unit outward normal $\ul{n}$ and the coordinate $\ul{x}$ shifted by $\ul{x}_0$

Definition:

$\int_{\Gamma} \ul{n} (\ul{x} - \ul{x}_0)$

Call signature:

ev_surface_moment

(material, parameter)

Arguments:

material : $\ul{x}_0$ (special)
parameter : any variable

arg_shapes = {'material': '.: D', 'parameter': 'N'}¶

arg_types = ('material', 'parameter')¶

static function(out, in_, cmap, conn)¶

get_eval_shape(material, parameter, mode=None, term_mode=None, diff_var=None, **kwargs)[source]¶

get_fargs(material, parameter, mode=None, term_mode=None, diff_var=None, **kwargs)[source]¶

integration = 'facet'¶

name = 'ev_surface_moment'¶

class sfepy.terms.terms_basic.VolumeSurfaceTerm(name, arg_str, integral, region, **kwargs)[source]¶

Volume of a $D$ -dimensional domain, using a surface integral. Uses approximation of the parameter variable.

Definition:

$1 / D \int_\Gamma \ul{x} \cdot \ul{n}$

Call signature:

ev_volume_surface

(parameter)

Arguments:

parameter : any variable

arg_shapes = {'parameter': 'N'}¶

arg_types = ('parameter',)¶

static function(out, in_, cmap, conn)¶

get_eval_shape(parameter, mode=None, term_mode=None, diff_var=None, **kwargs)[source]¶

get_fargs(parameter, mode=None, term_mode=None, diff_var=None, **kwargs)[source]¶

integration = 'facet'¶

name = 'ev_volume_surface'¶

class sfepy.terms.terms_basic.VolumeTerm(name, arg_str, integral, region, **kwargs)[source]¶

Volume or surface of a domain. Uses approximation of the parameter variable.

Definition:

$\int_{\cal{D}} 1$

Call signature:

ev_volume

(parameter)

Arguments:

parameter : any variable

arg_shapes = [{'parameter': 'N'}]¶

arg_types = ('parameter',)¶

static function(out, geo)[source]¶

get_eval_shape(parameter, mode=None, term_mode=None, diff_var=None, **kwargs)[source]¶

get_fargs(parameter, mode=None, term_mode=None, diff_var=None, **kwargs)[source]¶

integration = ('cell', 'facet')¶

name = 'ev_volume'¶

class sfepy.terms.terms_basic.ZeroTerm(name, arg_str, integral, region, **kwargs)[source]¶

A do-nothing term useful for introducing additional variables into the equations.

Definition:

$0$

Call signature:

dw_zero

(virtual, state)

Arguments:

virtual : $q$ or $\ul{v}$
state : $p$ or $\ul{u}$

arg_shapes = {'state': 'N', 'virtual': ('N', None)}¶

arg_types = ('virtual', 'state')¶

static function(out)[source]¶

get_fargs(vvar, svar, mode=None, term_mode=None, diff_var=None, **kwargs)[source]¶

name = 'dw_zero'¶