#include "cs_base.h"

Include dependency graph for cs_atmo.h:

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 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...

Variables
cs_atmo_option_t *	cs_glob_atmo_option

cs_atmo_constants_t *	cs_glob_atmo_constants

cs_atmo_chemistry_t *	cs_glob_atmo_chemistry

Enumeration Type Documentation

◆ cs_atmo_aerosol_type_t

enum cs_atmo_aerosol_type_t

Enumerator
CS_ATMO_AEROSOL_OFF
CS_ATMO_AEROSOL_SSH

◆ cs_atmo_model_t

enum cs_atmo_model_t

Enumerator
CS_ATMO_OFF
CS_ATMO_CONSTANT_DENSITY
CS_ATMO_DRY
CS_ATMO_HUMID

◆ cs_atmo_nucleation_type_t

enum 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

enum 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

enum 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_name name 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_name name 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 *	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]	xlat	latitude
[in]	xlong	longitude
[in]	jour	day in the year
[in]	heurtu	Universal time (hour)
[in]	imer	sea index
[out]	albe	albedo
[out]	muzero	cosin of zenithal angle
[out]	omega	solar azimut angle
[out]	fo	solar 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]	latitude	latitude
[in]	longitude	longitude
[in]	squant	start day in the year
[in]	utc	Universal time (hour)
[in]	sea_id	sea index
[out]	albedo	albedo
[out]	muzero	cosin of zenithal angle
[out]	omega	solar azimut angle
[out]	fo	solar 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.

◆ 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_name name of the file.

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

Parameters

[in] file_name name 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_name name of the file.

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

Parameters

[in] file_name name 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_name name 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]	z	altitude
[in]	dlmo	Inverse 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]	z	altitude
[in]	dlmo	Inverse 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]	z	altitude
[in]	z0	roughness
[in]	dlmo	Inverse 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]	z	altitude
[in]	z0	roughness
[in]	dlmo	Inverse Monin Obukhov length

Returns: factor

Variable Documentation

◆ cs_glob_atmo_chemistry

cs_atmo_chemistry_t* cs_glob_atmo_chemistry

◆ cs_glob_atmo_constants

cs_atmo_constants_t* cs_glob_atmo_constants

◆ cs_glob_atmo_option

cs_atmo_option_t* cs_glob_atmo_option

Data Structures

Enumerations

Functions

Variables

Enumeration Type Documentation

◆ cs_atmo_aerosol_type_t

◆ cs_atmo_model_t

◆ cs_atmo_nucleation_type_t

◆ cs_atmo_soil_cat_t

◆ cs_atmo_universal_functions_t

Function Documentation

◆ cs_atmo_add_property_fields()

◆ cs_atmo_aerosol_log_setup()

◆ cs_atmo_chemistry_log_setup()

◆ cs_atmo_chemistry_set_aerosol_file_name()

◆ cs_atmo_chemistry_set_spack_file_name()

◆ cs_atmo_compute_meteo_profiles()

◆ cs_atmo_compute_solar_angles()

◆ cs_atmo_declare_chem_from_spack()

◆ cs_atmo_finalize()

◆ cs_atmo_hydrostatic_profiles_compute()

◆ cs_atmo_init_meteo_profiles()

◆ cs_atmo_log_setup()

◆ cs_atmo_set_aero_conc_file_name()

◆ cs_atmo_set_chem_conc_file_name()

◆ cs_atmo_set_meteo_file_name()

◆ cs_atmo_z_ground_compute()

◆ cs_mo_phih()

◆ cs_mo_phim()

◆ cs_mo_psih()

◆ cs_mo_psim()

Variable Documentation

◆ cs_glob_atmo_chemistry

◆ cs_glob_atmo_constants

◆ cs_glob_atmo_option