Bretherton problem. More...

Inheritance diagram for BrethertonProblem< ELEMENT >:

Public Member Functions
	BrethertonProblem ()
	Constructor: More...

void	actions_before_newton_convergence_check ()

void	actions_before_newton_solve ()
	Update before solve: empty. More...

void	actions_after_newton_solve ()

void	fix_pressure (const unsigned &e, const unsigned &l, const double &pvalue)
	Fix pressure value l in element e to value p_value. More...

void	activate_inflow_dependency ()

void	parameter_study (const unsigned &nsteps)
	Run a parameter study; perform specified number of steps. More...

void	doc_solution (DocInfo &doc_info)
	Doc the solution. More...

Public Member Functions inherited from oomph::Problem
virtual void	debug_hook_fct (const unsigned &i)

void	set_analytic_dparameter (double *const &parameter_pt)

void	unset_analytic_dparameter (double *const &parameter_pt)

bool	is_dparameter_calculated_analytically (double *const &parameter_pt)

void	set_analytic_hessian_products ()

void	unset_analytic_hessian_products ()

bool	are_hessian_products_calculated_analytically ()

void	set_pinned_values_to_zero ()

bool	distributed () const

virtual void	actions_before_adapt ()

virtual void	actions_after_adapt ()
	Actions that are to be performed after a mesh adaptation. More...

OomphCommunicator *	communicator_pt ()
	access function to the oomph-lib communicator More...

const OomphCommunicator *	communicator_pt () const
	access function to the oomph-lib communicator, const version More...

	Problem ()

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

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

virtual	~Problem ()
	Virtual destructor to clean up memory. More...

Mesh *&	mesh_pt ()
	Return a pointer to the global mesh. More...

Mesh *const &	mesh_pt () const
	Return a pointer to the global mesh (const version) More...

Mesh *&	mesh_pt (const unsigned &imesh)

Mesh *const &	mesh_pt (const unsigned &imesh) const
	Return a pointer to the i-th submesh (const version) More...

unsigned	nsub_mesh () const
	Return number of submeshes. More...

unsigned	add_sub_mesh (Mesh *const &mesh_pt)

void	flush_sub_meshes ()

void	build_global_mesh ()

void	rebuild_global_mesh ()

LinearSolver *&	linear_solver_pt ()
	Return a pointer to the linear solver object. More...

LinearSolver *const &	linear_solver_pt () const
	Return a pointer to the linear solver object (const version) More...

LinearSolver *&	mass_matrix_solver_for_explicit_timestepper_pt ()

LinearSolver *	mass_matrix_solver_for_explicit_timestepper_pt () const

EigenSolver *&	eigen_solver_pt ()
	Return a pointer to the eigen solver object. More...

EigenSolver *const &	eigen_solver_pt () const
	Return a pointer to the eigen solver object (const version) More...

Time *&	time_pt ()
	Return a pointer to the global time object. More...

Time *	time_pt () const
	Return a pointer to the global time object (const version). More...

double &	time ()
	Return the current value of continuous time. More...

double	time () const
	Return the current value of continuous time (const version) More...

TimeStepper *&	time_stepper_pt ()

const TimeStepper *	time_stepper_pt () const

TimeStepper *&	time_stepper_pt (const unsigned &i)
	Return a pointer to the i-th timestepper. More...

ExplicitTimeStepper *&	explicit_time_stepper_pt ()
	Return a pointer to the explicit timestepper. More...

unsigned long	set_timestepper_for_all_data (TimeStepper *const &time_stepper_pt, const bool &preserve_existing_data=false)

virtual void	shift_time_values ()
	Shift all values along to prepare for next timestep. More...

AssemblyHandler *&	assembly_handler_pt ()
	Return a pointer to the assembly handler object. More...

AssemblyHandler *const &	assembly_handler_pt () const
	Return a pointer to the assembly handler object (const version) More...

double &	minimum_dt ()
	Access function to min timestep in adaptive timestepping. More...

double &	maximum_dt ()
	Access function to max timestep in adaptive timestepping. More...

unsigned &	max_newton_iterations ()
	Access function to max Newton iterations before giving up. More...

void	problem_is_nonlinear (const bool &prob_lin)
	Access function to Problem_is_nonlinear. More...

double &	max_residuals ()

bool &	time_adaptive_newton_crash_on_solve_fail ()
	Access function for Time_adaptive_newton_crash_on_solve_fail. More...

double &	newton_solver_tolerance ()

void	add_time_stepper_pt (TimeStepper *const &time_stepper_pt)

void	set_explicit_time_stepper_pt (ExplicitTimeStepper *const &explicit_time_stepper_pt)

void	initialise_dt (const double &dt)

void	initialise_dt (const Vector< double > &dt)

Data *&	global_data_pt (const unsigned &i)
	Return a pointer to the the i-th global data object. More...

void	add_global_data (Data *const &global_data_pt)

void	flush_global_data ()

LinearAlgebraDistribution *const &	dof_distribution_pt () const
	Return the pointer to the dof distribution (read-only) More...

unsigned long	ndof () const
	Return the number of dofs. More...

unsigned	ntime_stepper () const
	Return the number of time steppers. More...

unsigned	nglobal_data () const
	Return the number of global data values. More...

