Base class for unsteady solvers. More...

#include <UnsteadySystem.h>

Inheritance diagram for Nektar::SolverUtils::UnsteadySystem:

Public Member Functions
virtual SOLVER_UTILS_EXPORT	~UnsteadySystem ()
	Destructor. More...

SOLVER_UTILS_EXPORT NekDouble	GetTimeStep (const Array< OneD, const Array< OneD, NekDouble >> &inarray)
	Calculate the larger time-step mantaining the problem stable. More...

Public Member Functions inherited from Nektar::SolverUtils::EquationSystem
virtual SOLVER_UTILS_EXPORT	~EquationSystem ()
	Destructor. More...

SOLVER_UTILS_EXPORT void	SetUpTraceNormals (void)

SOLVER_UTILS_EXPORT void	InitObject ()
	Initialises the members of this object. More...

SOLVER_UTILS_EXPORT void	DoInitialise ()
	Perform any initialisation necessary before solving the problem. More...

SOLVER_UTILS_EXPORT void	DoSolve ()
	Solve the problem. More...

SOLVER_UTILS_EXPORT void	TransCoeffToPhys ()
	Transform from coefficient to physical space. More...

SOLVER_UTILS_EXPORT void	TransPhysToCoeff ()
	Transform from physical to coefficient space. More...

SOLVER_UTILS_EXPORT void	Output ()
	Perform output operations after solve. More...

SOLVER_UTILS_EXPORT NekDouble	LinfError (unsigned int field, const Array< OneD, NekDouble > &exactsoln=NullNekDouble1DArray)
	Linf error computation. More...

SOLVER_UTILS_EXPORT std::string	GetSessionName ()
	Get Session name. More...

template<class T >
std::shared_ptr< T >	as ()

SOLVER_UTILS_EXPORT void	ResetSessionName (std::string newname)
	Reset Session name. More...

SOLVER_UTILS_EXPORT LibUtilities::SessionReaderSharedPtr	GetSession ()
	Get Session name. More...

SOLVER_UTILS_EXPORT MultiRegions::ExpListSharedPtr	GetPressure ()
	Get pressure field if available. More...

SOLVER_UTILS_EXPORT void	ExtraFldOutput (std::vector< Array< OneD, NekDouble > > &fieldcoeffs, std::vector< std::string > &variables)

SOLVER_UTILS_EXPORT void	PrintSummary (std::ostream &out)
	Print a summary of parameters and solver characteristics. More...

SOLVER_UTILS_EXPORT void	SetLambda (NekDouble lambda)
	Set parameter m_lambda. More...

SOLVER_UTILS_EXPORT SessionFunctionSharedPtr	GetFunction (std::string name, const MultiRegions::ExpListSharedPtr &field=MultiRegions::NullExpListSharedPtr, bool cache=false)
	Get a SessionFunction by name. More...

SOLVER_UTILS_EXPORT void	SetInitialConditions (NekDouble initialtime=0.0, bool dumpInitialConditions=true, const int domain=0)
	Initialise the data in the dependent fields. More...

SOLVER_UTILS_EXPORT void	EvaluateExactSolution (int field, Array< OneD, NekDouble > &outfield, const NekDouble time)
	Evaluates an exact solution. More...

SOLVER_UTILS_EXPORT NekDouble	L2Error (unsigned int field, const Array< OneD, NekDouble > &exactsoln, bool Normalised=false)
	Compute the L2 error between fields and a given exact solution. More...

SOLVER_UTILS_EXPORT NekDouble	L2Error (unsigned int field, bool Normalised=false)
	Compute the L2 error of the fields. More...

SOLVER_UTILS_EXPORT Array< OneD, NekDouble >	ErrorExtraPoints (unsigned int field)
	Compute error (L2 and L_inf) over an larger set of quadrature points return [L2 Linf]. More...

SOLVER_UTILS_EXPORT void	Checkpoint_Output (const int n)
	Write checkpoint file of m_fields. More...

SOLVER_UTILS_EXPORT void	Checkpoint_Output (const int n, MultiRegions::ExpListSharedPtr &field, std::vector< Array< OneD, NekDouble > > &fieldcoeffs, std::vector< std::string > &variables)
	Write checkpoint file of custom data fields. More...

SOLVER_UTILS_EXPORT void	Checkpoint_BaseFlow (const int n)
	Write base flow file of m_fields. More...

SOLVER_UTILS_EXPORT void	WriteFld (const std::string &outname)
	Write field data to the given filename. More...

SOLVER_UTILS_EXPORT void	WriteFld (const std::string &outname, MultiRegions::ExpListSharedPtr &field, std::vector< Array< OneD, NekDouble > > &fieldcoeffs, std::vector< std::string > &variables)
	Write input fields to the given filename. More...

SOLVER_UTILS_EXPORT void	ImportFld (const std::string &infile, Array< OneD, MultiRegions::ExpListSharedPtr > &pFields)
	Input field data from the given file. More...

SOLVER_UTILS_EXPORT void	ImportFldToMultiDomains (const std::string &infile, Array< OneD, MultiRegions::ExpListSharedPtr > &pFields, const int ndomains)
	Input field data from the given file to multiple domains. More...

SOLVER_UTILS_EXPORT void	ImportFld (const std::string &infile, std::vector< std::string > &fieldStr, Array< OneD, Array< OneD, NekDouble > > &coeffs)
	Output a field. Input field data into array from the given file. More...

SOLVER_UTILS_EXPORT void	ImportFld (const std::string &infile, MultiRegions::ExpListSharedPtr &pField, std::string &pFieldName)
	Output a field. Input field data into ExpList from the given file. More...

SOLVER_UTILS_EXPORT void	SessionSummary (SummaryList &vSummary)
	Write out a session summary. More...

SOLVER_UTILS_EXPORT Array< OneD, MultiRegions::ExpListSharedPtr > &	UpdateFields ()

SOLVER_UTILS_EXPORT LibUtilities::FieldMetaDataMap &	UpdateFieldMetaDataMap ()
	Get hold of FieldInfoMap so it can be updated. More...

SOLVER_UTILS_EXPORT NekDouble	GetFinalTime ()
	Return final time. More...

SOLVER_UTILS_EXPORT int	GetNcoeffs ()

SOLVER_UTILS_EXPORT int	GetNcoeffs (const int eid)

SOLVER_UTILS_EXPORT int	GetNumExpModes ()

SOLVER_UTILS_EXPORT const Array< OneD, int >	GetNumExpModesPerExp ()

SOLVER_UTILS_EXPORT int	GetNvariables ()

SOLVER_UTILS_EXPORT const std::string	GetVariable (unsigned int i)

SOLVER_UTILS_EXPORT int	GetTraceTotPoints ()

SOLVER_UTILS_EXPORT int	GetTraceNpoints ()

SOLVER_UTILS_EXPORT int	GetExpSize ()

SOLVER_UTILS_EXPORT int	GetPhys_Offset (int n)

SOLVER_UTILS_EXPORT int	GetCoeff_Offset (int n)

SOLVER_UTILS_EXPORT int	GetTotPoints ()

SOLVER_UTILS_EXPORT int	GetTotPoints (int n)

SOLVER_UTILS_EXPORT int	GetNpoints ()

SOLVER_UTILS_EXPORT int	GetSteps ()

SOLVER_UTILS_EXPORT NekDouble	GetTimeStep ()

SOLVER_UTILS_EXPORT void	CopyFromPhysField (const int i, Array< OneD, NekDouble > &output)

SOLVER_UTILS_EXPORT void	CopyToPhysField (const int i, Array< OneD, NekDouble > &output)

SOLVER_UTILS_EXPORT void	SetSteps (const int steps)

SOLVER_UTILS_EXPORT void	ZeroPhysFields ()

SOLVER_UTILS_EXPORT void	FwdTransFields ()

SOLVER_UTILS_EXPORT void	SetModifiedBasis (const bool modbasis)

SOLVER_UTILS_EXPORT int	GetCheckpointNumber ()

SOLVER_UTILS_EXPORT void	SetCheckpointNumber (int num)

