#include <one_d_mesh.template.h>

Inheritance diagram for oomph::OneDMesh< ELEMENT >:

Public Member Functions
	OneDMesh (const unsigned &n_element, const double &length, TimeStepper *time_stepper_pt=&Mesh::Default_TimeStepper)

	OneDMesh (const unsigned &n_element, const double &xmin, const double &xmax, TimeStepper *time_stepper_pt=&Mesh::Default_TimeStepper)

Public Member Functions inherited from oomph::LineMeshBase
	LineMeshBase ()
	Constructor (empty) More...

	LineMeshBase (const LineMeshBase &node)=delete
	Broken copy constructor. More...

void	operator= (const LineMeshBase &)=delete
	Broken assignment operator. More...

virtual	~LineMeshBase ()
	Destructor (empty) More...

void	setup_boundary_element_info ()

void	setup_boundary_element_info (std::ostream &outfile)

Public Member Functions inherited from oomph::Mesh
	Mesh ()
	Default constructor. More...

	Mesh (const Vector< Mesh * > &sub_mesh_pt)

void	merge_meshes (const Vector< Mesh * > &sub_mesh_pt)

virtual void	reset_boundary_element_info (Vector< unsigned > &ntmp_boundary_elements, Vector< Vector< unsigned >> &ntmp_boundary_elements_in_region, Vector< FiniteElement * > &deleted_elements)
	Virtual function to perform the reset boundary elements info rutines. More...

template<class BULK_ELEMENT >
void	doc_boundary_coordinates (const unsigned &b, std::ofstream &the_file)

virtual void	scale_mesh (const double &factor)

	Mesh (const Mesh &dummy)=delete
	Broken copy constructor. More...

void	operator= (const Mesh &)=delete
	Broken assignment operator. More...

virtual	~Mesh ()
	Virtual Destructor to clean up all memory. More...

void	flush_element_and_node_storage ()

void	flush_element_storage ()

void	flush_node_storage ()

Node *&	node_pt (const unsigned long &n)
	Return pointer to global node n. More...

Node *	node_pt (const unsigned long &n) const
	Return pointer to global node n (const version) More...

GeneralisedElement *&	element_pt (const unsigned long &e)
	Return pointer to element e. More...

GeneralisedElement *	element_pt (const unsigned long &e) const
	Return pointer to element e (const version) More...

const Vector< GeneralisedElement * > &	element_pt () const
	Return reference to the Vector of elements. More...

Vector< GeneralisedElement * > &	element_pt ()
	Return reference to the Vector of elements. More...

FiniteElement *	finite_element_pt (const unsigned &e) const

Node *&	boundary_node_pt (const unsigned &b, const unsigned &n)
	Return pointer to node n on boundary b. More...

Node *	boundary_node_pt (const unsigned &b, const unsigned &n) const
	Return pointer to node n on boundary b. More...

void	set_nboundary (const unsigned &nbound)
	Set the number of boundaries in the mesh. More...

void	remove_boundary_nodes ()
	Clear all pointers to boundary nodes. More...

void	remove_boundary_nodes (const unsigned &b)

void	remove_boundary_node (const unsigned &b, Node *const &node_pt)
	Remove a node from the boundary b. More...

void	add_boundary_node (const unsigned &b, Node *const &node_pt)
	Add a (pointer to) a node to the b-th boundary. More...

void	copy_boundary_node_data_from_nodes ()

bool	boundary_coordinate_exists (const unsigned &i) const
	Indicate whether the i-th boundary has an intrinsic coordinate. More...

unsigned long	nelement () const
	Return number of elements in the mesh. More...

unsigned long	nnode () const
	Return number of nodes in the mesh. More...

unsigned	ndof_types () const
	Return number of dof types in mesh. More...

unsigned	elemental_dimension () const
	Return number of elemental dimension in mesh. More...

unsigned	nodal_dimension () const
	Return number of nodal dimension in mesh. More...

void	add_node_pt (Node *const &node_pt)
	Add a (pointer to a) node to the mesh. More...

void	add_element_pt (GeneralisedElement *const &element_pt)
	Add a (pointer to) an element to the mesh. More...

virtual void	node_update (const bool &update_all_solid_nodes=false)

virtual void	reorder_nodes (const bool &use_old_ordering=true)

virtual void	get_node_reordering (Vector< Node * > &reordering, const bool &use_old_ordering=true) const