unsigned	self_test ()
	Self-test: Check meshes and global data. Return 0 for OK. More...

void	enable_store_local_dof_pt_in_elements ()

void	disable_store_local_dof_pt_in_elements ()

unsigned long	assign_eqn_numbers (const bool &assign_local_eqn_numbers=true)

void	describe_dofs (std::ostream &out= *(oomph_info.stream_pt())) const

void	enable_discontinuous_formulation ()

void	disable_discontinuous_formulation ()

void	get_dofs (DoubleVector &dofs) const

void	get_dofs (const unsigned &t, DoubleVector &dofs) const
	Return vector of the t'th history value of all dofs. More...

void	set_dofs (const DoubleVector &dofs)
	Set the values of the dofs. More...

void	set_dofs (const unsigned &t, DoubleVector &dofs)
	Set the history values of the dofs. More...

void	set_dofs (const unsigned &t, Vector< double * > &dof_pt)

void	add_to_dofs (const double &lambda, const DoubleVector &increment_dofs)
	Add lambda x incremenet_dofs[l] to the l-th dof. More...

double *	global_dof_pt (const unsigned &i)

double &	dof (const unsigned &i)
	i-th dof in the problem More...

double	dof (const unsigned &i) const
	i-th dof in the problem (const version) More...

double *&	dof_pt (const unsigned &i)
	Pointer to i-th dof in the problem. More...

double *	dof_pt (const unsigned &i) const
	Pointer to i-th dof in the problem (const version) More...

virtual void	get_inverse_mass_matrix_times_residuals (DoubleVector &Mres)

virtual void	get_dvaluesdt (DoubleVector &f)

virtual void	get_residuals (DoubleVector &residuals)
	Get the total residuals Vector for the problem. More...

virtual void	get_jacobian (DoubleVector &residuals, DenseDoubleMatrix &jacobian)

virtual void	get_jacobian (DoubleVector &residuals, CRDoubleMatrix &jacobian)

virtual void	get_jacobian (DoubleVector &residuals, CCDoubleMatrix &jacobian)

virtual void	get_jacobian (DoubleVector &residuals, SumOfMatrices &jacobian)

void	get_fd_jacobian (DoubleVector &residuals, DenseMatrix< double > &jacobian)
	Get the full Jacobian by finite differencing. More...

void	get_derivative_wrt_global_parameter (double *const &parameter_pt, DoubleVector &result)

void	get_hessian_vector_products (DoubleVectorWithHaloEntries const &Y, Vector< DoubleVectorWithHaloEntries > const &C, Vector< DoubleVectorWithHaloEntries > &product)

void	solve_eigenproblem (const unsigned &n_eval, Vector< std::complex< double >> &eigenvalue, Vector< DoubleVector > &eigenvector, const bool &steady=true)
	Solve the eigenproblem. More...

void	solve_eigenproblem (const unsigned &n_eval, Vector< std::complex< double >> &eigenvalue, const bool &steady=true)

virtual void	get_eigenproblem_matrices (CRDoubleMatrix &mass_matrix, CRDoubleMatrix &main_matrix, const double &shift=0.0)

void	assign_eigenvector_to_dofs (DoubleVector &eigenvector)
	Assign the eigenvector passed to the function to the dofs. More...

void	add_eigenvector_to_dofs (const double &epsilon, const DoubleVector &eigenvector)

void	store_current_dof_values ()
	Store the current values of the degrees of freedom. More...

void	restore_dof_values ()
	Restore the stored values of the degrees of freedom. More...

void	enable_jacobian_reuse ()

void	disable_jacobian_reuse ()
	Disable recycling of Jacobian in Newton iteration. More...

bool	jacobian_reuse_is_enabled ()
	Is recycling of Jacobian in Newton iteration enabled? More...

bool &	use_predictor_values_as_initial_guess ()

void	newton_solve ()
	Use Newton method to solve the problem. More...

void	enable_globally_convergent_newton_method ()
	enable globally convergent Newton method More...

void	disable_globally_convergent_newton_method ()
	disable globally convergent Newton method More...

void	newton_solve (unsigned const &max_adapt)

void	steady_newton_solve (unsigned const &max_adapt=0)

void	copy (Problem *orig_problem_pt)

virtual Problem *	make_copy ()

virtual void	read (std::ifstream &restart_file, bool &unsteady_restart)

virtual void	read (std::ifstream &restart_file)

virtual void	dump (std::ofstream &dump_file) const

void	dump (const std::string &dump_file_name) const

void	delete_all_external_storage ()

virtual void	symmetrise_eigenfunction_for_adaptive_pitchfork_tracking ()

double *	bifurcation_parameter_pt () const

void	get_bifurcation_eigenfunction (Vector< DoubleVector > &eigenfunction)

void	activate_fold_tracking (double *const &parameter_pt, const bool &block_solve=true)

void	activate_bifurcation_tracking (double *const &parameter_pt, const DoubleVector &eigenvector, const bool &block_solve=true)

void	activate_bifurcation_tracking (double *const &parameter_pt, const DoubleVector &eigenvector, const DoubleVector &normalisation, const bool &block_solve=true)

void	activate_pitchfork_tracking (double *const &parameter_pt, const DoubleVector &symmetry_vector, const bool &block_solve=true)

