Adding and managing finite elements. More...

Collaboration diagram for Finite elements:

Finite elements
virtual MoFEMErrorCode	MoFEM::CoreInterface::add_finite_element (const std::string &fe_name, enum MoFEMTypes bh=MF_EXCL, int verb=DEFAULT_VERBOSITY)=0
	add finite element More...

virtual MoFEMErrorCode	MoFEM::CoreInterface::modify_finite_element_adjacency_table (const std::string &fe_name, const EntityType type, ElementAdjacencyFunct function)=0
	modify finite element table, only for advanced user More...

virtual MoFEMErrorCode	MoFEM::CoreInterface::modify_finite_element_add_field_data (const std::string &fe_name, const std::string name_filed)=0
	set finite element field data More...

virtual MoFEMErrorCode	MoFEM::CoreInterface::modify_finite_element_off_field_data (const std::string &fe_name, const std::string name_filed)=0
	unset finite element field data More...

virtual MoFEMErrorCode	MoFEM::CoreInterface::modify_finite_element_add_field_row (const std::string &fe_name, const std::string name_row)=0
	set field row which finite element use More...

virtual MoFEMErrorCode	MoFEM::CoreInterface::modify_finite_element_off_field_row (const std::string &fe_name, const std::string name_row)=0
	unset field row which finite element use More...

virtual MoFEMErrorCode	MoFEM::CoreInterface::modify_finite_element_add_field_col (const std::string &fe_name, const std::string name_row)=0
	set field col which finite element use More...

virtual MoFEMErrorCode	MoFEM::CoreInterface::modify_finite_element_off_field_col (const std::string &fe_name, const std::string name_row)=0
	unset field col which finite element use More...

virtual MoFEMErrorCode	MoFEM::CoreInterface::add_ents_to_finite_element_by_type (const EntityHandle entities, const EntityType type, const std::string &name, const bool recursive=true)=0
	add entities to finite element More...

virtual MoFEMErrorCode	MoFEM::CoreInterface::add_ents_to_finite_element_by_dim (const EntityHandle entities, const int dim, const std::string &name, const bool recursive=true)=0
	add entities to finite element More...

virtual MoFEMErrorCode	MoFEM::CoreInterface::add_ents_to_finite_element_by_type (const Range &ents, const EntityType type, const std::string &name)=0
	add entities to finite elements More...

virtual MoFEMErrorCode	MoFEM::CoreInterface::add_ents_to_finite_element_by_dim (const Range &ents, const int dim, const std::string &name)=0
	add entities to finite elements More...

virtual MoFEMErrorCode	MoFEM::CoreInterface::add_ents_to_finite_element_by_bit_ref (const BitRefLevel &bit, const BitRefLevel &mask, const std::string &name, EntityType type, int verb=DEFAULT_VERBOSITY)=0
	add TET entities from given refinement level to finite element database given by name More...

virtual EntityHandle	MoFEM::CoreInterface::get_finite_element_meshset (const std::string name) const =0

virtual MoFEMErrorCode	MoFEM::CoreInterface::remove_ents_from_finite_element_by_bit_ref (const BitRefLevel bit, const BitRefLevel mask, int verb=DEFAULT_VERBOSITY)=0
	remove elements from given refinement level to finite element database More...

virtual MoFEMErrorCode	MoFEM::CoreInterface::remove_ents_from_finite_element (const std::string name, const Range ents, int verb=DEFAULT_VERBOSITY)=0
	remove entities from finite element database More...

virtual MoFEMErrorCode	MoFEM::CoreInterface::remove_ents_from_finite_element (const Range ents, int verb=DEFAULT_VERBOSITY)=0
	remove entities from finite elements in database More...

virtual MoFEMErrorCode	MoFEM::CoreInterface::add_ents_to_finite_element_by_MESHSET (const EntityHandle meshset, const std::string &name, const bool recursive=false)=0
	add MESHSET element to finite element database given by name More...

virtual MoFEMErrorCode	MoFEM::CoreInterface::list_finite_elements () const =0
	list finite elements in database More...

Build fields, finite elements and problems
virtual MoFEMErrorCode	MoFEM::CoreInterface::build_finite_elements (int verb=DEFAULT_VERBOSITY)=0
	Build finite elements. More...

virtual MoFEMErrorCode	MoFEM::CoreInterface::build_finite_elements (const string fe_name, const Range *const ents_ptr=nullptr, int verb=DEFAULT_VERBOSITY)=0
	Build finite elements. More...

