Tempus Version of the Day
Time Integration
Loading...
Searching...
No Matches
List of all members
Tempus::Stepper< Scalar > Class Template Referenceabstract

Thyra Base interface for time steppers. More...

#include <Tempus_Stepper_decl.hpp>

Inheritance diagram for Tempus::Stepper< Scalar >:
Tempus::StepperExplicit< Scalar > Tempus::StepperImplicit< Scalar > Tempus::StepperOperatorSplit< Scalar > Tempus::StepperRKBase< Scalar > Tempus::StepperStaggeredForwardSensitivity< Scalar > Tempus::StepperSubcycling< Scalar > Tempus::StepperExplicitRK< Scalar > Tempus::StepperForwardEuler< Scalar > Tempus::StepperLeapfrog< Scalar > Tempus::StepperNewmarkExplicitAForm< Scalar > Tempus_Test::StepperPhysicsStateTest< Scalar > Tempus::StepperBDF2< Scalar > Tempus::StepperBackwardEuler< Scalar > Tempus::StepperDIRK< Scalar > Tempus::StepperHHTAlpha< Scalar > Tempus::StepperIMEX_RK< Scalar > Tempus::StepperIMEX_RK_Partition< Scalar > Tempus::StepperNewmarkImplicitAForm< Scalar > Tempus::StepperNewmarkImplicitDForm< Scalar > Tempus::StepperTrapezoidal< Scalar > Tempus::StepperDIRK< Scalar > Tempus::StepperExplicitRK< Scalar > Tempus::StepperIMEX_RK< Scalar > Tempus::StepperIMEX_RK_Partition< Scalar >

Overridden from Teuchos::Describable

std::string stepperName_
 Name used for output and ParameterLists.
 
std::string stepperType_
 Name of stepper type.
 
std::string ICConsistency_ = std::string("None")
 Type of consistency to apply to ICs.
 
bool ICConsistencyCheck_ = false
 Check if the initial condition is consistent.
 
Teuchos::RCP< Thyra::VectorBase< Scalar > > stepperX_
 
Teuchos::RCP< Thyra::VectorBase< Scalar > > stepperXDot_
 
Teuchos::RCP< Thyra::VectorBase< Scalar > > stepperXDotDot_
 
bool useFSAL_ = false
 Use First-Same-As-Last (FSAL) principle.
 
bool isInitialized_ = false
 True if stepper's member data is initialized.
 
virtual std::string description () const
 
virtual void describe (Teuchos::FancyOStream &out, const Teuchos::EVerbosityLevel verbLevel) const
 
virtual bool isValidSetup (Teuchos::FancyOStream &out) const
 
void setStepperValues (const Teuchos::RCP< Teuchos::ParameterList > pl)
 Set Stepper member data from ParameterList.
 
virtual Teuchos::RCP< const Teuchos::ParameterList > getValidParameters () const
 
Teuchos::RCP< Teuchos::ParameterList > getValidParametersBasic () const
 Add basic parameters to Steppers ParameterList.
 
virtual void setStepperX (Teuchos::RCP< Thyra::VectorBase< Scalar > > x)
 Set x for Stepper storage.
 
virtual void setStepperXDot (Teuchos::RCP< Thyra::VectorBase< Scalar > > xDot)
 Set xDot for Stepper storage.
 
virtual void setStepperXDotDot (Teuchos::RCP< Thyra::VectorBase< Scalar > > xDotDot)
 Set x for Stepper storage.
 

Basic stepper methods

virtual void setModel (const Teuchos::RCP< const Thyra::ModelEvaluator< Scalar > > &appModel)
 
virtual Teuchos::RCP< const Thyra::ModelEvaluator< Scalar > > getModel () const
 
virtual void setSolver (Teuchos::RCP< Thyra::NonlinearSolverBase< Scalar > > solver)
 Set solver.
 
virtual Teuchos::RCP< Thyra::NonlinearSolverBase< Scalar > > getSolver () const
 Get solver.
 