void	activate_hopf_tracking (double *const &parameter_pt, const bool &block_solve=true)

void	activate_hopf_tracking (double *const &parameter_pt, const double &omega, const DoubleVector &null_real, const DoubleVector &null_imag, const bool &block_solve=true)

void	deactivate_bifurcation_tracking ()

void	reset_assembly_handler_to_default ()
	Reset the system to the standard non-augemented state. More...

double	arc_length_step_solve (double *const &parameter_pt, const double &ds, const unsigned &max_adapt=0)

double	arc_length_step_solve (Data *const &data_pt, const unsigned &data_index, const double &ds, const unsigned &max_adapt=0)

void	reset_arc_length_parameters ()

int &	sign_of_jacobian ()

void	explicit_timestep (const double &dt, const bool &shift_values=true)
	Take an explicit timestep of size dt. More...

void	unsteady_newton_solve (const double &dt)

void	unsteady_newton_solve (const double &dt, const bool &shift_values)

void	unsteady_newton_solve (const double &dt, const unsigned &max_adapt, const bool &first, const bool &shift=true)

double	doubly_adaptive_unsteady_newton_solve (const double &dt, const double &epsilon, const unsigned &max_adapt, const bool &first, const bool &shift=true)

double	doubly_adaptive_unsteady_newton_solve (const double &dt, const double &epsilon, const unsigned &max_adapt, const unsigned &suppress_resolve_after_spatial_adapt_flag, const bool &first, const bool &shift=true)

double	adaptive_unsteady_newton_solve (const double &dt_desired, const double &epsilon)

double	adaptive_unsteady_newton_solve (const double &dt_desired, const double &epsilon, const bool &shift_values)

void	assign_initial_values_impulsive ()

void	assign_initial_values_impulsive (const double &dt)

void	calculate_predictions ()
	Calculate predictions. More...

void	enable_mass_matrix_reuse ()

void	disable_mass_matrix_reuse ()

bool	mass_matrix_reuse_is_enabled ()
	Return whether the mass matrix is being reused. More...

void	refine_uniformly (const Vector< unsigned > &nrefine_for_mesh)

void	refine_uniformly (const Vector< unsigned > &nrefine_for_mesh, DocInfo &doc_info)

void	refine_uniformly_and_prune (const Vector< unsigned > &nrefine_for_mesh)

void	refine_uniformly_and_prune (const Vector< unsigned > &nrefine_for_mesh, DocInfo &doc_info)

void	refine_uniformly (DocInfo &doc_info)

void	refine_uniformly_and_prune (DocInfo &doc_info)

void	refine_uniformly ()

void	refine_uniformly (const unsigned &i_mesh, DocInfo &doc_info)
	Do uniform refinement for submesh i_mesh with documentation. More...

void	refine_uniformly (const unsigned &i_mesh)
	Do uniform refinement for submesh i_mesh without documentation. More...

void	p_refine_uniformly (const Vector< unsigned > &nrefine_for_mesh)

void	p_refine_uniformly (const Vector< unsigned > &nrefine_for_mesh, DocInfo &doc_info)

void	p_refine_uniformly_and_prune (const Vector< unsigned > &nrefine_for_mesh)

void	p_refine_uniformly_and_prune (const Vector< unsigned > &nrefine_for_mesh, DocInfo &doc_info)

void	p_refine_uniformly (DocInfo &doc_info)

void	p_refine_uniformly_and_prune (DocInfo &doc_info)

void	p_refine_uniformly ()

void	p_refine_uniformly (const unsigned &i_mesh, DocInfo &doc_info)
	Do uniform p-refinement for submesh i_mesh with documentation. More...

void	p_refine_uniformly (const unsigned &i_mesh)
	Do uniform p-refinement for submesh i_mesh without documentation. More...

void	refine_selected_elements (const Vector< unsigned > &elements_to_be_refined)

void	refine_selected_elements (const Vector< RefineableElement * > &elements_to_be_refined_pt)

void	refine_selected_elements (const unsigned &i_mesh, const Vector< unsigned > &elements_to_be_refined)

void	refine_selected_elements (const unsigned &i_mesh, const Vector< RefineableElement * > &elements_to_be_refined_pt)

void	refine_selected_elements (const Vector< Vector< unsigned >> &elements_to_be_refined)

void	refine_selected_elements (const Vector< Vector< RefineableElement * >> &elements_to_be_refined_pt)

void	p_refine_selected_elements (const Vector< unsigned > &elements_to_be_refined)

void	p_refine_selected_elements (const Vector< PRefineableElement * > &elements_to_be_refined_pt)

void	p_refine_selected_elements (const unsigned &i_mesh, const Vector< unsigned > &elements_to_be_refined)

void	p_refine_selected_elements (const unsigned &i_mesh, const Vector< PRefineableElement * > &elements_to_be_refined_pt)

void	p_refine_selected_elements (const Vector< Vector< unsigned >> &elements_to_be_refined)

void	p_refine_selected_elements (const Vector< Vector< PRefineableElement * >> &elements_to_be_refined_pt)

unsigned	unrefine_uniformly ()

unsigned	unrefine_uniformly (const unsigned &i_mesh)

