8.1
general documentation
cs_atmo.h File Reference
#include "cs_base.h"
+ Include dependency graph for cs_atmo.h:

Go to the source code of this file.

Data Structures

struct  cs_atmo_option_t
 
struct  cs_atmo_constants_t
 
struct  cs_atmo_chemistry_t
 

Enumerations

enum  cs_atmo_model_t { CS_ATMO_OFF = -1 , CS_ATMO_CONSTANT_DENSITY = 0 , CS_ATMO_DRY = 1 , CS_ATMO_HUMID = 2 }
 
enum  cs_atmo_nucleation_type_t { CS_ATMO_NUC_OFF = 0 , CS_ATMO_NUC_PRUPPACHER_KLETT = 1 , CS_ATMO_NUC_COHARD = 2 , CS_ATMO_NUC_ABDUL_RAZZAK = 3 }
 
enum  cs_atmo_aerosol_type_t { CS_ATMO_AEROSOL_OFF = 0 , CS_ATMO_AEROSOL_SSH = 1 }
 
enum  cs_atmo_universal_functions_t {
  CS_ATMO_UNIV_FN_CHENG = 0 , CS_ATMO_UNIV_FN_HOGSTROM = 1 , CS_ATMO_UNIV_FN_BUSINGER = 2 , CS_ATMO_UNIV_FN_HARTOGENSIS = 3 ,
  CS_ATMO_UNIV_FN_CARL = 4
}
 
enum  cs_atmo_soil_cat_t { CS_ATMO_SOIL_5_CAT = 0 , CS_ATMO_SOIL_7_CAT = 1 , CS_ATMO_SOIL_23_CAT = 2 }
 

Functions

void cs_atmo_add_property_fields (void)
 
void cs_atmo_init_meteo_profiles (void)
 Initialize meteo profiles if no meteo file is given. More...
 
void cs_atmo_compute_meteo_profiles (void)
 Compute meteo profiles if no meteo file is given. More...
 
void cs_atmo_z_ground_compute (void)
 This function computes the ground elevation. More...
 
void cs_atmo_hydrostatic_profiles_compute (void)
 Compute hydrostatic profiles of density and pressure. More...
 
cs_real_t cs_mo_phim (cs_real_t z, cs_real_t dlmo)
 Universal function phim for neutral, stable and unstable. More...
 
cs_real_t cs_mo_phih (cs_real_t z, cs_real_t dlmo)
 Universal function phih for neutral, stable and unstable. More...
 
cs_real_t cs_mo_psim (cs_real_t z, cs_real_t z0, cs_real_t dlmo)
 Universal function psim for neutral, stable and unstable. More...
 
cs_real_t cs_mo_psih (cs_real_t z, cs_real_t z0, cs_real_t dlmo)
 Universal function psih for neutral, stable and unstable. More...
 
void cs_atmo_set_meteo_file_name (const char *file_name)
 This function set the file name of the meteo file. More...
 
void cs_atmo_set_chem_conc_file_name (const char *file_name)
 This function set the file name of the chemistry concentration file. More...
 
void cs_atmo_set_aero_conc_file_name (const char *file_name)
 This function set the file name of the aerosol concentration file. More...
 
void cs_atmo_chemistry_set_spack_file_name (const char *file_name)
 This function set the file name of the SPACK file. More...
 
void cs_atmo_chemistry_set_aerosol_file_name (const char *file_name)
 This function sets the file name to initialize the aerosol library. More...
 
void cs_atmo_declare_chem_from_spack (void)
 This function declare additional transported variables for atmospheric module for the chemistry defined from SPACK. More...
 
void cs_atmo_compute_solar_angles (cs_real_t xlat, cs_real_t xlong, cs_real_t jour, cs_real_t heurtu, int imer, cs_real_t *albe, cs_real_t *za, cs_real_t *muzero, cs_real_t *omega, cs_real_t *fo)
 1D Radiative scheme - Solar data + zenithal angle) More...
 
void cs_atmo_log_setup (void)
 Print the atmospheric module options to setup.log. More...
 
void cs_atmo_chemistry_log_setup (void)
 Print the atmospheric chemistry options to setup.log. More...
 
void cs_atmo_aerosol_log_setup (void)
 Print the atmospheric aerosols options to setup.log. More...
 
void cs_atmo_finalize (void)
 Deallocate arrays for atmo module. More...
 
void cs_user_soil_model (void)
 Allow call of cs_user fonctions during soil model computation. More...
 
void cs_soil_model (void)
 Compute soil and interface values using Deardorff force restore method. More...
 

Variables

cs_atmo_option_tcs_glob_atmo_option
 
cs_atmo_constants_tcs_glob_atmo_constants
 