SOLVER_UTILS_EXPORT int	GetCheckpointSteps ()

SOLVER_UTILS_EXPORT void	SetCheckpointSteps (int num)

SOLVER_UTILS_EXPORT void	SetTime (const NekDouble time)

SOLVER_UTILS_EXPORT void	SetInitialStep (const int step)

SOLVER_UTILS_EXPORT void	SetBoundaryConditions (NekDouble time)
	Evaluates the boundary conditions at the given time. More...

virtual SOLVER_UTILS_EXPORT bool	v_NegatedOp ()
	Virtual function to identify if operator is negated in DoSolve. More...

Public Attributes
NekDouble	m_cflSafetyFactor
	CFL safety factor (comprise between 0 to 1). More...

Protected Member Functions
SOLVER_UTILS_EXPORT	UnsteadySystem (const LibUtilities::SessionReaderSharedPtr &pSession, const SpatialDomains::MeshGraphSharedPtr &pGraph)
	Initialises UnsteadySystem class members. More...

virtual SOLVER_UTILS_EXPORT void	v_InitObject ()
	Init object for UnsteadySystem class. More...

SOLVER_UTILS_EXPORT NekDouble	MaxTimeStepEstimator ()
	Get the maximum timestep estimator for cfl control. More...

virtual SOLVER_UTILS_EXPORT void	v_DoSolve ()
	Solves an unsteady problem. More...

virtual SOLVER_UTILS_EXPORT void	v_DoInitialise ()
	Sets up initial conditions. More...

virtual SOLVER_UTILS_EXPORT void	v_GenerateSummary (SummaryList &s)
	Print a summary of time stepping parameters. More...

virtual SOLVER_UTILS_EXPORT void	v_AppendOutput1D (Array< OneD, Array< OneD, NekDouble >> &solution1D)
	Print the solution at each solution point in a txt file. More...

virtual SOLVER_UTILS_EXPORT NekDouble	v_GetTimeStep (const Array< OneD, const Array< OneD, NekDouble >> &inarray)
	Return the timestep to be used for the next step in the time-marching loop. More...

virtual SOLVER_UTILS_EXPORT bool	v_PreIntegrate (int step)

virtual SOLVER_UTILS_EXPORT bool	v_PostIntegrate (int step)

virtual SOLVER_UTILS_EXPORT bool	v_RequireFwdTrans ()

SOLVER_UTILS_EXPORT void	CheckForRestartTime (NekDouble &time, int &nchk)

SOLVER_UTILS_EXPORT void	SVVVarDiffCoeff (const Array< OneD, Array< OneD, NekDouble >> vel, StdRegions::VarCoeffMap &varCoeffMap)
	Evaluate the SVV diffusion coefficient according to Moura's paper where it should proportional to h time velocity. More...

Protected Member Functions inherited from Nektar::SolverUtils::EquationSystem
SOLVER_UTILS_EXPORT	EquationSystem (const LibUtilities::SessionReaderSharedPtr &pSession, const SpatialDomains::MeshGraphSharedPtr &pGraph)
	Initialises EquationSystem class members. More...

virtual SOLVER_UTILS_EXPORT NekDouble	v_LinfError (unsigned int field, const Array< OneD, NekDouble > &exactsoln=NullNekDouble1DArray)
	Virtual function for the L_inf error computation between fields and a given exact solution. More...

virtual SOLVER_UTILS_EXPORT NekDouble	v_L2Error (unsigned int field, const Array< OneD, NekDouble > &exactsoln=NullNekDouble1DArray, bool Normalised=false)
	Virtual function for the L_2 error computation between fields and a given exact solution. More...

virtual SOLVER_UTILS_EXPORT void	v_TransCoeffToPhys ()
	Virtual function for transformation to physical space. More...

virtual SOLVER_UTILS_EXPORT void	v_TransPhysToCoeff ()
	Virtual function for transformation to coefficient space. More...

virtual SOLVER_UTILS_EXPORT void	v_SetInitialConditions (NekDouble initialtime=0.0, bool dumpInitialConditions=true, const int domain=0)

virtual SOLVER_UTILS_EXPORT void	v_EvaluateExactSolution (unsigned int field, Array< OneD, NekDouble > &outfield, const NekDouble time)

virtual SOLVER_UTILS_EXPORT void	v_Output (void)

virtual SOLVER_UTILS_EXPORT MultiRegions::ExpListSharedPtr	v_GetPressure (void)

virtual SOLVER_UTILS_EXPORT void	v_ExtraFldOutput (std::vector< Array< OneD, NekDouble > > &fieldcoeffs, std::vector< std::string > &variables)

Protected Attributes
int	m_infosteps
	Number of time steps between outputting status information. More...

int	m_abortSteps
	Number of steps between checks for abort conditions. More...

int	m_filtersInfosteps
	Number of time steps between outputting filters information. More...

int	m_nanSteps

LibUtilities::TimeIntegrationWrapperSharedPtr	m_intScheme
	Wrapper to the time integration scheme. More...

LibUtilities::TimeIntegrationSchemeOperators	m_ode
	The time integration scheme operators to use. More...

LibUtilities::TimeIntegrationSolutionSharedPtr	m_intSoln

NekDouble	m_epsilon

bool	m_explicitDiffusion
	Indicates if explicit or implicit treatment of diffusion is used. More...

bool	m_explicitAdvection
	Indicates if explicit or implicit treatment of advection is used. More...

bool	m_explicitReaction
	Indicates if explicit or implicit treatment of reaction is used. More...

bool	m_homoInitialFwd
	Flag to determine if simulation should start in homogeneous forward transformed state. More...

NekDouble	m_steadyStateTol
	Tolerance to which steady state should be evaluated at. More...

int	m_steadyStateSteps
	Check for steady state at step interval. More...

Array< OneD, Array< OneD, NekDouble > >	m_previousSolution
	Storage for previous solution for steady-state check. More...

std::ofstream	m_errFile

std::vector< int >	m_intVariables

std::vector< std::pair< std::string, FilterSharedPtr > >	m_filters

NekDouble	m_filterTimeWarning
	Number of time steps between outputting status information. More...

Protected Attributes inherited from Nektar::SolverUtils::EquationSystem
LibUtilities::CommSharedPtr	m_comm
	Communicator. More...

LibUtilities::SessionReaderSharedPtr	m_session
	The session reader. More...

std::map< std::string, SolverUtils::SessionFunctionSharedPtr >	m_sessionFunctions
	Map of known SessionFunctions. More...

LibUtilities::FieldIOSharedPtr	m_fld
	Field input/output. More...

Array< OneD, MultiRegions::ExpListSharedPtr >	m_fields
	Array holding all dependent variables. More...

SpatialDomains::BoundaryConditionsSharedPtr	m_boundaryConditions
	Pointer to boundary conditions object. More...

SpatialDomains::MeshGraphSharedPtr	m_graph
	Pointer to graph defining mesh. More...

std::string	m_sessionName
	Name of the session. More...

NekDouble	m_time
	Current time of simulation. More...

int	m_initialStep
	Number of the step where the simulation should begin. More...

NekDouble	m_fintime
	Finish time of the simulation. More...

NekDouble	m_timestep
	Time step size. More...

NekDouble	m_lambda
	Lambda constant in real system if one required. More...

NekDouble	m_checktime
	Time between checkpoints. More...

int	m_nchk
	Number of checkpoints written so far. More...

int	m_steps
	Number of steps to take. More...

int	m_checksteps
	Number of steps between checkpoints. More...

int	m_spacedim
	Spatial dimension (>= expansion dim). More...

int	m_expdim
	Expansion dimension. More...

bool	m_singleMode
	Flag to determine if single homogeneous mode is used. More...

bool	m_halfMode
	Flag to determine if half homogeneous mode is used. More...

bool	m_multipleModes
	Flag to determine if use multiple homogenenous modes are used. More...

bool	m_useFFT
	Flag to determine if FFT is used for homogeneous transform. More...

bool	m_homogen_dealiasing
	Flag to determine if dealiasing is used for homogeneous simulations. More...

bool	m_specHP_dealiasing
	Flag to determine if dealisising is usde for the Spectral/hp element discretisation. More...