void	p_unrefine_uniformly (DocInfo &doc_info)

void	p_unrefine_uniformly (const unsigned &i_mesh, DocInfo &doc_info)
	Do uniform p-unrefinement for submesh i_mesh without documentation. More...

void	adapt (unsigned &n_refined, unsigned &n_unrefined)

void	adapt ()

void	p_adapt (unsigned &n_refined, unsigned &n_unrefined)

void	p_adapt ()

void	adapt_based_on_error_estimates (unsigned &n_refined, unsigned &n_unrefined, Vector< Vector< double >> &elemental_error)

void	adapt_based_on_error_estimates (Vector< Vector< double >> &elemental_error)

void	get_all_error_estimates (Vector< Vector< double >> &elemental_error)

void	doc_errors (DocInfo &doc_info)
	Get max and min error for all elements in submeshes. More...

void	doc_errors ()
	Get max and min error for all elements in submeshes. More...

void	enable_info_in_newton_solve ()

void	disable_info_in_newton_solve ()
	Disable the output of information when in the newton solver. More...

Public Member Functions inherited from oomph::ExplicitTimeSteppableObject
	ExplicitTimeSteppableObject ()
	Empty constructor. More...

	ExplicitTimeSteppableObject (const ExplicitTimeSteppableObject &)=delete
	Broken copy constructor. More...

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

virtual	~ExplicitTimeSteppableObject ()
	Empty destructor. More...

virtual void	actions_before_explicit_stage ()

virtual void	actions_after_explicit_stage ()

Private Attributes
ELEMENT *	Control_element_pt
	Pointer to control element. More...

ofstream	Trace_file
	Trace file. More...

BrethertonSpineMesh< ELEMENT, SpineLineFluidInterfaceElement< ELEMENT > > *	Bulk_mesh_pt
	Pointer to bulk mesh. More...

Additional Inherited Members
Public Types inherited from oomph::Problem
typedef void(*	SpatialErrorEstimatorFctPt) (Mesh *&mesh_pt, Vector< double > &elemental_error)
	Function pointer for spatial error estimator. More...

typedef void(*	SpatialErrorEstimatorWithDocFctPt) (Mesh *&mesh_pt, Vector< double > &elemental_error, DocInfo &doc_info)
	Function pointer for spatial error estimator with doc. More...

Public Attributes inherited from oomph::Problem
bool	Shut_up_in_newton_solve

Static Public Attributes inherited from oomph::Problem
static bool	Suppress_warning_about_actions_before_read_unstructured_meshes

Protected Types inherited from oomph::Problem
enum	Assembly_method { Perform_assembly_using_vectors_of_pairs , Perform_assembly_using_two_vectors , Perform_assembly_using_maps , Perform_assembly_using_lists , Perform_assembly_using_two_arrays }
	Enumerated flags to determine which sparse assembly method is used. More...

Protected Member Functions inherited from oomph::Problem
unsigned	setup_element_count_per_dof ()

virtual void	sparse_assemble_row_or_column_compressed (Vector< int * > &column_or_row_index, Vector< int * > &row_or_column_start, Vector< double * > &value, Vector< unsigned > &nnz, Vector< double * > &residual, bool compressed_row_flag)

virtual void	actions_before_newton_step ()

virtual void	actions_after_newton_step ()

virtual void	actions_before_implicit_timestep ()

virtual void	actions_after_implicit_timestep ()

virtual void	actions_after_implicit_timestep_and_error_estimation ()

virtual void	actions_before_explicit_timestep ()
	Actions that should be performed before each explicit time step. More...

virtual void	actions_after_explicit_timestep ()
	Actions that should be performed after each explicit time step. More...

virtual void	actions_before_read_unstructured_meshes ()

virtual void	actions_after_read_unstructured_meshes ()

virtual void	actions_after_change_in_global_parameter (double *const &parameter_pt)

virtual void	actions_after_change_in_bifurcation_parameter ()

virtual void	actions_after_parameter_increase (double *const &parameter_pt)

double &	dof_derivative (const unsigned &i)

double &	dof_current (const unsigned &i)

virtual void	set_initial_condition ()

virtual double	global_temporal_error_norm ()

unsigned	newton_solve_continuation (double *const &parameter_pt)

unsigned	newton_solve_continuation (double *const &parameter_pt, DoubleVector &z)

void	calculate_continuation_derivatives (double *const &parameter_pt)

void	calculate_continuation_derivatives (const DoubleVector &z)

void	calculate_continuation_derivatives_fd (double *const &parameter_pt)

bool	does_pointer_correspond_to_problem_data (double *const &parameter_pt)

void	set_consistent_pinned_values_for_continuation ()

Protected Attributes inherited from oomph::Problem
Vector< Problem * >	Copy_of_problem_pt

std::map< double *, bool >	Calculate_dparameter_analytic

bool	Calculate_hessian_products_analytic

LinearAlgebraDistribution *	Dof_distribution_pt

Vector< double * >	Dof_pt
	Vector of pointers to dofs. More...

DoubleVectorWithHaloEntries	Element_count_per_dof

double	Relaxation_factor

double	Newton_solver_tolerance

unsigned	Max_newton_iterations
	Maximum number of Newton iterations. More...