virtual void initialize ()
 Initialize after construction and changing input parameters.
 
virtual bool isInitialized ()
 True if stepper's member data is initialized.
 
virtual void checkInitialized ()
 Check initialization, and error out on failure.
 
virtual void setInitialConditions (const Teuchos::RCP< SolutionHistory< Scalar > > &solutionHistory)=0
 Set initial conditions, make them consistent, and set stepper memory.
 
virtual void takeStep (const Teuchos::RCP< SolutionHistory< Scalar > > &solutionHistory)=0
 Take the specified timestep, dt, and return true if successful.
 
virtual void setInitialGuess (Teuchos::RCP< const Thyra::VectorBase< Scalar > > initialGuess=Teuchos::null)=0
 Pass initial guess to Newton solver (for implicit schemes)
 
virtual Teuchos::RCP< Tempus::StepperState< Scalar > > getDefaultStepperState ()=0
 
virtual Scalar getOrder () const =0
 
virtual Scalar getOrderMin () const =0
 
virtual Scalar getOrderMax () const =0
 
virtual Scalar getInitTimeStep (const Teuchos::RCP< SolutionHistory< Scalar > > &solutionHistory) const =0
 
virtual bool isExplicit () const =0
 
virtual bool isImplicit () const =0
 
virtual bool isExplicitImplicit () const =0
 
virtual bool isOneStepMethod () const =0
 
virtual bool isMultiStepMethod () const =0
 
void setStepperName (std::string s)
 Set the stepper name.
 
std::string getStepperName () const
 Get the stepper name.
 
std::string getStepperType () const
 Get the stepper type. The stepper type is used as an identifier for the stepper, and can only be set by the derived Stepper class.
 
virtual void setUseFSAL (bool a)
 
void setUseFSALTrueOnly (bool a)
 
void setUseFSALFalseOnly (bool a)
 
bool getUseFSAL () const
 
void setICConsistency (std::string s)
 
std::string getICConsistency () const
 
void setICConsistencyCheck (bool c)
 
bool getICConsistencyCheck () const
 
virtual OrderODE getOrderODE () const =0
 
virtual Teuchos::RCP< Thyra::VectorBase< Scalar > > getStepperX ()
 Get Stepper x.
 
virtual Teuchos::RCP< Thyra::VectorBase< Scalar > > getStepperXDot ()
 Get Stepper xDot.
 
virtual Teuchos::RCP< Thyra::VectorBase< Scalar > > getStepperXDotDot ()
 Get Stepper xDotDot.
 
virtual Teuchos::RCP< Thyra::VectorBase< Scalar > > getStepperXDotDot (Teuchos::RCP< SolutionState< Scalar > > state)
 Get xDotDot from SolutionState or Stepper storage.
 
void setStepperType (std::string s)
 Set the stepper type.
 

Detailed Description

template<class Scalar>
class Tempus::Stepper< Scalar >

Thyra Base interface for time steppers.

Design Considerations

Definition at line 57 of file Tempus_Stepper_decl.hpp.

Member Function Documentation

◆ setModel()

template<class Scalar >
virtual void Tempus::Stepper< Scalar >::setModel ( const Teuchos::RCP< const Thyra::ModelEvaluator< Scalar > > &  appModel)
inlinevirtual

◆ getModel()

template<class Scalar >
virtual Teuchos::RCP< const Thyra::ModelEvaluator< Scalar > > Tempus::Stepper< Scalar >::getModel ( ) const
inlinevirtual

◆ setSolver()

template<class Scalar >
virtual void Tempus::Stepper< Scalar >::setSolver ( Teuchos::RCP< Thyra::NonlinearSolverBase< Scalar > >  solver)
inlinevirtual

◆ getSolver()

template<class Scalar >
virtual Teuchos::RCP< Thyra::NonlinearSolverBase< Scalar > > Tempus::Stepper< Scalar >::getSolver ( ) const
inlinevirtual

◆ initialize()

template<class Scalar >
void Tempus::Stepper< Scalar >::initialize
virtual

