OpenFCST: The open-source Fuel Cell Simulation Toolbox
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
proton_transport_equation.h
Go to the documentation of this file.
1 //---------------------------------------------------------------------------
2 //
3 // FCST: Fuel Cell Simulation Toolbox
4 //
5 // Copyright (C) 2013 by Energy Systems Design Laboratory, University of Alberta
6 //
7 // This software is distributed under the MIT License.
8 // For more information, see the README file in /doc/LICENSE
9 //
10 // - Class: proton_transport_equation.h
11 // - Description: Equation class for Proton Transport (using Ohm's law)
12 // - Developers: Madhur Bhaiya, M. Secanell, Valentin N. Zingan
13 // - Id: $Id: proton_transport_equation.h 2605 2014-08-15 03:36:44Z secanell $
14 //
15 //---------------------------------------------------------------------------
16 
17 #ifndef _FCST_FUELCELLSHOP_EQUATION_PROTON_TRANSPORT_EQUATION_H_
18 #define _FCST_FUELCELLSHOP_EQUATION_PROTON_TRANSPORT_EQUATION_H_
19 
20 // FCST includes
21 #include "utils/fcst_utilities.h"
22 #include "utils/fcst_constants.h"
23 
25 
26 #include "layers/catalyst_layer.h"
27 #include "layers/membrane_layer.h"
28 
29 
30 // STD
31 #include <sstream>
32 #include <string>
33 
34 namespace FuelCellShop
35 {
36  namespace Equation
37  {
137  template<int dim>
139  {
140  public:
141 
143 
144 
149 
153  virtual ~ProtonTransportEquation();
154 
158  virtual void declare_parameters(ParameterHandler& param) const;
159 
163  virtual void initialize(ParameterHandler& param);
164 
166 
169 
175 
182 
189 
196 
198 
200 
201 
205  virtual void print_equation_info() const;
206 
211  inline std::map<unsigned int, double> get_dirichlet_bdry_map() const
212  {
213  return dirichlet_bdry_map;
214  }
215 
220  void class_test();
222 
223  protected:
225 
226 
231  std::map<unsigned int, double> dirichlet_bdry_map;
232 
237  std::map<unsigned int, double> proton_current_flux_map;
238 
240 
242 
243 
249 
259 
269 
276 
283 
285 
287 
288 
293  virtual void make_internal_cell_couplings();
294 
299  virtual void make_boundary_types();
300 
305  virtual void make_output_types()
306  {};
307 
309 
311 
312 
316 
321 
326 
328 
330 
331 
336  std::vector<double> sigmaMeff_cell;
337 
343  std::vector<double> dsigmaMeff_dlambda_cell;
344 
350  std::vector<double> dsigmaMeff_dT_cell;
351 
359  std::vector< std::vector< Tensor<1,dim> > > grad_phi_phiM_cell;
360 
368  std::vector< std::vector<double> > phi_lambda_cell;
369 
377  std::vector< std::vector<double> > phi_T_cell;
378 
380 
382 
383 
391  std::vector< std::vector<double> > phi_phiM_bdry;
392 
394 
400 
406 
411  unsigned int last_iter_cell;
412 
417  unsigned int last_iter_bdry;
418 
419  };
420  } // Equation
421 } // FuelCellShop
422 
423 #endif
std::map< unsigned int, double > get_dirichlet_bdry_map() const
Method to provide access to Dirichlet boundary conditions map filled using the parameter file...
Definition: proton_transport_equation.h:211
std::vector< std::vector< Tensor< 1, dim > > > grad_phi_phiM_cell
shape function gradients.
Definition: proton_transport_equation.h:359
virtual void declare_parameters(ParameterHandler &param) const
Declare parameters.
void class_test()
This member function creates an object of its own type and runs test to diagnose if there are any pro...
virtual void print_equation_info() const
The function prints out the equation&#39;s info.
unsigned int last_iter_cell
Variable used to store the index in cell_info-&gt;global_data of the previous Newton solution The soluti...
Definition: proton_transport_equation.h:411
This class deals with Proton Transport Equation.
Definition: proton_transport_equation.h:138
FuelCell::SystemManagement * system_management
Pointer to the external YourApplication&lt;dim&gt;::system_management object.
Definition: equation_base.h:817
virtual void make_output_types()
This function fills out output_types.
Definition: proton_transport_equation.h:305
bool bdry_residual_counter
Counter set to TRUE when bdry_residual is being assembled.
Definition: proton_transport_equation.h:405
virtual void make_assemblers_cell_constant_data(const typename FuelCell::ApplicationCore::DoFApplication< dim >::CellInfo &cell_info)
This function computes Local CG FEM based assemblers - constant data (cell) and allocates the memor...
std::vector< double > sigmaMeff_cell
Effective proton conductivity, [S/cm], at all quadrature points of the cell.
Definition: proton_transport_equation.h:336
virtual void make_assemblers_bdry_constant_data(const typename FuelCell::ApplicationCore::DoFApplication< dim >::FaceInfo &bdry_info)
This function computes Local CG FEM based assemblers - constant data (boundary) and allocates the m...
ProtonTransportEquation(FuelCell::SystemManagement &system_management)
Constructor.
virtual void make_assemblers_generic_constant_data()
This function computes Local CG FEM based assemblers - constant data (generic).
virtual void make_boundary_types()
This function fills out boundary_types.
std::vector< std::vector< double > > phi_T_cell
shape functions.
Definition: proton_transport_equation.h:377
This class is created for the objects handed to the mesh loops.
Definition: mesh_loop_info_objects.h:625
virtual void assemble_cell_matrix(FuelCell::ApplicationCore::MatrixVector &cell_matrices, const typename FuelCell::ApplicationCore::DoFApplication< dim >::CellInfo &cell_info, FuelCellShop::Layer::BaseLayer< dim > *const layer)
Assemble local cell matrix.
std::vector< MatrixBlock< FullMatrix< double > > > MatrixVector
The matrix vector used in the mesh loops.
Definition: matrix_block.h:102
virtual void assemble_cell_residual(FuelCell::ApplicationCore::FEVector &cell_rhs, const typename FuelCell::ApplicationCore::DoFApplication< dim >::CellInfo &cell_info, FuelCellShop::Layer::BaseLayer< dim > *const layer)
Assemble local cell residual.
std::vector< std::vector< double > > phi_lambda_cell
shape functions.
Definition: proton_transport_equation.h:368
VariableInfo phi_m
VariableInfo structure corresponding to &quot;protonic_electrical_potential&quot;.
Definition: proton_transport_equation.h:315
virtual void initialize(ParameterHandler &param)
Initialize parameters.
std::map< unsigned int, double > proton_current_flux_map
std::map&lt; unsigned int, double &gt; container for details regarding Galvanostatic boundary conditions...
Definition: proton_transport_equation.h:237
virtual void make_internal_cell_couplings()
This function fills out internal_cell_couplings.
virtual void make_assemblers_cell_variable_data(const typename FuelCell::ApplicationCore::DoFApplication< dim >::CellInfo &cell_info, FuelCellShop::Layer::BaseLayer< dim > *const layer)
This function computes Local CG FEM based assemblers - variable data (cell) .
This class contains generic data and methods heavily used by all derived equation classes...
Definition: equation_base.h:199
VariableInfo lambda
VariableInfo structure corresponding to &quot;membrane_water_content&quot;.
Definition: proton_transport_equation.h:320
virtual void assemble_bdry_matrix(FuelCell::ApplicationCore::MatrixVector &bdry_matrices, const typename FuelCell::ApplicationCore::DoFApplication< dim >::FaceInfo &bdry_info, FuelCellShop::Layer::BaseLayer< dim > *const layer)
Assemble local boundary matrix.
IMPORTANT: Add all new solution variables and equations here !
Definition: system_management.h:271
This simple structure stores certain information regarding a particular variable for the equation (al...
Definition: equation_base.h:121
std::vector< std::vector< double > > phi_phiM_bdry
shape functions.
Definition: proton_transport_equation.h:391
virtual void make_assemblers_bdry_variable_data(const typename FuelCell::ApplicationCore::DoFApplication< dim >::FaceInfo &bdry_info, FuelCellShop::Layer::BaseLayer< dim > *const layer)
This function computes Local CG FEM based assemblers - variable data (boundary) .
unsigned int last_iter_bdry
Variable used to store the index in bdry_info-&gt;global_data of the previous Newton solution The soluti...
Definition: proton_transport_equation.h:417
virtual void assemble_bdry_residual(FuelCell::ApplicationCore::FEVector &bdry_rhs, const typename FuelCell::ApplicationCore::DoFApplication< dim >::FaceInfo &bdry_info, FuelCellShop::Layer::BaseLayer< dim > *const layer)
Assemble local boundary residual.
VariableInfo t_rev
VariableInfo structure corresponding to &quot;temperature_of_REV&quot;.
Definition: proton_transport_equation.h:325
bool cell_residual_counter
Counter set to TRUE when cell_residual is being assembled.
Definition: proton_transport_equation.h:399
BlockVector< double > FEVector
The vector class used by applications.
Definition: application_data.h:39
std::vector< double > dsigmaMeff_dlambda_cell
Derivative of effective protonic conductivity w.r.t.
Definition: proton_transport_equation.h:343
Virtual class used to characterize a generic layer interface.
Definition: base_layer.h:58
std::vector< double > dsigmaMeff_dT_cell
Derivative of effective protonic conductivity w.r.t &quot;temperature_of_REV&quot;, at all quadrature points in...
Definition: proton_transport_equation.h:350
std::map< unsigned int, double > dirichlet_bdry_map
std::map&lt; unsigned int, double &gt; container for Dirichlet boundary conditions.
Definition: proton_transport_equation.h:231