template<class BULK_ELEMENT , template< class > class FACE_ELEMENT>
void	build_face_mesh (const unsigned &b, Mesh *const &face_mesh_pt)

unsigned	self_test ()
	Self-test: Check elements and nodes. Return 0 for OK. More...

void	max_and_min_element_size (double &max_size, double &min_size)

double	total_size ()

void	check_inverted_elements (bool &mesh_has_inverted_elements, std::ofstream &inverted_element_file)

void	check_inverted_elements (bool &mesh_has_inverted_elements)

unsigned	check_for_repeated_nodes (const double &epsilon=1.0e-12)

Vector< Node * >	prune_dead_nodes ()

unsigned	nboundary () const
	Return number of boundaries. More...

unsigned long	nboundary_node (const unsigned &ibound) const
	Return number of nodes on a particular boundary. More...

FiniteElement *	boundary_element_pt (const unsigned &b, const unsigned &e) const
	Return pointer to e-th finite element on boundary b. More...

Node *	get_some_non_boundary_node () const

unsigned	nboundary_element (const unsigned &b) const
	Return number of finite elements that are adjacent to boundary b. More...

int	face_index_at_boundary (const unsigned &b, const unsigned &e) const

virtual void	dump (std::ofstream &dump_file, const bool &use_old_ordering=true) const
	Dump the data in the mesh into a file for restart. More...

void	dump (const std::string &dump_file_name, const bool &use_old_ordering=true) const
	Dump the data in the mesh into a file for restart. More...

virtual void	read (std::ifstream &restart_file)
	Read solution from restart file. More...

void	output_paraview (std::ofstream &file_out, const unsigned &nplot) const

void	output_fct_paraview (std::ofstream &file_out, const unsigned &nplot, FiniteElement::SteadyExactSolutionFctPt exact_soln_pt) const

void	output_fct_paraview (std::ofstream &file_out, const unsigned &nplot, const double &time, FiniteElement::UnsteadyExactSolutionFctPt exact_soln_pt) const

void	output (std::ostream &outfile)
	Output for all elements. More...

void	output (std::ostream &outfile, const unsigned &n_plot)
	Output at f(n_plot) points in each element. More...

void	output (FILE *file_pt)
	Output for all elements (C-style output) More...

void	output (FILE *file_pt, const unsigned &nplot)
	Output at f(n_plot) points in each element (C-style output) More...

void	output (const std::string &output_filename)
	Output for all elements. More...

void	output (const std::string &output_filename, const unsigned &n_plot)
	Output at f(n_plot) points in each element. More...

void	output_fct (std::ostream &outfile, const unsigned &n_plot, FiniteElement::SteadyExactSolutionFctPt)
	Output a given Vector function at f(n_plot) points in each element. More...

void	output_fct (std::ostream &outfile, const unsigned &n_plot, const double &time, FiniteElement::UnsteadyExactSolutionFctPt)

void	output_boundaries (std::ostream &outfile)
	Output the nodes on the boundaries (into separate tecplot zones) More...

void	output_boundaries (const std::string &output_filename)

void	assign_initial_values_impulsive ()
	Assign initial values for an impulsive start. More...

void	shift_time_values ()

void	calculate_predictions ()

void	set_nodal_and_elemental_time_stepper (TimeStepper *const &time_stepper_pt, const bool &preserve_existing_data)

virtual void	set_mesh_level_time_stepper (TimeStepper *const &time_stepper_pt, const bool &preserve_existing_data)

void	set_consistent_pinned_values_for_continuation (ContinuationStorageScheme *const &continuation_stepper_pt)
	Set consistent values for pinned data in continuation. More...

bool	does_pointer_correspond_to_mesh_data (double *const &parameter_pt)
	Does the double pointer correspond to any mesh data. More...

void	set_nodal_time_stepper (TimeStepper *const &time_stepper_pt, const bool &preserve_existing_data)
	Set the timestepper associated with the nodal data in the mesh. More...

void	set_elemental_internal_time_stepper (TimeStepper *const &time_stepper_pt, const bool &preserve_existing_data)

virtual void	compute_norm (double &norm)

virtual void	compute_norm (Vector< double > &norm)

virtual void	compute_error (std::ostream &outfile, FiniteElement::UnsteadyExactSolutionFctPt exact_soln_pt, const double &time, double &error, double &norm)

virtual void	compute_error (std::ostream &outfile, FiniteElement::SteadyExactSolutionFctPt exact_soln_pt, double &error, double &norm)