enum MultiRegions::ProjectionType	m_projectionType
	Type of projection; e.g continuous or discontinuous. More...

Array< OneD, Array< OneD, NekDouble > >	m_traceNormals
	Array holding trace normals for DG simulations in the forwards direction. More...

Array< OneD, bool >	m_checkIfSystemSingular
	Flag to indicate if the fields should be checked for singularity. More...

LibUtilities::FieldMetaDataMap	m_fieldMetaDataMap
	Map to identify relevant solver info to dump in output fields. More...

int	m_NumQuadPointsError
	Number of Quadrature points used to work out the error. More...

enum HomogeneousType	m_HomogeneousType

NekDouble	m_LhomX
	physical length in X direction (if homogeneous) More...

NekDouble	m_LhomY
	physical length in Y direction (if homogeneous) More...

NekDouble	m_LhomZ
	physical length in Z direction (if homogeneous) More...

int	m_npointsX
	number of points in X direction (if homogeneous) More...

int	m_npointsY
	number of points in Y direction (if homogeneous) More...

int	m_npointsZ
	number of points in Z direction (if homogeneous) More...

int	m_HomoDirec
	number of homogenous directions More...

Private Member Functions
void	InitializeSteadyState ()

bool	CheckSteadyState (int step)
	Calculate whether the system has reached a steady state by observing residuals to a user-defined tolerance. More...

Additional Inherited Members
Protected Types inherited from Nektar::SolverUtils::EquationSystem
enum	HomogeneousType { eHomogeneous1D, eHomogeneous2D, eHomogeneous3D, eNotHomogeneous }
	Parameter for homogeneous expansions. More...

Static Protected Attributes inherited from Nektar::SolverUtils::EquationSystem
static std::string	equationSystemTypeLookupIds []

Detailed Description

Base class for unsteady solvers.

Provides the underlying timestepping framework for unsteady solvers including the general timestepping routines. This class is not intended to be directly instantiated, but rather is a base class on which to define unsteady solvers.

For details on implementing unsteady solvers see sectionADRSolverModuleImplementation here

Definition at line 47 of file UnsteadySystem.h.

Constructor & Destructor Documentation

◆ ~UnsteadySystem()

Nektar::SolverUtils::UnsteadySystem::~UnsteadySystem ( )

virtual

Destructor.

Destructor for the class UnsteadyAdvection.

Definition at line 153 of file UnsteadySystem.cpp.

154 {

155 }

◆ UnsteadySystem()

Nektar::SolverUtils::UnsteadySystem::UnsteadySystem	(	const LibUtilities::SessionReaderSharedPtr &	pSession,
		const SpatialDomains::MeshGraphSharedPtr &	pGraph
	)

protected

Initialises UnsteadySystem class members.

Processes SolverInfo parameters from the session file and sets up timestepping-specific code.

Parameters

pSession Session object to read parameters from.

Definition at line 68 of file UnsteadySystem.cpp.

             : EquationSystem(pSession, pGraph),
               m_infosteps(10)
 
         {
         }

Member Function Documentation

◆ CheckForRestartTime()

void Nektar::SolverUtils::UnsteadySystem::CheckForRestartTime	(	NekDouble &	time,
		int &	nchk
	)

protected

Definition at line 604 of file UnsteadySystem.cpp.

References Nektar::LibUtilities::FieldIO::CreateForFile(), Nektar::LibUtilities::eFunctionTypeFile, Nektar::SolverUtils::EquationSystem::m_fieldMetaDataMap, Nektar::SolverUtils::EquationSystem::m_fields, Nektar::SolverUtils::EquationSystem::m_session, Nektar::LibUtilities::NullFieldMetaDataMap, and Nektar::LibUtilities::PortablePath().

Referenced by v_DoInitialise(), and v_RequireFwdTrans().

         {
             if (m_session->DefinesFunction("InitialConditions"))
             {
                 for (int i = 0; i < m_fields.num_elements(); ++i)
                 {
                     LibUtilities::FunctionType vType;
 
                     vType = m_session->GetFunctionType(
                         "InitialConditions", m_session->GetVariable(i));
 
                     if (vType == LibUtilities::eFunctionTypeFile)
                     {
                         std::string filename
                             = m_session->GetFunctionFilename(
                                 "InitialConditions", m_session->GetVariable(i));
 
                         fs::path pfilename(filename);
 
                         // redefine path for parallel file which is in directory
                         if(fs::is_directory(pfilename))
                         {
                             fs::path metafile("Info.xml");
                             fs::path fullpath = pfilename / metafile;
                             filename = LibUtilities::PortablePath(fullpath);
                         }
                         LibUtilities::FieldIOSharedPtr fld =
                             LibUtilities::FieldIO::CreateForFile(
                                 m_session, filename);
                         fld->ImportFieldMetaData(filename, m_fieldMetaDataMap);
 
                         // check to see if time defined
                         if (m_fieldMetaDataMap !=
                                 LibUtilities::NullFieldMetaDataMap)
                         {
                             auto iter = m_fieldMetaDataMap.find("Time");
                             if (iter != m_fieldMetaDataMap.end())
                             {
                                 time = boost::lexical_cast<NekDouble>(
                                     iter->second);
                             }
 
                             iter = m_fieldMetaDataMap.find("ChkFileNum");
                             if (iter != m_fieldMetaDataMap.end())
                             {
                                 nchk = boost::lexical_cast<NekDouble>(
                                     iter->second);
                             }
                         }
                         
                         break;
                     }
                 }
             }
         }

◆ CheckSteadyState()

bool Nektar::SolverUtils::UnsteadySystem::CheckSteadyState ( int step )

private

Calculate whether the system has reached a steady state by observing residuals to a user-defined tolerance.

Definition at line 777 of file UnsteadySystem.cpp.

References CellMLToNektar.pycml::format, Nektar::SolverUtils::EquationSystem::GetTotPoints(), Nektar::SolverUtils::EquationSystem::m_comm, m_errFile, Nektar::SolverUtils::EquationSystem::m_fields, m_infosteps, m_previousSolution, Nektar::SolverUtils::EquationSystem::m_session, m_steadyStateTol, Nektar::SolverUtils::EquationSystem::m_time, Nektar::LibUtilities::ReduceSum, Vmath::Vcopy(), Vmath::Vmax(), Vmath::Vmul(), Vmath::Vsub(), and Vmath::Vsum().

Referenced by v_DoSolve(), and v_RequireFwdTrans().

         {
             const int nPoints = GetTotPoints();
             const int nFields = m_fields.num_elements();
 
             // Holds L2 errors.
             Array<OneD, NekDouble> L2       (nFields);
             Array<OneD, NekDouble> residual (nFields);
             Array<OneD, NekDouble> reference(nFields);
 
             for (int i = 0; i < nFields; ++i)
             {
                 Array<OneD, NekDouble> tmp(nPoints);
 
                 Vmath::Vsub(nPoints, m_fields[i]->GetPhys(), 1,
                                      m_previousSolution[i], 1, tmp, 1);
                 Vmath::Vmul(nPoints, tmp, 1, tmp, 1, tmp, 1);
                 residual[i] = Vmath::Vsum(nPoints, tmp, 1);
 
                 Vmath::Vmul(nPoints, m_previousSolution[i], 1,
                                      m_previousSolution[i], 1, tmp, 1);
                 reference[i] = Vmath::Vsum(nPoints, tmp, 1);
             }
 
             m_comm->AllReduce(residual , LibUtilities::ReduceSum);
             m_comm->AllReduce(reference, LibUtilities::ReduceSum);
 
             // L2 error
             for (int i = 0; i < nFields; ++i)
             {
                 reference[i] = (reference[i] == 0) ? 1 : reference[i];
                 L2[i] = sqrt(residual[i] / reference[i]);
             }
 
             if (m_comm->GetRank() == 0 && ((step+1) % m_infosteps == 0))
             {
                 // Output time
                 m_errFile << boost::format("%25.19e") % m_time;
 
                 // Output residuals
                 for (int i = 0; i < nFields; ++i)
                 {
                     m_errFile << " " << boost::format("%25.19e") % L2[i];
                 }
 
                 m_errFile << endl;
             }
 
             // Calculate maximum L2 error
             NekDouble maxL2 = Vmath::Vmax(nFields, L2, 1);
 
             if (m_session->DefinesCmdLineArgument("verbose") &&
                 m_comm->GetRank() == 0 && ((step+1) % m_infosteps == 0))
             {
                 cout << "-- Maximum L^2 residual: " << maxL2 << endl;
             }
 
             if (maxL2 <= m_steadyStateTol)
             {
                 return true;
             }
 
             for (int i = 0; i < m_fields.num_elements(); ++i)
             {
                 Vmath::Vcopy(nPoints, m_fields[i]->GetPhys(), 1,
                                       m_previousSolution[i], 1);
             }
 
             return false;
         }