Detailed Description

Adding and managing finite elements.

Function Documentation

◆ add_ents_to_finite_element_by_bit_ref()

virtual MoFEMErrorCode MoFEM::CoreInterface::add_ents_to_finite_element_by_bit_ref	(	const BitRefLevel &	bit,
		const BitRefLevel &	mask,
		const std::string &	name,
		EntityType	type,
		int	verb = `DEFAULT_VERBOSITY`
	)

pure virtual

add TET entities from given refinement level to finite element database given by name

Note: not collective

Parameters

BitRefLevel	bit
BitRefLevel	mask
finite	element name
finite	element type
verbose	level

Implemented in MoFEM::CoreTmp< 0 >.

◆ add_ents_to_finite_element_by_dim() [1/2]

virtual MoFEMErrorCode MoFEM::CoreInterface::add_ents_to_finite_element_by_dim	(	const EntityHandle	entities,
		const int	dim,
		const std::string &	name,
		const bool	recursive = `true`
	)

pure virtual

add entities to finite element

Note: not collective

Parameters

entities	meshset or range form were entities taken
dim	dimension
name	name of field
recursive	take entities from meshsets in meshset

Returns: error code

Implemented in MoFEM::CoreTmp< 0 >.

Examples: continuity_check_on_skeleton_3d.cpp, elasticity.cpp, hcurl_divergence_operator_2d.cpp, HookeElement.cpp, NavierStokesElement.hpp, photon_diffusion.cpp, remove_entities_from_problem.cpp, remove_entities_from_problem_not_partitioned.cpp, and simple_elasticity.cpp.

◆ add_ents_to_finite_element_by_dim() [2/2]

virtual MoFEMErrorCode MoFEM::CoreInterface::add_ents_to_finite_element_by_dim	(	const Range &	ents,
		const int	dim,
		const std::string &	name
	)

pure virtual

add entities to finite elements

Note: not collective

Parameters

ents	range of entities
dim	dimension of entities
name	name of finite element

Returns: error code

Implemented in MoFEM::CoreTmp< 0 >.

◆ add_ents_to_finite_element_by_MESHSET()

virtual MoFEMErrorCode MoFEM::CoreInterface::add_ents_to_finite_element_by_MESHSET	(	const EntityHandle	meshset,
		const std::string &	name,
		const bool	recursive = `false`
	)

pure virtual

add MESHSET element to finite element database given by name

Note: not collective

Parameters

meshset	contains all entities that could be used for finite element
name	Finite Element name

Implemented in MoFEM::CoreTmp< 0 >.

◆ add_ents_to_finite_element_by_type() [1/2]

virtual MoFEMErrorCode MoFEM::CoreInterface::add_ents_to_finite_element_by_type	(	const EntityHandle	entities,
		const EntityType	type,
		const std::string &	name,
		const bool	recursive = `true`
	)

pure virtual

add entities to finite element

Note: not collective

Parameters

entities	meshset or range form were entities taken
type	type of entity
name	name of field
recursive	take entities from meshsets in meshset

Returns: error code

Implemented in MoFEM::CoreTmp< 0 >.

◆ add_ents_to_finite_element_by_type() [2/2]

virtual MoFEMErrorCode MoFEM::CoreInterface::add_ents_to_finite_element_by_type	(	const Range &	ents,
		const EntityType	type,
		const std::string &	name
	)

pure virtual

add entities to finite elements

Note: not collective

Parameters

ents	range of entities
type	type of entity (MBVERTEX, MBEDGE, MBTRI, ...)
name	name of finite element

Returns: error code

Implemented in MoFEM::CoreTmp< 0 >.

◆ add_finite_element()

virtual MoFEMErrorCode MoFEM::CoreInterface::add_finite_element	(	const std::string &	fe_name,
		enum MoFEMTypes	bh = `MF_EXCL`,
		int	verb = `DEFAULT_VERBOSITY`
	)

pure virtual

add finite element

Parameters

name	finite element name

Note: add_file is a collective, should be executed on all processors. Otherwise could lead to deadlock.

Example

CHKERR mField.add_finite_element("ELASTIC");

CHKERR mField.add_finite_element("PLASTIC");

Implemented in MoFEM::CoreTmp< 0 >.

