Term Overview¶
Term Syntax¶
In general, the syntax of a term call is:
<term name>.<i>.<r>( <arg1>, <arg2>, ... )
,
where <i>
denotes an integral name (i.e. a name of numerical quadrature
to use) and <r>
marks a region (domain of the integral).
The following notation is used:
symbol |
meaning |
---|---|
cell (volume) (sub)domain |
|
facet (surface) (sub)domain |
|
cell or facet (sub)domain |
|
dimension of space |
|
time |
|
any function |
|
any vector function |
|
unit outward normal |
|
scalar test or parameter function |
|
scalar unknown or parameter function |
|
vector test or parameter function |
|
, |
vector unknown or parameter function |
Cauchy strain tensor () |
|
deformation gradient |
|
right Cauchy-Green deformation tensor |
|
Green strain tensor |
|
second Piola-Kirchhoff stress tensor |
|
vector volume forces |
|
scalar volume force (source) |
|
density |
|
kinematic viscosity |
|
, , |
any constant |
Kronecker delta, identity matrix |
|
trace of a second order tensor () |
|
deviator of a second order tensor () |
|
-th element of triangulation (= mesh) of domain |
|
is assigned values from in ascending order |
The suffix “” denotes a quantity related to a previous time step.
Term names are (usually) prefixed according to the following conventions:
prefix |
meaning |
evaluation modes |
meaning |
---|---|---|---|
dw |
discrete weak |
‘weak’ |
terms having a virtual (test) argument and zero or more unknown arguments, used for FE assembling |
ev |
evaluate |
‘eval’, ‘el_eval’, ‘el_avg’, ‘qp’ |
terms having all arguments known, modes ‘el_avg’, ‘qp’ are not supported by all ev_ terms |
de |
discrete einsum |
any (work in progress) |
multi-linear terms defined using an enriched einsum notation |
Evaluation modes ‘eval’, ‘el_avg’ and ‘qp’ are defined as follows:
mode |
definition |
---|---|
‘eval’ |
|
‘el_avg’ |
vector for |
‘qp’ |
Term Table¶
Below we list all the terms available in automatically generated tables. The first column lists the name, the second column the argument lists and the third column the mathematical definition of each term. The terms are devided into the following tables:
Table of large deformation terms (total/updated Lagrangian formulation)
The notation <virtual>
corresponds to a test function,
<state>
to a unknown function and <parameter>
to a known function. By
<material>
we denote material (constitutive) parameters, or, in general, any
given function of space and time that parameterizes a term, for example
a given traction force vector.
Table of basic terms¶
name/class |
arguments |
definition |
examples |
---|---|---|---|
dw_advect_div_free |
|
||
dw_bc_newton |
|
||
dw_biot |
|
the.ela.ess, bio.npb, bio.sho.syn, bio, the.ela, bio.npb.lag |
|
ev_biot_stress |
|
||
ev_cauchy_strain |
|
||
ev_cauchy_stress |
|
||
dw_contact |
|
||
dw_contact_plane |
|
||
dw_contact_sphere |
|
||
dw_convect |
|
||
dw_convect_v_grad_s |
|
||
ev_def_grad |
|
||
dw_dg_advect_laxfrie_flux |
|
where |
|
dw_dg_diffusion_flux |
|
where |
|
dw_dg_interior_penalty |
|
where |
|
dw_dg_nonlinear_laxfrie_flux |
|
where |
|
dw_diffusion |
|
bio.npb, bio.sho.syn, bio, vib.aco, pie.ela, dar.flo.mul, pie.ela, poi.neu, bio.npb.lag |
|
dw_diffusion_coupling |
|
||
dw_diffusion_r |
|
||
ev_diffusion_velocity |
|
||
ev_div |
|
||
dw_div |
|
||
dw_div_grad |
|
||
dw_dot |
|
lin.ela.dam, bor, adv.2D, vib.aco, hyd, tim.hea.equ.mul.mat, poi.fun, lin.ela.up, poi.per.bou.con, bur.2D, sto.sli.bc, bal, tim.poi, dar.flo.mul, ref.evp, tim.adv.dif, mod.ana.dec, the.ele, hel.apa, aco, aco, pie.ela, tim.poi.exp, osc, adv.1D, pie.ela, wel |
|
dw_elastic_wave |
|
||
dw_elastic_wave_cauchy |
|
||
dw_electric_source |
|
||
ev_grad |
|
||
ev_integrate |
|
||
dw_integrate |
|
poi.per.bou.con, vib.aco, hel.apa, dar.flo.mul, aco, aco, tim.hea.equ.mul.mat, poi.neu |
|
ev_integrate_mat |
|
||
dw_jump |
|
||
dw_laplace |
|
the.ela.ess, lap.2D, bor, poi.sho.syn, lap.tim.ebc, vib.aco, hyd, tim.hea.equ.mul.mat, cub, poi.fun, poi.per.bou.con, bur.2D, sto.sli.bc, poi.iga, tim.poi, adv.dif.2D, ref.evp, poi.par.stu, tim.adv.dif, sin, the.ele, poi.fie.dep.mat, hel.apa, lap.flu.2d, aco, aco, tim.poi.exp, osc, poi, lap.cou.lcb, wel, lap.1d |
|
dw_lin_convect |
|
||
dw_lin_convect2 |
|
||
dw_lin_dspring |
|
||
dw_lin_elastic |
|
mul.nod.lcb, the.ela.ess, ela, mix.mes, lin.ela.dam, com.ela.mat, bio.sho.syn, tru.bri, lin.vis, vib.aco, lin.ela.tra, lin.ela.mM, lin.ela.up, lin.ela, its.1, mat.non, pie.ela.mac, mod.ana.dec, sei.loa, its.3, bio, pre.fib, wed.mes, its.4, mul.poi.con, pie.ela, the.ela, lin.ela.opt, bio.npb.lag, bio.npb, lin.ela.iga, two.bod.con, pie.ela, nod.lcb, ela.shi.per, its.2, ela.con.sph, ela.con.pla |
|
dw_lin_elastic_iso |
|
||
dw_lin_elastic_l_ad |
|
||
dw_lin_elastic_yp_ad |
|
||
dw_lin_prestress |
|
||
dw_lin_spring |
|
||
dw_lin_strain_fib |
|
||
dw_lin_truss |
|
||
ev_lin_truss_force |
|
||
dw_mass_ad |
|
||
dw_nl_diffusion |
|
||
dw_non_penetration |
|
||
dw_non_penetration_p |
|
||
dw_nonsym_elastic |
|
||
dw_ns_dot_grad_s |
|
||
dw_piezo_coupling |
|
||
ev_piezo_strain |
|
||
ev_piezo_stress |
|
||
dw_point_load |
|
||
dw_point_lspring |
|
||
dw_s_dot_grad_i_s |
|
||
dw_s_dot_mgrad_s |
|
||
dw_shell10x |
|
||
dw_stokes |
|
lin.ela.up, sto.sli.bc, sto, nav.sto, nav.sto, nav.sto.iga, sta.nav.sto |
|
dw_stokes_wave |
|
||
dw_stokes_wave_div |
|
||
ev_sum_vals |
|
||
ev_surface_flux |
|
||
dw_surface_flux |
|
||
dw_surface_ltr |
|
mix.mes, com.ela.mat, tru.bri, lin.vis, lin.ela.tra, nod.lcb, wed.mes, ela.shi.per, lin.ela.opt |
|
ev_surface_moment |
|
||
dw_surface_ndot |
|
||
ev_surface_piezo_flux |
|
||
dw_v_dot_grad_s |
|
||
dw_vm_dot_s |
|
||
ev_volume |
|
||
dw_volume_lvf |
|
||
dw_volume_nvf |
|
||
ev_volume_surface |
|
||
dw_zero |
|
Table of sensitivity terms¶
name/class |
arguments |
definition |
examples |
---|---|---|---|
dw_adj_convect1 |
|
||
dw_adj_convect2 |
|
||
dw_adj_div_grad |
|
||
ev_sd_convect |
|
||
ev_sd_diffusion |
|
||
de_sd_diffusion |
|
||
ev_sd_div |
|
||
ev_sd_div_grad |
|
||
de_sd_div_grad |
|
||
ev_sd_dot |
|
||
de_sd_dot |
|
||
de_sd_lin_elastic |
|
||
ev_sd_lin_elastic |
|
||
ev_sd_piezo_coupling |
|
||
de_sd_piezo_coupling |
|
||
de_sd_stokes |
|
||
ev_sd_surface_integrate |
|
||
de_sd_surface_ltr |
|
||
ev_sd_surface_ltr |
|
||
de_sd_v_dot_grad_s |
|
Table of large deformation terms¶
name/class |
arguments |
definition |
examples |
---|---|---|---|
dw_tl_bulk_active |
|
||
dw_tl_bulk_penalty |
|
||
dw_tl_bulk_pressure |
|
||
dw_tl_diffusion |
|
||
dw_tl_fib_a |
|
||
dw_tl_fib_e |
|
||
dw_tl_he_genyeoh |
|
||
dw_tl_he_mooney_rivlin |
|
||
dw_tl_he_neohook |
|
per.tl, com.ela.mat, bal, hyp, act.fib |
|
dw_tl_he_neohook_ad |
|
||
dw_tl_he_ogden |
|
||
dw_tl_he_ogden_ad |
|
||
dw_tl_membrane |
|
||
ev_tl_surface_flux |
|
||
dw_tl_surface_traction |
|
||
dw_tl_volume |
|
||
ev_tl_volume_surface |
|
||
dw_ul_bulk_penalty |
|
||
dw_ul_bulk_pressure |
|
||
dw_ul_compressible |
|
||
dw_ul_he_mooney_rivlin |
|
||
dw_ul_he_neohook |
|
||
dw_ul_volume |
|
Table of special terms¶
name/class |
arguments |
definition |
examples |
---|---|---|---|
dw_biot_eth |
|
||
dw_biot_th |
|
||
ev_cauchy_stress_eth |
|
||
ev_cauchy_stress_th |
|
||
dw_lin_elastic_eth |
|
||
dw_lin_elastic_th |
|
||
ev_of_ns_surf_min_d_press |
|
||
dw_of_ns_surf_min_d_press_diff |
|
||
ev_sd_st_grad_div |
|
||
ev_sd_st_pspg_c |
|
||
ev_sd_st_pspg_p |
|
||
ev_sd_st_supg_c |
|
||
dw_st_adj1_supg_p |
|
||
dw_st_adj2_supg_p |
|
||
dw_st_adj_supg_c |
|
||
dw_st_grad_div |
|
||
dw_st_pspg_c |
|
||
dw_st_pspg_p |
|
||
dw_st_supg_c |
|
||
dw_st_supg_p |
|
||
dw_volume_dot_w_scalar_eth |
|
||
dw_volume_dot_w_scalar_th |
|
Table of multi-linear terms¶
name/class |
arguments |
definition |
examples |
---|---|---|---|
de_cauchy_stress |
|
||
de_convect |
|
||
de_diffusion |
|
||
de_div |
|
||
de_div_grad |
|
||
de_dot |
|
||
de_grad |
|
||
de_integrate |
|
||
de_laplace |
|
||
de_lin_convect |
|
||
de_lin_elastic |
|
||
de_m_flexo |
|
||
de_m_flexo_coupling |
|
||
de_m_sg_elastic |
|
||
de_mass |
|
||
de_non_penetration_p |
|
||
de_nonsym_elastic |
|
||
de_s_dot_mgrad_s |
|
||
de_stokes |
|
||
de_stokes_traction |
|
||
de_surface_flux |
|
||
de_surface_ltr |
|
||
de_surface_piezo_flux |
|