◆ GetTimeStep()

NekDouble Nektar::SolverUtils::UnsteadySystem::GetTimeStep ( const Array< OneD, const Array< OneD, NekDouble >> & inarray )

Calculate the larger time-step mantaining the problem stable.

Return the timestep to be used for the next step in the time-marching loop.

This function can be overloaded to facilitate solver which utilise a CFL (or other) parameter to determine a maximum timestep under which the problem remains stable.

Definition at line 668 of file UnsteadySystem.cpp.

References v_GetTimeStep().

         {
             return v_GetTimeStep(inarray);
         }

◆ InitializeSteadyState()

void Nektar::SolverUtils::UnsteadySystem::InitializeSteadyState ( )

private

Definition at line 741 of file UnsteadySystem.cpp.

References Nektar::SolverUtils::EquationSystem::m_comm, m_errFile, Nektar::SolverUtils::EquationSystem::m_fields, m_previousSolution, Nektar::SolverUtils::EquationSystem::m_session, m_steadyStateTol, and Vmath::Vcopy().

Referenced by v_DoInitialise(), and v_RequireFwdTrans().

         {
             if (m_steadyStateTol > 0.0)
             {
                 const int nPoints = m_fields[0]->GetTotPoints();
                 m_previousSolution = Array<OneD, Array<OneD, NekDouble> > (
                             m_fields.num_elements());
 
                 for (int i = 0; i < m_fields.num_elements(); ++i)
                 {
                     m_previousSolution[i] = Array<OneD, NekDouble>(nPoints);
                     Vmath::Vcopy(nPoints, m_fields[i]->GetPhys(), 1,
                                           m_previousSolution[i], 1);
                 }
 
                 if (m_comm->GetRank() == 0)
                 {
                     std::string fName = m_session->GetSessionName() +
                         std::string(".res");
                     m_errFile.open(fName.c_str());
                     m_errFile << setw(26) << left << "# Time";
 
                     for (int i = 0; i < m_fields.num_elements(); ++i)
                     {
                         m_errFile << setw(26) << m_session->GetVariables()[i];
                     }
 
                     m_errFile << endl;
                 }
             }
         }

◆ MaxTimeStepEstimator()

NekDouble Nektar::SolverUtils::UnsteadySystem::MaxTimeStepEstimator ( )

protected

Get the maximum timestep estimator for cfl control.

Returns the maximum time estimator for CFL control.

Definition at line 160 of file UnsteadySystem.cpp.

References ASSERTL0, Nektar::LibUtilities::eAdamsBashforthOrder1, Nektar::LibUtilities::eAdamsBashforthOrder2, Nektar::LibUtilities::eClassicalRungeKutta4, Nektar::LibUtilities::eForwardEuler, Nektar::LibUtilities::eMidpoint, Nektar::LibUtilities::eRungeKutta2, Nektar::LibUtilities::eRungeKutta2_ImprovedEuler, Nektar::LibUtilities::eRungeKutta2_SSP, Nektar::LibUtilities::eRungeKutta3_SSP, Nektar::LibUtilities::eRungeKutta4, and m_intScheme.

Referenced by Nektar::CompressibleFlowSystem::GetElmtTimeStep().

         {
             NekDouble TimeStability = 0.0;
             switch(m_intScheme->GetIntegrationMethod())
             {
                 case LibUtilities::eForwardEuler:
                 case LibUtilities::eClassicalRungeKutta4:
                 case LibUtilities::eRungeKutta4:
                 {
                     TimeStability = 2.784;
                     break;
                 }
                 case LibUtilities::eAdamsBashforthOrder1:
                 case LibUtilities::eMidpoint:
                 case LibUtilities::eRungeKutta2:
                 case LibUtilities::eRungeKutta2_ImprovedEuler:
                 case LibUtilities::eRungeKutta2_SSP:
                 case LibUtilities::eRungeKutta3_SSP:
                 {
                     TimeStability = 2.0;
                     break;
                 }
                 case LibUtilities::eAdamsBashforthOrder2:
                 {
                     TimeStability = 1.0;
                     break;
                 }
                 default:
                 {
                     ASSERTL0(
                         false,
                         "No CFL control implementation for this time"
                         "integration scheme");
                 }
             }
             return TimeStability;
         }

◆ SVVVarDiffCoeff()

void Nektar::SolverUtils::UnsteadySystem::SVVVarDiffCoeff	(	const Array< OneD, Array< OneD, NekDouble >>	vel,
		StdRegions::VarCoeffMap &	varCoeffMap
	)

protected

Evaluate the SVV diffusion coefficient according to Moura's paper where it should proportional to h time velocity.

Definition at line 700 of file UnsteadySystem.cpp.

References Nektar::StdRegions::eVarCoeffLaplacian, Nektar::SolverUtils::EquationSystem::m_fields, Vmath::Smul(), Vmath::Vmul(), Vmath::Vsqrt(), and Vmath::Vvtvp().

Referenced by Nektar::UnsteadyViscousBurgers::DoImplicitSolve(), Nektar::UnsteadyViscousBurgers::v_InitObject(), and v_RequireFwdTrans().

         {
             int phystot = m_fields[0]->GetTotPoints();
             int nvel = vel.num_elements();
 
             Array<OneD, NekDouble> varcoeff(phystot),tmp;
 
             // calculate magnitude of v
             Vmath::Vmul(phystot,vel[0],1,vel[0],1,varcoeff,1);
             for(int n = 1; n < nvel; ++n)
             {
                 Vmath::Vvtvp(phystot,vel[n],1,vel[n],1,varcoeff,1,varcoeff,1);
             }
             Vmath::Vsqrt(phystot,varcoeff,1,varcoeff,1);
 
             for(int i = 0; i < m_fields[0]->GetNumElmts(); ++i)
             {
                 int offset = m_fields[0]->GetPhys_Offset(i);
                 int nq = m_fields[0]->GetExp(i)->GetTotPoints();
                 Array<OneD, NekDouble> unit(nq,1.0);
 
                 int nmodes = 0;
 
                 for(int n = 0; n < m_fields[0]->GetExp(i)->GetNumBases(); ++n)
                 {
                     nmodes = max(nmodes,
                                  m_fields[0]->GetExp(i)->GetBasisNumModes(n));
                 }
 
                 NekDouble h = m_fields[0]->GetExp(i)->Integral(unit);
                 h = pow(h,(NekDouble) (1.0/nvel))/((NekDouble) nmodes);
 
                 Vmath::Smul(nq,h,varcoeff+offset,1,tmp = varcoeff+offset,1);
             }
 
             // set up map with eVarCoffLaplacian key
             varCoeffMap[StdRegions::eVarCoeffLaplacian] = varcoeff;
         }

◆ v_AppendOutput1D()

void Nektar::SolverUtils::UnsteadySystem::v_AppendOutput1D ( Array< OneD, Array< OneD, NekDouble >> & solution1D )

protectedvirtual

Print the solution at each solution point in a txt file.

Stores the solution in a file for 1D problems only. This method has been implemented to facilitate the post-processing for 1D problems.

Definition at line 583 of file UnsteadySystem.cpp.

References Nektar::SolverUtils::EquationSystem::GetNpoints(), and Nektar::SolverUtils::EquationSystem::m_fields.