virtual void	compute_error (FiniteElement::SteadyExactSolutionFctPt exact_soln_pt, double &error, double &norm)

virtual void	compute_error (FiniteElement::SteadyExactSolutionFctPt exact_soln_pt, Vector< double > &error, Vector< double > &norm)

virtual void	compute_error (std::ostream &outfile, FiniteElement::UnsteadyExactSolutionFctPt exact_soln_pt, const double &time, Vector< double > &error, Vector< double > &norm)

virtual void	compute_error (std::ostream &outfile, FiniteElement::SteadyExactSolutionFctPt exact_soln_pt, Vector< double > &error, Vector< double > &norm)

virtual void	compute_error (FiniteElement::UnsteadyExactSolutionFctPt exact_soln_pt, const double &time, double &error, double &norm)
	Returns the norm of the error and that of the exact solution. More...

virtual void	compute_error (FiniteElement::UnsteadyExactSolutionFctPt exact_soln_pt, const double &time, Vector< double > &error, Vector< double > &norm)

bool	is_mesh_distributed () const
	Boolean to indicate if Mesh has been distributed. More...

OomphCommunicator *	communicator_pt () const

void	delete_all_external_storage ()
	Wipe the storage for all externally-based elements. More...

Protected Member Functions
void	check_1d () const

void	build_mesh (TimeStepper *time_stepper_pt=&Mesh::Default_TimeStepper)
	Generic mesh constuction routine, called by all constructors. More...

Protected Member Functions inherited from oomph::Mesh
unsigned long	assign_global_eqn_numbers (Vector< double * > &Dof_pt)
	Assign (global) equation numbers to the nodes. More...

void	describe_dofs (std::ostream &out, const std::string &current_string) const

void	describe_local_dofs (std::ostream &out, const std::string &current_string) const

void	assign_local_eqn_numbers (const bool &store_local_dof_pt)
	Assign local equation numbers in all elements. More...

void	convert_to_boundary_node (Node &node_pt, const Vector< FiniteElement > &finite_element_pt)

void	convert_to_boundary_node (Node *&node_pt)

Protected Attributes
double	Xmin
	Minimum coordinate. More...

double	Xmax
	Maximum coordinate. More...

double	Length
	Length of the domain. More...

unsigned	N
	Number of elements. More...

Protected Attributes inherited from oomph::Mesh
Vector< Vector< Node * > >	Boundary_node_pt

bool	Lookup_for_elements_next_boundary_is_setup

Vector< Vector< FiniteElement * > >	Boundary_element_pt

Vector< Vector< int > >	Face_index_at_boundary

Vector< Node * >	Node_pt
	Vector of pointers to nodes. More...

Vector< GeneralisedElement * >	Element_pt
	Vector of pointers to generalised elements. More...

std::vector< bool >	Boundary_coordinate_exists

Additional Inherited Members
Public Types inherited from oomph::Mesh
typedef void(FiniteElement::*	SteadyExactSolutionFctPt) (const Vector< double > &x, Vector< double > &soln)

typedef void(FiniteElement::*	UnsteadyExactSolutionFctPt) (const double &time, const Vector< double > &x, Vector< double > &soln)

Static Public Attributes inherited from oomph::Mesh
static Steady< 0 >	Default_TimeStepper
	The Steady Timestepper. More...

static bool	Suppress_warning_about_empty_mesh_level_time_stepper_function
	Static boolean flag to control warning about mesh level timesteppers. More...

Detailed Description

template<class ELEMENT>
class oomph::OneDMesh< ELEMENT >

1D mesh consisting of N one-dimensional elements from the QElement family.

\[ x \in [Xmin,Xmax] \]

The mesh has two boundaries:

Boundary 0 is at \(x=Xmin\).
Boundary 1 is at \(x=Xmax\).

There is one node on each of these boundaries.

Constructor & Destructor Documentation

◆ OneDMesh() [1/2]

template<class ELEMENT >

oomph::OneDMesh< ELEMENT >::OneDMesh	(	const unsigned &	n_element,
		const double &	length,
		TimeStepper *	time_stepper_pt = `&Mesh::Default_TimeStepper`
	)

inline