◆ isInitialized()

template<class Scalar >
virtual bool Tempus::Stepper< Scalar >::isInitialized ( )
inlinevirtual

True if stepper's member data is initialized.

Definition at line 83 of file Tempus_Stepper_decl.hpp.

◆ checkInitialized()

template<class Scalar >
void Tempus::Stepper< Scalar >::checkInitialized
virtual

Check initialization, and error out on failure.

Definition at line 34 of file Tempus_Stepper_impl.hpp.

◆ setInitialConditions()

template<class Scalar >
virtual void Tempus::Stepper< Scalar >::setInitialConditions ( const Teuchos::RCP< SolutionHistory< Scalar > > &  solutionHistory)
pure virtual

◆ takeStep()

template<class Scalar >
virtual void Tempus::Stepper< Scalar >::takeStep ( const Teuchos::RCP< SolutionHistory< Scalar > > &  solutionHistory)
pure virtual

◆ setInitialGuess()

template<class Scalar >
virtual void Tempus::Stepper< Scalar >::setInitialGuess ( Teuchos::RCP< const Thyra::VectorBase< Scalar > >  initialGuess = Teuchos::null)
pure virtual

◆ getDefaultStepperState()

template<class Scalar >
virtual Teuchos::RCP< Tempus::StepperState< Scalar > > Tempus::Stepper< Scalar >::getDefaultStepperState ( )
pure virtual

◆ getOrder()

template<class Scalar >
virtual Scalar Tempus::Stepper< Scalar >::getOrder ( ) const
pure virtual

◆ getOrderMin()

template<class Scalar >
virtual Scalar Tempus::Stepper< Scalar >::getOrderMin ( ) const
pure virtual

◆ getOrderMax()

template<class Scalar >
virtual Scalar Tempus::Stepper< Scalar >::getOrderMax ( ) const
pure virtual

◆ getInitTimeStep()

template<class Scalar >
virtual Scalar Tempus::Stepper< Scalar >::getInitTimeStep ( const Teuchos::RCP< SolutionHistory< Scalar > > &  solutionHistory) const
pure virtual

◆ isExplicit()

template<class Scalar >
virtual bool Tempus::Stepper< Scalar >::isExplicit ( ) const
pure virtual

◆ isImplicit()

template<class Scalar >
virtual bool Tempus::Stepper< Scalar >::isImplicit ( ) const
pure virtual

◆ isExplicitImplicit()

template<class Scalar >
virtual bool Tempus::Stepper< Scalar >::isExplicitImplicit ( ) const
pure virtual

◆ isOneStepMethod()

template<class Scalar >
virtual bool Tempus::Stepper< Scalar >::isOneStepMethod ( ) const
pure virtual

◆ isMultiStepMethod()

template<class Scalar >
virtual bool Tempus::Stepper< Scalar >::isMultiStepMethod ( ) const
pure virtual

◆ setStepperName()

template<class Scalar >
void Tempus::Stepper< Scalar >::setStepperName ( std::string  s)
inline

Set the stepper name.

Definition at line 116 of file Tempus_Stepper_decl.hpp.

◆ getStepperName()

template<class Scalar >
std::string Tempus::Stepper< Scalar >::getStepperName ( ) const
inline

Get the stepper name.

The stepper name is just a name used to distinguish it during I/O and in ParameterLists, and can be anything the user would like. One example is when two steppers of the same type (see getStepperType()) are being used during the same simulation. The user can name one as "Stepper with settings 1" and the other as "Stepper with settings 2". The default name is the stepper type (e.g., "BDF2" or "Bogacki-Shampine 3(2) Pair").

Definition at line 129 of file Tempus_Stepper_decl.hpp.

◆ setStepperType()

template<class Scalar >
void Tempus::Stepper< Scalar >::setStepperType ( std::string  s)
inlineprotected

Set the stepper type.

Definition at line 133 of file Tempus_Stepper_decl.hpp.

◆ getStepperType()

