Nodes are derived from Data, but, in addition, have a definite (Eulerian) position in a space of a given dimension. More...

#include <nodes.h>

Inheritance diagram for oomph::Node:

Public Types
typedef void(*	AuxNodeUpdateFctPt) (Node *)
	Function pointer to auxiliary node update function. More...

Public Member Functions
	Node ()
	Default constructor. More...

	Node (const unsigned &n_dim, const unsigned &n_position_type, const unsigned &initial_n_value, const bool &allocate_x_position=true)
	Steady constructor, for a Node of spatial dimension n_dim. Allocates storage for initial_n_value values. NPosition_type is the number of coordinate types needed in the mapping between local and global coordinates (e.g. 1 for Lagrange-type elements; 2 for 1D Hermite elements; 4 for 2D Hermite elements, etc). More...

	Node (TimeStepper *const &time_stepper_pt, const unsigned &n_dim, const unsigned &n_position_type, const unsigned &initial_n_value, const bool &allocate_x_position=true)
	Unsteady constructor for a node of spatial dimension n_dim. Allocates storage for initial_n_value values with history values as required by the timestepper. n_position_type: # of coordinate types needed in the mapping between local and global coordinates (e.g. 1 for Lagrange-type elements; 2 for 1D Hermite elements; 4 for 2D Hermite elements). More...

virtual	~Node ()
	Destructor: Clean up the memory allocated for nodal position. More...

	Node (const Node &node)
	Broken copy constructor. More...

void	operator= (const Node &)
	Broken assignment operator. More...

unsigned	nposition_type () const
	Number of coordinate types needed in the mapping between local and global coordinates. More...

TimeStepper *&	position_time_stepper_pt ()
	Return a pointer to the position timestepper. More...

TimeStepper *const &	position_time_stepper_pt () const
	Return a pointer to the position timestepper (const version). More...

virtual void	set_position_time_stepper (TimeStepper *const &position_time_stepper_pt, const bool &preserve_existing_data)
	Set a new position timestepper be resizing the appropriate storage. More...

virtual bool	does_pointer_correspond_to_position_data (double *const &parameter_pt)
	Check whether the pointer parameter_pt addresses position data values. It never does for a standard node, because the positions are not data. More...

virtual void	assign_eqn_numbers (unsigned long &global_ndof, Vector< double *> &dof_pt)
	Assign global equation numbers; increment global number of unknowns, global_ndof; and add any new dofs to the dof_pt. More...

unsigned	ndim () const
	Return (Eulerian) spatial dimension of the node. More...

double &	x (const unsigned &i)
	Return the i-th nodal coordinate. More...

const double &	x (const unsigned &i) const
	Return the i-th nodal coordinate (const version). More...

double &	x (const unsigned &t, const unsigned &i)
	Return the position x(i) at previous timestep t (t=0: present; t>0 previous timestep). More...

const double &	x (const unsigned &t, const unsigned &i) const
	Return the position x(i) at previous timestep t (t=0: present; t>0 previous timestep) (const version) More...

double	dx_dt (const unsigned &i) const
	Return the i-th component of nodal velocity: dx/dt. More...

double	dx_dt (const unsigned &j, const unsigned &i) const
	Return the i-th component of j-th derivative of nodal position: d^jx/dt^j. More...