Examples: build_large_problem.cpp, build_problems.cpp, cell_forces.cpp, continuity_check_on_contact_prism_side_ele.cpp, continuity_check_on_skeleton_3d.cpp, dm_build_partitioned_mesh.cpp, dm_create_subdm.cpp, dm_partitioned_no_field.cpp, elasticity.cpp, elasticity_mixed_formulation.cpp, forces_and_sources_testing_edge_element.cpp, forces_and_sources_testing_flat_prism_element.cpp, forces_and_sources_testing_users_base.cpp, hcurl_divergence_operator_2d.cpp, HookeElement.cpp, MagneticElement.hpp, mesh_insert_interface_atom.cpp, mesh_smoothing.cpp, minimal_surface_area.cpp, mortar_contact_thermal.cpp, NavierStokesElement.hpp, nonlinear_dynamics.cpp, photon_diffusion.cpp, prism_elements_from_surface.cpp, prism_polynomial_approximation.cpp, quad_polynomial_approximation.cpp, remove_entities_from_problem.cpp, remove_entities_from_problem_not_partitioned.cpp, simple_contact_thermal.cpp, simple_elasticity.cpp, test_jacobian_of_simple_contact_element.cpp, and UnsaturatedFlow.hpp.

◆ build_finite_elements() [1/2]

virtual MoFEMErrorCode MoFEM::CoreInterface::build_finite_elements	(	const string	fe_name,
		const Range *const	ents_ptr = `nullptr`,
		int	verb = `DEFAULT_VERBOSITY`
	)

pure virtual

Build finite elements.

Build finite element data structures. Have to be run before problem and adjacencies are constructed.

Parameters

fe_name	Name of finite element
ents_ptr	Pointer to range of finite elements
verb	Verbosity level

Returns: Error code

Implemented in MoFEM::CoreTmp< 0 >.

◆ build_finite_elements() [2/2]

virtual MoFEMErrorCode MoFEM::CoreInterface::build_finite_elements ( int verb = DEFAULT_VERBOSITY )

pure virtual

Build finite elements.

Build finite element data structures. Have to be run before problem and adjacencies are constructed.

Parameters

verb	Verbosity level

Returns: Error code

Implemented in MoFEM::CoreTmp< 0 >.

Examples: build_large_problem.cpp, build_problems.cpp, cell_forces.cpp, continuity_check_on_contact_prism_side_ele.cpp, continuity_check_on_skeleton_3d.cpp, dm_build_partitioned_mesh.cpp, dm_create_subdm.cpp, dm_partitioned_no_field.cpp, elasticity.cpp, elasticity_mixed_formulation.cpp, forces_and_sources_testing_edge_element.cpp, forces_and_sources_testing_flat_prism_element.cpp, forces_and_sources_testing_users_base.cpp, hcurl_divergence_operator_2d.cpp, lorentz_force.cpp, MagneticElement.hpp, mesh_insert_interface_atom.cpp, minimal_surface_area.cpp, mixed_poisson.cpp, mortar_contact.cpp, mortar_contact_thermal.cpp, nonlinear_dynamics.cpp, photon_diffusion.cpp, prism_elements_from_surface.cpp, prism_polynomial_approximation.cpp, quad_polynomial_approximation.cpp, remove_entities_from_problem.cpp, remove_entities_from_problem_not_partitioned.cpp, simple_contact.cpp, simple_contact_thermal.cpp, simple_elasticity.cpp, test_jacobian_of_simple_contact_element.cpp, and UnsaturatedFlow.hpp.

◆ get_finite_element_meshset()

virtual EntityHandle MoFEM::CoreInterface::get_finite_element_meshset ( const std::string name ) const

pure virtual

get finite element meshset

Implemented in MoFEM::CoreTmp< 0 >.

Examples: level_set.cpp.

◆ list_finite_elements()

virtual MoFEMErrorCode MoFEM::CoreInterface::list_finite_elements ( ) const

pure virtual

list finite elements in database

Implemented in MoFEM::CoreTmp< 0 >.

◆ modify_finite_element_add_field_col()

virtual MoFEMErrorCode MoFEM::CoreInterface::modify_finite_element_add_field_col	(	const std::string &	fe_name,
		const std::string	name_row
	)

pure virtual

set field col which finite element use

Note: add_file is a collective, should be executed on all processors. Otherwise could lead to deadlock.

Parameters

name	finite element name
name	field name

Implemented in MoFEM::CoreTmp< 0 >.