template<class Scalar >
std::string Tempus::Stepper< Scalar >::getStepperType ( ) const
inline

Get the stepper type. The stepper type is used as an identifier for the stepper, and can only be set by the derived Stepper class.

Definition at line 141 of file Tempus_Stepper_decl.hpp.

◆ setUseFSAL()

template<class Scalar >
virtual void Tempus::Stepper< Scalar >::setUseFSAL ( bool  a)
inlinevirtual

◆ setUseFSALTrueOnly()

template<class Scalar >
void Tempus::Stepper< Scalar >::setUseFSALTrueOnly ( bool  a)

Definition at line 45 of file Tempus_Stepper_impl.hpp.

◆ setUseFSALFalseOnly()

template<class Scalar >
void Tempus::Stepper< Scalar >::setUseFSALFalseOnly ( bool  a)

Definition at line 59 of file Tempus_Stepper_impl.hpp.

◆ getUseFSAL()

template<class Scalar >
bool Tempus::Stepper< Scalar >::getUseFSAL ( ) const
inline

Definition at line 146 of file Tempus_Stepper_decl.hpp.

◆ setICConsistency()

template<class Scalar >
void Tempus::Stepper< Scalar >::setICConsistency ( std::string  s)
inline

Definition at line 148 of file Tempus_Stepper_decl.hpp.

◆ getICConsistency()

template<class Scalar >
std::string Tempus::Stepper< Scalar >::getICConsistency ( ) const
inline

Definition at line 150 of file Tempus_Stepper_decl.hpp.

◆ setICConsistencyCheck()

template<class Scalar >
void Tempus::Stepper< Scalar >::setICConsistencyCheck ( bool  c)
inline

Definition at line 152 of file Tempus_Stepper_decl.hpp.

◆ getICConsistencyCheck()

template<class Scalar >
bool Tempus::Stepper< Scalar >::getICConsistencyCheck ( ) const
inline

Definition at line 154 of file Tempus_Stepper_decl.hpp.

◆ getOrderODE()

template<class Scalar >
virtual OrderODE Tempus::Stepper< Scalar >::getOrderODE ( ) const
pure virtual

◆ getStepperX()

template<class Scalar >
Teuchos::RCP< Thyra::VectorBase< Scalar > > Tempus::Stepper< Scalar >::getStepperX
virtual

Get Stepper x.

Definition at line 74 of file Tempus_Stepper_impl.hpp.

◆ getStepperXDot()

template<class Scalar >
Teuchos::RCP< Thyra::VectorBase< Scalar > > Tempus::Stepper< Scalar >::getStepperXDot
virtual

Get Stepper xDot.

Definition at line 85 of file Tempus_Stepper_impl.hpp.

◆ getStepperXDotDot() [1/2]

template<class Scalar >
Teuchos::RCP< Thyra::VectorBase< Scalar > > Tempus::Stepper< Scalar >::getStepperXDotDot
virtual

Get Stepper xDotDot.

Definition at line 96 of file Tempus_Stepper_impl.hpp.

◆ getStepperXDotDot() [2/2]

template<class Scalar >
Teuchos::RCP< Thyra::VectorBase< Scalar > > Tempus::Stepper< Scalar >::getStepperXDotDot ( Teuchos::RCP< SolutionState< Scalar > >  state)
virtual

Get xDotDot from SolutionState or Stepper storage.

Definition at line 108 of file Tempus_Stepper_impl.hpp.

◆ description()

template<class Scalar >
virtual std::string Tempus::Stepper< Scalar >::description ( ) const
inlinevirtual

◆ describe()

template<class Scalar >
void Tempus::Stepper< Scalar >::describe ( Teuchos::FancyOStream &  out,
const Teuchos::EVerbosityLevel  verbLevel 
) const
virtual

◆ isValidSetup()

template<class Scalar >
bool Tempus::Stepper< Scalar >::isValidSetup ( Teuchos::FancyOStream &  out) const
virtual

◆ setStepperValues()