Constructor: Pass number of elements, n_element, length of domain, length, and pointer to timestepper (defaults to a Steady timestepper so we don't need to specify one in problems without time-dependence).

       : Xmin(0.0), Xmax(length), N(n_element)
     {
       check_1d();
  
       build_mesh(time_stepper_pt);
     }

References oomph::OneDMesh< ELEMENT >::build_mesh(), and oomph::OneDMesh< ELEMENT >::check_1d().

◆ OneDMesh() [2/2]

template<class ELEMENT >

oomph::OneDMesh< ELEMENT >::OneDMesh	(	const unsigned &	n_element,
		const double &	xmin,
		const double &	xmax,
		TimeStepper *	time_stepper_pt = `&Mesh::Default_TimeStepper`
	)

inline

Constructor: Pass number of elements, n_element, minimum coordinate, xmin, maximum coordinate, xmax, and a pointer to a timestepper.

       : Xmin(xmin), Xmax(xmax), N(n_element)
     {
       check_1d();
  
       build_mesh(time_stepper_pt);
     }

References oomph::OneDMesh< ELEMENT >::build_mesh(), and oomph::OneDMesh< ELEMENT >::check_1d().

Member Function Documentation

◆ build_mesh()

template<class ELEMENT >

void oomph::OneDMesh< ELEMENT >::build_mesh ( TimeStepper * time_stepper_pt = &Mesh::Default_TimeStepper )

protected

Generic mesh constuction routine, called by all constructors.

The generic mesh construction routine — this contains all the hard work and is called by all constructors

   {
     // Set the length of the domain
     Length = Xmax - Xmin;
  
     // Set the number of boundaries -- there are 2 boundaries in a 1D mesh
     set_nboundary(2);
  
     // Allocate storage for the pointers to the elements
     Element_pt.resize(N);
  
     // Allocate memory for the first element
     Element_pt[0] = new ELEMENT;
  
     // Read out the number of nodes in the element (the member function
     // nnode_1d() is implemented in QElement)
     const unsigned n_node =
       dynamic_cast<ELEMENT*>(finite_element_pt(0))->nnode_1d();
  
     // We can now allocate storage for the pointers to the nodes in the mesh
     Node_pt.resize(1 + (n_node - 1) * N);
  
     // Initialise the node counter
     unsigned node_count = 0;
  
     // Initialise the minimum x coordinate in the mesh
     const double xinit = Xmin;
  
     // Calculate the length of the element
     const double el_length = Length / double(N);
  
     // Allocate storage for the local coordinate in the element
     Vector<double> s_fraction;
  
     // If the number of elements is 1, the first element is also the
     // last element
     if (N == 1)
     {
       // Set the first node
       // ------------------
  
       // Allocate memory for the node, using the element's own construct_node
       // function -- only the element knows what type of nodes it needs!
       Node_pt[node_count] =
         finite_element_pt(0)->construct_boundary_node(0, time_stepper_pt);
  
       // Set the position of the node
       node_pt(node_count)->x(0) = xinit;
  
       // Add the node to the boundary 0
       add_boundary_node(0, Node_pt[node_count]);
  
       // Increment the counter for the nodes
       node_count++;
  
       // Now build central nodes (ignore last one which needs special
       // ------------------------------------------------------------
       // treatment because it's on the boundary)
       // ---------------------------------------
       for (unsigned jnod = 1; jnod < (n_node - 1); jnod++)
       {
         // Allocate memory for nodes, as before
         Node_pt[node_count] =
           finite_element_pt(0)->construct_node(jnod, time_stepper_pt);
  
         // Get the local coordinate of the node
         finite_element_pt(0)->local_fraction_of_node(jnod, s_fraction);
  
         // Set the position of the node (linear mapping)
         node_pt(node_count)->x(0) = xinit + el_length * s_fraction[0];
  
         // Increment the node counter
         node_count++;
       }
  
       // New final node
       // --------------
  
       // Allocate memory for the node, as before
       Node_pt[node_count] = finite_element_pt(0)->construct_boundary_node(
         n_node - 1, time_stepper_pt);
  
       // Set the position of the node
       node_pt(node_count)->x(0) = xinit + Length;
  
       // Add the node to the boundary 1
       add_boundary_node(1, Node_pt[node_count]);
  
       // Increment the node counter
       node_count++;
     }
  
     // Otherwise, i.e. if there is more than one element, build all elements
     else
     {
       // -------------
       // FIRST ELEMENT
       // -------------
  
       // Set the first node
       // ------------------
  
       // Allocate memory for the node, using the element's own construct_node
       // function -- only the element knows what type of nodes it needs!
       Node_pt[node_count] =
         finite_element_pt(0)->construct_boundary_node(0, time_stepper_pt);
  
       // Set the position of the node
       node_pt(node_count)->x(0) = xinit;
  
       // Add the node to the boundary 0
       add_boundary_node(0, Node_pt[node_count]);
  
       // Increment the counter for the nodes
       node_count++;
  
       // Now build the other nodes in the first element
       // ----------------------------------------------
  
       // Loop over the other nodes in the first element
       for (unsigned jnod = 1; jnod < n_node; jnod++)
       {
         // Allocate memory for the nodes
         Node_pt[node_count] =
           finite_element_pt(0)->construct_node(jnod, time_stepper_pt);
  
         // Get the local coordinate of the node
         finite_element_pt(0)->local_fraction_of_node(jnod, s_fraction);
  
         // Set the position of the node (linear mapping)
         node_pt(node_count)->x(0) = xinit + el_length * s_fraction[0];
  
         // Increment the node counter
         node_count++;
       }
  
       // ----------------
       // CENTRAL ELEMENTS
       // ----------------
  
       // Loop over central elements in mesh
       for (unsigned e = 1; e < (N - 1); e++)
       {
         // Allocate memory for the new element
         Element_pt[e] = new ELEMENT;
  
         // The first node is the same as the last node in the neighbouring
         // element on the left
         finite_element_pt(e)->node_pt(0) =
           finite_element_pt(e - 1)->node_pt((n_node - 1));
  
         // Loop over the remaining nodes in the element
         for (unsigned jnod = 1; jnod < n_node; jnod++)
         {
           // Allocate memory for the nodes, as before
           Node_pt[node_count] =
             finite_element_pt(e)->construct_node(jnod, time_stepper_pt);
  
           // Get the local coordinate of the nodes
           finite_element_pt(e)->local_fraction_of_node(jnod, s_fraction);
  
           // Set the position of the node (linear mapping)
           node_pt(node_count)->x(0) = xinit + el_length * (e + s_fraction[0]);
  
           // Increment the node counter
           node_count++;
         }
       } // End of loop over central elements
  
  
       // FINAL ELEMENT
       //--------------
  
       // Allocate memory for element
       Element_pt[N - 1] = new ELEMENT;
  
       // The first node is the same as the last node in the neighbouring
       // element on the left
       finite_element_pt(N - 1)->node_pt(0) =
         finite_element_pt(N - 2)->node_pt(n_node - 1);
  
       // New central nodes (ignore last one which needs special treatment
       // because it's on the boundary)
       for (unsigned jnod = 1; jnod < (n_node - 1); jnod++)
       {
         // Allocate memory for nodes, as before
         Node_pt[node_count] =
           finite_element_pt(N - 1)->construct_node(jnod, time_stepper_pt);
  
         // Get the local coordinate of the node
         finite_element_pt(N - 1)->local_fraction_of_node(jnod, s_fraction);
  
         // Set the position of the node
         node_pt(node_count)->x(0) = xinit + el_length * (N - 1 + s_fraction[0]);
  
         // Increment the node counter
         node_count++;
       }
  
       // New final node
       // --------------
  
       // Allocate memory for the node, as before
       Node_pt[node_count] = finite_element_pt(N - 1)->construct_boundary_node(
         n_node - 1, time_stepper_pt);
  
       // Set the position of the node
       node_pt(node_count)->x(0) = xinit + Length;
  
       // Add the node to the boundary 1
       add_boundary_node(1, Node_pt[node_count]);
  
       // Increment the node counter
       node_count++;
     }
   }

References e(), Global_Physical_Variables::Length, and N.

Referenced by oomph::OneDMesh< ELEMENT >::OneDMesh().

◆ check_1d()

template<class ELEMENT >

void oomph::OneDMesh< ELEMENT >::check_1d ( ) const

inlineprotected

Mesh can only be built with 1D elements (but can be either T or Q so can't use the normal assert_geometric_element function.

     {
 #ifdef PARANOID
       FiniteElement* el_pt = new ELEMENT;
       if (el_pt->dim() != 1)
       {
         std::string err = "OneDMesh is only for 1D elements";
         throw OomphLibError(
           err, OOMPH_CURRENT_FUNCTION, OOMPH_EXCEPTION_LOCATION);
       }
       delete el_pt;
       el_pt = 0;
 #endif
     }