saturation_transport_equation.h

Go to the documentation of this file.

//---------------------------------------------------------------------------
//
//    FCST: Fuel Cell Simulation Toolbox
//
//    Copyright (C) 2013 by Energy Systems Design Laboratory, University of Alberta
//
//    This software is distributed under the MIT License.
//    For more information, see the README file in /doc/LICENSE
//
//    - Class: saturation_transport_equation.h
//    - Description: Equation class for liquid water saturation transport due to capillary diffusion
//    - Developers: Madhur Bhaiya
//
//---------------------------------------------------------------------------

#ifndef _FCST_FUELCELLSHOP_EQUATION_SATURATION_TRANSPORT_EQUATION_H_
#define _FCST_FUELCELLSHOP_EQUATION_SATURATION_TRANSPORT_EQUATION_H_

// FCST includes
#include <utils/fcst_units.h>
#include <materials/PureLiquid.h>

#include <equations/equation_base.h>

#include <layers/gas_diffusion_layer.h>
#include <layers/micro_porous_layer.h>
#include <layers/catalyst_layer.h>

// STD
#include <sstream>
#include <string>

namespace FuelCellShop
{
    namespace Equation
    {
        template<int dim>
        class SaturationTransportEquation : public EquationBase<dim>
        {
        public:
            

            
            SaturationTransportEquation(FuelCell::SystemManagement& system_management,boost::shared_ptr< FuelCell::ApplicationCore::ApplicationData > data = 
            boost::shared_ptr< FuelCell::ApplicationCore::ApplicationData >());
            
            virtual ~SaturationTransportEquation();
            
            virtual void declare_parameters(ParameterHandler& param) const;
            
            virtual void initialize(ParameterHandler& param);
            
            


            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);
            
            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);
            
            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){};
            
            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){};
            
            

            
            virtual void print_equation_info() const;
            
            double get_kevap() const
            {
                return k_e;
            }
            
            double get_kcond() const
            {
                return k_c;
            }

            
        protected:


            
            virtual void make_assemblers_generic_constant_data();
            
            virtual void make_assemblers_cell_constant_data(const typename FuelCell::ApplicationCore::DoFApplication<dim>::CellInfo& cell_info);
            
            virtual void make_assemblers_bdry_constant_data(const typename FuelCell::ApplicationCore::DoFApplication<dim>::FaceInfo& bdry_info){};
            
            virtual void make_assemblers_cell_variable_data(const typename FuelCell::ApplicationCore::DoFApplication<dim>::CellInfo& cell_info,
                                                            FuelCellShop::Layer::BaseLayer<dim>* const layer);
            
            virtual void make_assemblers_bdry_variable_data(const typename FuelCell::ApplicationCore::DoFApplication<dim>::FaceInfo& bdry_info,
                                                            FuelCellShop::Layer::BaseLayer<dim>* const layer){};
            
            

            
            virtual void make_internal_cell_couplings();
            
            virtual void make_boundary_types(){};
            
            virtual void make_output_types()
            {};
            
            


            VariableInfo s_liquid_water;
            
            VariableInfo x_water;
            
            VariableInfo t_rev;
            
            unsigned int fickswater_blockindex_xwater;
            
            unsigned int fickswater_blockindex_sliquid;
            
            unsigned int fickswater_blockindex_trev;
            
            unsigned int thermal_blockindex_xwater;
            
            unsigned int thermal_blockindex_sliquid;
            
            unsigned int thermal_blockindex_trev;
            
            double M_water;
            
            double k_e;
            double k_c;
            
            double rho_l;
            
            

            
            double p_cell;
            
            std::vector<double> area_lv_cell;
            
            std::vector<double> darea_lv_ds_cell;
            
            std::vector< Tensor<2,dim> > rhok_mu_dpcds_cell;
            
            std::vector< Tensor<2,dim> > ds_rhok_mu_dpcds_cell;
            
            std::vector< Tensor<2,dim> > dT_rhok_mu_dpcds_cell;

            std::vector< std::vector<double> > phi_s_cell;
            
            std::vector< std::vector<double> > phi_xwater_cell;
            
            std::vector< std::vector<double> > phi_T_cell;
                   
            std::vector< std::vector< Tensor<1,dim> > > grad_phi_s_cell;
            
            std::vector< std::vector< Tensor<1,dim> > > grad_phi_T_cell;
            
            
            bool cell_residual_counter;

            unsigned int last_iter_cell;
            
        };
    } // Equation    
} // FuelCellShop

#endif