Examples: build_large_problem.cpp, build_problems.cpp, cell_forces.cpp, continuity_check_on_contact_prism_side_ele.cpp, continuity_check_on_skeleton_3d.cpp, dm_build_partitioned_mesh.cpp, dm_create_subdm.cpp, dm_partitioned_no_field.cpp, elasticity.cpp, elasticity_mixed_formulation.cpp, forces_and_sources_testing_edge_element.cpp, forces_and_sources_testing_flat_prism_element.cpp, forces_and_sources_testing_users_base.cpp, hcurl_divergence_operator_2d.cpp, HookeElement.cpp, MagneticElement.hpp, mesh_insert_interface_atom.cpp, mesh_smoothing.cpp, minimal_surface_area.cpp, mortar_contact_thermal.cpp, NavierStokesElement.hpp, nonlinear_dynamics.cpp, prism_elements_from_surface.cpp, prism_polynomial_approximation.cpp, quad_polynomial_approximation.cpp, remove_entities_from_problem.cpp, remove_entities_from_problem_not_partitioned.cpp, simple_contact_thermal.cpp, simple_elasticity.cpp, test_jacobian_of_simple_contact_element.cpp, and UnsaturatedFlow.hpp.

◆ modify_finite_element_add_field_data()

virtual MoFEMErrorCode MoFEM::CoreInterface::modify_finite_element_add_field_data	(	const std::string &	fe_name,
		const std::string	name_filed
	)

pure virtual

set finite element field data

Note: add_file is a collective, should be executed on all processors. Otherwise could lead to deadlock.

Parameters

name	finite element name
name	field name

This function will set memory in the form of a vector

Implemented in MoFEM::CoreTmp< 0 >.

Examples: build_large_problem.cpp, cell_forces.cpp, continuity_check_on_contact_prism_side_ele.cpp, continuity_check_on_skeleton_3d.cpp, dm_build_partitioned_mesh.cpp, dm_create_subdm.cpp, dm_partitioned_no_field.cpp, elasticity.cpp, elasticity_mixed_formulation.cpp, forces_and_sources_testing_edge_element.cpp, forces_and_sources_testing_flat_prism_element.cpp, forces_and_sources_testing_users_base.cpp, hcurl_divergence_operator_2d.cpp, HookeElement.cpp, MagneticElement.hpp, mesh_insert_interface_atom.cpp, mesh_smoothing.cpp, minimal_surface_area.cpp, mortar_contact_thermal.cpp, NavierStokesElement.hpp, nonlinear_dynamics.cpp, photon_diffusion.cpp, prism_elements_from_surface.cpp, prism_polynomial_approximation.cpp, quad_polynomial_approximation.cpp, remove_entities_from_problem.cpp, remove_entities_from_problem_not_partitioned.cpp, simple_contact_thermal.cpp, simple_elasticity.cpp, test_jacobian_of_simple_contact_element.cpp, and UnsaturatedFlow.hpp.

◆ modify_finite_element_add_field_row()

virtual MoFEMErrorCode MoFEM::CoreInterface::modify_finite_element_add_field_row	(	const std::string &	fe_name,
		const std::string	name_row
	)

pure virtual

set field row which finite element use

Note: add_file is a collective, should be executed on all processors. Otherwise could lead to deadlock.

Parameters

name	finite element name
name	field name

Implemented in MoFEM::CoreTmp< 0 >.

Examples: build_large_problem.cpp, build_problems.cpp, cell_forces.cpp, continuity_check_on_contact_prism_side_ele.cpp, continuity_check_on_skeleton_3d.cpp, dm_build_partitioned_mesh.cpp, dm_create_subdm.cpp, dm_partitioned_no_field.cpp, elasticity.cpp, elasticity_mixed_formulation.cpp, forces_and_sources_testing_edge_element.cpp, forces_and_sources_testing_flat_prism_element.cpp, forces_and_sources_testing_users_base.cpp, hcurl_divergence_operator_2d.cpp, HookeElement.cpp, MagneticElement.hpp, mesh_insert_interface_atom.cpp, mesh_smoothing.cpp, minimal_surface_area.cpp, mortar_contact_thermal.cpp, NavierStokesElement.hpp, nonlinear_dynamics.cpp, prism_elements_from_surface.cpp, prism_polynomial_approximation.cpp, quad_polynomial_approximation.cpp, remove_entities_from_problem.cpp, remove_entities_from_problem_not_partitioned.cpp, simple_contact_thermal.cpp, simple_elasticity.cpp, test_jacobian_of_simple_contact_element.cpp, and UnsaturatedFlow.hpp.