Referenced by v_DoSolve().

         {
             // Coordinates of the quadrature points in the real physical space
             Array<OneD,NekDouble> x(GetNpoints());
             Array<OneD,NekDouble> y(GetNpoints());
             Array<OneD,NekDouble> z(GetNpoints());
             m_fields[0]->GetCoords(x, y, z);
             
             // Print out the solution in a txt file
             ofstream outfile;
             outfile.open("solution1D.txt");
             for(int i = 0; i < GetNpoints(); i++)
             {
                 outfile << scientific << setw (17) << setprecision(16) << x[i]
                         << "  " << solution1D[0][i] << endl;
             }
             outfile << endl << endl;
             outfile.close();
         }

◆ v_DoInitialise()

void Nektar::SolverUtils::UnsteadySystem::v_DoInitialise ( void )

protectedvirtual

Sets up initial conditions.

Sets the initial conditions.

Reimplemented from Nektar::SolverUtils::EquationSystem.

Reimplemented in Nektar::MMFSWE, Nektar::CoupledLinearNS, Nektar::VelocityCorrectionScheme, Nektar::PulseWaveSystem, and Nektar::VCSMapping.

Definition at line 537 of file UnsteadySystem.cpp.

References CheckForRestartTime(), InitializeSteadyState(), Nektar::SolverUtils::EquationSystem::m_nchk, Nektar::SolverUtils::EquationSystem::m_time, Nektar::SolverUtils::EquationSystem::SetBoundaryConditions(), and Nektar::SolverUtils::EquationSystem::SetInitialConditions().

Referenced by Nektar::VCSMapping::v_DoInitialise(), and Nektar::VelocityCorrectionScheme::v_DoInitialise().

         {
             CheckForRestartTime(m_time, m_nchk);
             SetBoundaryConditions(m_time);
             SetInitialConditions(m_time);
             InitializeSteadyState();
         }

◆ v_DoSolve()

void Nektar::SolverUtils::UnsteadySystem::v_DoSolve ( void )

protectedvirtual

Solves an unsteady problem.

Initialises the time integration scheme (as specified in the session file), and perform the time integration.

Reimplemented from Nektar::SolverUtils::EquationSystem.

Reimplemented in Nektar::MMFSWE, Nektar::CoupledLinearNS, Nektar::MMFAdvection, Nektar::PulseWaveSystem, and Nektar::MMFMaxwell.

Definition at line 202 of file UnsteadySystem.cpp.

Referenced by Nektar::CoupledLinearNS::v_DoSolve().

         {
             ASSERTL0(m_intScheme != 0, "No time integration scheme.");
 
             int i = 1;
             int nvariables = 0;
             int nfields = m_fields.num_elements();
 
             if (m_intVariables.empty())
             {
                 for (i = 0; i < nfields; ++i)
                 {
                     m_intVariables.push_back(i);
                 }
                 nvariables = nfields;
             }
             else
             {
                 nvariables = m_intVariables.size();
             }
 
             // Integrate in wave-space if using homogeneous1D
             if(m_HomogeneousType != eNotHomogeneous && m_homoInitialFwd)
             {
                 for(i = 0; i < nfields; ++i)
                 {
                     m_fields[i]->HomogeneousFwdTrans(m_fields[i]->GetPhys(),
                                                      m_fields[i]->UpdatePhys());
                     m_fields[i]->SetWaveSpace(true);
                     m_fields[i]->SetPhysState(false);
                 }
             }
 
             // Set up wrapper to fields data storage.
             Array<OneD, Array<OneD, NekDouble> > fields(nvariables);
 
             // Order storage to list time-integrated fields first.
             for(i = 0; i < nvariables; ++i)
             {
                 fields[i] = m_fields[m_intVariables[i]]->GetPhys();
                 m_fields[m_intVariables[i]]->SetPhysState(false);
             }
             
             // Initialise time integration scheme
             m_intSoln = m_intScheme->InitializeScheme(
                 m_timestep, fields, m_time, m_ode);
 
             // Initialise filters
             for (auto &x : m_filters)
             {
                 x.second->Initialise(m_fields, m_time);
             }
 
             LibUtilities::Timer         timer;
             bool      doCheckTime       = false;
             int       step              = m_initialStep;
             int       stepCounter       = 0;
             NekDouble intTime           = 0.0;
             NekDouble lastCheckTime     = 0.0;
             NekDouble cpuTime           = 0.0;
             NekDouble cpuPrevious       = 0.0;
             NekDouble elapsed           = 0.0;
             NekDouble totFilterTime     = 0.0;
 
             Array<OneD, int> abortFlags(2, 0);
             string    abortFile     = "abort";
             if (m_session->DefinesSolverInfo("CheckAbortFile"))
             {
                 abortFile = m_session->GetSolverInfo("CheckAbortFile");
             }
 
             while ((step   < m_steps ||
                    m_time < m_fintime - NekConstants::kNekZeroTol) &&
                    abortFlags[1] == 0)
             {
                 if (m_cflSafetyFactor)
                 {
                     m_timestep = GetTimeStep(fields);
         
                     // Ensure that the final timestep finishes at the final
                     // time, or at a prescribed IO_CheckTime.
                     if (m_time + m_timestep > m_fintime && m_fintime > 0.0)
                     {
                         m_timestep = m_fintime - m_time;
                     }
                     else if (m_checktime &&
                              m_time + m_timestep - lastCheckTime >= m_checktime)
                     {
                         lastCheckTime += m_checktime;
                         m_timestep     = lastCheckTime - m_time;
                         doCheckTime    = true;
                     }
                 }
         
                 // Perform any solver-specific pre-integration steps
                 timer.Start();
                 if (v_PreIntegrate(step))
                 {
                     break;
                 }
 
                 fields = m_intScheme->TimeIntegrate(
                     stepCounter, m_timestep, m_intSoln, m_ode);
                 timer.Stop();
 
                 m_time  += m_timestep;
                 elapsed  = timer.TimePerTest(1);
                 intTime += elapsed;
                 cpuTime += elapsed;
         
                 // Write out status information
                 if (m_session->GetComm()->GetRank() == 0 && 
                     !((step+1) % m_infosteps))
                 {
                     cout << "Steps: " << setw(8)  << left << step+1 << " "
                          << "Time: "  << setw(12) << left << m_time;
 
                     if (m_cflSafetyFactor)
                     {
                         cout << " Time-step: " << setw(12)
                              << left << m_timestep;
                     }
 
                     stringstream ss;
                     ss << cpuTime << "s";
                     cout << " CPU Time: " << setw(8) << left
                          << ss.str() << endl;
                     cpuPrevious = cpuTime;
                     cpuTime = 0.0;
                 }
 
                 // Transform data into coefficient space
                 for (i = 0; i < nvariables; ++i)
                 {
                     // copy fields into ExpList::m_phys and assign the new
                     // array to fields
                     m_fields[m_intVariables[i]]->SetPhys(fields[i]);
                     fields[i] = m_fields[m_intVariables[i]]->UpdatePhys();
                     if( v_RequireFwdTrans() )
                     {
                         m_fields[m_intVariables[i]]->FwdTrans_IterPerExp(
                             fields[i],
                             m_fields[m_intVariables[i]]->UpdateCoeffs());
                     }
                     m_fields[m_intVariables[i]]->SetPhysState(false);
                 }
 
                 // Perform any solver-specific post-integration steps
                 if (v_PostIntegrate(step))
                 {
                     break;
                 }
 
                 // Check for steady-state
                 if (m_steadyStateTol > 0.0 && (!((step+1)%m_steadyStateSteps)) )
                 {
                     if (CheckSteadyState(step))
                     {
                         if (m_comm->GetRank() == 0)
                         {
                             cout << "Reached Steady State to tolerance "
                                  << m_steadyStateTol << endl;
                         }
                         break;
                     }
                 }
 
                 // test for abort conditions (nan, or abort file)
                 if (m_abortSteps && !((step+1) % m_abortSteps) )
                 {
                     abortFlags[0] = 0;
                     for (i = 0; i < nvariables; ++i)
                     {
                         if (Vmath::Nnan(fields[i].num_elements(),
                                 fields[i], 1) > 0)
                         {
                             abortFlags[0] = 1;
                         }
                     }
 
                     //rank zero looks for abort file and deltes it
                     //if it exists. The communicates the abort
                     if(m_session->GetComm()->GetRank() == 0)
                     {
                         if(boost::filesystem::exists(abortFile))
                         {
                             boost::filesystem::remove(abortFile);
                             abortFlags[1] = 1;
                         }
                     }                    
 
                     m_session->GetComm()->AllReduce(abortFlags,
                                 LibUtilities::ReduceMax);
 
                     ASSERTL0 (!abortFlags[0],
                                 "NaN found during time integration.");
                 }
 
                 // Update filters
                 for (auto &x : m_filters)
                 {
                     timer.Start();
                     x.second->Update(m_fields, m_time);
                     timer.Stop();
                     elapsed = timer.TimePerTest(1);
                     totFilterTime += elapsed;
 
                     // Write out individual filter status information
                     if(m_session->GetComm()->GetRank() == 0 && 
                     !((step+1) % m_filtersInfosteps) && !m_filters.empty() && 
                     m_session->DefinesCmdLineArgument("verbose"))
                     {
                         stringstream s0;
                         s0 << x.first << ":";
                         stringstream s1;
                         s1 << elapsed << "s";
                         stringstream s2;
                         s2 << elapsed / cpuPrevious * 100 << "%";
                         cout << "CPU time for filter " << setw(25) << left 
                             << s0.str() << setw(12) << left << s1.str() << 
                             endl << "\t Percentage of time integration:     "
                              << setw(10) << left << s2.str() << endl;
                     }
                 }
 
                 // Write out overall filter status information
                 if (m_session->GetComm()->GetRank() == 0 && 
                     !((step+1) % m_filtersInfosteps) && !m_filters.empty())
                  {
                     stringstream ss;
                     ss << totFilterTime << "s";
                     cout << "Total filters CPU Time:\t\t\t     " << setw(10)
                         << left << ss.str() << endl;
                  }
                 totFilterTime = 0.0;
 
                 // Write out checkpoint files
                 if ((m_checksteps && !((step + 1) % m_checksteps)) ||
                      doCheckTime)
                 {
                     if(m_HomogeneousType != eNotHomogeneous)
                     {
                         vector<bool> transformed(nfields, false);
                         for(i = 0; i < nfields; i++)
                         {
                             if (m_fields[i]->GetWaveSpace())
                             {
                                 m_fields[i]->SetWaveSpace(false);
                                 m_fields[i]->BwdTrans(m_fields[i]->GetCoeffs(),
                                                       m_fields[i]->UpdatePhys());
                                 m_fields[i]->SetPhysState(true);
                                 transformed[i] = true;
                             }
                         }
                         Checkpoint_Output(m_nchk);
                         m_nchk++;
                         for(i = 0; i < nfields; i++)
                         {
                             if (transformed[i])
                             {
                                 m_fields[i]->SetWaveSpace(true);
                                 m_fields[i]->HomogeneousFwdTrans(
                                     m_fields[i]->GetPhys(),
                                     m_fields[i]->UpdatePhys());
                                 m_fields[i]->SetPhysState(false);
                             }
                         }
                     }
                     else
                     {
                         Checkpoint_Output(m_nchk);
                         m_nchk++;
                     }
                     doCheckTime = false;
                 }
 
                 // Step advance
                 ++step;
                 ++stepCounter;
             }
         
             // Print out summary statistics
             if (m_session->GetComm()->GetRank() == 0)
             {
                 if (m_cflSafetyFactor > 0.0)
                 {
                     cout << "CFL safety factor : " << m_cflSafetyFactor << endl
                          << "CFL time-step     : " << m_timestep        << endl;
                 }
 
                 if (m_session->GetSolverInfo("Driver") != "SteadyState")
                 {
                     cout << "Time-integration  : " << intTime  << "s"   << endl;
                 }
             }
         
             // If homogeneous, transform back into physical space if necessary.
             if(m_HomogeneousType != eNotHomogeneous)
             {
                 for(i = 0; i < nfields; i++)
                 {
                     if (m_fields[i]->GetWaveSpace())
                     {
                         m_fields[i]->SetWaveSpace(false);
                         m_fields[i]->BwdTrans(m_fields[i]->GetCoeffs(),
                                               m_fields[i]->UpdatePhys());
                         m_fields[i]->SetPhysState(true);
                     }
                 }
             }
             else
             {
                 for(i = 0; i < nvariables; ++i)
                 {
                     m_fields[m_intVariables[i]]->SetPhys(fields[i]);
                     m_fields[m_intVariables[i]]->SetPhysState(true);
                 }
             }
 
             // Finalise filters
             for (auto &x : m_filters)
             {
                 x.second->Finalise(m_fields, m_time);
             }
         
             // Print for 1D problems
             if(m_spacedim == 1)
             {
                 v_AppendOutput1D(fields);
             }
         }

