Tempus  Version of the Day
Time Integration
Tempus_IntegratorPseudoTransientAdjointSensitivity_decl.hpp
Go to the documentation of this file.
1 // @HEADER
2 // ****************************************************************************
3 // Tempus: Copyright (2017) Sandia Corporation
4 //
5 // Distributed under BSD 3-clause license (See accompanying file Copyright.txt)
6 // ****************************************************************************
7 // @HEADER
8 
9 #ifndef Tempus_IntegratorPseudoTransientAdjointSensitivity_decl_hpp
10 #define Tempus_IntegratorPseudoTransientAdjointSensitivity_decl_hpp
11 
12 #include "Tempus_config.hpp"
13 #include "Tempus_IntegratorBasicOld.hpp"
14 #include "Tempus_AdjointSensitivityModelEvaluator.hpp"
15 
16 
17 namespace Tempus {
18 
19 
57 template<class Scalar>
59  : virtual public Tempus::Integrator<Scalar>,
60  virtual public Teuchos::ParameterListAcceptor
61 {
62 public:
63 
90  Teuchos::RCP<Teuchos::ParameterList> pList,
91  const Teuchos::RCP<Thyra::ModelEvaluator<Scalar> >& model,
92  const Teuchos::RCP<Thyra::ModelEvaluator<Scalar> >& adjoint_model);
93 
96  const Teuchos::RCP<Thyra::ModelEvaluator<Scalar> >& model,
97  const Teuchos::RCP<Thyra::ModelEvaluator<Scalar> >& adjoint_model,
98  std::string stepperType);
99 
107  Teuchos::RCP<Teuchos::ParameterList> pList,
108  const Teuchos::RCP<Thyra::ModelEvaluator<Scalar> >& model);
109 
117  const Teuchos::RCP<Thyra::ModelEvaluator<Scalar> >& model,
118  std::string stepperType);
119 
121 
123 
126 
128 
129 
131  virtual bool advanceTime();
133  virtual bool advanceTime(const Scalar timeFinal) override;
135  virtual Scalar getTime() const override;
137  virtual int getIndex() const override;
139  virtual Status getStatus() const override;
141  virtual void setStatus(const Status st) override;
143  virtual Teuchos::RCP<Stepper<Scalar> > getStepper() const override;
145  virtual Teuchos::RCP<Teuchos::ParameterList> getTempusParameterList() override;
146  virtual void setTempusParameterList(Teuchos::RCP<Teuchos::ParameterList> pl) override;
148  virtual Teuchos::RCP<const SolutionHistory<Scalar> > getSolutionHistory() const override;
150  virtual Teuchos::RCP<SolutionHistory<Scalar> > getNonConstSolutionHistory() override;
152  virtual Teuchos::RCP<const TimeStepControl<Scalar> > getTimeStepControl() const override;
153  virtual Teuchos::RCP<TimeStepControl<Scalar> > getNonConstTimeStepControl() override;
155  virtual Teuchos::RCP<Teuchos::Time> getIntegratorTimer() const override
156  {return state_integrator_->getIntegratorTimer();}
157  virtual Teuchos::RCP<Teuchos::Time> getStepperTimer() const override
158  {return state_integrator_->getStepperTimer();}
159 
161 
163  virtual void initializeSolutionHistory(
164  Scalar t0,
165  Teuchos::RCP<const Thyra::VectorBase<Scalar> > x0,
166  Teuchos::RCP<const Thyra::VectorBase<Scalar> > xdot0 = Teuchos::null,
167  Teuchos::RCP<const Thyra::VectorBase<Scalar> > xdotdot0 = Teuchos::null,
168  Teuchos::RCP<const Thyra::MultiVectorBase<Scalar> > y0 = Teuchos::null,
169  Teuchos::RCP<const Thyra::MultiVectorBase<Scalar> > ydot0 = Teuchos::null,
170  Teuchos::RCP<const Thyra::MultiVectorBase<Scalar> > ydotdot0 = Teuchos::null);
171 
173  virtual Teuchos::RCP<const Thyra::VectorBase<Scalar> > getX() const;
175  virtual Teuchos::RCP<const Thyra::VectorBase<Scalar> > getXDot() const;
177  virtual Teuchos::RCP<const Thyra::VectorBase<Scalar> > getXDotDot() const;
178 
180  virtual Teuchos::RCP<const Thyra::MultiVectorBase<Scalar> > getDgDp() const;
181 
183 
184  void setParameterList(const Teuchos::RCP<Teuchos::ParameterList> & pl)
185  override;
186  Teuchos::RCP<Teuchos::ParameterList> getNonconstParameterList() override;
187  Teuchos::RCP<Teuchos::ParameterList> unsetParameterList() override;
188 
189  Teuchos::RCP<const Teuchos::ParameterList> getValidParameters()
190  const override;
192 
194 
195  std::string description() const override;
196  void describe(Teuchos::FancyOStream & out,
197  const Teuchos::EVerbosityLevel verbLevel) const override;
199 
200 protected:
201  typedef Thyra::DefaultMultiVectorProductVector<Scalar> DMVPV;
202 
203  // Create sensitivity model evaluator from application model
204  Teuchos::RCP<AdjointSensitivityModelEvaluator<Scalar> >
206  const Teuchos::RCP<Thyra::ModelEvaluator<Scalar> >& model,
207  const Teuchos::RCP<Thyra::ModelEvaluator<Scalar> >& adjoint_model,
208  const Teuchos::RCP<Teuchos::ParameterList>& inputPL);
209 
210  void buildSolutionHistory();
211 
212  Teuchos::RCP<Thyra::ModelEvaluator<Scalar> > model_;
213  Teuchos::RCP<Thyra::ModelEvaluator<Scalar> > adjoint_model_;
214  Teuchos::RCP<AdjointSensitivityModelEvaluator<Scalar> > sens_model_;
215  Teuchos::RCP<IntegratorBasicOld<Scalar> > state_integrator_;
216  Teuchos::RCP<IntegratorBasicOld<Scalar> > sens_integrator_;
217  Teuchos::RCP<SolutionHistory<Scalar> > solutionHistory_;
218  Teuchos::RCP<DMVPV> dgdp_;
219 };
220 
222 template<class Scalar>
223 Teuchos::RCP<Tempus::IntegratorPseudoTransientAdjointSensitivity<Scalar> >
225  Teuchos::RCP<Teuchos::ParameterList> pList,
226  const Teuchos::RCP<Thyra::ModelEvaluator<Scalar> >& model);
227 
229 template<class Scalar>
230 Teuchos::RCP<Tempus::IntegratorPseudoTransientAdjointSensitivity<Scalar> >
232  const Teuchos::RCP<Thyra::ModelEvaluator<Scalar> >& model,
233  std::string stepperType);
234 
236 template<class Scalar>
237 Teuchos::RCP<Tempus::IntegratorPseudoTransientAdjointSensitivity<Scalar> >
239  Teuchos::RCP<Teuchos::ParameterList> pList,
240  const Teuchos::RCP<Thyra::ModelEvaluator<Scalar> >& model,
241  const Teuchos::RCP<Thyra::ModelEvaluator<Scalar> >& adjoint_model);
242 
244 template<class Scalar>
245 Teuchos::RCP<Tempus::IntegratorPseudoTransientAdjointSensitivity<Scalar> >
247  const Teuchos::RCP<Thyra::ModelEvaluator<Scalar> >& model,
248  const Teuchos::RCP<Thyra::ModelEvaluator<Scalar> >& adjoint_model,
249  std::string stepperType);
250 
252 template<class Scalar>
253 Teuchos::RCP<Tempus::IntegratorPseudoTransientAdjointSensitivity<Scalar> >
255 
256 } // namespace Tempus
257 
258 #endif // Tempus_IntegratorPseudoTransientAdjointSensitivity_decl_hpp
void setParameterList(const Teuchos::RCP< Teuchos::ParameterList > &pl) override
virtual Teuchos::RCP< Teuchos::Time > getIntegratorTimer() const override
Returns the IntegratorTimer_ for this Integrator.
void describe(Teuchos::FancyOStream &out, const Teuchos::EVerbosityLevel verbLevel) const override
virtual void setTempusParameterList(Teuchos::RCP< Teuchos::ParameterList > pl) override
virtual Teuchos::RCP< const Thyra::VectorBase< Scalar > > getXDotDot() const
Get current the second time derivative of the solution, xdotdot.
Teuchos::RCP< Tempus::IntegratorPseudoTransientAdjointSensitivity< Scalar > > integratorPseudoTransientAdjointSensitivity(Teuchos::RCP< Teuchos::ParameterList > pList, const Teuchos::RCP< Thyra::ModelEvaluator< Scalar > > &model)
Nonmember constructor.
virtual Teuchos::RCP< const Thyra::MultiVectorBase< Scalar > > getDgDp() const
Return adjoint sensitivity stored in gradient format.
virtual Teuchos::RCP< SolutionHistory< Scalar > > getNonConstSolutionHistory() override
Get the SolutionHistory.
Teuchos::RCP< const Teuchos::ParameterList > getValidParameters() const override
Time integrator suitable for pseudotransient adjoint sensitivity analysis.
Teuchos::RCP< AdjointSensitivityModelEvaluator< Scalar > > createSensitivityModel(const Teuchos::RCP< Thyra::ModelEvaluator< Scalar > > &model, const Teuchos::RCP< Thyra::ModelEvaluator< Scalar > > &adjoint_model, const Teuchos::RCP< Teuchos::ParameterList > &inputPL)
virtual Teuchos::RCP< TimeStepControl< Scalar > > getNonConstTimeStepControl() override
Status
Status for the Integrator, the Stepper and the SolutionState.
virtual void initializeSolutionHistory(Scalar t0, Teuchos::RCP< const Thyra::VectorBase< Scalar > > x0, Teuchos::RCP< const Thyra::VectorBase< Scalar > > xdot0=Teuchos::null, Teuchos::RCP< const Thyra::VectorBase< Scalar > > xdotdot0=Teuchos::null, Teuchos::RCP< const Thyra::MultiVectorBase< Scalar > > y0=Teuchos::null, Teuchos::RCP< const Thyra::MultiVectorBase< Scalar > > ydot0=Teuchos::null, Teuchos::RCP< const Thyra::MultiVectorBase< Scalar > > ydotdot0=Teuchos::null)
Set the initial state from Thyra::VectorBase(s)
virtual Teuchos::RCP< const Thyra::VectorBase< Scalar > > getXDot() const
Get current the time derivative of the solution, xdot.
virtual Teuchos::RCP< Teuchos::ParameterList > getTempusParameterList() override
Return a copy of the Tempus ParameterList.
Thyra Base interface for time integrators. Time integrators are designed to advance the solution from...
virtual Teuchos::RCP< Stepper< Scalar > > getStepper() const override
Get the Stepper.
virtual Teuchos::RCP< const SolutionHistory< Scalar > > getSolutionHistory() const override
Get the SolutionHistory.
virtual Teuchos::RCP< const TimeStepControl< Scalar > > getTimeStepControl() const override
Get the TimeStepControl.
virtual bool advanceTime()
Advance the solution to timeMax, and return true if successful.
virtual Teuchos::RCP< const Thyra::VectorBase< Scalar > > getX() const
Get current the solution, x.