◆ modify_finite_element_adjacency_table()

virtual MoFEMErrorCode MoFEM::CoreInterface::modify_finite_element_adjacency_table	(	const std::string &	fe_name,
		const EntityType	type,
		ElementAdjacencyFunct	function
	)

pure virtual

modify finite element table, only for advanced user

Note: add_file is a collective, should be executed on all processors. Otherwise could lead to deadlock.

Using that functions means that you like to do something not usual.

Implemented in MoFEM::CoreTmp< 0 >.

Examples: scalar_check_approximation.cpp.

◆ modify_finite_element_off_field_col()

virtual MoFEMErrorCode MoFEM::CoreInterface::modify_finite_element_off_field_col	(	const std::string &	fe_name,
		const std::string	name_row
	)

pure virtual

unset field col which finite element use

Note: add_file is a collective, should be executed on all processors. Otherwise could lead to deadlock.

Parameters

name	finite element name
name	field name

Implemented in MoFEM::CoreTmp< 0 >.

◆ modify_finite_element_off_field_data()

virtual MoFEMErrorCode MoFEM::CoreInterface::modify_finite_element_off_field_data	(	const std::string &	fe_name,
		const std::string	name_filed
	)

pure virtual

unset finite element field data

Note: add_file is a collective, should be executed on all processors. Otherwise could lead to deadlock.

Parameters

name	finite element name
name	field name

This function will set memory in the form of a vector

Implemented in MoFEM::CoreTmp< 0 >.

◆ modify_finite_element_off_field_row()

virtual MoFEMErrorCode MoFEM::CoreInterface::modify_finite_element_off_field_row	(	const std::string &	fe_name,
		const std::string	name_row
	)

pure virtual

unset field row which finite element use

Note: add_file is a collective, should be executed on all processors. Otherwise could lead to deadlock.

Parameters

name	finite element name
name	field name

Implemented in MoFEM::CoreTmp< 0 >.

◆ remove_ents_from_finite_element() [1/2]

virtual MoFEMErrorCode MoFEM::CoreInterface::remove_ents_from_finite_element	(	const Range	ents,
		int	verb = `DEFAULT_VERBOSITY`
	)

pure virtual

remove entities from finite elements in database

Implemented in MoFEM::CoreTmp< 0 >.

◆ remove_ents_from_finite_element() [2/2]

virtual MoFEMErrorCode MoFEM::CoreInterface::remove_ents_from_finite_element	(	const std::string	name,
		const Range	ents,
		int	verb = `DEFAULT_VERBOSITY`
	)

pure virtual

remove entities from finite element database

Implemented in MoFEM::CoreTmp< 0 >.

◆ remove_ents_from_finite_element_by_bit_ref()

virtual MoFEMErrorCode MoFEM::CoreInterface::remove_ents_from_finite_element_by_bit_ref	(	const BitRefLevel	bit,
		const BitRefLevel	mask,
		int	verb = `DEFAULT_VERBOSITY`
	)

pure virtual

remove elements from given refinement level to finite element database

Parameters

BitRefLevel	bit
BitRefLevel	mask
verbose	level

Implemented in MoFEM::CoreTmp< 0 >.

Finite elements

Build fields, finite elements and problems

Detailed Description

Function Documentation

◆ add_ents_to_finite_element_by_bit_ref()

◆ add_ents_to_finite_element_by_dim() [1/2]

◆ add_ents_to_finite_element_by_dim() [2/2]

◆ add_ents_to_finite_element_by_MESHSET()

◆ add_ents_to_finite_element_by_type() [1/2]

◆ add_ents_to_finite_element_by_type() [2/2]

◆ add_finite_element()

◆ build_finite_elements() [1/2]

◆ build_finite_elements() [2/2]

◆ get_finite_element_meshset()

◆ list_finite_elements()

◆ modify_finite_element_add_field_col()

◆ modify_finite_element_add_field_data()

◆ modify_finite_element_add_field_row()

◆ modify_finite_element_adjacency_table()

◆ modify_finite_element_off_field_col()

◆ modify_finite_element_off_field_data()

◆ modify_finite_element_off_field_row()

◆ remove_ents_from_finite_element() [1/2]

◆ remove_ents_from_finite_element() [2/2]

◆ remove_ents_from_finite_element_by_bit_ref()