unsigned	Nnewton_iter_taken

Vector< double >	Max_res
	Maximum residuals at start and after each newton iteration. More...

double	Max_residuals

bool	Time_adaptive_newton_crash_on_solve_fail

bool	Jacobian_reuse_is_enabled
	Is re-use of Jacobian in Newton iteration enabled? Default: false. More...

bool	Jacobian_has_been_computed

bool	Problem_is_nonlinear

bool	Pause_at_end_of_sparse_assembly

bool	Doc_time_in_distribute

unsigned	Sparse_assembly_method

unsigned	Sparse_assemble_with_arrays_initial_allocation

unsigned	Sparse_assemble_with_arrays_allocation_increment

Vector< Vector< unsigned > >	Sparse_assemble_with_arrays_previous_allocation

double	Numerical_zero_for_sparse_assembly

double	FD_step_used_in_get_hessian_vector_products

bool	Mass_matrix_reuse_is_enabled

bool	Mass_matrix_has_been_computed

bool	Discontinuous_element_formulation

double	Minimum_dt
	Minimum desired dt: if dt falls below this value, exit. More...

double	Maximum_dt
	Maximum desired dt. More...

double	DTSF_max_increase

double	DTSF_min_decrease

double	Minimum_dt_but_still_proceed

bool	Scale_arc_length
	Boolean to control whether arc-length should be scaled. More...

double	Desired_proportion_of_arc_length
	Proportion of the arc-length to taken by the parameter. More...

double	Theta_squared

int	Sign_of_jacobian
	Storage for the sign of the global Jacobian. More...

double	Continuation_direction

double	Parameter_derivative
	Storage for the derivative of the global parameter wrt arc-length. More...

double	Parameter_current
	Storage for the present value of the global parameter. More...

bool	Use_continuation_timestepper
	Boolean to control original or new storage of dof stuff. More...

unsigned	Dof_derivative_offset

unsigned	Dof_current_offset

Vector< double >	Dof_derivative
	Storage for the derivative of the problem variables wrt arc-length. More...

Vector< double >	Dof_current
	Storage for the present values of the variables. More...

double	Ds_current
	Storage for the current step value. More...

unsigned	Desired_newton_iterations_ds

double	Minimum_ds
	Minimum desired value of arc-length. More...

bool	Bifurcation_detection
	Boolean to control bifurcation detection via determinant of Jacobian. More...

bool	Bisect_to_find_bifurcation
	Boolean to control wheter bisection is used to located bifurcation. More...

bool	First_jacobian_sign_change
	Boolean to indicate whether a sign change has occured in the Jacobian. More...

bool	Arc_length_step_taken
	Boolean to indicate whether an arc-length step has been taken. More...

bool	Use_finite_differences_for_continuation_derivatives

OomphCommunicator *	Communicator_pt
	The communicator for this problem. More...

bool	Always_take_one_newton_step

double	Timestep_reduction_factor_after_nonconvergence

bool	Keep_temporal_error_below_tolerance

Static Protected Attributes inherited from oomph::Problem
static ContinuationStorageScheme	Continuation_time_stepper
	Storage for the single static continuation timestorage object. More...

Detailed Description

template<class ELEMENT>
class BrethertonProblem< ELEMENT >

Bretherton problem.

////////////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////

Constructor & Destructor Documentation

◆ BrethertonProblem()

template<class ELEMENT >

BrethertonProblem< ELEMENT >::BrethertonProblem

Constructor:

Problem constructor.

 {
  
  // Number of elements in the deposited film region
  unsigned nx1=24;
  
  // Number of elements in the bottom part of the transition region
  unsigned nx2=6;
  
  // Number of elements in channel region
  unsigned nx3=12;
  
  // Number of elements in the vertical part of the transition region
  // (=half the number of elements in the liquid filled region ahead
  // of the finger tip)
  unsigned nhalf=4;
  
  // Number of elements through thickness of deposited film
  unsigned nh=3;
  
  // Thickness of deposited film
  double h=0.1;
  
  // Create wall geom objects
  GeomObject* lower_wall_pt=new StraightLine(-1.0);
  GeomObject* upper_wall_pt=new StraightLine( 1.0);
  
  // Start coordinate on wall
  double xi0=-4.0;
  
  // End of transition region on wall
  double xi1=1.5;
  
  // End of liquid filled region (inflow) on wall
  double xi2=5.0;
  
  //Now create the mesh
  Bulk_mesh_pt = new  BrethertonSpineMesh<ELEMENT,
   SpineLineFluidInterfaceElement<ELEMENT> > 
   (nx1,nx2,nx3,nh,nhalf,h,lower_wall_pt,upper_wall_pt,xi0,0.0,xi1,xi2);
  
  // Make bulk mesh the global mesh
  mesh_pt()=Bulk_mesh_pt;
  
  // Store the control element
  Control_element_pt=Bulk_mesh_pt->control_element_pt();
  
  
  // Set pointers to quantities that determine the inflow profile
  
  // Film thickness at outflow on lower wall:
  Global_Physical_Variables::H_lo_pt=
   Bulk_mesh_pt->spine_pt(0)->spine_height_pt()->value_pt(0);
  
  // Film thickness at outflow on upper wall:
  unsigned last_spine=Bulk_mesh_pt->nfree_surface_spines()-1;
  Global_Physical_Variables::H_up_pt=
   Bulk_mesh_pt->spine_pt(last_spine)->spine_height_pt()->value_pt(0);
  
  // Current y-position on lower wall at inflow
  unsigned ibound=1;
  Global_Physical_Variables::Y_lo_pt=
   Bulk_mesh_pt->boundary_node_pt(ibound,0)->x_pt(0,1);
  
  // Current y-position on upper wall at inflow
  unsigned nnod=Bulk_mesh_pt->nboundary_node(ibound);
  Global_Physical_Variables::Y_up_pt=
   Bulk_mesh_pt->boundary_node_pt(ibound,nnod-1)->x_pt(0,1);
  
  // Activate dependency of inflow on spine heights at outflow
  activate_inflow_dependency();
  
  // Set the boundary conditions for this problem: All nodes are
  // free by default -- just pin the ones that have Dirichlet conditions
  // here
  
  // No slip on boundaries 0 1 and 2
  for(unsigned ibound=0;ibound<=2;ibound++)
   {
    unsigned num_nod=mesh_pt()->nboundary_node(ibound);
    for (unsigned inod=0;inod<num_nod;inod++)
     {
      mesh_pt()->boundary_node_pt(ibound,inod)->pin(0);
      mesh_pt()->boundary_node_pt(ibound,inod)->pin(1);
     }
   }
  
  // Uniform, parallel outflow on boundaries 3 and 5
  for(unsigned ibound=3;ibound<=5;ibound+=2)
   {
    unsigned num_nod=mesh_pt()->nboundary_node(ibound);
    for (unsigned inod=0;inod<num_nod;inod++)
     {
      mesh_pt()->boundary_node_pt(ibound,inod)->pin(0);
      mesh_pt()->boundary_node_pt(ibound,inod)->pin(1);
     }
   }
  
  // Pin central spine
  unsigned central_spine=(Bulk_mesh_pt->nfree_surface_spines()-1)/2;
  Bulk_mesh_pt->spine_pt(central_spine)->spine_height_pt()->pin(0);
  
  
  // No slip in moving frame on boundaries 0 and 2
  for (unsigned ibound=0;ibound<=2;ibound+=2)
   {
    unsigned num_nod=mesh_pt()->nboundary_node(ibound);
    for (unsigned inod=0;inod<num_nod;inod++)
     {
      // Parallel flow
      mesh_pt()->boundary_node_pt(ibound,inod)->set_value(0,-1.0);
      mesh_pt()->boundary_node_pt(ibound,inod)->set_value(1, 0.0);
     }
   }
    
  
  // Parallel, uniform outflow on boundaries 3 and 5
  for (unsigned ibound=3;ibound<=5;ibound+=2)
   {
    unsigned num_nod=mesh_pt()->nboundary_node(ibound);
    for (unsigned inod=0;inod<num_nod;inod++)
     {
      // Parallel inflow
      mesh_pt()->boundary_node_pt(ibound,inod)->set_value(0,-1.0);
      mesh_pt()->boundary_node_pt(ibound,inod)->set_value(1, 0.0);
     }
   }
    
  
  
  //Complete the problem setup to make the elements fully functional
  
  //Loop over the elements in the layer
  unsigned n_bulk=Bulk_mesh_pt->nbulk();
  for(unsigned i=0;i<n_bulk;i++)
   {
    //Cast to a fluid element
    ELEMENT *el_pt = dynamic_cast<ELEMENT*>(Bulk_mesh_pt->
                                            bulk_element_pt(i));
    //Set the Reynolds number, etc
    el_pt->re_pt() = &Global_Physical_Variables::Re;
    el_pt->re_st_pt() = &Global_Physical_Variables::ReSt;
    el_pt->re_invfr_pt() = &Global_Physical_Variables::ReInvFr;
    el_pt->g_pt() = &Global_Physical_Variables::G;
   }
  
  //Loop over 1D interface elements and set capillary number
  unsigned interface_element_pt_range = Bulk_mesh_pt->ninterface_element();
  for(unsigned i=0;i<interface_element_pt_range;i++)
   {
    //Cast to a interface element
    SpineLineFluidInterfaceElement<ELEMENT>* el_pt = 
     dynamic_cast<SpineLineFluidInterfaceElement<ELEMENT>*>
     (Bulk_mesh_pt->interface_element_pt(i));
  
    //Set the Capillary number
    el_pt->ca_pt() = &Global_Physical_Variables::Ca;
   }
  
  //Update the nodal positions, so that the domain is correct
  //(and therefore the repeated node test passes)
  Bulk_mesh_pt->node_update();
  
  //Do equation numbering
  cout << "Number of unknowns: " << assign_eqn_numbers() << std::endl; 
  
 }

References Global_Physical_Variables::Ca, oomph::FluidInterfaceElement::ca_pt(), Global_Physical_Variables::G, Global_Physical_Variables::H_lo_pt, Global_Physical_Variables::H_up_pt, i, Global_Physical_Variables::Re, Global_Physical_Variables::ReInvFr, Global_Physical_Variables::ReSt, Global_Physical_Variables::Y_lo_pt, and Global_Physical_Variables::Y_up_pt.

