Stokhos Package Browser (Single Doxygen Collection)  Version of the Day
Stokhos_SGModelEvaluator.hpp
Go to the documentation of this file.
1 // @HEADER
2 // ***********************************************************************
3 //
4 // Stokhos Package
5 // Copyright (2009) Sandia Corporation
6 //
7 // Under terms of Contract DE-AC04-94AL85000, there is a non-exclusive
8 // license for use of this work by or on behalf of the U.S. Government.
9 //
10 // Redistribution and use in source and binary forms, with or without
11 // modification, are permitted provided that the following conditions are
12 // met:
13 //
14 // 1. Redistributions of source code must retain the above copyright
15 // notice, this list of conditions and the following disclaimer.
16 //
17 // 2. Redistributions in binary form must reproduce the above copyright
18 // notice, this list of conditions and the following disclaimer in the
19 // documentation and/or other materials provided with the distribution.
20 //
21 // 3. Neither the name of the Corporation nor the names of the
22 // contributors may be used to endorse or promote products derived from
23 // this software without specific prior written permission.
24 //
25 // THIS SOFTWARE IS PROVIDED BY SANDIA CORPORATION "AS IS" AND ANY
26 // EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27 // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28 // PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SANDIA CORPORATION OR THE
29 // CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
30 // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
31 // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
32 // PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
33 // LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
34 // NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
35 // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
36 //
37 // Questions? Contact Eric T. Phipps (etphipp@sandia.gov).
38 //
39 // ***********************************************************************
40 // @HEADER
41 
42 #ifndef STOKHOS_SGMODELEVALUATOR_HPP
43 #define STOKHOS_SGMODELEVALUATOR_HPP
44 
45 #include <vector>
46 
47 #include "EpetraExt_ModelEvaluator.h"
48 #include "EpetraExt_MultiComm.h"
49 #include "EpetraExt_BlockVector.h"
50 
52 #include "Teuchos_RCP.hpp"
53 #include "Teuchos_Array.hpp"
54 #include "Teuchos_ParameterList.hpp"
55 #include "Stokhos_ParallelData.hpp"
61 #include "Stokhos_SGOperator.hpp"
64 
65 namespace Stokhos {
66 
68 
91  public:
92 
93  // Constructor
95  const Teuchos::RCP<EpetraExt::ModelEvaluator>& me,
96  const Teuchos::RCP<const Stokhos::OrthogPolyBasis<int,double> >& sg_basis,
97  const Teuchos::RCP<const Stokhos::Quadrature<int,double> >& sg_quad,
99  const Teuchos::RCP<const Stokhos::ParallelData>& sg_parallel_data,
100  const Teuchos::RCP<Teuchos::ParameterList>& params,
101  bool scaleOP = true);
102 
105 
107  Teuchos::RCP<const Epetra_Map> get_x_map() const;
108 
110  Teuchos::RCP<const Epetra_Map> get_f_map() const;
111 
113  Teuchos::RCP<const Epetra_Map> get_p_map(int l) const;
114 
116  Teuchos::RCP<const Epetra_Map> get_g_map(int l) const;
117 
119  Teuchos::RCP<const Teuchos::Array<std::string> >
120  get_p_names(int l) const;
121 
123  Teuchos::RCP<const Epetra_Vector> get_x_init() const;
124 
126  Teuchos::RCP<const Epetra_Vector> get_p_init(int l) const;
127 
129  Teuchos::RCP<Epetra_Operator> create_W() const;
130 
132  Teuchos::RCP<EpetraExt::ModelEvaluator::Preconditioner> create_WPrec() const;
133 
135  Teuchos::RCP<Epetra_Operator> create_DgDx_dot_op(int j) const;
136 
138  Teuchos::RCP<Epetra_Operator> create_DgDx_op(int j) const;
139 
141  Teuchos::RCP<Epetra_Operator> create_DgDp_op(int j, int i) const;
142 
144  Teuchos::RCP<Epetra_Operator> create_DfDp_op(int i) const;
145 
147  InArgs createInArgs() const;
148 
150  OutArgs createOutArgs() const;
151 
153  void evalModel(const InArgs& inArgs, const OutArgs& outArgs) const;
154 
156 
159 
161  void set_x_sg_init(const Stokhos::EpetraVectorOrthogPoly& x_sg_in);
162 
164  Teuchos::RCP<const Stokhos::EpetraVectorOrthogPoly> get_x_sg_init() const;
165 
167  void set_p_sg_init(int i, const Stokhos::EpetraVectorOrthogPoly& p_sg_in);
168 
170  Teuchos::RCP<const Stokhos::EpetraVectorOrthogPoly> get_p_sg_init(int l) const;
171 
173 
176  Teuchos::Array<int> get_p_sg_map_indices() const;
177 
179 
182  Teuchos::Array<int> get_g_sg_map_indices() const;
183 
185  Teuchos::Array< Teuchos::RCP<const Epetra_Map> > get_g_sg_base_maps() const;
186 
188  Teuchos::RCP<const Epetra_BlockMap> get_overlap_stochastic_map() const;
189 
191  Teuchos::RCP<const Epetra_BlockMap> get_x_sg_overlap_map() const;
192 
194  Teuchos::RCP<const Epetra_Import> get_x_sg_importer() const;
195 
197  Teuchos::RCP<Stokhos::EpetraVectorOrthogPoly>
199  const Epetra_Vector* v = NULL) const;
200 
202  Teuchos::RCP<Stokhos::EpetraVectorOrthogPoly>
204  const Epetra_Vector* v = NULL) const;
205 
207  Teuchos::RCP<Stokhos::EpetraMultiVectorOrthogPoly>
208  create_x_mv_sg(int num_vecs,
209  Epetra_DataAccess CV = Copy,
210  const Epetra_MultiVector* v = NULL) const;
211 
213  Teuchos::RCP<Stokhos::EpetraMultiVectorOrthogPoly>
214  create_x_mv_sg_overlap(int num_vecs,
215  Epetra_DataAccess CV = Copy,
216  const Epetra_MultiVector* v = NULL) const;
217 
219  Teuchos::RCP<Stokhos::EpetraVectorOrthogPoly>
220  create_p_sg(int l, Epetra_DataAccess CV = Copy,
221  const Epetra_Vector* v = NULL) const;
222 
224  Teuchos::RCP<Stokhos::EpetraVectorOrthogPoly>
226  const Epetra_Vector* v = NULL) const;
227 
229  Teuchos::RCP<Stokhos::EpetraVectorOrthogPoly>
231  const Epetra_Vector* v = NULL) const;
232 
234  Teuchos::RCP<Stokhos::EpetraMultiVectorOrthogPoly>
235  create_f_mv_sg(int num_vecs, Epetra_DataAccess CV = Copy,
236  const Epetra_MultiVector* v = NULL) const;
237 
239  Teuchos::RCP<Stokhos::EpetraMultiVectorOrthogPoly>
240  create_f_mv_sg_overlap(int num_vecs, Epetra_DataAccess CV = Copy,
241  const Epetra_MultiVector* v = NULL) const;
242 
244  Teuchos::RCP<Stokhos::EpetraVectorOrthogPoly>
245  create_g_sg(int l, Epetra_DataAccess CV = Copy,
246  const Epetra_Vector* v = NULL) const;
247 
249  Teuchos::RCP<Stokhos::EpetraMultiVectorOrthogPoly>
250  create_g_mv_sg(int l, int num_vecs, Epetra_DataAccess CV = Copy,
251  const Epetra_MultiVector* v = NULL) const;
252 
254 
256  Teuchos::RCP<EpetraExt::BlockVector>
257  import_solution(const Epetra_Vector& x) const;
258 
260  Teuchos::RCP<Stokhos::EpetraVectorOrthogPoly>
261  import_solution_poly(const Epetra_Vector& x) const;
262 
264  Teuchos::RCP<EpetraExt::BlockVector>
265  export_solution(const Epetra_Vector& x_overlapped) const;
266 
268  Teuchos::RCP<EpetraExt::BlockVector>
269  import_residual(const Epetra_Vector& f) const;
270 
272  Teuchos::RCP<EpetraExt::BlockVector>
273  export_residual(const Epetra_Vector& f_overlapped) const;
274 
275  protected:
276 
278  Teuchos::RCP<EpetraExt::ModelEvaluator> me;
279 
281  Teuchos::RCP<const Stokhos::OrthogPolyBasis<int, double> > sg_basis;
282 
284  Teuchos::RCP<const Stokhos::Quadrature<int,double> > sg_quad;
285 
287  Teuchos::RCP<Stokhos::OrthogPolyExpansion<int,double> > sg_exp;
288 
290  Teuchos::RCP<Teuchos::ParameterList> params;
291 
293  unsigned int num_sg_blocks;
294 
296  unsigned int num_W_blocks;
297 
299  unsigned int num_p_blocks;
300 
303 
305  Teuchos::RCP<const Epetra_Map> x_map;
306 
308  Teuchos::RCP<const Epetra_Map> f_map;
309 
311  Teuchos::RCP<const Stokhos::ParallelData> sg_parallel_data;
312 
314  Teuchos::RCP<const EpetraExt::MultiComm> sg_comm;
315 
317  Teuchos::RCP<const Stokhos::EpetraSparse3Tensor> epetraCijk;
318 
320  Teuchos::RCP<const Stokhos::EpetraSparse3Tensor> serialCijk;
321 
323  Teuchos::RCP<const Epetra_BlockMap> stoch_row_map;
324 
326  Teuchos::RCP<const Epetra_BlockMap> overlapped_stoch_row_map;
327 
329  Teuchos::RCP<const Epetra_BlockMap> overlapped_stoch_p_map;
330 
332  Teuchos::RCP<const Epetra_Map> sg_x_map;
333 
335  Teuchos::RCP<const Epetra_Map> sg_overlapped_x_map;
336 
338  Teuchos::RCP<const Epetra_Map> sg_f_map;
339 
341  Teuchos::RCP<const Epetra_Map> sg_overlapped_f_map;
342 
344  Teuchos::RCP<Epetra_Import> sg_overlapped_x_importer;
345 
347  Teuchos::RCP<Epetra_Export> sg_overlapped_f_exporter;
348 
350  int num_p;
351 
353  int num_p_sg;
354 
356  Teuchos::Array<int> sg_p_index_map;
357 
359  Teuchos::Array< Teuchos::RCP<const Epetra_Map> > sg_p_map;
360 
362  Teuchos::Array< Teuchos::RCP< Teuchos::Array<std::string> > > sg_p_names;
363 
365  int num_g;
366 
368  int num_g_sg;
369 
371  Teuchos::Array<int> sg_g_index_map;
372 
374  Teuchos::Array< Teuchos::RCP<const Epetra_Map> > sg_g_map;
375 
377  Teuchos::RCP< Stokhos::EpetraVectorOrthogPoly > x_dot_sg_blocks;
378 
380  Teuchos::RCP< Stokhos::EpetraVectorOrthogPoly > x_sg_blocks;
381 
383  mutable Teuchos::RCP< Stokhos::EpetraVectorOrthogPoly > f_sg_blocks;
384 
386  mutable Teuchos::RCP< Stokhos::EpetraOperatorOrthogPoly > W_sg_blocks;
387 
389  Teuchos::RCP<Stokhos::EpetraVectorOrthogPoly> sg_x_init;
390 
392  Teuchos::Array< Teuchos::RCP<Stokhos::EpetraVectorOrthogPoly> > sg_p_init;
393 
396 
398  mutable Teuchos::RCP<Stokhos::SGOperator> my_W;
399 
401  mutable Teuchos::RCP<Epetra_Vector> my_x;
402 
403  bool scaleOP;
404 
406  Teuchos::RCP< Stokhos::SGPreconditionerFactory > sg_prec_factory;
407 
408  };
409 
410 }
411 
412 #endif // FEAPP_MODELEVALUATOR_HPP
Teuchos::RCP< const Stokhos::EpetraSparse3Tensor > epetraCijk
Epetra Cijk.
Teuchos::RCP< Stokhos::EpetraVectorOrthogPoly > import_solution_poly(const Epetra_Vector &x) const
Import parallel solution vector.
Teuchos::RCP< EpetraExt::BlockVector > import_residual(const Epetra_Vector &f) const
Import parallel residual vector.
Teuchos::RCP< Stokhos::EpetraOperatorOrthogPoly > W_sg_blocks
W stochastic Galerkin components.
Teuchos::RCP< const Epetra_Map > sg_overlapped_f_map
Block SG overlapped residual map.
Teuchos::RCP< const Epetra_Vector > get_x_init() const
Return initial solution.
Teuchos::RCP< Stokhos::EpetraVectorOrthogPoly > sg_x_init
SG initial x.
Teuchos::Array< int > sg_g_index_map
Index map between block-g and g_sg maps.
unsigned int num_sg_blocks
Number of stochastic blocks.
Copy
Teuchos::RCP< const Epetra_Map > x_map
Underlying unknown map.
Teuchos::RCP< const Stokhos::EpetraVectorOrthogPoly > get_p_sg_init(int l) const
Return initial SG parameters.
Teuchos::RCP< Stokhos::EpetraVectorOrthogPoly > x_sg_blocks
x stochastic Galerkin components
Teuchos::RCP< Stokhos::EpetraVectorOrthogPoly > f_sg_blocks
f stochastic Galerkin components
int num_p_sg
Number of stochastic parameter vectors.
bool eval_W_with_f
Whether to always evaluate W with f.
Teuchos::RCP< const Epetra_Map > sg_overlapped_x_map
Block SG overlapped unknown map.
SGModelEvaluator(const Teuchos::RCP< EpetraExt::ModelEvaluator > &me, const Teuchos::RCP< const Stokhos::OrthogPolyBasis< int, double > > &sg_basis, const Teuchos::RCP< const Stokhos::Quadrature< int, double > > &sg_quad, const Teuchos::RCP< Stokhos::OrthogPolyExpansion< int, double > > &sg_exp, const Teuchos::RCP< const Stokhos::ParallelData > &sg_parallel_data, const Teuchos::RCP< Teuchos::ParameterList > &params, bool scaleOP=true)
void evalModel(const InArgs &inArgs, const OutArgs &outArgs) const
Evaluate model on InArgs.
Teuchos::RCP< const Epetra_Map > get_g_map(int l) const
Return response map.
Teuchos::RCP< const Epetra_Map > get_p_map(int l) const
Return parameter vector map.
Teuchos::Array< Teuchos::RCP< const Epetra_Map > > sg_g_map
Block SG response map.
Teuchos::RCP< Stokhos::EpetraMultiVectorOrthogPoly > create_f_mv_sg(int num_vecs, Epetra_DataAccess CV=Copy, const Epetra_MultiVector *v=NULL) const
Create multi-vector orthog poly using f map and owned sg map.
Teuchos::RCP< const Epetra_BlockMap > get_overlap_stochastic_map() const
Return overlap stochastic map.
Teuchos::RCP< EpetraExt::ModelEvaluator::Preconditioner > create_WPrec() const
Create preconditioner operator.
unsigned int num_p_blocks
Number of p stochastic blocks (may be smaller than num_sg_blocks)
Teuchos::RCP< const Epetra_Map > get_f_map() const
Return residual vector map.
Teuchos::RCP< Stokhos::EpetraMultiVectorOrthogPoly > create_g_mv_sg(int l, int num_vecs, Epetra_DataAccess CV=Copy, const Epetra_MultiVector *v=NULL) const
Create multi-vector orthog poly using g map.
Teuchos::RCP< Stokhos::EpetraVectorOrthogPoly > create_g_sg(int l, Epetra_DataAccess CV=Copy, const Epetra_Vector *v=NULL) const
Create vector orthog poly using g map.
Teuchos::RCP< const Stokhos::ParallelData > sg_parallel_data
Parallel SG data.
Teuchos::RCP< const Epetra_BlockMap > overlapped_stoch_p_map
Overlapped map for p stochastic blocks (local map)
Teuchos::RCP< const Stokhos::EpetraVectorOrthogPoly > get_x_sg_init() const
Return initial SG x.
Nonlinear, stochastic Galerkin ModelEvaluator.
Teuchos::RCP< Stokhos::EpetraVectorOrthogPoly > create_p_sg(int l, Epetra_DataAccess CV=Copy, const Epetra_Vector *v=NULL) const
Create vector orthog poly using p map.
Teuchos::Array< Teuchos::RCP< Stokhos::EpetraVectorOrthogPoly > > sg_p_init
SG initial p.
Teuchos::RCP< const Stokhos::EpetraSparse3Tensor > serialCijk
Serial Epetra Cijk for dgdx*.
Teuchos::RCP< Epetra_Operator > create_DfDp_op(int i) const
Create SG operator representing df/dp.
Teuchos::RCP< const Epetra_Map > sg_f_map
Block SG residual map.
Abstract base class for orthogonal polynomial-based expansions.
Teuchos::RCP< const Epetra_Map > get_x_map() const
Return solution vector map.
Teuchos::RCP< Stokhos::EpetraVectorOrthogPoly > create_f_sg(Epetra_DataAccess CV=Copy, const Epetra_Vector *v=NULL) const
Create vector orthog poly using f map and owned sg map.
Teuchos::RCP< const Epetra_BlockMap > get_x_sg_overlap_map() const
Return x sg overlap map.
Teuchos::RCP< Stokhos::EpetraMultiVectorOrthogPoly > create_f_mv_sg_overlap(int num_vecs, Epetra_DataAccess CV=Copy, const Epetra_MultiVector *v=NULL) const
Create multi-vector orthog poly using f map and overlap sg map.
int num_g_sg
Number of stochastic response vectors.
Teuchos::RCP< const Epetra_BlockMap > stoch_row_map
Map for stochastic blocks.
const IndexType const IndexType const IndexType const IndexType const ValueType const ValueType * x
Definition: csr_vector.h:260
Teuchos::RCP< Stokhos::EpetraVectorOrthogPoly > x_dot_sg_blocks
x_dot stochastic Galerkin components
Teuchos::Array< Teuchos::RCP< const Epetra_Map > > get_g_sg_base_maps() const
Get base maps of SG responses.
Abstract base class for quadrature methods.
Teuchos::RCP< Stokhos::SGPreconditionerFactory > sg_prec_factory
Preconditioner factory.
Teuchos::RCP< Stokhos::EpetraMultiVectorOrthogPoly > create_x_mv_sg_overlap(int num_vecs, Epetra_DataAccess CV=Copy, const Epetra_MultiVector *v=NULL) const
Create vector orthog poly using x map and overlap sg map.
Teuchos::RCP< Epetra_Operator > create_DgDx_dot_op(int j) const
Create SG operator representing dg/dxdot.
A container class storing an orthogonal polynomial whose coefficients are vectors, operators, or in general any type that would have an expensive copy constructor.
Teuchos::RCP< const Epetra_Vector > get_p_init(int l) const
Return initial parameters.
Teuchos::RCP< const Stokhos::OrthogPolyBasis< int, double > > sg_basis
Stochastic Galerkin basis.
Top-level namespace for Stokhos classes and functions.
Teuchos::RCP< EpetraExt::BlockVector > import_solution(const Epetra_Vector &x) const
Import parallel solution vector.
Teuchos::Array< Teuchos::RCP< const Epetra_Map > > sg_p_map
Block SG parameter map.
Teuchos::RCP< Stokhos::EpetraVectorOrthogPoly > create_x_sg(Epetra_DataAccess CV=Copy, const Epetra_Vector *v=NULL) const
Create vector orthog poly using x map and owned sg map.
bool supports_x
Whether we support x (and thus f and W)
void set_p_sg_init(int i, const Stokhos::EpetraVectorOrthogPoly &p_sg_in)
Set initial parameter polynomial.
Teuchos::RCP< Stokhos::SGOperator > my_W
W pointer for evaluating W with f.
Teuchos::RCP< const Teuchos::Array< std::string > > get_p_names(int l) const
Return array of parameter names.
Teuchos::RCP< Epetra_Export > sg_overlapped_f_exporter
Exporter from SG-overlapped to SG maps.
Teuchos::RCP< EpetraExt::BlockVector > export_residual(const Epetra_Vector &f_overlapped) const
Export parallel residual vector.
Teuchos::RCP< EpetraExt::BlockVector > export_solution(const Epetra_Vector &x_overlapped) const
Export parallel solution vector.
Teuchos::Array< Teuchos::RCP< Teuchos::Array< std::string > > > sg_p_names
SG coefficient parameter names.
Teuchos::RCP< EpetraExt::ModelEvaluator > me
Underlying model evaluator.
unsigned int num_W_blocks
Number of W stochastic blocks (may be smaller than num_sg_blocks)
OutArgs createOutArgs() const
Create OutArgs.
void set_x_sg_init(const Stokhos::EpetraVectorOrthogPoly &x_sg_in)
Set initial solution polynomial.
InArgs createInArgs() const
Create InArgs.
Teuchos::Array< int > get_p_sg_map_indices() const
Get indices of SG parameters.
Teuchos::RCP< Epetra_Operator > create_DgDp_op(int j, int i) const
Create SG operator representing dg/dp.
Teuchos::RCP< const Epetra_BlockMap > overlapped_stoch_row_map
Overlapped map for stochastic blocks (local map)
ScalarType f(const Teuchos::Array< ScalarType > &x, double a, double b)
int num_g
Number of response vectors of underlying model evaluator.
int num_p
Number of parameter vectors of underlying model evaluator.
Teuchos::RCP< Epetra_Import > sg_overlapped_x_importer
Importer from SG to SG-overlapped maps.
Teuchos::RCP< Stokhos::EpetraVectorOrthogPoly > create_f_sg_overlap(Epetra_DataAccess CV=Copy, const Epetra_Vector *v=NULL) const
Create vector orthog poly using f map and overlap sg map.
Base class for stochastic Galerkin model evaluators.
Teuchos::RCP< Stokhos::EpetraMultiVectorOrthogPoly > create_x_mv_sg(int num_vecs, Epetra_DataAccess CV=Copy, const Epetra_MultiVector *v=NULL) const
Create vector orthog poly using x map and owned sg map.
Teuchos::RCP< const Epetra_Import > get_x_sg_importer() const
Return x sg importer.
Teuchos::RCP< Epetra_Operator > create_W() const
Create W = alpha*M + beta*J matrix.
Teuchos::RCP< Epetra_Vector > my_x
x pointer for evaluating preconditioner
Teuchos::RCP< Teuchos::ParameterList > params
Algorithmic parameters.
Teuchos::Array< int > sg_p_index_map
Index map between block-p and p_sg maps.
Epetra_DataAccess
Teuchos::RCP< const Epetra_Map > f_map
Underlying residual map.
Teuchos::RCP< Stokhos::EpetraVectorOrthogPoly > create_x_sg_overlap(Epetra_DataAccess CV=Copy, const Epetra_Vector *v=NULL) const
Create vector orthog poly using x map and overlap sg map.
Teuchos::RCP< Epetra_Operator > create_DgDx_op(int j) const
Create SG operator representing dg/dx.
Teuchos::RCP< Stokhos::OrthogPolyExpansion< int, double > > sg_exp
Stochastic Galerkin expansion.
Teuchos::Array< int > get_g_sg_map_indices() const
Get indices of SG responses.
Teuchos::RCP< const Stokhos::Quadrature< int, double > > sg_quad
Stochastic Galerkin quadrature.
Teuchos::RCP< const Epetra_Map > sg_x_map
Block SG unknown map.
Teuchos::RCP< const EpetraExt::MultiComm > sg_comm
Parallel SG communicator.