cs_atmo_chemistry_tcs_glob_atmo_chemistry
 

Enumeration Type Documentation

◆ cs_atmo_aerosol_type_t

Enumerator
CS_ATMO_AEROSOL_OFF 
CS_ATMO_AEROSOL_SSH 

◆ cs_atmo_model_t

Enumerator
CS_ATMO_OFF 
CS_ATMO_CONSTANT_DENSITY 
CS_ATMO_DRY 
CS_ATMO_HUMID 

◆ cs_atmo_nucleation_type_t

Enumerator
CS_ATMO_NUC_OFF 
CS_ATMO_NUC_PRUPPACHER_KLETT 
CS_ATMO_NUC_COHARD 
CS_ATMO_NUC_ABDUL_RAZZAK 

◆ cs_atmo_soil_cat_t

Enumerator
CS_ATMO_SOIL_5_CAT 

5 categories: water, forest, diverse, mineral, building

CS_ATMO_SOIL_7_CAT 

7 categories: water, forest, diverse, mineral, diffuse buildings, mixtie buildings, dense buildings

CS_ATMO_SOIL_23_CAT 

Roughness length classification of Corine land cover classes Julieta Silva et al. doi=10.1.1.608.2707

◆ cs_atmo_universal_functions_t

Enumerator
CS_ATMO_UNIV_FN_CHENG 
CS_ATMO_UNIV_FN_HOGSTROM 
CS_ATMO_UNIV_FN_BUSINGER 
CS_ATMO_UNIV_FN_HARTOGENSIS 
CS_ATMO_UNIV_FN_CARL 

Function Documentation

◆ cs_atmo_add_property_fields()

void cs_atmo_add_property_fields ( void  )

add properties fields

◆ cs_atmo_aerosol_log_setup()

void cs_atmo_aerosol_log_setup ( void  )

Print the atmospheric aerosols options to setup.log.

◆ cs_atmo_chemistry_log_setup()

void cs_atmo_chemistry_log_setup ( void  )

Print the atmospheric chemistry options to setup.log.

◆ cs_atmo_chemistry_set_aerosol_file_name()

void cs_atmo_chemistry_set_aerosol_file_name ( const char *  file_name)

This function sets the file name to initialize the aerosol library.

Parameters
[in]file_namename of the file.

◆ cs_atmo_chemistry_set_spack_file_name()

void cs_atmo_chemistry_set_spack_file_name ( const char *  file_name)

This function set the file name of the SPACK file.

Parameters
[in]file_namename of the file.

◆ cs_atmo_compute_meteo_profiles()

void cs_atmo_compute_meteo_profiles ( void  )

Compute meteo profiles if no meteo file is given.

◆ cs_atmo_compute_solar_angles()

void cs_atmo_compute_solar_angles ( cs_real_t  latitude,
cs_real_t  longitude,
cs_real_t  squant,
cs_real_t  utc,
int  sea_id,
cs_real_t albedo,
cs_real_t za,
cs_real_t muzero,
cs_real_t omega,
cs_real_t fo 
)

1D Radiative scheme - Solar data + zenithal angle)

Compute:

  • zenithal angle
  • solar contant (with correction for earth - solar length)
  • albedo if above the sea (Use analytical formulae of Paltrige and Platt dev.in atm. science no 5)
    Parameters
    [in]xlatlatitude
    [in]xlonglongitude
    [in]jourday in the year
    [in]heurtuUniversal time (hour)
    [in]imersea index
    [out]albealbedo
    [out]zazenithal angle
    [out]muzerocosin of zenithal angle (+ correction due to Earth curvature)
    [out]omegasolar azimut angle
    [out]fosolar constant
    Compute:
  • zenithal angle
  • solar contant (with correction for earth - solar length)
  • albedo if above the sea (Use analytical formulae of Paltrige and Platt dev.in atm. science no 5)
    Parameters
    [in]latitudelatitude
    [in]longitudelongitude
    [in]squantstart day in the year
    [in]utcUniversal time (hour)
    [in]sea_idsea index
    [out]albedoalbedo
    [out]zazenithal angle
    [out]muzerocosin of zenithal angle
    [out]omegasolar azimut angle
    [out]fosolar constant

◆ cs_atmo_declare_chem_from_spack()

void cs_atmo_declare_chem_from_spack ( void  )

This function declare additional transported variables for atmospheric module for the chemistry defined from SPACK.

This function declare additional transported variables for atmospheric module for the chemistry defined from SPACK.

◆ cs_atmo_finalize()

void cs_atmo_finalize ( void  )

Deallocate arrays for atmo module.

◆ cs_atmo_hydrostatic_profiles_compute()

void cs_atmo_hydrostatic_profiles_compute ( void  )