Member Function Documentation

◆ actions_after_newton_solve()

template<class ELEMENT >

void BrethertonProblem< ELEMENT >::actions_after_newton_solve ( )

inlinevirtual

Update after solve can remain empty, because the update is performed automatically after every Newton step.

Reimplemented from oomph::Problem.

509 {}

◆ actions_before_newton_convergence_check()

template<class ELEMENT >

void BrethertonProblem< ELEMENT >::actions_before_newton_convergence_check ( )

inlinevirtual

Spine heights/lengths are unknowns in the problem so their values get corrected during each Newton step. However, changing their value does not automatically change the nodal positions, so we need to update all of them

Reimplemented from oomph::Problem.

   {
    // Update
    Bulk_mesh_pt->node_update();
  
    // Apply inflow on boundary 1
    unsigned ibound=1;
    unsigned num_nod=mesh_pt()->nboundary_node(ibound);
    
    // Coordinate and velocity
    Vector<double> x(2);
    Vector<double> veloc(2);
  
    // Loop over all nodes
    for (unsigned inod=0;inod<num_nod;inod++)
     {
      // Get nodal position
      x[0]=mesh_pt()->boundary_node_pt(ibound,inod)->x(0);
      x[1]=mesh_pt()->boundary_node_pt(ibound,inod)->x(1);
  
      // Get inflow profile
      Global_Physical_Variables::inflow(x,veloc);
      mesh_pt()->boundary_node_pt(ibound,inod)->set_value(0,veloc[0]);
      mesh_pt()->boundary_node_pt(ibound,inod)->set_value(1,veloc[1]);
     }
   }

References Global_Physical_Variables::inflow(), and plotDoE::x.

◆ actions_before_newton_solve()

template<class ELEMENT >

void BrethertonProblem< ELEMENT >::actions_before_newton_solve ( )

inlinevirtual

Update before solve: empty.

Reimplemented from oomph::Problem.

505 {}

◆ activate_inflow_dependency()

template<class ELEMENT >

void BrethertonProblem< ELEMENT >::activate_inflow_dependency

Activate the dependency of the inflow velocity on the spine heights at the outflow

Loop over elements on inflow boundary (1)

 {
  
  // Spine heights that affect the inflow
  Vector<Data*> outflow_spines(2);
  
  // First spine
  outflow_spines[0]=Bulk_mesh_pt->spine_pt(0)->spine_height_pt();
  
  // Last proper spine
  unsigned last_spine=Bulk_mesh_pt->nfree_surface_spines()-1;
  outflow_spines[1]=Bulk_mesh_pt->spine_pt(last_spine)->spine_height_pt();;
  
  
  
  unsigned ibound=1;
  unsigned nel=Bulk_mesh_pt->nboundary_element(ibound);
  for (unsigned e=0;e<nel;e++)
   {
    // Get pointer to element
    ELEMENT* el_pt=dynamic_cast<ELEMENT*>(Bulk_mesh_pt->
                                          boundary_element_pt(ibound,e));  
    // Activate depency on inflow
    el_pt->activate_inflow_dependency_on_external_data(
     outflow_spines,ibound,&Global_Physical_Variables::inflow);
   }
  
 }

References e(), and Global_Physical_Variables::inflow().

◆ doc_solution()

template<class ELEMENT >

void BrethertonProblem< ELEMENT >::doc_solution ( DocInfo & doc_info )

Doc the solution.

 { 
  
  ofstream some_file;
  char filename[100];
  
  // Number of plot points
  unsigned npts=5; 
  
  // Control coordinate: At bubble tip
  Vector<double> s(2);
  s[0]=1.0;
  s[1]=1.0;
  
  // Last proper spine
  unsigned last_spine=Bulk_mesh_pt->nfree_surface_spines()-1;
  
  // Doc
  Trace_file << " " << Global_Physical_Variables::Ca;
  Trace_file << " " << Bulk_mesh_pt->spine_pt(0)->height();
  Trace_file << " " << Bulk_mesh_pt->spine_pt(last_spine)->height();
  Trace_file << " " << 1.3375*pow(Global_Physical_Variables::Ca,2.0/3.0);
  Trace_file << " " << -Control_element_pt->interpolated_p_nst(s)*
                       Global_Physical_Variables::Ca;
  Trace_file << " " << 1.0+3.8*pow(Global_Physical_Variables::Ca,2.0/3.0);
  Trace_file << " " << Control_element_pt->interpolated_u_nst(s,0);
  Trace_file << " " << Control_element_pt->interpolated_u_nst(s,1);
  Trace_file << std::endl;
  
  
  // Output solution 
  sprintf(filename,"%s/soln%i.dat",doc_info.directory().c_str(),
          doc_info.number());
  some_file.open(filename);
  Bulk_mesh_pt->output(some_file,npts);
  some_file.close();
  
  
  // Output boundaries
  sprintf(filename,"%s/boundaries%i.dat",doc_info.directory().c_str(),
          doc_info.number());
  some_file.open(filename);
  Bulk_mesh_pt->output_boundaries(some_file);
  some_file.close();
  
 }