◆ v_GenerateSummary()

void Nektar::SolverUtils::UnsteadySystem::v_GenerateSummary ( SummaryList & s )

protectedvirtual

Print a summary of time stepping parameters.

Prints a summary with some information regards the time-stepping.

Reimplemented from Nektar::SolverUtils::EquationSystem.

Reimplemented in Nektar::MMFSWE, Nektar::MMFMaxwell, Nektar::CoupledLinearNS, Nektar::VelocityCorrectionScheme, Nektar::SolverUtils::MMFSystem, Nektar::MMFAdvection, Nektar::MMFDiffusion, Nektar::UnsteadyViscousBurgers, Nektar::UnsteadyAdvectionDiffusion, Nektar::CFLtester, Nektar::UnsteadyAdvection, Nektar::NonlinearPeregrine, Nektar::PulseWavePropagation, Nektar::Monodomain, Nektar::Bidomain, Nektar::BidomainRoth, Nektar::ImageWarpingSystem, Nektar::ShallowWaterSystem, Nektar::LinearSWE, Nektar::NonlinearSWE, Nektar::UnsteadyDiffusion, Nektar::VCSWeakPressure, Nektar::IsentropicVortex, and Nektar::RinglebFlow.

Definition at line 549 of file UnsteadySystem.cpp.

References Nektar::SolverUtils::AddSummaryItem(), Nektar::SolverUtils::EquationSystem::m_checksteps, m_explicitAdvection, m_explicitDiffusion, m_explicitReaction, m_intScheme, Nektar::SolverUtils::EquationSystem::m_session, Nektar::SolverUtils::EquationSystem::m_steps, Nektar::SolverUtils::EquationSystem::m_timestep, Nektar::LibUtilities::TimeIntegrationMethodMap, and Nektar::SolverUtils::EquationSystem::v_GenerateSummary().

         {
             EquationSystem::v_GenerateSummary(s);
             AddSummaryItem(s, "Advection",
                            m_explicitAdvection ? "explicit" : "implicit");
 
             if(m_session->DefinesSolverInfo("AdvectionType"))
             {
                 AddSummaryItem(s, "AdvectionType",
                                m_session->GetSolverInfo("AdvectionType"));
             }
 
             AddSummaryItem(s, "Diffusion",
                            m_explicitDiffusion ? "explicit" : "implicit");
 
             if (m_session->GetSolverInfo("EQTYPE")
                     == "SteadyAdvectionDiffusionReaction")
             {
                 AddSummaryItem(s, "Reaction",
                                m_explicitReaction  ? "explicit" : "implicit");
             }
 
             AddSummaryItem(s, "Time Step", m_timestep);
             AddSummaryItem(s, "No. of Steps", m_steps);
             AddSummaryItem(s, "Checkpoints (steps)", m_checksteps);
             AddSummaryItem(s, "Integration Type",
                            LibUtilities::TimeIntegrationMethodMap[
                                m_intScheme->GetIntegrationMethod()]);
         }

◆ v_GetTimeStep()

NekDouble Nektar::SolverUtils::UnsteadySystem::v_GetTimeStep ( const Array< OneD, const Array< OneD, NekDouble >> & inarray )

protectedvirtual

