cs_domain.h

Go to the documentation of this file.

#ifndef __CS_DOMAIN_H__
#define __CS_DOMAIN_H__
 
/*============================================================================
 * Manage a computational domain
 *  - equations, settings, fields, connectivities and geometrical quantities
 *============================================================================*/
 
/*
  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.
*/
 
/*----------------------------------------------------------------------------
 *  Standard C library headers
 *----------------------------------------------------------------------------*/
 
#include <stdbool.h>
 
/*----------------------------------------------------------------------------
 *  Local headers
 *----------------------------------------------------------------------------*/
 
#include "cs_boundary.h"
#include "cs_cdo_connect.h"
#include "cs_cdo_quantities.h"
#include "cs_mesh.h"
#include "cs_mesh_quantities.h"
#include "cs_time_step.h"
#include "cs_timer.h"
#include "cs_xdef.h"
 
/*----------------------------------------------------------------------------*/
 
BEGIN_C_DECLS
 
/*============================================================================
 * Macro definitions
 *============================================================================*/
 
/* Flag related to the activation (or not) of the CDO schemes */
#define CS_DOMAIN_CDO_MODE_OFF     -1  /* CDO schemes are not used */
#define CS_DOMAIN_CDO_MODE_WITH_FV  1  /* CDO and legacy FV schemes are used */
#define CS_DOMAIN_CDO_MODE_ONLY     2  /* CDO schemes are exclusively used */
 
/*============================================================================
 * Type definitions
 *============================================================================*/
 
typedef struct {
 
  /* Mode for CDO: activated, switched off... */
  int                       mode;
 
  /* Flag to know if scalar or vector equations are requested and which kind
     of numerical schemes is requested to solve these equations */
  cs_flag_t                 fb_scheme_flag;
  cs_flag_t                 vb_scheme_flag;
  cs_flag_t                 vcb_scheme_flag;
  cs_flag_t                 hho_scheme_flag;
 
} cs_domain_cdo_context_t;
 
typedef struct {
 
  /* Code_Saturne mesh and mesh quantities structures already computed */
  cs_mesh_t                *mesh;
  cs_mesh_quantities_t     *mesh_quantities;
 
  /* CDO structures:
   * - cs_cdo_connect_t contains additional information about connectivity
   * - cs_cdo_quantities_t contains additional information on mesh quantities
   */
  cs_cdo_connect_t         *connect;
  cs_cdo_quantities_t      *cdo_quantities;
 
  /* Boundary of the computational domain */
  cs_boundary_t            *boundaries;
  cs_boundary_t            *ale_boundaries;
 
  /* Time step management */
  bool                      only_steady;
  bool                      is_last_iter;     /* true or false */
  cs_xdef_t                *time_step_def;    /* Definition of the time_step */
  cs_time_step_t           *time_step;        /* time step descriptor */
  cs_time_step_options_t    time_options;     /* time step options */
 
  /* Output options */
  int                       output_nt;   /* Logging done every nt iterations */
  int                       restart_nt;  /* Restart done every nt iterations */
  int                       verbosity;   /* Level of details given in log */
 
  /* Specific context structure related to the numerical schemes */
  cs_domain_cdo_context_t   *cdo_context;
 
  /* Monitoring */
  cs_timer_counter_t    tcp; /* Cumulated elapsed time for extra-operations
                                and post-processing */
  cs_timer_counter_t    tcs; /* Cumulated elapsed time for setup operations */
 
} cs_domain_t;
 
/*============================================================================
 * Static global variables
 *============================================================================*/
 
extern cs_domain_t *cs_glob_domain; /* Pointer to main computational domain */
 
/*============================================================================
 * Static inline public function prototypes
 *============================================================================*/
 
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
 
static inline void
cs_domain_increment_time_step(cs_domain_t  *domain)
{
  cs_time_step_t  *ts = domain->time_step;
 
  /* Increment time iteration */
  ts->nt_cur++;
}
 
/*============================================================================
 * Public function prototypes
 *============================================================================*/
 
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
 
cs_domain_t *
cs_domain_create(void);
 
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
 
void
cs_domain_free(cs_domain_t   **p_domain);
 
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
 
void
cs_domain_set_cdo_mode(cs_domain_t    *domain,
                       int             mode);
 
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
 
int
cs_domain_get_cdo_mode(const cs_domain_t   *domain);
 
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
 
bool
cs_domain_needs_iteration(cs_domain_t  *domain);
 
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
 
bool
cs_domain_needs_log(const cs_domain_t      *domain);
 
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
 
void
cs_domain_define_current_time_step(cs_domain_t   *domain);
 
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
 
void
cs_domain_increment_time(cs_domain_t  *domain);
 
/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
 
void
cs_domain_cdo_log(const cs_domain_t   *domain);
 
/*----------------------------------------------------------------------------*/
 
END_C_DECLS
 
#endif /* __CS_DOMAIN_H__ */