References Global_Physical_Variables::Ca, oomph::DocInfo::directory(), MergeRestartFiles::filename, oomph::DocInfo::number(), Eigen::bfloat16_impl::pow(), s, and oomph::Problem_Parameter::Trace_file.

◆ fix_pressure()

template<class ELEMENT >

void BrethertonProblem< ELEMENT >::fix_pressure	(	const unsigned &	e,
		const unsigned &	l,
		const double &	pvalue
	)

inline

Fix pressure value l in element e to value p_value.

   {
    //Fix the pressure at that element
    dynamic_cast<ELEMENT *>(Bulk_mesh_pt->element_pt(e))->
     fix_pressure(l,pvalue);
   }

References e().

◆ parameter_study()

template<class ELEMENT >

void BrethertonProblem< ELEMENT >::parameter_study ( const unsigned & nsteps )

Run a parameter study; perform specified number of steps.

Parameter study.

 {
  
  // Increase maximum residual
  Problem::Max_residuals=100.0;
  
  // Set output directory
  DocInfo doc_info;
  doc_info.set_directory("RESLT");
  doc_info.number()=0;
  
  
  // Open trace file
  char filename[100];   
  sprintf(filename,"%s/trace.dat",doc_info.directory().c_str());
  Trace_file.open(filename);
  
  Trace_file << "VARIABLES=\"Ca\",";
  Trace_file << "\"h<sub>bottom</sub>\",\"h<sub>too</sub>\",";
  Trace_file << "\"h<sub>Bretherton</sub>\",\"p<sub>tip</sub>\",";
  Trace_file << "\"p<sub>tip (Bretherton)</sub>\",\"u<sub>stag</sub>\",";
  Trace_file << "\"v<sub>stag</sub>\"";
  Trace_file << "\"<greek>a</greek><sub>bottom</sub>\",";
  Trace_file << "\"<greek>a</greek><sub>top</sub>\"";
  Trace_file << std::endl;
  
  // Initial scaling factor for Ca reduction
  double factor=2.0;
  
  //Doc initial solution
  doc_solution(doc_info);
  
 //Loop over the steps
  for (unsigned step=1;step<=nsteps;step++)
   {
    cout << std::endl << "STEP " << step << std::endl;
  
    // Newton method tends to converge is initial stays bounded below
    // a certain tolerance: This is cheaper to check than restarting
    // the Newton method after divergence (we'd also need to back up
    // the previous solution)
    double maxres=100.0;
    while (true)
     {
      cout << "Checking max. res for Ca = " 
           << Global_Physical_Variables::Ca << ".   Max. residual: ";
  
      // Check the maximum residual
      DoubleVector residuals;
      actions_before_newton_solve();
      actions_before_newton_convergence_check();
      get_residuals(residuals);
      double max_res=residuals.max();
      cout << max_res;
  
      // Check what to do 
      if (max_res>maxres)
       {
        cout << ". Too big!" << std::endl;
        // Reset the capillary number
        Global_Physical_Variables::Ca *= factor;       
        // Reduce the factor
        factor=1.0+(factor-1.0)/1.5;
        cout << "New reduction factor: " << factor << std::endl;
        // Reduce the capillary number
        Global_Physical_Variables::Ca /= factor;
        // Try again
        continue;
       }
      // Looks promising: Let's proceed to solve
      else
       {
        cout << ". OK" << std::endl << std::endl;
        // Break out of the Ca adjustment loop
        break;
       }
     }
  
    //Solve
    cout << "Solving for capillary number: " 
         << Global_Physical_Variables::Ca << std::endl;
    newton_solve();
  
    // Doc solution
    doc_info.number()++;
    doc_solution(doc_info);
    
    // Reduce the capillary number
    Global_Physical_Variables::Ca /= factor;
   }
  
 }

References Global_Physical_Variables::Ca, oomph::DocInfo::directory(), MergeRestartFiles::filename, GlobalFct::get_residuals(), oomph::DoubleVector::max(), oomph::DocInfo::number(), oomph::DocInfo::set_directory(), and oomph::Problem_Parameter::Trace_file.

Member Data Documentation

◆ Bulk_mesh_pt

template<class ELEMENT >

BrethertonSpineMesh<ELEMENT,SpineLineFluidInterfaceElement<ELEMENT> >* BrethertonProblem< ELEMENT >::Bulk_mesh_pt

private

Pointer to bulk mesh.

◆ Control_element_pt

template<class ELEMENT >

ELEMENT* BrethertonProblem< ELEMENT >::Control_element_pt

private

Pointer to control element.

◆ Trace_file

template<class ELEMENT >

ofstream BrethertonProblem< ELEMENT >::Trace_file

private

Trace file.

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

bretherton.cc

Public Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

template<class ELEMENT> class BrethertonProblem< ELEMENT >

Constructor & Destructor Documentation

◆ BrethertonProblem()

Member Function Documentation

◆ actions_after_newton_solve()

◆ actions_before_newton_convergence_check()

◆ actions_before_newton_solve()

◆ activate_inflow_dependency()

◆ doc_solution()

◆ fix_pressure()

◆ parameter_study()

Member Data Documentation

◆ Bulk_mesh_pt

◆ Control_element_pt

◆ Trace_file

template<class ELEMENT>
class BrethertonProblem< ELEMENT >