Return the timestep to be used for the next step in the time-marching loop.

See also: UnsteadySystem::GetTimeStep

Definition at line 680 of file UnsteadySystem.cpp.

References Nektar::ErrorUtil::efatal, and NEKERROR.

Referenced by GetTimeStep().

         {
             boost::ignore_unused(inarray);
             NEKERROR(ErrorUtil::efatal, "Not defined for this class");
             return 0.0;
         }

◆ v_InitObject()

void Nektar::SolverUtils::UnsteadySystem::v_InitObject ( )

protectedvirtual

Init object for UnsteadySystem class.

Initialization object for UnsteadySystem class.

Reimplemented from Nektar::SolverUtils::EquationSystem.

Reimplemented in Nektar::MMFSWE, Nektar::CoupledLinearNS, Nektar::MMFAdvection, Nektar::IncNavierStokes, Nektar::PulseWaveSystem, Nektar::UnsteadyViscousBurgers, Nektar::CompressibleFlowSystem, Nektar::UnsteadyAdvectionDiffusion, Nektar::MMFDiffusion, Nektar::CFLtester, Nektar::UnsteadyAdvection, Nektar::UnsteadyInviscidBurger, Nektar::MMFMaxwell, Nektar::PulseWavePropagation, Nektar::ShallowWaterSystem, Nektar::NonlinearPeregrine, Nektar::AcousticSystem, Nektar::ImageWarpingSystem, Nektar::NavierStokesCFE, Nektar::UnsteadyDiffusion, Nektar::Monodomain, Nektar::Dummy, Nektar::LEE, Nektar::Bidomain, Nektar::NavierStokesCFEAxisym, Nektar::BidomainRoth, Nektar::LinearSWE, Nektar::NonlinearSWE, Nektar::VCSMapping, Nektar::APE, Nektar::UnsteadyReactionDiffusion, Nektar::PulseWaveSystemOutput, Nektar::VelocityCorrectionScheme, and Nektar::SolverUtils::AdvectionSystem.

Definition at line 80 of file UnsteadySystem.cpp.

         {
             EquationSystem::v_InitObject();
             
             m_initialStep = 0;
 
             // Load SolverInfo parameters
             m_session->MatchSolverInfo("DIFFUSIONADVANCEMENT","Explicit",
                                        m_explicitDiffusion,true);
             m_session->MatchSolverInfo("ADVECTIONADVANCEMENT","Explicit",
                                        m_explicitAdvection,true);
             m_session->MatchSolverInfo("REACTIONADVANCEMENT", "Explicit",
                                        m_explicitReaction, true);
 
             m_session->LoadParameter("CheckAbortSteps", m_abortSteps, 1);
             // Steady state tolerance
             m_session->LoadParameter("SteadyStateTol", m_steadyStateTol, 0.0);
             // Frequency for checking steady state
             m_session->LoadParameter("SteadyStateSteps",
                                           m_steadyStateSteps, 1);
 
             // For steady problems, we do not initialise the time integration
             if (m_session->DefinesSolverInfo("TIMEINTEGRATIONMETHOD"))
             {
                 m_intScheme = LibUtilities::GetTimeIntegrationWrapperFactory().
                     CreateInstance(m_session->GetSolverInfo(
                                        "TIMEINTEGRATIONMETHOD"));
 
                 // Load generic input parameters
                 m_session->LoadParameter("IO_InfoSteps", m_infosteps, 0);
                 m_session->LoadParameter("IO_FiltersInfoSteps",
                     m_filtersInfosteps, 10.0 * m_infosteps);
                 m_session->LoadParameter("CFL", m_cflSafetyFactor, 0.0);
 
                 // Time tolerance between filter update time and time integration
                 m_session->LoadParameter("FilterTimeWarning", m_filterTimeWarning, 1);
 
                 // Ensure that there is no conflict of parameters
                 if(m_cflSafetyFactor > 0.0)
                 {
                     // Check final condition
                     ASSERTL0(m_fintime == 0.0 || m_steps == 0,
                              "Final condition not unique: "
                              "fintime > 0.0 and Nsteps > 0");
                     // Check timestep condition
                     ASSERTL0(m_timestep == 0.0,
                              "Timestep not unique: timestep > 0.0 & CFL > 0.0");
                 }
                 else
                 {
                     ASSERTL0(m_timestep != 0.0,
                              "Need to set either TimeStep or CFL");
                 }
 
                 // Set up time to be dumped in field information
                 m_fieldMetaDataMap["Time"] =
                         boost::lexical_cast<std::string>(m_time);
             }
 
             // By default attempt to forward transform initial condition.
             m_homoInitialFwd = true;
 
             // Set up filters
             for (auto &x : m_session->GetFilters())
             {
                 m_filters.push_back(make_pair(x.first, GetFilterFactory().CreateInstance(
                         x.first, m_session, shared_from_this(), x.second)));
             }
         }

◆ v_PostIntegrate()

bool Nektar::SolverUtils::UnsteadySystem::v_PostIntegrate ( int step )

protectedvirtual

Reimplemented in Nektar::VelocityCorrectionScheme, Nektar::Dummy, and Nektar::SolverUtils::AdvectionSystem.

Definition at line 694 of file UnsteadySystem.cpp.

Referenced by v_DoSolve(), Nektar::SolverUtils::AdvectionSystem::v_PostIntegrate(), and Nektar::Dummy::v_PostIntegrate().

         {
             boost::ignore_unused(step);
             return false;
         }

◆ v_PreIntegrate()

bool Nektar::SolverUtils::UnsteadySystem::v_PreIntegrate ( int step )

protectedvirtual

Reimplemented in Nektar::IncNavierStokes, Nektar::UnsteadyAdvectionDiffusion, Nektar::AcousticSystem, and Nektar::Dummy.

Definition at line 688 of file UnsteadySystem.cpp.

Referenced by v_DoSolve(), Nektar::Dummy::v_PreIntegrate(), and Nektar::AcousticSystem::v_PreIntegrate().

         {
             boost::ignore_unused(step);
             return false;
         }

◆ v_RequireFwdTrans()

virtual SOLVER_UTILS_EXPORT bool Nektar::SolverUtils::UnsteadySystem::v_RequireFwdTrans ( )

inlineprotectedvirtual

Reimplemented in Nektar::VelocityCorrectionScheme, and Nektar::Dummy.

Definition at line 132 of file UnsteadySystem.h.

References CheckForRestartTime(), CheckSteadyState(), InitializeSteadyState(), SOLVER_UTILS_EXPORT, and SVVVarDiffCoeff().

Referenced by v_DoSolve().

     {
         return true;
     }

Member Data Documentation

◆ m_abortSteps

int Nektar::SolverUtils::UnsteadySystem::m_abortSteps

protected

Number of steps between checks for abort conditions.

Definition at line 64 of file UnsteadySystem.h.

Referenced by v_DoSolve(), and v_InitObject().

◆ m_cflSafetyFactor

NekDouble Nektar::SolverUtils::UnsteadySystem::m_cflSafetyFactor

CFL safety factor (comprise between 0 to 1).

Definition at line 58 of file UnsteadySystem.h.

Referenced by Nektar::CompressibleFlowSystem::GetElmtTimeStep(), Nektar::CompressibleFlowSystem::InitialiseParameters(), v_DoSolve(), Nektar::MMFAdvection::v_DoSolve(), Nektar::MMFSWE::v_DoSolve(), and v_InitObject().

◆ m_epsilon

NekDouble Nektar::SolverUtils::UnsteadySystem::m_epsilon

protected

Definition at line 75 of file UnsteadySystem.h.

◆ m_errFile

std::ofstream Nektar::SolverUtils::UnsteadySystem::m_errFile

protected

Definition at line 93 of file UnsteadySystem.h.

Referenced by CheckSteadyState(), and InitializeSteadyState().

◆ m_explicitAdvection

bool Nektar::SolverUtils::UnsteadySystem::m_explicitAdvection

protected

Indicates if explicit or implicit treatment of advection is used.

Definition at line 79 of file UnsteadySystem.h.

◆ m_explicitDiffusion