Compute hydrostatic profiles of density and pressure.

This function solves the following transport equation on $ \varia $:

\[ \divs \left( \grad \varia \right) = \divs \left( \dfrac{\vect{g}}{c_p \theta} \right) \]

where $ \vect{g} $ is the gravity field and $ \theta $ is the potential temperature.

The boundary conditions on $ \varia $ read:

\[ \varia = \left(\dfrac{P_{sea}}{p_s}\right)^{R/C_p} \textrm{on the ground} \]

and Neumann elsewhere.

◆ cs_atmo_init_meteo_profiles()

void cs_atmo_init_meteo_profiles ( void  )

Initialize meteo profiles if no meteo file is given.

◆ cs_atmo_log_setup()

void cs_atmo_log_setup ( void  )

Print the atmospheric module options to setup.log.

◆ cs_atmo_set_aero_conc_file_name()

void cs_atmo_set_aero_conc_file_name ( const char *  file_name)

This function set the file name of the aerosol concentration file.

Parameters
[in]file_namename of the file.

This function set the file name of the aerosol concentration file.

Parameters
[in]file_namename of the file.

◆ cs_atmo_set_chem_conc_file_name()

void cs_atmo_set_chem_conc_file_name ( const char *  file_name)

This function set the file name of the chemistry concentration file.

Parameters
[in]file_namename of the file.

This function set the file name of the chemistry concentration file.

Parameters
[in]file_namename of the file.

◆ cs_atmo_set_meteo_file_name()

void cs_atmo_set_meteo_file_name ( const char *  file_name)

This function set the file name of the meteo file.

Parameters
[in]file_namename of the file.

◆ cs_atmo_z_ground_compute()

void cs_atmo_z_ground_compute ( void  )

This function computes the ground elevation.

This function solves the following transport equation on $ \varia $:

\[ \dfrac{\partial \varia}{\partial t} + \divs \left( \varia \vect{g} \right) - \divs \left( \vect{V} \right) \varia = 0 \]

where $ \vect{g} $ is the gravity field

The boundary conditions on $ \varia $ read:

\[ \varia = z \textrm{ on walls} \]

\[ \dfrac{\partial \varia}{\partial n} = 0 \textrm{ elsewhere} \]

Remarks:

  • a steady state is looked for.

This function computes the ground elevation.

This function solves the following transport equation on $ \varia $:

\[ \dfrac{\partial \varia}{\partial t} + \divs \left( \varia \vect{g} \right) - \divs \left( \vect{V} \right) \varia = 0 \]

where $ \vect{g} $ is the gravity field

The boundary conditions on $ \varia $ read:

\[ \varia = z \textrm{ on walls} \]

\[ \dfrac{\partial \varia}{\partial n} = 0 \textrm{ elsewhere} \]

Remarks:

  • a steady state is looked for.

◆ cs_mo_phih()

cs_real_t cs_mo_phih ( cs_real_t  z,
cs_real_t  dlmo 
)

Universal function phih for neutral, stable and unstable.

Parameters
[in]zaltitude
[in]dlmoInverse Monin Obukhov length
Returns
factor

◆ cs_mo_phim()

cs_real_t cs_mo_phim ( cs_real_t  z,
cs_real_t  dlmo 
)

Universal function phim for neutral, stable and unstable.

Parameters
[in]zaltitude
[in]dlmoInverse Monin Obukhov length
Returns
factor

◆ cs_mo_psih()

cs_real_t cs_mo_psih ( cs_real_t  z,
cs_real_t  z0,
cs_real_t  dlmo 
)

Universal function psih for neutral, stable and unstable.

Parameters
[in]zaltitude
[in]z0roughness
[in]dlmoInverse Monin Obukhov length
Returns
factor

◆ cs_mo_psim()

cs_real_t cs_mo_psim ( cs_real_t  z,
cs_real_t  z0,
cs_real_t  dlmo 
)

Universal function psim for neutral, stable and unstable.

Parameters
[in]zaltitude
[in]z0roughness
[in]dlmoInverse Monin Obukhov length
Returns
factor

◆ cs_soil_model()

void cs_soil_model ( void  )

Compute soil and interface values using Deardorff force restore method.

Compute soil and interface values using Deardorff force restore method.

◆ cs_user_soil_model()

void cs_user_soil_model ( void  )

Allow call of cs_user fonctions during soil model computation.

Variable Documentation

◆ cs_glob_atmo_chemistry

cs_atmo_chemistry_t* cs_glob_atmo_chemistry
extern

◆ cs_glob_atmo_constants

cs_atmo_constants_t* cs_glob_atmo_constants
extern

◆ cs_glob_atmo_option

cs_atmo_option_t* cs_glob_atmo_option
extern