OpenFCST: The open-source Fuel Cell Simulation Toolbox
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
lambda_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: lambda_transport_equation.h
11 // - Description: Equation class for Lambda Transport (using Springer Model + Thermal Osmosis)
12 // - Developers: Marc Secanell, Madhur Bhaiya, Valentin N. Zingan
13 // - Id: $Id: lambda_transport_equation.h 2605 2014-08-15 03:36:44Z secanell $
14 //
15 //---------------------------------------------------------------------------
16 
17 #ifndef _FCST_FUELCELLSHOP_EQUATION_LAMBDA_TRANSPORT_EQUATION_H_
18 #define _FCST_FUELCELLSHOP_EQUATION_LAMBDA_TRANSPORT_EQUATION_H_
19 
20 // FCST includes
21 #include "utils/fcst_constants.h"
22 #include "utils/fcst_utilities.h"
23 
25 
26 #include "layers/catalyst_layer.h"
27 #include "layers/membrane_layer.h"
28 
29 // STD
30 #include <sstream>
31 #include <string>
32 
33 namespace FuelCellShop
34 {
35  namespace Equation
36  {
132  template<int dim>
134  {
135  public:
136 
138 
139 
144 
148  virtual ~LambdaTransportEquation();
149 
153  virtual void declare_parameters(ParameterHandler& param) const;
154 
158  virtual void initialize(ParameterHandler& param);
159 
161 
164 
170 
177 
184  FuelCellShop::Layer::BaseLayer<dim>* const layer){};
185 
192  FuelCellShop::Layer::BaseLayer<dim>* const layer){};
193 
195 
197 
198 
202  virtual void print_equation_info() const;
203 
205 
206  protected:
207 
209 
210 
215 
217 
219 
220 
226 
236 
248 
255 
263  FuelCellShop::Layer::BaseLayer<dim>* const layer){};
264 
266 
268 
269 
274  virtual void make_internal_cell_couplings();
275 
282  virtual void make_boundary_types(){};
283 
290  virtual void make_output_types()
291  {};
292 
294 
296 
297 
302 
307 
312 
316  double F;
317 
321  double M_water;
322 
324 
326 
327 
331  double rho_dry_cell;
332 
336  double EW_cell;
337 
341  std::vector<double> nDrag_cell;
342 
347  std::vector<double> dnDrag_dlambda_cell;
348 
353  std::vector<double> sigmaMeff_cell;
354 
360  std::vector<double> dsigmaMeff_dT_cell;
361 
367  std::vector<double> dsigmaMeff_dlambda_cell;
368 
373  std::vector<double> Dlambdaeff_cell;
374 
380  std::vector<double> dDlambdaeff_dT_cell;
381 
387  std::vector<double> dDlambdaeff_dlambda_cell;
388 
393  std::vector<double> DTeff_cell;
394 
400  std::vector<double> dDTeff_dT_cell;
401 
409  std::vector< std::vector<double> > phi_lambda_cell;
410 
418  std::vector< std::vector< Tensor<1,dim> > > grad_phi_lambda_cell;
419 
427  std::vector< std::vector< double > > phi_T_cell;
428 
436  std::vector< std::vector< Tensor<1,dim> > > grad_phi_T_cell;
437 
445  std::vector< std::vector< Tensor<1,dim> > > grad_phi_phiM_cell;
446 
448 
454 
459  unsigned int last_iter_cell;
460 
461  };
462  } // Equation
463 } // FuelCellShop
464 
465 #endif
std::vector< double > nDrag_cell
Electro-osmotic drag coefficient, at all quadrature points in the cell.
Definition: lambda_transport_equation.h:341
double rho_dry_cell
Density [gm/cm^3] of the dry polymer electrolyte material in the cell.
Definition: lambda_transport_equation.h:331
std::vector< std::vector< double > > phi_lambda_cell
shape functions.
Definition: lambda_transport_equation.h:409
virtual void make_boundary_types()
This function fills out boundary_types.
Definition: lambda_transport_equation.h:282
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: lambda_transport_equation.h:459
std::vector< double > DTeff_cell
Effecive thermo-osmotic diffusion coefficient [gm/(cm-s-K)], at all quadrature points in the cell...
Definition: lambda_transport_equation.h:393
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.
Definition: lambda_transport_equation.h:190
std::vector< double > Dlambdaeff_cell
Effecive lambda (sorbed water) diffusivity [cm^2/s], at all quadrature points in the cell...
Definition: lambda_transport_equation.h:373
LambdaTransportEquation(FuelCell::SystemManagement &system_management)
Constructor.
std::vector< std::vector< Tensor< 1, dim > > > grad_phi_T_cell
shape function gradients.
Definition: lambda_transport_equation.h:436
std::vector< double > dsigmaMeff_dlambda_cell
Derivative of effective protonic conductivity w.r.t.
Definition: lambda_transport_equation.h:367
std::vector< double > dDTeff_dT_cell
Derivative of effective thermo-osmotic diffusion coefficient w.r.t.
Definition: lambda_transport_equation.h:400
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.
FuelCell::SystemManagement * system_management
Pointer to the external YourApplication&lt;dim&gt;::system_management object.
Definition: equation_base.h:817
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) .
Definition: lambda_transport_equation.h:262
virtual void print_equation_info() const
The function prints out the equation&#39;s info.
bool cell_residual_counter
Counter set to TRUE when cell_residual is being assembled.
Definition: lambda_transport_equation.h:453
std::vector< double > dnDrag_dlambda_cell
Derivative of electro-osmotic drag coefficient w.r.t.
Definition: lambda_transport_equation.h:347
This class deals with Membrane Water Content Transport Equation.
Definition: lambda_transport_equation.h:133
double F
Universal Faraday&#39;s constant.
Definition: lambda_transport_equation.h:316
virtual void make_output_types()
This function fills out output_types.
Definition: lambda_transport_equation.h:290
std::vector< std::vector< double > > phi_T_cell
shape functions.
Definition: lambda_transport_equation.h:427
bool flag_thermoosmosis
Flag to indicate that lambda (sorbed water) transport by Thermo-osmosis is ON or OFF.
Definition: lambda_transport_equation.h:214
virtual void make_internal_cell_couplings()
This function fills out internal_cell_couplings.
This class is created for the objects handed to the mesh loops.
Definition: mesh_loop_info_objects.h:625
std::vector< double > dDlambdaeff_dlambda_cell
Derivative of effective lambda diffusivity w.r.t.
Definition: lambda_transport_equation.h:387
std::vector< MatrixBlock< FullMatrix< double > > > MatrixVector
The matrix vector used in the mesh loops.
Definition: matrix_block.h:102
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 > dDlambdaeff_dT_cell
Derivative of effective lambda diffusivity w.r.t.
Definition: lambda_transport_equation.h:380
std::vector< double > sigmaMeff_cell
Effective proton conductivity [S/cm], at all quadrature points of the cell.
Definition: lambda_transport_equation.h:353
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: lambda_transport_equation.h:360
virtual void initialize(ParameterHandler &param)
Initialize parameters.
std::vector< std::vector< Tensor< 1, dim > > > grad_phi_lambda_cell
shape function gradients.
Definition: lambda_transport_equation.h:418
virtual void make_assemblers_generic_constant_data()
This function computes Local CG FEM based assemblers - constant data (generic).
VariableInfo t_rev
VariableInfo structure corresponding to &quot;temperature_of_REV&quot;.
Definition: lambda_transport_equation.h:311
This class contains generic data and methods heavily used by all derived equation classes...
Definition: equation_base.h:199
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.
VariableInfo lambda
VariableInfo structure corresponding to &quot;membrane_water_content&quot;.
Definition: lambda_transport_equation.h:306
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
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.
Definition: lambda_transport_equation.h:182
double M_water
Molar weight of water in grams/mole.
Definition: lambda_transport_equation.h:321
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) .
double EW_cell
Equivalent weight of the polymer electrolyte material in the cell.
Definition: lambda_transport_equation.h:336
BlockVector< double > FEVector
The vector class used by applications.
Definition: application_data.h:39
std::vector< std::vector< Tensor< 1, dim > > > grad_phi_phiM_cell
shape function gradients.
Definition: lambda_transport_equation.h:445
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...
Definition: lambda_transport_equation.h:247
Virtual class used to characterize a generic layer interface.
Definition: base_layer.h:58
VariableInfo phi_m
VariableInfo structure corresponding to &quot;protonic_electrical_potential&quot;.
Definition: lambda_transport_equation.h:301
virtual void declare_parameters(ParameterHandler &param) const
Declare parameters.