virtual Node *	copied_node_pt () const
	Return pointer to copied node (null if the current node is not a copy – always the case here; it's overloaded for boundary nodes) More...

virtual bool	position_is_a_copy () const
	Return whether any position coordinate has been copied (always false) More...

virtual bool	position_is_a_copy (const unsigned &i) const
	Return whether the position coordinate i has been copied (always false) More...

double &	x_gen (const unsigned &k, const unsigned &i)
	Reference to the generalised position x(k,i). More...

const double &	x_gen (const unsigned &k, const unsigned &i) const
	Reference to the generalised position x(k,i). `Type': k; Coordinate direction: i (const version). More...

double &	x_gen (const unsigned &t, const unsigned &k, const unsigned &i)
	Reference to the generalised position x(k,i) at the previous timestep [t=0: present]. `Type': k; Coordinate direction: i. More...

const double &	x_gen (const unsigned &t, const unsigned &k, const unsigned &i) const
	Reference to the generalised position x(k,i) at the previous timestep [t=0: present]. `Type': k; Coordinate direction: i. (const version) More...

double	dx_gen_dt (const unsigned &k, const unsigned &i) const
	i-th component of time derivative (velocity) of the generalised position, dx(k,i)/dt. `Type': k; Coordinate direction: i. More...

double	dx_gen_dt (const unsigned &j, const unsigned &k, const unsigned &i) const
	i-th component of j-th time derivative (velocity) of the generalised position, d^jx(k,i)/dt^j. `Type': k; Coordinate direction: i. More...

double *	x_pt (const unsigned &t, const unsigned &i)
	Direct access to the i-th coordinate at time level t. More...

void	copy (Node *orig_node_pt)
	Copy all nodal data from specified Node object. More...

virtual void	dump (std::ostream &dump_file) const
	Dump nodal position and associated data to file for restart. More...

void	read (std::ifstream &restart_file)
	Read nodal position and associated data from file for restart. More...

virtual void	pin_all ()
	The pin_all() function must be overloaded by SolidNodes, so we put the virtual interface here to avoid virtual functions in Data. More...

virtual void	unpin_all ()
	The unpin_all() function must be overloaded by SolidNode, so we put the virtual interface here to avoid virtual functions in Data. More...

unsigned	hang_code ()
	Code that encapsulates the hanging status of the node (incl. the geometric hanging status) as $\sum_{i=-1}{nval-1} Node::is_hanging(i) 2^{i+1}$ . More...

HangInfo *const &	hanging_pt () const
	Return pointer to hanging node data (this refers to the geometric hanging node status) (const version). More...

HangInfo *const &	hanging_pt (const int &i) const
	Return pointer to hanging node data for value i (const version) More...

bool	is_hanging () const
	Test whether the node is geometrically hanging. More...

bool	is_hanging (const int &i) const
	Test whether the i-th value is hanging. More...

void	set_hanging_pt (HangInfo *const &hang_pt, const int &i)
	Set the hanging data for the i-th value. (hang_pt=0 to make non-hanging) More...

void	set_nonhanging ()
	Label node as non-hanging node by removing all hanging node data. More...

void	resize (const unsigned &n_value)
	Resize the number of equations. More...

virtual void	constrain_positions ()
	Constrain the positions when the node is made hanging Empty virtual function that is overloaded in SolidNodes. More...

virtual void	unconstrain_positions ()
	Unconstrain the positions when the node is made non-hanging Empty virtual function that is overloaded in SolidNodes. More...

virtual void	make_periodic (Node *const &node_pt)
	Make the node periodic by copying the values from node_pt. Note that the coordinates will always remain independent, even though this may lead to (a little) unrequired information being stored. Broken virtual (only implemented in BoundaryNodes) More...

virtual void	make_periodic_nodes (const Vector< Node *> &periodic_nodes_pt)
	Make the nodes passed in the vector periodic_nodes share the same data as this node. More...

virtual void	get_boundaries_pt (std::set< unsigned > *&boundaries_pt)
	Return a pointer to set of mesh boundaries that this node occupies; this will be overloaded by BoundaryNodes. The default behaviour is that the Node does not lie on any boundaries so the pointer to the set of boundaries is NULL. More...

virtual bool	is_on_boundary () const
	Test whether the Node lies on a boundary. The "bulk" Node cannot lie on a boundary, so return false. This will be overloaded by BoundaryNodes. More...

virtual bool	is_on_boundary (const unsigned &b) const
	Test whether the node lies on mesh boundary b. The "bulk" Node cannot lie on a boundary, so return false. This will be overloaded by BoundaryNodes. More...

virtual void	add_to_boundary (const unsigned &b)
	Broken interface for adding the node to the mesh boundary b Essentially here for error reporting. More...

virtual void	remove_from_boundary (const unsigned &b)
	Broken interface for removing the node from the mesh boundary b Here to provide error reporting. More...

virtual unsigned	ncoordinates_on_boundary (const unsigned &b)
	Get the number of boundary coordinates on mesh boundary b. Broken virtual interface provides run-time error checking. More...

virtual bool	boundary_coordinates_have_been_set_up ()

virtual void	get_coordinates_on_boundary (const unsigned &b, const unsigned &k, Vector< double > &boundary_zeta)
	Return the vector of the k-th generalised boundary coordinates on mesh boundary b. Broken virtual interface provides run-time error checking. More...

virtual void	set_coordinates_on_boundary (const unsigned &b, const unsigned &k, const Vector< double > &boundary_zeta)
	Set the vector of the k-th generalised boundary coordinates on mesh boundary b. Broken virtual interface provides run-time error checking. More...

virtual void	get_coordinates_on_boundary (const unsigned &b, Vector< double > &boundary_zeta)
	Return the vector of coordinates on mesh boundary b Broken virtual interface provides run-time error checking. More...

virtual void	set_coordinates_on_boundary (const unsigned &b, const Vector< double > &boundary_zeta)
	Set the vector of coordinates on mesh boundary b Broken virtual interface provides run-time error checking. More...

void	set_obsolete ()
	Mark node as obsolete. More...

void	set_non_obsolete ()
	Mark node as non-obsolete. More...

bool	is_obsolete ()
	Test whether node is obsolete. More...

double	raw_value (const unsigned &i) const
	Return the i-th value stored at the Node. This interface does NOT take the hanging status of the Node into account. More...

double	raw_value (const unsigned &t, const unsigned &i) const
	Return the i-th value at time level t (t=0: present, t>0: previous). This interface does NOT take the hanging status of the Node into account. More...

double	value (const unsigned &i) const
	Return i-th value (dofs or pinned) at this node either directly or via hanging node representation. Note that this REDFINES the interface in Data Thus, the present function will be called provided that it is accessed through a pointer to a node i.e. Node* node_pt->value() will take hanging information into account. If a pointer to a Node has been explicitly down-cast to a pointer to Data then the "wrong" (Data) version of the function will be called. More...

double	value (const unsigned &t, const unsigned &i) const
	Return i-th value at time level t (t=0: present, t>0: previous) either directly or via hanging node representation. Note that this REDEFINES the interface in Data Thus, the present function will be called provided that it is accessed through a pointer to a node i.e. Node* node_pt->value() will take hanging information into account. If a pointer to a Node has been explicitly down-cast to a pointer to Data then the "wrong" (Data) version of the function will be called. More...

void	value (Vector< double > &values) const
	Compute Vector of values for the Data value taking the hanging node status into account. Note that this REDEFINES the interface in Data Thus, the present function will be called provided that it is accessed through a pointer to a node i.e. Node* node_pt->value() will take hanging information into account. If a pointer to a Node has been explicitly down-cast to a pointer to Data then the "wrong" (Data) version of the function will be called. More...

Vector< double >	value () const
	Return vector of values calculated using value(vector). More...

void	value (const unsigned &t, Vector< double > &values) const
	Compute Vector of values (dofs or pinned) in this data at time level t (t=0: present; t>0: previous). This interface explicitly takes the hanging status into account. Thus, the present function will be called provided that it is accessed through a pointer to a node i.e. Node* node_pt->value() will take hanging information into account. If a pointer to a Node has been explicitly down-cast to a pointer to Data then the "wrong" (Data) version of the function will be called. More...

void	position (Vector< double > &pos) const
	Compute Vector of nodal positions either directly or via hanging node representation. More...

Vector< double >	position () const
	Return vector of position of node at current time. More...

void	position (const unsigned &t, Vector< double > &pos) const
	Compute Vector of nodal position at time level t (t=0: current; t>0: previous timestep), either directly or via hanging node representation. More...

double	position (const unsigned &i) const
	Return i-th nodal coordinate either directly or via hanging node representation. More...

double	position (const unsigned &t, const unsigned &i) const
	Return i-th nodal coordinate at time level t (t=0: current; t>0: previous time level), either directly or via hanging node representation. More...

double	position_gen (const unsigned &k, const unsigned &i) const
	Return generalised nodal coordinate either directly or via hanging node representation. More...

double	position_gen (const unsigned &t, const unsigned &k, const unsigned &i) const
	Return generalised nodal coordinate at time level t (t=0: current; t>0: previous time level), either directly or via hanging node representation. More...

double	dposition_dt (const unsigned &i) const
	Return the i-th component of nodal velocity: dx/dt, either directly or via hanging node representation. More...

double	dposition_dt (const unsigned &j, const unsigned &i) const
	Return the i-th component of j-th derivative of nodal position: d^jx/dt^j either directly or via hanging node representation. More...

double	dposition_gen_dt (const unsigned &k, const unsigned &i) const
	i-th component of time derivative (velocity) of the generalised position, dx(k,i)/dt. `Type': k; Coordinate direction: i. This function uses the hanging node representation if necessary. More...

double	dposition_gen_dt (const unsigned &j, const unsigned &k, const unsigned &i) const
	i-th component of j-th time derivative (velocity) of the generalised position, d^jx(k,i)/dt^j. `Type': k; Coordinate direction: i. This function uses the hanging node representation if necessary More...

virtual void	node_update (const bool &update_all_time_levels_for_new_node=false)
	Interface for functions that update the nodal position using algebraic remeshing strategies. The interface is common to SpineNodes, AlgebraicNodes and MacroElementNodeUpdateNodes. The default is that the node does not "update itself" i.e. it is fixed in space. When implemented, this function should also execute the Node's auxiliary node update function (if any). More...

void	set_auxiliary_node_update_fct_pt (AuxNodeUpdateFctPt aux_node_update_fct_pt)
	Set pointer to auxiliary update function – this can be used to update any nodal values following the update of the nodal position. This is needed e.g. to update the no-slip condition on moving boundaries. More...

bool	has_auxiliary_node_update_fct_pt ()
	Boolean to indicate if node has a pointer to and auxiliary update function. More...

void	perform_auxiliary_node_update_fct ()
	Execute auxiliary update function (if any) – this can be used to update any nodal values following the update of the nodal position. This is needed e.g. to update the no-slip condition on moving boundaries. More...

virtual unsigned	ngeom_data () const
	Return the number of geometric data that affect the nodal position. The default value is zero (node is stationary) More...

virtual Data **	all_geom_data_pt ()
	Return a pointer to an array of all (geometric) data that affect the nodal position. The default value is zero (node is stationary) More...

virtual unsigned	ngeom_object () const
	Return the number of geometric objects that affect the nodal position. The default value is zero (node is stationary) More...

virtual GeomObject **	all_geom_object_pt ()
	Return a pointer to an array of all (geometric) objects that affect the nodal position. The default value is zero (node is stationary) More...

void	output (std::ostream &outfile)
	Output nodal position. More...

void	add_values_to_vector (Vector< double > &vector_of_values)
	Add all data and time history values to the vector. Overloaded to add the position information as well. More...

void	read_values_from_vector (const Vector< double > &vector_of_values, unsigned &index)
	Read all data and time history values from the vector starting from index. On return the index will be set the value at the end of the data that has been read in Overload to also read the position information. More...

Public Member Functions inherited from oomph::Data
virtual void	clear_copied_pointers ()
	Helper function that should be overloaded derived classes that contain copies of data. The function must unset (NULL out) the internal pointers to the copied data. This is used when destructing data to ensure that all pointers remain valid. The default implementation throws an error because Data cannot be a copy. More...

	Data ()
	Default: Just set pointer to (steady) timestepper. No storage for values is allocated. More...

	Data (const unsigned &initial_n_value)
	Default constructor for steady problems: assign memory for initial_n_value values. More...

	Data (TimeStepper *const &time_stepper_pt, const unsigned &initial_n_value, const bool &allocate_storage=true)
	Constructor for unsteady problems: assign memory for initial_n_value values and any memory required by the Timestepper for the storage of history values. More...

	Data (const Data &data)
	Broken copy constructor. More...

void	operator= (const Data &)
	Broken assignment operator. More...

virtual	~Data ()
	Destructor, deallocates memory assigned for data. More...

void	set_time_stepper (TimeStepper *const &time_stepper_pt, const bool &preserve_existing_data)
	Set a new timestepper by resizing the appropriate storage. If already assigned the equation numbering will not be altered. More...

TimeStepper *&	time_stepper_pt ()
	Return the pointer to the timestepper. More...

TimeStepper *const &	time_stepper_pt () const
	Return the pointer to the timestepper (const version). More...

virtual bool	is_a_copy () const
	Return a boolean to indicate whether the Data objact contains any copied values. A base Data object can never be a copy so the default implementation always returns false. More...

virtual bool	is_a_copy (const unsigned &i) const
	Return flag to indicate whether the i-th value is a copy. A base Data object can never be a copy so the default implementation always returns false. More...

void	set_value (const unsigned &i, const double &value_)
	Set the i-th stored data value to specified value. The only reason that we require an explicit set function is because we redefine value() in the Node class to interpolate the values for nodes that are hanging and so we cannot return a reference to the value in this case. More...

void	set_value (const unsigned &t, const unsigned &i, const double &value_)
	Set the t-th history value of the i-th stored data value to specified value. More...

double	value (const unsigned &i) const
	Return i-th stored value. This function is not virtual so that it can be inlined. This means that if we have an explicit pointer to a Data object Data* data_pt->value() always returns the "raw" stored value. More...

double	value (const unsigned &t, const unsigned &i) const
	Return i-th value at time level t (t=0: present, t>0: previous) This function is not virtual so that it can be inlined. This means that if we have an explicit pointer to a Data object Data* data_pt->value() always returns to the "raw" stored value. More...

void	value (Vector< double > &values) const
	Compute Vector of values for the Data value. More...

void	value (const unsigned &t, Vector< double > &values) const
	Compute Vector of values (dofs or pinned) in this data at time level t (t=0: present; t>0: previous). More...

double *	value_pt (const unsigned &i) const
	Return the pointer to the i-the stored value. Typically this is required when direct access to the stored value is required, e.g. when writing functions that return a reference to a variable that is stored in a Data object. More...

double *	value_pt (const unsigned &t, const unsigned &i) const
	Return the pointer to the i-th stored value, or any of its history values (const version). Typically this is required when direct access to the stored value is required, e.g. when writing functions that return a reference to a variable that is stored in a Data object. More...

bool	does_pointer_correspond_to_value (double *const &parameter_pt)
	Check whether the pointer parameter_pt addresses internal data values. More...

void	copy (Data *orig_data_pt)
	Copy Data values from specified Data object. More...

void	dump (std::ostream &dump_file) const
	Dump the data object to a file. More...

void	read (std::ifstream &restart_file)
	Read data object from a file. More...

long *	eqn_number_pt (const unsigned &i)
	Return the pointer to the equation number of the i-th stored variable. More...

long &	eqn_number (const unsigned &i)
	Return the equation number of the i-th stored variable. More...

long	eqn_number (const unsigned &i) const
	Return the equation number of the i-th stored variable. More...

void	pin (const unsigned &i)
	Pin the i-th stored variable. More...

void	unpin (const unsigned &i)
	Unpin the i-th stored variable. More...

void	pin_all ()
	Pin all the stored variables. More...

void	unpin_all ()
	Unpin all the stored variables. More...

bool	is_pinned (const unsigned &i) const
	Test whether the i-th variable is pinned (1: true; 0: false). More...

bool	is_segregated_solve_pinned (const unsigned &i)
	Test whether the i-th variable is temporaily pinned for a segregated solve. More...

void	constrain (const unsigned &i)
	Constrain the i-th stored variable when making hanging data If the data is already pinned leave it along, otherwise mark as constrained (hanging) More...

void	unconstrain (const unsigned &i)
	Unconstrain the i-th stored variable when make the data nonhanging. Only unconstrain if it was actually constrained (hanging) More...

void	constrain_all ()
	Constrain all the stored variables when the data is made hanging. More...

void	unconstrain_all ()
	Unconstrain all the stored variables when the data is made nonhanging. More...

bool	is_constrained (const unsigned &i)
	Test whether the i-th variable is constrained (1: true; 0: false). More...

unsigned	self_test ()
	Self-test: Have all values been classified as pinned/unpinned? Return 0 if OK. More...

unsigned	nvalue () const
	Return number of values stored in data object (incl pinned ones). More...

unsigned	ntstorage () const
	Return total number of doubles stored per value to record time history of each value (one for steady problems). More...

virtual void	describe_dofs (std::ostream &out, const std::string &current_string) const
	Function to describe the dofs of the Node. The ostream specifies the output stream to which the description is written; the string stores the currently assembled output that is ultimately written to the output stream by Data::describe_dofs(...); it is typically built up incrementally as we descend through the call hierarchy of this function when called from Problem::describe_dofs(...) More...

virtual void	add_value_pt_to_map (std::map< unsigned, double *> &map_of_value_pt)
	Add pointers to all unpinned and unconstrained data to a map indexed by (global) equation number. More...

void	set_halo (const unsigned &non_halo_proc_ID)
	Label the node as halo and specify processor that holds non-halo counterpart. More...

void	set_nonhalo ()
	Label the node as not being a halo. More...

bool	is_halo () const
	Is this Data a halo? More...

int	non_halo_proc_ID ()
	ID of processor ID that holds non-halo counterpart of halo node; negative if not a halo. More...

virtual void	add_eqn_numbers_to_vector (Vector< long > &vector_of_eqn_numbers)
	Add all equation numbers to the vector in the internal storage order. More...

virtual void	read_eqn_numbers_from_vector (const Vector< long > &vector_of_eqn_numbers, unsigned &index)
	Read all equation numbers from the vector starting from index. On return the index will be set to the value at the end of the data that has been read in. More...

Static Public Attributes
static unsigned	No_independent_position =10
	Static "Magic number" used to indicate that there is no independent position in a periodic node. More...

Static Public Attributes inherited from oomph::Data
static long	Is_pinned =-1
	Static "Magic number" used in place of the equation number to indicate that the value is pinned. More...

static long	Is_segregated_solve_pinned =-3
	Static "Magic number" used in place of the equation number to indicate that the value is pinned, but only for the duration of a segregated solve. More...

static long	Is_unclassified =-10
	Static "Magic number" used in place of the equation number to denote a value that hasn't been classified as pinned or free. More...

static long	Is_constrained =-2
	Static "Magic number" used in place of the equation number to indicate that the value is constrained because it is associated with non-conforming element boundaries — a hanging node — (and is therefore pinned) More...

Protected Member Functions
void	x_gen_range_check (const unsigned &t, const unsigned &k, const unsigned &i) const
	Private function to check that the arguemnts to the position functions are in range. More...

double *	x_position_pt (const unsigned &i)
	Direct access to the pointer to the i-th stored coordinate data. More...

Protected Member Functions inherited from oomph::Data
virtual void	reset_copied_pointers ()
	Helper function that should be overloaded in derived classes that can contain copies of Data. The function must reset the internal pointers to the copied data. This is used when resizing data to ensure that all the pointers remain valid. The default implementation throws an error beacause Data cannot be a copy. More...

Protected Attributes
double **	X_position
	Array of pointers to the data holding the Eulerian positions. The storage format must be the same as the internal data storage so that we can implement the functions x() in generality here without the need for virtual functions. The first index will be a flat array of position types and coordinates and the second will be the number of time history values at each position type. More...

TimeStepper *	Position_time_stepper_pt
	Pointer to the timestepper associated with the position data. More...

HangInfo **	Hanging_pt
	C-style array of pointers to hanging node info. It's set to NULL if the node isn't hanging. The first entry (0) is the geometric hanging node data. The remaining entries correspond to the hanging data for the other values stored at the node. Usually, these entries will be the same as the geometric hanging node data represented by Hanging_pt[0], but this is not necessarily the case; e.g. the pressure in Taylor Hood has different hanging node data from the velocities. More...

unsigned	Ndim
	Eulerian dimension of the node. More...

unsigned	Nposition_type
	Number of coordinate types used in the mapping between local and global coordinates (e.g. 1 for Lagrange-type elements; 2 for 1D Hermite elements; 4 for 2D Hermite elements, etc). More...

bool	Obsolete
	Flag to indicate that the Node has become obsolete — usually during mesh refinement process. More...

AuxNodeUpdateFctPt	Aux_node_update_fct_pt
	Pointer to auxiliary update function – this can be used to update any nodal values following the update of the nodal position. This is needed e.g. to update the no-slip condition on moving boundaries. More...

Protected Attributes inherited from oomph::Data
Data **	Copy_of_data_pt
	C-style array of any Data objects that contain copies of the current Data object's data values. More...

unsigned	Ncopies
	Number of Data that contain copies of this Data object's values. More...

Friends
class	BoundaryNodeBase
	to construct periodic Nodes More...

std::ostream &	operator<< (std::ostream &out, const Node &d)

Additional Inherited Members
Static Protected Attributes inherited from oomph::Data
static TimeStepper *	Default_static_time_stepper_pt =new Steady<0>()
	Default (static) timestepper used in steady problems. More...

Detailed Description

Nodes are derived from Data, but, in addition, have a definite (Eulerian) position in a space of a given dimension.

The nodal coordinates are used in the elements' mapping between local and global coordinates and in the simplest case (stationary nodes in Lagrange-type elements) this mapping is given by

$x_i = \sum_{j=1}^{N_{node}} X_{ij} \psi_{j}(s_k)$

so we need only access to the nodal coordinates $X_{ij}\ (i=1..DIM)$ of all nodes $ j $ : provided by the Node member function

Node::x(i)

If the nodal positions are time-dependent, the mapping becomes

$x_i(t) = \sum_{j=1}^{N_{node}} X_{ij}(t) \ \psi_{j}(s_k).$

Within the computation (where time is only evaluated at discrete levels) this becomes

$x_{ti} = \sum_{j=1}^{N_{node}} X_{ijt} \ \psi_{j}(s_k).$

and we need access to the nodal coordinates $X_{ijt} \ (i=1..DIM)$ of all nodes $ j $ at the present (t=0) and previous (t>0) timesteps: provided by the Node member function

Node::x(t,i)

Note: The interpretation of the history values is slightly more subtle than that. Depending on the positional TimeStepper used, only a limited number of the positional history values accessed Node::x(t,i) represent previous nodal positions; the others are generalised history values that the TimeStepper uses to determine approximations for the time-derivatives of the nodal positions.

Finally, some elements employ mappings that involve additional, generalised coordinates. For instance, in Hermite elements the mapping between local and global coordinates is based on an independent interpolation for the global coordinates and their derivative w.r.t. to the local coordinates. In such elements, the mapping becomes

$x_i = \sum_{j=1}^{N_{node}} \sum_{k=1}^{N_{type}} X_{ijk} \psi_{jk}(s_k)$

where $N_{type}$ is the number of the different types of generalised coordinates involved in the mapping. For instance, in 1D Hermite elements $N_{type}=2$ and k=0 corresponds to the global coordinates while k=1 corresponds to the derivative of the global coordinates w.r.t. to the local coordinate. In such cases we need access to the generalised nodal coordinates $X_{ijk} \ (i=1..DIM, \ k=1..N_{type})$ of all nodes $ j $ . Access is provided by the Node member function

Node::x_gen(k,i)

and the corresponding time-dependent version

Node::x_gen(t,k,i)

While this is all pretty straightforward, it does make the argument list of the Node constructors rather lengthy.

Definition at line 852 of file nodes.h.

Member Typedef Documentation

◆ AuxNodeUpdateFctPt

typedef void(* oomph::Node::AuxNodeUpdateFctPt) (Node *)

Function pointer to auxiliary node update function.

Definition at line 859 of file nodes.h.

Constructor & Destructor Documentation

◆ Node() [1/4]

oomph::Node::Node ( )

Default constructor.

Definition at line 1517 of file nodes.cc.

References oomph::LeakCheckNames::Node_build.

◆ Node() [2/4]

oomph::Node::Node	(	const unsigned &	n_dim,
		const unsigned &	n_position_type,
		const unsigned &	initial_n_value,
		const bool &	allocate_x_position = `true`
	)

Steady constructor, for a Node of spatial dimension n_dim. Allocates storage for initial_n_value values. NPosition_type is the number of coordinate types needed in the mapping between local and global coordinates (e.g. 1 for Lagrange-type elements; 2 for 1D Hermite elements; 4 for 2D Hermite elements, etc).

Steady Constructor, allocates storage for initial_n_value values at a node of spatial dimension NDim. nposition_type: # of coordinate types needed in the mapping between local and global coordinates (e.g. 1 for Lagrange-type elements; 2 for 1D Hermite elements; 4 for 2D Hermite elements, etc).

Definition at line 1535 of file nodes.cc.

References oomph::LeakCheckNames::Node_build, and X_position.

◆ Node() [3/4]

oomph::Node::Node	(	TimeStepper *const &	time_stepper_pt_,
		const unsigned &	n_dim,
		const unsigned &	n_position_type,
		const unsigned &	initial_n_value,
		const bool &	allocate_x_position = `true`
	)

Unsteady constructor for a node of spatial dimension n_dim. Allocates storage for initial_n_value values with history values as required by the timestepper. n_position_type: # of coordinate types needed in the mapping between local and global coordinates (e.g. 1 for Lagrange-type elements; 2 for 1D Hermite elements; 4 for 2D Hermite elements).

Unsteady Constructor for a node of spatial dimension n_dim. Allocates storage for initial_n_value values with history values as required by timestepper. n_position_type: # of coordinate types needed in the mapping between local and global coordinates (e.g. 1 for Lagrange-type elements; 2 for 1D Hermite elements; 4 for 2D Hermite elements)

Definition at line 1583 of file nodes.cc.

References oomph::LeakCheckNames::Node_build, oomph::TimeStepper::ntstorage(), Position_time_stepper_pt, t, and X_position.

◆ ~Node()

oomph::Node::~Node ( )

virtual

Destructor: Clean up the memory allocated for nodal position.

Destructor to clean up the memory allocated for nodal position.

Definition at line 1628 of file nodes.cc.

References Hanging_pt, oomph::LeakCheckNames::Node_build, oomph::Data::nvalue(), and X_position.

◆ Node() [4/4]

oomph::Node::Node ( const Node & node )

inline

Broken copy constructor.

Definition at line 949 of file nodes.h.

References oomph::BrokenCopy::broken_copy().

Member Function Documentation

◆ add_to_boundary()

void oomph::Node::add_to_boundary ( const unsigned & b )

virtual

Broken interface for adding the node to the mesh boundary b Essentially here for error reporting.

Interface for function to add the node to the mesh boundary b. Broken here in order to report run-time errors. Must be overloaded by all boundary nodes

Definition at line 2257 of file nodes.cc.

Referenced by oomph::Mesh::add_boundary_node(), and oomph::BackupMeshForProjection< GEOMETRIC_ELEMENT >::BackupMeshForProjection().

◆ add_values_to_vector()

void oomph::Node::add_values_to_vector ( Vector< double > & vector_of_values )

virtual

Add all data and time history values to the vector. Overloaded to add the position information as well.

Add position data and time-history values to the vector after the addition of the "standard" data stored at the node

Reimplemented from oomph::Data.

Reimplemented in oomph::SolidNode.

Definition at line 2671 of file nodes.cc.

References oomph::Data::add_values_to_vector(), i, ndim(), nposition_type(), oomph::TimeStepper::ntstorage(), position_time_stepper_pt(), t, and X_position.

Referenced by oomph::SolidNode::add_values_to_vector(), and oomph::Problem::synchronise_dofs().

◆ all_geom_data_pt()

virtual Data** oomph::Node::all_geom_data_pt ( )

inlinevirtual

Return a pointer to an array of all (geometric) data that affect the nodal position. The default value is zero (node is stationary)

Reimplemented in oomph::SpineNode.

Definition at line 1524 of file nodes.h.

Referenced by oomph::ElementWithMovingNodes::assemble_set_of_all_geometric_data().

◆ all_geom_object_pt()

virtual GeomObject** oomph::Node::all_geom_object_pt ( )

inlinevirtual

Return a pointer to an array of all (geometric) objects that affect the nodal position. The default value is zero (node is stationary)

Reimplemented in oomph::SpineNode, oomph::AlgebraicNode, and oomph::MacroElementNodeUpdateNode.

Definition at line 1532 of file nodes.h.

References oomph::Data::add_values_to_vector(), oomph::output(), and oomph::Data::read_values_from_vector().

Referenced by oomph::ElementWithMovingNodes::assemble_set_of_all_geometric_data().

◆ assign_eqn_numbers()

void oomph::Node::assign_eqn_numbers	(	unsigned long &	global_number,
		Vector< double *> &	dof_pt
	)

virtual

Assign global equation numbers; increment global number of unknowns, global_ndof; and add any new dofs to the dof_pt.

Assign (global) equation number. Overloaded version for nodes. Checks if a hanging value has a non-negative equation number and if so shouts and then sets it to Is_constrained. Then drops down to Data version which does the actual work

Reimplemented from oomph::Data.

Reimplemented in oomph::SolidNode.

Definition at line 499 of file nodes.cc.

References oomph::Data::assign_eqn_numbers(), oomph::Data::constrain(), i, oomph::Data::is_constrained(), oomph::Data::is_pinned(), and oomph::Data::nvalue().

◆ boundary_coordinates_have_been_set_up()

bool oomph::Node::boundary_coordinates_have_been_set_up ( )

virtual

Have boundary coordinates been set up? Broken virtual interface provides run-time error checking

Interface for function to report if boundary coordinates have been set up for this node Broken here in order to report run-time errors. Must be overloaded by all boundary nodes

Definition at line 2243 of file nodes.cc.

◆ constrain_positions()

virtual void oomph::Node::constrain_positions ( )

inlinevirtual

Constrain the positions when the node is made hanging Empty virtual function that is overloaded in SolidNodes.

Reimplemented in oomph::SolidNode.

Definition at line 1264 of file nodes.h.

Referenced by set_hanging_pt().

◆ copied_node_pt()

virtual Node* oomph::Node::copied_node_pt ( ) const

inlinevirtual

Return pointer to copied node (null if the current node is not a copy – always the case here; it's overloaded for boundary nodes)

Definition at line 1042 of file nodes.h.

Referenced by oomph::FourierDecomposedHelmholtzDtNBoundaryElement< ELEMENT >::complete_setup_of_dependencies(), oomph::HelmholtzDtNBoundaryElement< ELEMENT >::complete_setup_of_dependencies(), oomph::BoundaryNodeBase::make_node_periodic(), and oomph::BoundaryNodeBase::make_nodes_periodic().

◆ copy()

void oomph::Node::copy ( Node * orig_node_pt )

Copy all nodal data from specified Node object.

Definition at line 1834 of file nodes.cc.

References oomph::Data::copy(), Ndim, ndim(), Nposition_type, nposition_type(), oomph::TimeStepper::ntstorage(), Position_time_stepper_pt, position_time_stepper_pt(), t, and X_position.

Referenced by oomph::Mesh::convert_to_boundary_node(), and oomph::Problem::copy().

◆ does_pointer_correspond_to_position_data()

virtual bool oomph::Node::does_pointer_correspond_to_position_data ( double *const & parameter_pt )

inlinevirtual

Check whether the pointer parameter_pt addresses position data values. It never does for a standard node, because the positions are not data.

Reimplemented in oomph::SolidNode.

Definition at line 983 of file nodes.h.

References oomph::Data::assign_eqn_numbers().

◆ dposition_dt() [1/2]

double oomph::Node::dposition_dt ( const unsigned & i ) const

Return the i-th component of nodal velocity: dx/dt, either directly or via hanging node representation.

Return the i-th component of nodal velocity: dx/dt / Use the hanging node representation if required.

Definition at line 2556 of file nodes.cc.

References oomph::TimeStepper::is_steady(), oomph::TimeStepper::ntstorage(), position(), Position_time_stepper_pt, t, and oomph::TimeStepper::weight().

Referenced by oomph::FSI_functions::apply_no_slip_on_moving_wall().

◆ dposition_dt() [2/2]

double oomph::Node::dposition_dt	(	const unsigned &	j,
		const unsigned &	i
	)		const

Return the i-th component of j-th derivative of nodal position: d^jx/dt^j either directly or via hanging node representation.

Return the i-th component of j-th derivative of nodal position: d^jx/dt^j. Use the hanging node representation.

Definition at line 2580 of file nodes.cc.

References oomph::TimeStepper::is_steady(), oomph::TimeStepper::ntstorage(), position(), Position_time_stepper_pt, t, and oomph::TimeStepper::weight().

◆ dposition_gen_dt() [1/2]

double oomph::Node::dposition_gen_dt	(	const unsigned &	k,
		const unsigned &	i
	)		const

i-th component of time derivative (velocity) of the generalised position, dx(k,i)/dt. `Type': k; Coordinate direction: i. This function uses the hanging node representation if necessary.

i-th component of time derivative (velocity) of the generalised position, dx(k,i)/dt. `Type': k; Coordinate direction: i. Use the hanging node representation

Definition at line 2605 of file nodes.cc.

References oomph::TimeStepper::is_steady(), oomph::TimeStepper::ntstorage(), position_gen(), Position_time_stepper_pt, t, and oomph::TimeStepper::weight().

◆ dposition_gen_dt() [2/2]

double oomph::Node::dposition_gen_dt	(	const unsigned &	j,
		const unsigned &	k,
		const unsigned &	i
	)		const

i-th component of j-th time derivative (velocity) of the generalised position, d^jx(k,i)/dt^j. `Type': k; Coordinate direction: i. This function uses the hanging node representation if necessary

i-th component of j-th time derivative (velocity) of the generalised position, d^jx(k,i)/dt^j. `Type': k; Coordinate direction: i. Use the hanging node representation.

Definition at line 2631 of file nodes.cc.

References oomph::TimeStepper::is_steady(), oomph::TimeStepper::ntstorage(), position_gen(), Position_time_stepper_pt, t, and oomph::TimeStepper::weight().

◆ dump()

void oomph::Node::dump ( std::ostream & dump_file ) const

virtual

Dump nodal position and associated data to file for restart.

Dump nodal positions and associated data to file for restart.

Reimplemented in oomph::SolidNode.

Definition at line 1892 of file nodes.cc.

References oomph::Data::dump(), Ndim, Nposition_type, oomph::TimeStepper::ntstorage(), Position_time_stepper_pt, t, and X_position.

Referenced by oomph::SolidNode::dump().

◆ dx_dt() [1/2]

double oomph::Node::dx_dt ( const unsigned & i ) const

Return the i-th component of nodal velocity: dx/dt.

Definition at line 1735 of file nodes.cc.

References oomph::TimeStepper::is_steady(), oomph::TimeStepper::ntstorage(), Position_time_stepper_pt, t, oomph::TimeStepper::weight(), and x().

◆ dx_dt() [2/2]

double oomph::Node::dx_dt	(	const unsigned &	j,
		const unsigned &	i
	)		const

Return the i-th component of j-th derivative of nodal position: d^jx/dt^j.

Definition at line 1759 of file nodes.cc.

References oomph::TimeStepper::is_steady(), oomph::TimeStepper::ntstorage(), Position_time_stepper_pt, t, oomph::TimeStepper::weight(), and x().

◆ dx_gen_dt() [1/2]

double oomph::Node::dx_gen_dt	(	const unsigned &	k,
		const unsigned &	i
	)		const

i-th component of time derivative (velocity) of the generalised position, dx(k,i)/dt. `Type': k; Coordinate direction: i.

Definition at line 1783 of file nodes.cc.

References oomph::TimeStepper::is_steady(), oomph::TimeStepper::ntstorage(), Position_time_stepper_pt, t, oomph::TimeStepper::weight(), and x_gen().

◆ dx_gen_dt() [2/2]

double oomph::Node::dx_gen_dt	(	const unsigned &	j,
		const unsigned &	k,
		const unsigned &	i
	)		const

i-th component of j-th time derivative (velocity) of the generalised position, d^jx(k,i)/dt^j. `Type': k; Coordinate direction: i.

Definition at line 1808 of file nodes.cc.

References oomph::TimeStepper::is_steady(), oomph::TimeStepper::ntstorage(), Position_time_stepper_pt, t, oomph::TimeStepper::weight(), and x_gen().

◆ get_boundaries_pt()

virtual void oomph::Node::get_boundaries_pt ( std::set< unsigned > *& boundaries_pt )

inlinevirtual

Return a pointer to set of mesh boundaries that this node occupies; this will be overloaded by BoundaryNodes. The default behaviour is that the Node does not lie on any boundaries so the pointer to the set of boundaries is NULL.

Definition at line 1284 of file nodes.h.

Referenced by oomph::TreeBasedRefineableMeshBase::adapt_mesh(), oomph::GeompackQuadMesh< ELEMENT >::build_from_scaffold(), oomph::SimpleCubicTetMesh< ELEMENT >::build_from_scaffold(), oomph::QuadFromTriangleMesh< ELEMENT >::build_from_scaffold(), oomph::TetgenMesh< ELEMENT >::build_from_scaffold(), oomph::TriangleMesh< ELEMENT >::build_from_scaffold(), oomph::GmshTetMesh< ELEMENT >::build_from_scaffold(), oomph::Mesh::copy_boundary_node_data_from_nodes(), oomph::TFace::get_boundaries_pt(), oomph::TreeBasedRefineableMeshBase::p_adapt_mesh(), oomph::LineMeshBase::setup_boundary_element_info(), oomph::QuadMeshBase::setup_boundary_element_info(), oomph::TriangleMeshBase::setup_boundary_element_info(), oomph::BrickMeshBase::setup_boundary_element_info(), oomph::HermiteQuadMesh< ELEMENT >::setup_boundary_element_info(), oomph::TetMeshBase::setup_boundary_element_info(), and oomph::ThinLayerBrickOnTetMesh< ELEMENT >::ThinLayerBrickOnTetMesh().

◆ get_coordinates_on_boundary() [1/2]

void oomph::Node::get_coordinates_on_boundary	(	const unsigned &	b,
		const unsigned &	k,
		Vector< double > &	boundary_zeta
	)

virtual

Return the vector of the k-th generalised boundary coordinates on mesh boundary b. Broken virtual interface provides run-time error checking.

Interface for function to get the k-th generalised boundary coordinate of the node on boundary b. Broken here in order to provide run-time error reporting. Must be overloaded by all boundary nodes.

Definition at line 2301 of file nodes.cc.

◆ get_coordinates_on_boundary() [2/2]

virtual void oomph::Node::get_coordinates_on_boundary	(	const unsigned &	b,
		Vector< double > &	boundary_zeta
	)

inlinevirtual

Return the vector of coordinates on mesh boundary b Broken virtual interface provides run-time error checking.

Definition at line 1328 of file nodes.h.

◆ hang_code()

unsigned oomph::Node::hang_code ( )

inline

Code that encapsulates the hanging status of the node (incl. the geometric hanging status) as $\sum_{i=-1}{nval-1} Node::is_hanging(i) 2^{i+1}$ .

Definition at line 1133 of file nodes.h.

References is_hanging(), and oomph::Data::nvalue().

Referenced by oomph::Mesh::doc_mesh_distribution().

◆ hanging_pt() [1/2]

HangInfo* const& oomph::Node::hanging_pt ( ) const

inline

Return pointer to hanging node data (this refers to the geometric hanging node status) (const version).

Definition at line 1148 of file nodes.h.

◆ hanging_pt() [2/2]

HangInfo* const& oomph::Node::hanging_pt ( const int & i ) const

inline

Return pointer to hanging node data for value i (const version)

Definition at line 1163 of file nodes.h.

References oomph::MPI_Helpers::communicator_pt(), and oomph::Data::nvalue().

◆ has_auxiliary_node_update_fct_pt()

bool oomph::Node::has_auxiliary_node_update_fct_pt ( )

inline

Boolean to indicate if node has a pointer to and auxiliary update function.

Definition at line 1501 of file nodes.h.

◆ is_hanging() [1/2]

bool oomph::Node::is_hanging ( ) const

inline

Test whether the node is geometrically hanging.

Definition at line 1207 of file nodes.h.

◆ is_hanging() [2/2]

bool oomph::Node::is_hanging ( const int & i ) const

inline

Test whether the i-th value is hanging.

Definition at line 1220 of file nodes.h.

References oomph::Data::nvalue(), and oomph::Data::resize().

◆ is_obsolete()

bool oomph::Node::is_obsolete ( )

inline

Test whether node is obsolete.

Definition at line 1354 of file nodes.h.

Referenced by oomph::Mesh::prune_halo_elements_and_nodes().

◆ is_on_boundary() [1/2]

virtual bool oomph::Node::is_on_boundary ( ) const

inlinevirtual

Test whether the Node lies on a boundary. The "bulk" Node cannot lie on a boundary, so return false. This will be overloaded by BoundaryNodes.

Definition at line 1290 of file nodes.h.

Referenced by oomph::TreeBasedRefineableMeshBase::adapt_mesh(), oomph::BackupMeshForProjection< GEOMETRIC_ELEMENT >::BackupMeshForProjection(), oomph::BackwardStepQuadMesh< ELEMENT >::build_mesh(), oomph::BrickFromTetMesh< ELEMENT >::build_mesh(), oomph::TriangleMesh< ELEMENT >::check_connections_of_polyline_nodes(), oomph::Mesh::copy_boundary_node_data_from_nodes(), oomph::BoundaryNodeBase::get_coordinates_on_boundary(), oomph::Missing_masters_functions::get_required_master_nodal_information_helper(), oomph::Multi_domain_functions::get_required_master_nodal_information_helper(), oomph::Missing_masters_functions::get_required_nodal_information_helper(), oomph::Multi_domain_functions::get_required_nodal_information_helper(), oomph::RefineableTriangleMesh< ELEMENT >::get_required_nodal_information_helper(), oomph::RefineableTriangleMesh< ELEMENT >::get_required_nodal_information_load_balance_helper(), oomph::TFace::is_on_boundary(), oomph::BoundaryNodeBase::ncoordinates_on_boundary(), oomph::TreeBasedRefineableMeshBase::p_adapt_mesh(), oomph::MGSolver< DIM >::plot(), oomph::BoundaryNodeBase::remove_from_boundary(), oomph::RefineableTriangleMesh< ELEMENT >::send_boundary_node_info_of_shared_nodes(), oomph::BoundaryNodeBase::set_coordinates_on_boundary(), oomph::RefineableTriangleMesh< ELEMENT >::snap_nodes_onto_boundary(), oomph::TetMeshBase::snap_to_quadratic_surface(), and oomph::TwoDAnnularMesh< ELEMENT >::wrap_into_annular_shape().

◆ is_on_boundary() [2/2]

virtual bool oomph::Node::is_on_boundary ( const unsigned & b ) const

inlinevirtual

Test whether the node lies on mesh boundary b. The "bulk" Node cannot lie on a boundary, so return false. This will be overloaded by BoundaryNodes.

Definition at line 1295 of file nodes.h.

◆ make_periodic()

void oomph::Node::make_periodic ( Node *const & node_pt )

virtual

Make the node periodic by copying the values from node_pt. Note that the coordinates will always remain independent, even though this may lead to (a little) unrequired information being stored. Broken virtual (only implemented in BoundaryNodes)

Make the node periodic by copying values from node_pt. Broken virtual (only implemented in BoundaryNodes)

Definition at line 2180 of file nodes.cc.

◆ make_periodic_nodes()

void oomph::Node::make_periodic_nodes ( const Vector< Node *> & periodic_nodes_pt )

virtual

Make the nodes passed in the vector periodic_nodes share the same data as this node.

Make the nodes passed in periodic_nodes_pt periodic by copying values across from this node. At present all the positions will be assumed to be independent. Broken virtual (only implemented in BoundaryNodes)

Definition at line 2193 of file nodes.cc.

◆ ncoordinates_on_boundary()

unsigned oomph::Node::ncoordinates_on_boundary ( const unsigned & b )

virtual

Get the number of boundary coordinates on mesh boundary b. Broken virtual interface provides run-time error checking.

Interface to get the number of boundary coordinates on mesh boundary b. Broken here in order to provide run-time error reporting. Must be overloaded by all boundary nodes.

Definition at line 2285 of file nodes.cc.

Referenced by oomph::BackupMeshForProjection< GEOMETRIC_ELEMENT >::BackupMeshForProjection(), and oomph::TwoLayerSpineMesh< ELEMENT >::build_two_layer_mesh().

◆ ndim()

unsigned oomph::Node::ndim ( ) const

inline

Return (Eulerian) spatial dimension of the node.

Definition at line 992 of file nodes.h.

Referenced by oomph::NonLinearElasticitySmoothMesh< ELEMENT >::actions_before_newton_solve(), oomph::Problem::adapt(), oomph::TreeBasedRefineableMeshBase::adapt_mesh(), oomph::SurfactantTransportInterfaceElement::add_additional_residual_contributions_interface(), add_values_to_vector(), oomph::AdvectionDiffusionFluxElement< ELEMENT >::AdvectionDiffusionFluxElement(), oomph::FSI_functions::apply_no_slip_on_moving_wall(), oomph::Newmark< NSTEPS >::assign_initial_data_values(), oomph::Steady< 0 >::assign_initial_positions_impulsive(), oomph::Newmark< NSTEPS >::assign_initial_positions_impulsive(), oomph::BDF< NSTEPS >::assign_initial_positions_impulsive(), oomph::GeneralisedElement::assign_local_eqn_numbers(), oomph::OneDLagrangianMesh< ELEMENT >::assign_undeformed_positions(), oomph::Multi_domain_functions::aux_setup_multi_domain_interaction(), oomph::NonLinearElasticitySmoothMesh< ELEMENT >::backup(), oomph::SolidICProblem::backup_original_state(), oomph::BackupMeshForProjection< GEOMETRIC_ELEMENT >::BackupMeshForProjection(), oomph::RefineableQElement< 3 >::build(), oomph::RefineableQElement< 2 >::build(), oomph::BDF< NSTEPS >::calculate_predicted_positions(), oomph::TR::calculate_predicted_positions(), oomph::Mesh::check_for_repeated_nodes(), oomph::Mesh::check_halo_schemes(), oomph::Missing_masters_functions::construct_new_external_halo_master_node_helper(), oomph::Multi_domain_functions::construct_new_external_halo_master_node_helper(), oomph::Missing_masters_functions::construct_new_external_halo_node_helper(), oomph::Multi_domain_functions::construct_new_external_halo_node_helper(), oomph::RefineableTriangleMesh< ELEMENT >::construct_new_halo_node_helper(), oomph::RefineableTriangleMesh< ELEMENT >::construct_new_node_load_balance_helper(), copy(), oomph::Mesh::delete_all_external_storage(), oomph::Mesh::distribute(), oomph::Mesh::doc_boundary_coordinates(), oomph::FSI_functions::doc_fsi(), oomph::Mesh::doc_mesh_distribution(), oomph::Mesh::doc_shared_nodes(), oomph::DummyErrorEstimator::DummyErrorEstimator(), oomph::ElementWithMovingNodes::fill_in_jacobian_from_geometric_data(), oomph::Problem::get_data_to_be_sent_during_load_balancing(), oomph::ElementWithMovingNodes::get_dnodal_coordinates_dgeom_dofs(), oomph::RefineableElement::get_dresidual_dnodal_coordinates(), oomph::ProjectableTimeHarmonicLinearElasticityElement< TIME_HARMONIC_LINEAR_ELAST_ELEMENT >::get_field(), oomph::ProjectablePMLTimeHarmonicLinearElasticityElement< TIME_HARMONIC_LINEAR_ELAST_ELEMENT >::get_field(), oomph::ProjectableTimeHarmonicFourierDecomposedLinearElasticityElement< TIME_HARMONIC_LINEAR_ELAST_ELEMENT >::get_field(), oomph::Missing_masters_functions::get_required_master_nodal_information_helper(), oomph::Multi_domain_functions::get_required_master_nodal_information_helper(), oomph::Missing_masters_functions::get_required_nodal_information_helper(), oomph::Multi_domain_functions::get_required_nodal_information_helper(), oomph::RefineableTriangleMesh< ELEMENT >::get_required_nodal_information_helper(), oomph::RefineableTriangleMesh< ELEMENT >::get_required_nodal_information_load_balance_helper(), oomph::FourierDecomposedHelmholtzBCElementBase< ELEMENT >::global_power_contribution(), oomph::PMLFourierDecomposedHelmholtzPowerMonitorElement< ELEMENT >::global_power_contribution(), oomph::HelmholtzBCElementBase< ELEMENT >::HelmholtzBCElementBase(), oomph::HelmholtzFluxElement< ELEMENT >::HelmholtzFluxElement(), oomph::HelmholtzFluxFromNormalDisplacementBCElement< HELMHOLTZ_BULK_ELEMENT, ELASTICITY_BULK_ELEMENT >::HelmholtzFluxFromNormalDisplacementBCElement(), oomph::LinearisedAxisymPoroelasticBJS_FSIElement< FLUID_BULK_ELEMENT, POROELASTICITY_BULK_ELEMENT >::LinearisedAxisymPoroelasticBJS_FSIElement(), oomph::LinearisedFSIAxisymmetricNStNoSlipBCElementElement< FLUID_BULK_ELEMENT, SOLID_BULK_ELEMENT >::LinearisedFSIAxisymmetricNStNoSlipBCElementElement(), oomph::LinearWaveFluxElement< ELEMENT >::LinearWaveFluxElement(), oomph::ProjectableTimeHarmonicLinearElasticityElement< TIME_HARMONIC_LINEAR_ELAST_ELEMENT >::local_equation(), oomph::ProjectablePMLTimeHarmonicLinearElasticityElement< TIME_HARMONIC_LINEAR_ELAST_ELEMENT >::local_equation(), oomph::ProjectableTimeHarmonicFourierDecomposedLinearElasticityElement< TIME_HARMONIC_LINEAR_ELAST_ELEMENT >::local_equation(), oomph::NavierStokesSurfaceDragTorqueElement< ELEMENT >::NavierStokesSurfaceDragTorqueElement(), oomph::NavierStokesSurfacePowerElement< ELEMENT >::NavierStokesSurfacePowerElement(), oomph::NavierStokesTractionElement< ELEMENT >::NavierStokesTractionElement(), oomph::NodeOrdering::node_global_position_comparison(), oomph::MacroElementNodeUpdateNode::node_update(), oomph::Mesh::node_update(), oomph::AlgebraicMesh::node_update(), oomph::NonLinearElasticitySmoothMesh< ELEMENT >::operator()(), oomph::LinearElasticitySmoothMesh< LINEAR_ELASTICITY_ELEMENT >::operator()(), oomph::PoissonSmoothMesh< POISSON_ELEMENT >::operator()(), oomph::operator<<(), oomph::HermiteBeamElement::output(), output(), oomph::DummyFaceElement< ELEMENT >::output(), oomph::TriangleMesh< ELEMENT >::output_boundary_coordinates(), oomph::ElementWithExternalElement::output_external_elements(), oomph::FiniteElement::output_paraview(), oomph::TreeBasedRefineableMeshBase::p_adapt_mesh(), oomph::PRefineableQElement< 2, INITIAL_NNODE_1D >::p_refine(), oomph::PRefineableQElement< 3, INITIAL_NNODE_1D >::p_refine(), oomph::Tree::p_refine_if_required(), oomph::MGSolver< DIM >::plot(), oomph::PMLHelmholtzFluxElement< ELEMENT >::PMLHelmholtzFluxElement(), oomph::PMLHelmholtzFluxFromNormalDisplacementBCElement< HELMHOLTZ_BULK_ELEMENT, ELASTICITY_BULK_ELEMENT >::PMLHelmholtzFluxFromNormalDisplacementBCElement(), oomph::PMLHelmholtzPowerElement< ELEMENT >::PMLHelmholtzPowerElement(), oomph::PoissonFluxElement< ELEMENT >::PoissonFluxElement(), oomph::PolarNavierStokesTractionElement< ELEMENT >::PolarNavierStokesTractionElement(), oomph::PolarStressIntegralElement< ELEMENT >::PolarStressIntegralElement(), position(), oomph::ProjectionProblem< PROJECTABLE_ELEMENT >::project(), oomph::Data::read(), read_values_from_vector(), oomph::RefineableQSpectralElement< 3 >::rebuild_from_sons(), oomph::RefineableQSpectralElement< 2 >::rebuild_from_sons(), oomph::PRefineableQElement< 2, INITIAL_NNODE_1D >::rebuild_from_sons(), oomph::PRefineableQElement< 3, INITIAL_NNODE_1D >::rebuild_from_sons(), oomph::TreeBasedRefineableMeshBase::refine_as_in_reference_mesh(), oomph::Problem::remove_duplicate_data(), oomph::NonLinearElasticitySmoothMesh< ELEMENT >::reset(), oomph::SolidICProblem::reset_original_state(), oomph::Mesh::resize_halo_nodes(), oomph::Mesh::scale_mesh(), oomph::Problem::set_pinned_values_to_zero(), set_position_time_stepper(), oomph::MGSolver< DIM >::set_self_test_vector(), oomph::SolidICProblem::setup_problem(), oomph::IMRBase::shift_time_positions(), oomph::Steady< 0 >::shift_time_positions(), oomph::Newmark< NSTEPS >::shift_time_positions(), oomph::NewmarkBDF< NSTEPS >::shift_time_positions(), oomph::BDF< NSTEPS >::shift_time_positions(), oomph::Tree::split_if_required(), oomph::UnsteadyHeatFluxElement< ELEMENT >::UnsteadyHeatFluxElement(), oomph::WomersleyMesh< WOMERSLEY_ELEMENT >::WomersleyMesh(), and oomph::YoungLaplaceContactAngleElement< ELEMENT >::YoungLaplaceContactAngleElement().

◆ ngeom_data()

virtual unsigned oomph::Node::ngeom_data ( ) const

inlinevirtual

Return the number of geometric data that affect the nodal position. The default value is zero (node is stationary)

Reimplemented in oomph::SpineNode.

Definition at line 1520 of file nodes.h.

Referenced by oomph::ElementWithMovingNodes::assemble_set_of_all_geometric_data().

◆ ngeom_object()

virtual unsigned oomph::Node::ngeom_object ( ) const

inlinevirtual

Return the number of geometric objects that affect the nodal position. The default value is zero (node is stationary)

Reimplemented in oomph::SpineNode, oomph::AlgebraicNode, and oomph::MacroElementNodeUpdateNode.

Definition at line 1528 of file nodes.h.

Referenced by oomph::ElementWithMovingNodes::assemble_set_of_all_geometric_data().

◆ node_update()

virtual void oomph::Node::node_update ( const bool & update_all_time_levels_for_new_node = false )

inlinevirtual

Interface for functions that update the nodal position using algebraic remeshing strategies. The interface is common to SpineNodes, AlgebraicNodes and MacroElementNodeUpdateNodes. The default is that the node does not "update itself" i.e. it is fixed in space. When implemented, this function should also execute the Node's auxiliary node update function (if any).

Reimplemented in oomph::SolidNode, oomph::SpineNode, oomph::AlgebraicNode, and oomph::MacroElementNodeUpdateNode.

Definition at line 1482 of file nodes.h.

◆ nposition_type()

unsigned oomph::Node::nposition_type ( ) const

inline

Number of coordinate types needed in the mapping between local and global coordinates.

Definition at line 966 of file nodes.h.

Referenced by add_values_to_vector(), oomph::Steady< 0 >::assign_initial_positions_impulsive(), oomph::Newmark< NSTEPS >::assign_initial_positions_impulsive(), oomph::BDF< NSTEPS >::assign_initial_positions_impulsive(), oomph::BackupMeshForProjection< GEOMETRIC_ELEMENT >::BackupMeshForProjection(), oomph::RefineableQElement< 3 >::build(), oomph::RefineableQElement< 1 >::build(), oomph::RefineableQElement< 2 >::build(), copy(), oomph::Missing_masters_functions::get_required_master_nodal_information_helper(), oomph::Multi_domain_functions::get_required_master_nodal_information_helper(), oomph::PRefineableQElement< 1, INITIAL_NNODE_1D >::p_refine(), oomph::PRefineableQElement< 2, INITIAL_NNODE_1D >::p_refine(), oomph::PRefineableQElement< 3, INITIAL_NNODE_1D >::p_refine(), oomph::ProjectionProblem< PROJECTABLE_ELEMENT >::pin_dofs_of_coordinate(), oomph::ProjectionProblem< PROJECTABLE_ELEMENT >::project(), read_values_from_vector(), oomph::Problem::set_pinned_values_to_zero(), set_position_time_stepper(), oomph::IMRBase::shift_time_positions(), oomph::Steady< 0 >::shift_time_positions(), oomph::Newmark< NSTEPS >::shift_time_positions(), oomph::NewmarkBDF< NSTEPS >::shift_time_positions(), oomph::BDF< NSTEPS >::shift_time_positions(), and oomph::ProjectionProblem< PROJECTABLE_ELEMENT >::unpin_dofs_of_coordinate().

◆ operator=()

void oomph::Node::operator= ( const Node & )

inline

Broken assignment operator.

Definition at line 955 of file nodes.h.

References oomph::BrokenCopy::broken_assign(), and oomph::Data::operator<<.

◆ output()

void oomph::Node::output ( std::ostream & outfile )

Output nodal position.

Output nodal coordinates.

Definition at line 2656 of file nodes.cc.

References i, ndim(), and x().

◆ perform_auxiliary_node_update_fct()

void oomph::Node::perform_auxiliary_node_update_fct ( )

inline

Execute auxiliary update function (if any) – this can be used to update any nodal values following the update of the nodal position. This is needed e.g. to update the no-slip condition on moving boundaries.

Definition at line 1510 of file nodes.h.

◆ pin_all()

virtual void oomph::Node::pin_all ( )

inlinevirtual

The pin_all() function must be overloaded by SolidNodes, so we put the virtual interface here to avoid virtual functions in Data.

Reimplemented in oomph::SolidNode.

Definition at line 1123 of file nodes.h.

References oomph::Data::pin_all().

Referenced by oomph::SolidNode::pin_all().

◆ position() [1/5]

void oomph::Node::position ( Vector< double > & pos ) const

Compute Vector of nodal positions either directly or via hanging node representation.

Compute Vector of nodal positions either directly or via hanging node representation

Definition at line 2413 of file nodes.cc.

References i, ndim(), and position().

Referenced by oomph::TreeBasedRefineableMeshBase::adapt_mesh(), oomph::Mesh::check_halo_schemes(), oomph::Mesh::delete_all_external_storage(), oomph::Problem::get_data_to_be_sent_during_load_balancing(), oomph::ElementWithMovingNodes::get_dnodal_coordinates_dgeom_dofs(), oomph::TreeBasedRefineableMeshBase::p_adapt_mesh(), oomph::Mesh::resize_halo_nodes(), oomph::XdaTetMesh< ELEMENT >::setup_boundary_coordinates(), oomph::HelmholtzMGPreconditioner< DIM >::setup_interpolation_matrices_unstructured(), oomph::MGSolver< DIM >::setup_interpolation_matrices_unstructured(), oomph::TetMeshBase::snap_nodes_onto_geometric_objects(), and oomph::ThinLayerBrickOnTetMesh< ELEMENT >::ThinLayerBrickOnTetMesh().

◆ position() [2/5]

Vector<double> oomph::Node::position ( ) const

inline

Return vector of position of node at current time.

Definition at line 1423 of file nodes.h.

Referenced by dposition_dt(), and position().

◆ position() [3/5]

void oomph::Node::position	(	const unsigned &	t,
		Vector< double > &	pos
	)		const

Compute Vector of nodal position at time level t (t=0: current; t>0: previous timestep), either directly or via hanging node representation.

Compute Vector of nodal position at timestep t (t=0: current; t>0: previous timestep), either directly or via hanging node representation.

Definition at line 2425 of file nodes.cc.

References i, ndim(), and position().

◆ position() [4/5]

double oomph::Node::position ( const unsigned & i ) const

Return i-th nodal coordinate either directly or via hanging node representation.

Definition at line 2436 of file nodes.cc.

References hanging_pt(), is_hanging(), oomph::HangInfo::master_node_pt(), oomph::HangInfo::master_weight(), oomph::HangInfo::nmaster(), and x().

◆ position() [5/5]

double oomph::Node::position	(	const unsigned &	t,
		const unsigned &	i
	)		const

Return i-th nodal coordinate at time level t (t=0: current; t>0: previous time level), either directly or via hanging node representation.

Definition at line 2465 of file nodes.cc.

References hanging_pt(), is_hanging(), oomph::HangInfo::master_node_pt(), oomph::HangInfo::master_weight(), oomph::HangInfo::nmaster(), and x().

◆ position_gen() [1/2]

double oomph::Node::position_gen	(	const unsigned &	k,
		const unsigned &	i
	)		const

Return generalised nodal coordinate either directly or via hanging node representation.

Definition at line 2495 of file nodes.cc.

References hanging_pt(), is_hanging(), oomph::HangInfo::master_node_pt(), oomph::HangInfo::master_weight(), oomph::HangInfo::nmaster(), and x_gen().

Referenced by dposition_gen_dt().

◆ position_gen() [2/2]

double oomph::Node::position_gen	(	const unsigned &	t,
		const unsigned &	k,
		const unsigned &	i
	)		const

Return generalised nodal coordinate at time level t (t=0: current; t>0: previous time level), either directly or via hanging node representation.

Definition at line 2525 of file nodes.cc.

References hanging_pt(), is_hanging(), oomph::HangInfo::master_node_pt(), oomph::HangInfo::master_weight(), oomph::HangInfo::nmaster(), and x_gen().

◆ position_is_a_copy() [1/2]

virtual bool oomph::Node::position_is_a_copy ( ) const

inlinevirtual

Return whether any position coordinate has been copied (always false)

Reimplemented in oomph::SolidNode.

Definition at line 1048 of file nodes.h.

Referenced by oomph::Steady< 0 >::assign_initial_positions_impulsive(), oomph::Newmark< NSTEPS >::assign_initial_positions_impulsive(), oomph::BDF< NSTEPS >::assign_initial_positions_impulsive(), oomph::RefineableQElement< 3 >::build(), oomph::BDF< NSTEPS >::calculate_predicted_positions(), oomph::TR::calculate_predicted_positions(), oomph::IMRBase::shift_time_positions(), oomph::Steady< 0 >::shift_time_positions(), oomph::Newmark< NSTEPS >::shift_time_positions(), oomph::NewmarkBDF< NSTEPS >::shift_time_positions(), and oomph::BDF< NSTEPS >::shift_time_positions().

◆ position_is_a_copy() [2/2]

virtual bool oomph::Node::position_is_a_copy ( const unsigned & i ) const

inlinevirtual

Return whether the position coordinate i has been copied (always false)

Reimplemented in oomph::SolidNode.

Definition at line 1051 of file nodes.h.

◆ position_time_stepper_pt() [1/2]

TimeStepper* & oomph::Node::position_time_stepper_pt ( )

inline

Return a pointer to the position timestepper.

Definition at line 969 of file nodes.h.

◆ position_time_stepper_pt() [2/2]

TimeStepper* const& oomph::Node::position_time_stepper_pt ( ) const

inline

Return a pointer to the position timestepper (const version).

Definition at line 972 of file nodes.h.

◆ raw_value() [1/2]

double oomph::Node::raw_value ( const unsigned & i ) const

inline

Return the i-th value stored at the Node. This interface does NOT take the hanging status of the Node into account.

Definition at line 1358 of file nodes.h.

References oomph::Data::value().

Referenced by oomph::TreeBasedRefineableMeshBase::adapt_mesh(), oomph::TreeBasedRefineableMeshBase::p_adapt_mesh(), oomph::FiniteElement::raw_nodal_value(), and value().

◆ raw_value() [2/2]

double oomph::Node::raw_value	(	const unsigned &	t,
		const unsigned &	i
	)		const

inline

Return the i-th value at time level t (t=0: present, t>0: previous). This interface does NOT take the hanging status of the Node into account.

Definition at line 1363 of file nodes.h.

References t, and oomph::Data::value().

◆ read()

void oomph::Node::read ( std::ifstream & restart_file )

Read nodal position and associated data from file for restart.

Read nodal positions and associated data from file for restart.

Definition at line 1919 of file nodes.cc.

References Ndim, Nposition_type, oomph::TimeStepper::ntstorage(), Position_time_stepper_pt, oomph::Data::read(), oomph::Global_string_for_annotation::string(), t, and X_position.

Referenced by oomph::Mesh::read(), and oomph::SolidNode::read().

◆ read_values_from_vector()

void oomph::Node::read_values_from_vector	(	const Vector< double > &	vector_of_values,
		unsigned &	index
	)

virtual

Read all data and time history values from the vector starting from index. On return the index will be set the value at the end of the data that has been read in Overload to also read the position information.

Read the position data and its time histories from the vector after reading the "standard" data.

Reimplemented from oomph::Data.

Reimplemented in oomph::SolidNode.

Definition at line 2726 of file nodes.cc.

References i, ndim(), nposition_type(), oomph::TimeStepper::ntstorage(), position_time_stepper_pt(), oomph::Data::read_values_from_vector(), t, and X_position.

Referenced by oomph::SolidNode::read_values_from_vector().

◆ remove_from_boundary()

void oomph::Node::remove_from_boundary ( const unsigned & b )

virtual

Broken interface for removing the node from the mesh boundary b Here to provide error reporting.

Interface for function to remove the node from the mesh boundary b. Broken here in order to report run-time erorrs. Must be overloaded by all boundary nodes

Definition at line 2272 of file nodes.cc.

Referenced by oomph::RefineableTriangleMesh< ELEMENT >::adapt(), oomph::TwoLayerSpineMesh< ELEMENT >::build_two_layer_mesh(), oomph::Mesh::remove_boundary_node(), and oomph::Mesh::remove_boundary_nodes().

◆ resize()

void oomph::Node::resize ( const unsigned & n_value )

virtual

Resize the number of equations.

Resize the node to allow it to store n_value unknowns.

Reimplemented from oomph::Data.

Definition at line 2089 of file nodes.cc.

References oomph::Data::constrain(), Hanging_pt, i, oomph::Data::nvalue(), oomph::Data::resize(), and oomph::Data::unconstrain().

Referenced by oomph::TriangleMesh< ELEMENT >::build_from_scaffold(), oomph::Missing_masters_functions::construct_new_external_halo_node_helper(), oomph::Multi_domain_functions::construct_new_external_halo_node_helper(), oomph::RefineableTriangleMesh< ELEMENT >::construct_new_halo_node_helper(), oomph::RefineableTriangleMesh< ELEMENT >::construct_new_node_load_balance_helper(), oomph::Mesh::resize_halo_nodes(), oomph::FaceElement::resize_nodes(), and oomph::ProjectionProblem< PROJECTABLE_ELEMENT >::store_positions().

◆ set_auxiliary_node_update_fct_pt()

void oomph::Node::set_auxiliary_node_update_fct_pt ( AuxNodeUpdateFctPt aux_node_update_fct_pt )

inline

Set pointer to auxiliary update function – this can be used to update any nodal values following the update of the nodal position. This is needed e.g. to update the no-slip condition on moving boundaries.

Definition at line 1490 of file nodes.h.

◆ set_coordinates_on_boundary() [1/2]

void oomph::Node::set_coordinates_on_boundary	(	const unsigned &	b,
		const unsigned &	k,
		const Vector< double > &	boundary_zeta
	)

virtual

Set the vector of the k-th generalised boundary coordinates on mesh boundary b. Broken virtual interface provides run-time error checking.

Interface for function to set the k-th generalised boundary coordinate of the node on boundary b. Broken here to provide run-time error reports. Must be overloaded by all boundary nodes.

Definition at line 2315 of file nodes.cc.

Referenced by oomph::BackupMeshForProjection< GEOMETRIC_ELEMENT >::BackupMeshForProjection(), oomph::BrethertonSpineMesh< ELEMENT, INTERFACE_ELEMENT >::BrethertonSpineMesh(), oomph::RefineableQElement< 3 >::build(), oomph::RefineableQElement< 2 >::build(), oomph::BrickFromTetMesh< ELEMENT >::build_mesh(), oomph::TwoLayerSpineMesh< ELEMENT >::build_two_layer_mesh(), oomph::ChannelWithLeafletMesh< ELEMENT >::ChannelWithLeafletMesh(), oomph::RefineableTriangleMesh< ELEMENT >::construct_new_halo_node_helper(), oomph::RefineableTriangleMesh< ELEMENT >::construct_new_node_load_balance_helper(), oomph::CylinderWithFlagMesh< ELEMENT >::CylinderWithFlagMesh(), oomph::TriangleMesh< ELEMENT >::identify_boundary_segments_and_assign_initial_zeta_values(), oomph::PRefineableQElement< 2, INITIAL_NNODE_1D >::p_refine(), oomph::PRefineableQElement< 3, INITIAL_NNODE_1D >::p_refine(), oomph::QuarterPipeMesh< ELEMENT >::QuarterPipeMesh(), oomph::PRefineableQElement< 2, INITIAL_NNODE_1D >::rebuild_from_sons(), oomph::PRefineableQElement< 3, INITIAL_NNODE_1D >::rebuild_from_sons(), oomph::BrethertonSpineMesh< ELEMENT, INTERFACE_ELEMENT >::reposition_spines(), oomph::RefineableTriangleMesh< ELEMENT >::send_boundary_node_info_of_shared_nodes(), oomph::ElasticRectangularQuadMesh< ELEMENT >::set_boundary_coordinates(), oomph::XdaTetMesh< ELEMENT >::setup_boundary_coordinates(), oomph::TetMeshBase::setup_boundary_coordinates(), oomph::UnstructuredTwoDMeshGeometryBase::setup_boundary_coordinates(), oomph::TetMeshBase::snap_to_quadratic_surface(), oomph::TriangleMesh< ELEMENT >::synchronize_boundary_coordinates(), oomph::ThinLayerBrickOnTetMesh< ELEMENT >::ThinLayerBrickOnTetMesh(), and oomph::TwoDAnnularMesh< ELEMENT >::wrap_into_annular_shape().

◆ set_coordinates_on_boundary() [2/2]

virtual void oomph::Node::set_coordinates_on_boundary	(	const unsigned &	b,
		const Vector< double > &	boundary_zeta
	)

inlinevirtual

Set the vector of coordinates on mesh boundary b Broken virtual interface provides run-time error checking.

Definition at line 1336 of file nodes.h.

◆ set_hanging_pt()

void oomph::Node::set_hanging_pt	(	HangInfo *const &	hang_pt,
		const int &	i
	)

Set the hanging data for the i-th value. (hang_pt=0 to make non-hanging)

Set the hanging data for the i-th value. If node is already hanging, simply overwrite the appropriate entry. If the node isn't hanging (because it might not be hanging geometrically), create the Vector of hanging pointers and make the other entries point to the node's geometric hanging data. Set hang_pt=0 to make entry explicitly non-hanging. Use Node::set_nonhanging() to unhang everything and clear up storage.

Definition at line 1997 of file nodes.cc.

References oomph::Data::constrain(), constrain_positions(), Hanging_pt, oomph::Data::nvalue(), oomph::Data::unconstrain(), and unconstrain_positions().

Referenced by oomph::TreeBasedRefineableMeshBase::complete_hanging_nodes(), oomph::RefineableQElement< 3 >::oc_hang_helper(), oomph::RefineableQElement< 2 >::quad_hang_helper(), oomph::Missing_masters_functions::recursively_add_masters_of_external_halo_node_to_storage(), oomph::Multi_domain_functions::recursively_add_masters_of_external_halo_node_to_storage(), and oomph::TreeBasedRefineableMeshBase::synchronise_hanging_nodes().

◆ set_non_obsolete()

void oomph::Node::set_non_obsolete ( )

inline

Mark node as non-obsolete.

Definition at line 1351 of file nodes.h.

Referenced by oomph::TreeBasedRefineableMeshBase::adapt_mesh(), oomph::Mesh::distribute(), oomph::RefineableTriangleMesh< ELEMENT >::load_balance(), oomph::TreeBasedRefineableMeshBase::p_adapt_mesh(), oomph::Mesh::prune_halo_elements_and_nodes(), and oomph::RefineableElement::unbuild().

◆ set_nonhanging()

void oomph::Node::set_nonhanging ( )

Label node as non-hanging node by removing all hanging node data.

Definition at line 2204 of file nodes.cc.

References Hanging_pt, oomph::Data::nvalue(), oomph::Data::unconstrain(), and unconstrain_positions().

Referenced by oomph::TreeBasedRefineableMeshBase::adapt_mesh(), oomph::Mesh::delete_all_external_storage(), and oomph::TreeBasedRefineableMeshBase::p_adapt_mesh().

◆ set_obsolete()

void oomph::Node::set_obsolete ( )

inline

Mark node as obsolete.

Definition at line 1348 of file nodes.h.

Referenced by oomph::TreeBasedRefineableMeshBase::adapt_mesh(), oomph::Mesh::distribute(), oomph::TreeBasedRefineableMeshBase::p_adapt_mesh(), and oomph::Mesh::prune_halo_elements_and_nodes().

◆ set_position_time_stepper()

void oomph::Node::set_position_time_stepper	(	TimeStepper *const &	position_time_stepper_pt,
		const bool &	preserve_existing_data
	)

virtual

Set a new position timestepper be resizing the appropriate storage.

Set a new position TimeStepper be resizing the appropriate storage. The current (zero) values will be unaffected, but all other entries will be set to zero.

Reimplemented in oomph::SolidNode.

Definition at line 1678 of file nodes.cc.

References ndim(), nposition_type(), oomph::TimeStepper::ntstorage(), Position_time_stepper_pt, position_time_stepper_pt(), t, and X_position.

◆ unconstrain_positions()

virtual void oomph::Node::unconstrain_positions ( )

inlinevirtual

Unconstrain the positions when the node is made non-hanging Empty virtual function that is overloaded in SolidNodes.

Reimplemented in oomph::SolidNode.

Definition at line 1268 of file nodes.h.

Referenced by set_hanging_pt(), and set_nonhanging().

◆ unpin_all()

virtual void oomph::Node::unpin_all ( )

inlinevirtual

The unpin_all() function must be overloaded by SolidNode, so we put the virtual interface here to avoid virtual functions in Data.

Reimplemented in oomph::SolidNode.

Definition at line 1127 of file nodes.h.

References oomph::Data::unpin_all().

Referenced by oomph::SolidNode::unpin_all().

◆ value() [1/5]

double oomph::Node::value ( const unsigned & i ) const

Return i-th value (dofs or pinned) at this node either directly or via hanging node representation. Note that this REDFINES the interface in Data Thus, the present function will be called provided that it is accessed through a pointer to a node i.e. Node* node_pt->value() will take hanging information into account. If a pointer to a Node has been explicitly down-cast to a pointer to Data then the "wrong" (Data) version of the function will be called.

Return i-th value (free or pinned) at this node either directly or via hanging node representation.

Definition at line 2328 of file nodes.cc.

References hanging_pt(), is_hanging(), oomph::HangInfo::master_node_pt(), oomph::HangInfo::master_weight(), oomph::HangInfo::nmaster(), and raw_value().

◆ value() [2/5]

double oomph::Node::value	(	const unsigned &	t,
		const unsigned &	i
	)		const

Return i-th value at time level t (t=0: present, t>0: previous) either directly or via hanging node representation. Note that this REDEFINES the interface in Data Thus, the present function will be called provided that it is accessed through a pointer to a node i.e. Node* node_pt->value() will take hanging information into account. If a pointer to a Node has been explicitly down-cast to a pointer to Data then the "wrong" (Data) version of the function will be called.

Return i-th value (free or pinned) at this node at time level t either directly or via hanging node representation.

Definition at line 2354 of file nodes.cc.

References hanging_pt(), is_hanging(), oomph::HangInfo::master_node_pt(), oomph::HangInfo::master_weight(), oomph::HangInfo::nmaster(), and raw_value().

◆ value() [3/5]

void oomph::Node::value ( Vector< double > & values ) const

Compute Vector of values for the Data value taking the hanging node status into account. Note that this REDEFINES the interface in Data Thus, the present function will be called provided that it is accessed through a pointer to a node i.e. Node* node_pt->value() will take hanging information into account. If a pointer to a Node has been explicitly down-cast to a pointer to Data then the "wrong" (Data) version of the function will be called.

Compute Vector of values (dofs or pinned) at this Data object either directly or via hanging node representation.

Definition at line 2380 of file nodes.cc.

References i, oomph::Data::nvalue(), and value().

◆ value() [4/5]

Vector<double> oomph::Node::value ( ) const

inline

Return vector of values calculated using value(vector).

Definition at line 1400 of file nodes.h.

References oomph::Data::nvalue(), and oomph::Data::value().

Referenced by value().

◆ value() [5/5]

void oomph::Node::value	(	const unsigned &	t,
		Vector< double > &	values
	)		const

Compute Vector of values (dofs or pinned) in this data at time level t (t=0: present; t>0: previous). This interface explicitly takes the hanging status into account. Thus, the present function will be called provided that it is accessed through a pointer to a node i.e. Node* node_pt->value() will take hanging information into account. If a pointer to a Node has been explicitly down-cast to a pointer to Data then the "wrong" (Data) version of the function will be called.

Compute Vector of values (dofs or pinned) at this node at time level t (t=0: present; t>0: previous) either directly or via hanging node representation.

Definition at line 2396 of file nodes.cc.

References i, oomph::Data::nvalue(), and value().

◆ x() [1/4]

double& oomph::Node::x ( const unsigned & i )

inline

Return the i-th nodal coordinate.

Definition at line 995 of file nodes.h.

References i.

◆ x() [2/4]

const double& oomph::Node::x ( const unsigned & i ) const

inline

Return the i-th nodal coordinate (const version).

Definition at line 1004 of file nodes.h.

References i.

◆ x() [3/4]

double& oomph::Node::x	(	const unsigned &	t,
		const unsigned &	i
	)

inline

Return the position x(i) at previous timestep t (t=0: present; t>0 previous timestep).

Definition at line 1014 of file nodes.h.

References i, and t.

◆ x() [4/4]

const double& oomph::Node::x	(	const unsigned &	t,
		const unsigned &	i
	)		const

inline

Return the position x(i) at previous timestep t (t=0: present; t>0 previous timestep) (const version)

Definition at line 1024 of file nodes.h.

References i, and t.

◆ x_gen() [1/4]

double& oomph::Node::x_gen	(	const unsigned &	k,
		const unsigned &	i
	)

inline

Reference to the generalised position x(k,i).

`Type': k; Coordinate direction: i.

Definition at line 1055 of file nodes.h.

Referenced by oomph::Steady< 0 >::assign_initial_positions_impulsive(), oomph::Newmark< NSTEPS >::assign_initial_positions_impulsive(), oomph::BDF< NSTEPS >::assign_initial_positions_impulsive(), oomph::RefineableSolidElement::assign_solid_hanging_local_eqn_numbers(), oomph::SolidFiniteElement::assign_solid_local_eqn_numbers(), oomph::OneDLagrangianMesh< ELEMENT >::assign_undeformed_positions(), dx_gen_dt(), oomph::ClampedHermiteShellBoundaryConditionElement::fill_in_contribution_to_residuals(), oomph::BiharmonicFluidBoundaryElement::fill_in_generic_residual_contribution_biharmonic_boundary(), oomph::BiharmonicFluxElement< DIM >::fill_in_generic_residual_contribution_biharmonic_flux(), oomph::RefineableSolidElement::fill_in_jacobian_from_solid_position_by_fd(), oomph::RefineablePseudoSolidNodeUpdateElement< BASIC, SOLID >::fill_in_shape_derivatives_by_fd(), oomph::BiharmonicFluxElement< DIM >::J_eulerian(), position_gen(), oomph::ProjectionProblem< PROJECTABLE_ELEMENT >::project(), oomph::ProjectionProblem< PROJECTABLE_ELEMENT >::restore_positions(), oomph::SolidMesh::set_lagrangian_nodal_coordinates(), oomph::Problem::set_pinned_values_to_zero(), oomph::HermiteQuadMesh< ELEMENT >::set_position_of_node(), oomph::IMRBase::shift_time_positions(), oomph::Steady< 0 >::shift_time_positions(), oomph::Newmark< NSTEPS >::shift_time_positions(), oomph::NewmarkBDF< NSTEPS >::shift_time_positions(), oomph::BDF< NSTEPS >::shift_time_positions(), and oomph::ProjectionProblem< PROJECTABLE_ELEMENT >::store_positions().

◆ x_gen() [2/4]

const double& oomph::Node::x_gen	(	const unsigned &	k,
		const unsigned &	i
	)		const

inline

Reference to the generalised position x(k,i). `Type': k; Coordinate direction: i (const version).

Definition at line 1065 of file nodes.h.

◆ x_gen() [3/4]

double& oomph::Node::x_gen	(	const unsigned &	t,
		const unsigned &	k,
		const unsigned &	i
	)

inline

Reference to the generalised position x(k,i) at the previous timestep [t=0: present]. `Type': k; Coordinate direction: i.

Definition at line 1076 of file nodes.h.

References t.

◆ x_gen() [4/4]

const double& oomph::Node::x_gen	(	const unsigned &	t,
		const unsigned &	k,
		const unsigned &	i
	)		const

inline

Reference to the generalised position x(k,i) at the previous timestep [t=0: present]. `Type': k; Coordinate direction: i. (const version)

Definition at line 1088 of file nodes.h.

References t.

◆ x_gen_range_check()

void oomph::Node::x_gen_range_check	(	const unsigned &	t,
		const unsigned &	k,
		const unsigned &	i
	)		const

protected

Private function to check that the arguemnts to the position functions are in range.

Private function to check that the arguments are within the range of the stored coordinates, position types and time history values.

Definition at line 1469 of file nodes.cc.

References No_independent_position.

◆ x_position_pt()

double* oomph::Node::x_position_pt ( const unsigned & i )

inlineprotected

Direct access to the pointer to the i-th stored coordinate data.

Definition at line 907 of file nodes.h.

References i.

◆ x_pt()

double* oomph::Node::x_pt	(	const unsigned &	t,
		const unsigned &	i
	)

inline

Direct access to the i-th coordinate at time level t.

(t=0: present; t>0: previous)

Definition at line 1109 of file nodes.h.

References oomph::Data::copy(), oomph::Data::dump(), i, oomph::Data::read(), and t.

Friends And Related Function Documentation

◆ BoundaryNodeBase

friend class BoundaryNodeBase

friend

to construct periodic Nodes

Definition at line 863 of file nodes.h.

◆ operator<<

std::ostream& operator<<	(	std::ostream &	out,
		const Node &	d
	)

friend

Output operator: output location and all values at all times, along with any extra information stored for the timestepper.

Node output operator: output equation numbers and values at all times, along with any extra information stored for the timestepper.

Definition at line 359 of file nodes.cc.

Member Data Documentation

◆ Aux_node_update_fct_pt

AuxNodeUpdateFctPt oomph::Node::Aux_node_update_fct_pt

protected

Pointer to auxiliary update function – this can be used to update any nodal values following the update of the nodal position. This is needed e.g. to update the no-slip condition on moving boundaries.

Definition at line 913 of file nodes.h.

Referenced by oomph::MacroElementNodeUpdateNode::node_update(), and oomph::SpineNode::node_update().

◆ Hanging_pt

HangInfo* * oomph::Node::Hanging_pt

protected

C-style array of pointers to hanging node info. It's set to NULL if the node isn't hanging. The first entry (0) is the geometric hanging node data. The remaining entries correspond to the hanging data for the other values stored at the node. Usually, these entries will be the same as the geometric hanging node data represented by Hanging_pt[0], but this is not necessarily the case; e.g. the pressure in Taylor Hood has different hanging node data from the velocities.

Definition at line 891 of file nodes.h.

Referenced by resize(), set_hanging_pt(), set_nonhanging(), and ~Node().

◆ Ndim

unsigned oomph::Node::Ndim

protected

Eulerian dimension of the node.

Definition at line 894 of file nodes.h.

Referenced by copy(), dump(), read(), and oomph::SolidNode::SolidNode().

◆ No_independent_position

unsigned oomph::Node::No_independent_position =10

static

Static "Magic number" used to indicate that there is no independent position in a periodic node.

Static "Magic number" passed as independent_position when there is no independent position in the periodic node. For example, in a periodic mesh.

Definition at line 919 of file nodes.h.

Referenced by x_gen_range_check().

◆ Nposition_type

unsigned oomph::Node::Nposition_type

protected

Number of coordinate types used in the mapping between local and global coordinates (e.g. 1 for Lagrange-type elements; 2 for 1D Hermite elements; 4 for 2D Hermite elements, etc).

Definition at line 900 of file nodes.h.

Referenced by copy(), dump(), read(), and oomph::SolidNode::SolidNode().

◆ Obsolete

bool oomph::Node::Obsolete

protected

Flag to indicate that the Node has become obsolete — usually during mesh refinement process.

Definition at line 904 of file nodes.h.

◆ Position_time_stepper_pt

TimeStepper* oomph::Node::Position_time_stepper_pt

protected

Pointer to the timestepper associated with the position data.

Definition at line 881 of file nodes.h.

Referenced by copy(), dposition_dt(), dposition_gen_dt(), dump(), dx_dt(), dx_gen_dt(), Node(), oomph::MacroElementNodeUpdateNode::node_update(), read(), set_position_time_stepper(), and oomph::SolidNode::set_position_time_stepper().

◆ X_position

double** oomph::Node::X_position

protected

Array of pointers to the data holding the Eulerian positions. The storage format must be the same as the internal data storage so that we can implement the functions x() in generality here without the need for virtual functions. The first index will be a flat array of position types and coordinates and the second will be the number of time history values at each position type.

Definition at line 878 of file nodes.h.

Referenced by add_values_to_vector(), copy(), dump(), Node(), read(), read_values_from_vector(), oomph::SolidNode::set_external_variable_position_pt(), set_position_time_stepper(), oomph::SolidNode::set_position_time_stepper(), oomph::SolidNode::SolidNode(), ~Node(), and oomph::SolidNode::~SolidNode().

The documentation for this class was generated from the following files:

Public Types

Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Friends

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ AuxNodeUpdateFctPt

Constructor & Destructor Documentation

◆ Node() [1/4]

◆ Node() [2/4]

◆ Node() [3/4]

◆ ~Node()

◆ Node() [4/4]

Member Function Documentation

◆ add_to_boundary()

◆ add_values_to_vector()

◆ all_geom_data_pt()

◆ all_geom_object_pt()

◆ assign_eqn_numbers()

◆ boundary_coordinates_have_been_set_up()

◆ constrain_positions()

◆ copied_node_pt()

◆ copy()

◆ does_pointer_correspond_to_position_data()

◆ dposition_dt() [1/2]

◆ dposition_dt() [2/2]

◆ dposition_gen_dt() [1/2]

◆ dposition_gen_dt() [2/2]

◆ dump()

◆ dx_dt() [1/2]

◆ dx_dt() [2/2]

◆ dx_gen_dt() [1/2]

◆ dx_gen_dt() [2/2]

◆ get_boundaries_pt()

◆ get_coordinates_on_boundary() [1/2]

◆ get_coordinates_on_boundary() [2/2]

◆ hang_code()

◆ hanging_pt() [1/2]

◆ hanging_pt() [2/2]

◆ has_auxiliary_node_update_fct_pt()

◆ is_hanging() [1/2]

◆ is_hanging() [2/2]

◆ is_obsolete()

◆ is_on_boundary() [1/2]

◆ is_on_boundary() [2/2]

◆ make_periodic()

◆ make_periodic_nodes()

◆ ncoordinates_on_boundary()

◆ ndim()

◆ ngeom_data()

◆ ngeom_object()

◆ node_update()

◆ nposition_type()

◆ operator=()

◆ output()

◆ perform_auxiliary_node_update_fct()

◆ pin_all()

◆ position() [1/5]

◆ position() [2/5]

◆ position() [3/5]

◆ position() [4/5]

◆ position() [5/5]

◆ position_gen() [1/2]

◆ position_gen() [2/2]

◆ position_is_a_copy() [1/2]

◆ position_is_a_copy() [2/2]

◆ position_time_stepper_pt() [1/2]

◆ position_time_stepper_pt() [2/2]

◆ raw_value() [1/2]

◆ raw_value() [2/2]

◆ read()

◆ read_values_from_vector()

◆ remove_from_boundary()

◆ resize()

◆ set_auxiliary_node_update_fct_pt()

◆ set_coordinates_on_boundary() [1/2]

◆ set_coordinates_on_boundary() [2/2]