bool Nektar::SolverUtils::UnsteadySystem::m_explicitDiffusion

protected

Indicates if explicit or implicit treatment of diffusion is used.

Definition at line 77 of file UnsteadySystem.h.

Referenced by Nektar::UnsteadyAdvectionDiffusion::DoOdeRhs(), v_GenerateSummary(), Nektar::VelocityCorrectionScheme::v_InitObject(), Nektar::BidomainRoth::v_InitObject(), Nektar::Bidomain::v_InitObject(), Nektar::Monodomain::v_InitObject(), Nektar::UnsteadyDiffusion::v_InitObject(), v_InitObject(), Nektar::MMFDiffusion::v_InitObject(), Nektar::UnsteadyAdvectionDiffusion::v_InitObject(), and Nektar::UnsteadyViscousBurgers::v_InitObject().

◆ m_explicitReaction

bool Nektar::SolverUtils::UnsteadySystem::m_explicitReaction

protected

Indicates if explicit or implicit treatment of reaction is used.

Definition at line 81 of file UnsteadySystem.h.

Referenced by v_GenerateSummary(), and v_InitObject().

◆ m_filters

std::vector<std::pair<std::string, FilterSharedPtr> > Nektar::SolverUtils::UnsteadySystem::m_filters

protected

Definition at line 97 of file UnsteadySystem.h.

Referenced by v_DoSolve(), Nektar::BidomainRoth::v_InitObject(), Nektar::Bidomain::v_InitObject(), Nektar::Monodomain::v_InitObject(), and v_InitObject().

◆ m_filtersInfosteps

int Nektar::SolverUtils::UnsteadySystem::m_filtersInfosteps

protected

Number of time steps between outputting filters information.

Definition at line 66 of file UnsteadySystem.h.

Referenced by v_DoSolve(), and v_InitObject().

◆ m_filterTimeWarning

NekDouble Nektar::SolverUtils::UnsteadySystem::m_filterTimeWarning

protected

Number of time steps between outputting status information.

Definition at line 100 of file UnsteadySystem.h.

Referenced by v_InitObject().

◆ m_homoInitialFwd

bool Nektar::SolverUtils::UnsteadySystem::m_homoInitialFwd

protected

Flag to determine if simulation should start in homogeneous forward transformed state.

Definition at line 84 of file UnsteadySystem.h.

Referenced by v_DoSolve(), Nektar::UnsteadyDiffusion::v_InitObject(), Nektar::AcousticSystem::v_InitObject(), Nektar::UnsteadyAdvection::v_InitObject(), v_InitObject(), Nektar::CFLtester::v_InitObject(), Nektar::UnsteadyAdvectionDiffusion::v_InitObject(), Nektar::CompressibleFlowSystem::v_InitObject(), and Nektar::UnsteadyViscousBurgers::v_InitObject().

◆ m_infosteps

int Nektar::SolverUtils::UnsteadySystem::m_infosteps

protected

Number of time steps between outputting status information.

Definition at line 62 of file UnsteadySystem.h.

Referenced by CheckSteadyState(), Nektar::MMFMaxwell::v_DoSolve(), v_DoSolve(), Nektar::PulseWaveSystem::v_DoSolve(), Nektar::MMFAdvection::v_DoSolve(), Nektar::MMFSWE::v_DoSolve(), Nektar::ShallowWaterSystem::v_InitObject(), and v_InitObject().

◆ m_intScheme

LibUtilities::TimeIntegrationWrapperSharedPtr Nektar::SolverUtils::UnsteadySystem::m_intScheme

protected

Wrapper to the time integration scheme.

Definition at line 69 of file UnsteadySystem.h.

Referenced by MaxTimeStepEstimator(), Nektar::VelocityCorrectionScheme::SetUpExtrapolation(), Nektar::MMFMaxwell::v_DoSolve(), v_DoSolve(), Nektar::PulseWaveSystem::v_DoSolve(), Nektar::MMFAdvection::v_DoSolve(), Nektar::MMFSWE::v_DoSolve(), v_GenerateSummary(), Nektar::UnsteadyReactionDiffusion::v_InitObject(), Nektar::VCSMapping::v_InitObject(), v_InitObject(), and Nektar::UnsteadyAdvectionDiffusion::v_InitObject().

◆ m_intSoln

LibUtilities::TimeIntegrationSolutionSharedPtr Nektar::SolverUtils::UnsteadySystem::m_intSoln

protected

Definition at line 73 of file UnsteadySystem.h.

Referenced by Nektar::MMFMaxwell::v_DoSolve(), v_DoSolve(), Nektar::PulseWaveSystem::v_DoSolve(), Nektar::MMFAdvection::v_DoSolve(), Nektar::MMFSWE::v_DoSolve(), Nektar::UnsteadyAdvectionDiffusion::v_PreIntegrate(), and Nektar::IncNavierStokes::v_PreIntegrate().

◆ m_intVariables

std::vector<int> Nektar::SolverUtils::UnsteadySystem::m_intVariables

protected

Definition at line 95 of file UnsteadySystem.h.

Referenced by Nektar::MMFMaxwell::v_DoSolve(), v_DoSolve(), Nektar::MMFAdvection::v_DoSolve(), Nektar::MMFSWE::v_DoSolve(), Nektar::VelocityCorrectionScheme::v_InitObject(), Nektar::BidomainRoth::v_InitObject(), Nektar::Bidomain::v_InitObject(), Nektar::Monodomain::v_InitObject(), Nektar::Dummy::v_InitObject(), and Nektar::ImageWarpingSystem::v_InitObject().

◆ m_nanSteps

int Nektar::SolverUtils::UnsteadySystem::m_nanSteps

protected

Definition at line 67 of file UnsteadySystem.h.

Referenced by Nektar::Dummy::v_InitObject().

◆ m_ode

LibUtilities::TimeIntegrationSchemeOperators Nektar::SolverUtils::UnsteadySystem::m_ode

protected

The time integration scheme operators to use.

Definition at line 71 of file UnsteadySystem.h.

◆ m_previousSolution

Array<OneD, Array<OneD, NekDouble> > Nektar::SolverUtils::UnsteadySystem::m_previousSolution

protected

Storage for previous solution for steady-state check.

Definition at line 91 of file UnsteadySystem.h.

Referenced by CheckSteadyState(), and InitializeSteadyState().

◆ m_steadyStateSteps

int Nektar::SolverUtils::UnsteadySystem::m_steadyStateSteps

protected

Check for steady state at step interval.

Definition at line 89 of file UnsteadySystem.h.

Referenced by v_DoSolve(), and v_InitObject().

◆ m_steadyStateTol

NekDouble Nektar::SolverUtils::UnsteadySystem::m_steadyStateTol

protected

Tolerance to which steady state should be evaluated at.

Definition at line 87 of file UnsteadySystem.h.

Referenced by CheckSteadyState(), InitializeSteadyState(), v_DoSolve(), and v_InitObject().

Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Private Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ~UnsteadySystem()

◆ UnsteadySystem()

Member Function Documentation

◆ CheckForRestartTime()

◆ CheckSteadyState()

◆ GetTimeStep()

◆ InitializeSteadyState()

◆ MaxTimeStepEstimator()

◆ SVVVarDiffCoeff()

◆ v_AppendOutput1D()

◆ v_DoInitialise()

◆ v_DoSolve()

◆ v_GenerateSummary()

◆ v_GetTimeStep()

◆ v_InitObject()

◆ v_PostIntegrate()

◆ v_PreIntegrate()

◆ v_RequireFwdTrans()

Member Data Documentation

◆ m_abortSteps

◆ m_cflSafetyFactor

◆ m_epsilon

◆ m_errFile

◆ m_explicitAdvection

◆ m_explicitDiffusion

◆ m_explicitReaction

◆ m_filters

◆ m_filtersInfosteps

◆ m_filterTimeWarning

◆ m_homoInitialFwd

◆ m_infosteps

◆ m_intScheme

◆ m_intSoln

◆ m_intVariables

◆ m_nanSteps

◆ m_ode

◆ m_previousSolution

◆ m_steadyStateSteps

◆ m_steadyStateTol