cs_gwf_tracer.h

Go to the documentation of this file.

#ifndef __CS_GWF_TRACER_H__
#define __CS_GWF_TRACER_H__
 
/*============================================================================
 * Set of main functions to handle soils in the groundwater flow module
 * when using CDO schemes
 *============================================================================*/
 
/*
  This file is part of Code_Saturne, a general-purpose CFD tool.
 
  Copyright (C) 1998-2019 EDF S.A.
 
  This program is free software; you can redistribute it and/or modify it under
  the terms of the GNU General Public License as published by the Free Software
  Foundation; either version 2 of the License, or (at your option) any later
  version.
 
  This program is distributed in the hope that it will be useful, but WITHOUT
  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
  details.
 
  You should have received a copy of the GNU General Public License along with
  this program; if not, write to the Free Software Foundation, Inc., 51 Franklin
  Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
 
/*----------------------------------------------------------------------------*/
 
/*----------------------------------------------------------------------------
 *  Local headers
 *----------------------------------------------------------------------------*/
 
#include "cs_advection_field.h"
#include "cs_base.h"
#include "cs_equation.h"
 
/*----------------------------------------------------------------------------*/
 
BEGIN_C_DECLS
 
/*============================================================================
 * Macro definitions
 *============================================================================*/
 
/*============================================================================
 * Public function pointer prototypes
 *============================================================================*/
 
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
 
typedef void
(cs_gwf_tracer_update_t) (void                        *input,
                          const cs_mesh_t             *mesh,
                          const cs_cdo_connect_t      *connect,
                          const cs_cdo_quantities_t   *quant,
                          cs_real_t                    t_eval);
 
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
 
typedef void
(cs_gwf_tracer_free_input_t) (void      *input);
 
/*============================================================================
 * Structure definitions
 *============================================================================*/
 
/* Type of predefined modelling for the groundwater flows */
typedef enum {
 
  CS_GWF_TRACER_STANDARD, /* Default behavior of a tracer in groundwater flow
                            module */
  CS_GWF_TRACER_USER,     /* User-defined behavior */
  CS_GWF_N_TRACER_MODELS
 
} cs_gwf_tracer_model_t;
 
/* Set of parameters related to a tracer equation attached to a standard
   modelling */
 
typedef struct {
 
  /* Parameters (array of size: n_soils) */
  double    *rho_kd;        // Bulk density times the distribution coefficient
  double    *alpha_l;       // Longitudinal dispersivity
  double    *alpha_t;       // Transversal dispersivity
  double    *wmd;           // Water molecular diffusivity
  double    *reaction_rate; /* First order decay coefficient (related to the
                               reaction term) */
 
  /* Variables used for the update of physical properties */
  cs_field_t   *darcy_velocity_field;
  cs_field_t   *moisture_content;
 
} cs_gwf_std_tracer_input_t;
 
/* Set of parameters describing a tracer */
typedef struct {
 
  int                          id;       /* tracer id */
  cs_equation_t               *eq;       /* related equation */
 
  /* Physical modelling adopted for this tracer */
  cs_gwf_tracer_model_t        model;
 
  cs_field_t                  *diffusivity; /* NULL if no diffusion term is
                                               build in the tracer equation */
  int                          reaction_id; /* id related to the reaction
                                               term in the tracer equation */
 
  /* Pointer to an input structure according to the model */
  void                        *input;
 
  /* Pointers to functions */
  cs_gwf_tracer_update_t      *update_properties;
  cs_gwf_tracer_free_input_t  *free_input;
 
} cs_gwf_tracer_t;
 
/*============================================================================
 * Public function pointer prototypes
 *============================================================================*/
 
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
 
typedef void
(cs_gwf_tracer_setup_t) (const cs_cdo_connect_t      *connect,
                         const cs_cdo_quantities_t   *quant,
                         cs_gwf_tracer_t             *tracer);
 
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
 
typedef void
(cs_gwf_tracer_add_terms_t) (cs_gwf_tracer_t             *tracer);
 
/*============================================================================
 * Public function prototypes
 *============================================================================*/
 
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
 
cs_gwf_tracer_t *
cs_gwf_tracer_init(int                      tracer_id,
                   const char              *eq_name,
                   const char              *var_name,
                   cs_adv_field_t          *adv_field,
                   cs_gwf_tracer_model_t    model);
 
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
 
cs_gwf_tracer_t *
cs_gwf_tracer_free(cs_gwf_tracer_t     *tracer);
 
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
 
void
cs_gwf_set_standard_tracer(cs_gwf_tracer_t   *tracer,
                           const char        *soil_name,
                           double             wmd,
                           double             alpha_l,
                           double             alpha_t,
                           double             distrib_coef,
                           double             reaction_rate);
 
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
 
void
cs_gwf_tracer_standard_add_terms(cs_gwf_tracer_t     *tracer);
 
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
 
void
cs_gwf_tracer_standard_setup(const cs_cdo_connect_t      *connect,
                             const cs_cdo_quantities_t   *quant,
                             cs_gwf_tracer_t             *tracer);
 
/*----------------------------------------------------------------------------*/
 
END_C_DECLS
 
#endif /* __CS_GWF_TRACER_H__ */