template<class Scalar >
void Tempus::Stepper< Scalar >::setStepperValues ( const Teuchos::RCP< Teuchos::ParameterList >  pl)

Set Stepper member data from ParameterList.

Definition at line 164 of file Tempus_Stepper_impl.hpp.

◆ getValidParameters()

template<class Scalar >
Teuchos::RCP< const Teuchos::ParameterList > Tempus::Stepper< Scalar >::getValidParameters
virtual

◆ getValidParametersBasic()

template<class Scalar >
Teuchos::RCP< Teuchos::ParameterList > Tempus::Stepper< Scalar >::getValidParametersBasic

Add basic parameters to Steppers ParameterList.

Definition at line 199 of file Tempus_Stepper_impl.hpp.

◆ setStepperX()

template<class Scalar >
virtual void Tempus::Stepper< Scalar >::setStepperX ( Teuchos::RCP< Thyra::VectorBase< Scalar > >  x)
inlineprotectedvirtual

Set x for Stepper storage.

Definition at line 208 of file Tempus_Stepper_decl.hpp.

◆ setStepperXDot()

template<class Scalar >
virtual void Tempus::Stepper< Scalar >::setStepperXDot ( Teuchos::RCP< Thyra::VectorBase< Scalar > >  xDot)
inlineprotectedvirtual

Set xDot for Stepper storage.

Definition at line 212 of file Tempus_Stepper_decl.hpp.

◆ setStepperXDotDot()

template<class Scalar >
virtual void Tempus::Stepper< Scalar >::setStepperXDotDot ( Teuchos::RCP< Thyra::VectorBase< Scalar > >  xDotDot)
inlineprotectedvirtual

Set x for Stepper storage.

Definition at line 216 of file Tempus_Stepper_decl.hpp.

Member Data Documentation

◆ stepperName_

template<class Scalar >
std::string Tempus::Stepper< Scalar >::stepperName_
private

Name used for output and ParameterLists.

Definition at line 195 of file Tempus_Stepper_decl.hpp.

◆ stepperType_

template<class Scalar >
std::string Tempus::Stepper< Scalar >::stepperType_
private

Name of stepper type.

Definition at line 196 of file Tempus_Stepper_decl.hpp.

◆ ICConsistency_

template<class Scalar >
std::string Tempus::Stepper< Scalar >::ICConsistency_ = std::string("None")
private

Type of consistency to apply to ICs.

Definition at line 197 of file Tempus_Stepper_decl.hpp.

◆ ICConsistencyCheck_

template<class Scalar >
bool Tempus::Stepper< Scalar >::ICConsistencyCheck_ = false
private

Check if the initial condition is consistent.

Definition at line 198 of file Tempus_Stepper_decl.hpp.

◆ stepperX_

template<class Scalar >
Teuchos::RCP<Thyra::VectorBase<Scalar> > Tempus::Stepper< Scalar >::stepperX_
private

Definition at line 201 of file Tempus_Stepper_decl.hpp.

◆ stepperXDot_

template<class Scalar >
Teuchos::RCP<Thyra::VectorBase<Scalar> > Tempus::Stepper< Scalar >::stepperXDot_
private

Definition at line 202 of file Tempus_Stepper_decl.hpp.

◆ stepperXDotDot_

template<class Scalar >
Teuchos::RCP<Thyra::VectorBase<Scalar> > Tempus::Stepper< Scalar >::stepperXDotDot_
private

Definition at line 203 of file Tempus_Stepper_decl.hpp.

◆ useFSAL_

template<class Scalar >
bool Tempus::Stepper< Scalar >::useFSAL_ = false
protected

Use First-Same-As-Last (FSAL) principle.

Definition at line 219 of file Tempus_Stepper_decl.hpp.

◆ isInitialized_

template<class Scalar >
bool Tempus::Stepper< Scalar >::isInitialized_ = false
protected

True if stepper's member data is initialized.

Definition at line 220 of file Tempus_Stepper_decl.hpp.


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