Overview

This page is part of the Aerosol Model (SALSA) documentation.
It contains a listing of all PALM input parameters used to steer the SALSA.
For an overview of all SALSA-related pages, see the SALSA main page.

Parameter list

NAMELIST group name: salsa_parameters

Parameter Name	FORTRAN Type	Default Value	Explanation
advect_particle_water	L	.T.	Parameter to switch on the advection of condensed water in aerosol particles. If advect_particle_water = .F., the aerosol particle water content is calculated at each dt_salsa based on the equilibrium solution using the ZSR method (Stokes and Robinson, 1966).
aerosol_flux_dpg	R(7)	1.3E-8, 5.4E-8, 8.6E-7, 2.0E-7, 2.0E-7, 2.0E-7, 2.0E-7	The number geometric mean diameter per aerosol mode (in m) for the aerosol emission. A total of 7 different aerosol modes can be applied. Example aerosol modes: nucleation, Aitken, accumulation and coarse mode. Used to construct the aerosol emissions if horizontally uniform (salsa_emission_mode = 'uniform' ) or parameterized (salsa_emission_mode = 'parameterized' ) aerosol emissions are applied. Then the aerosol number emission is described by input parameters aerosol_flux_dpg, aerosol_flux_sigmag, aerosol_flux_mass_fracs_a and surface_aerosol_flux.
aerosol_flux_mass_fracs_a	R(7)	1.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0	Mass fractions of soluble chemical components (subrange 2a) for the horizontally homogeneous aerosol emission (salsa_emission_mode = 'uniform' ). Given in the same order as the list of activated aerosol chemical components listspec. E.g. listspec = 'OC','NH','BC',' ',' ',' ',' ', aerosol_flux_mass_fracs_a = 0.3, 0.1, 0.6, 0., 0., 0., 0., implies that the mass composition of the aerosol emission is 30% organic carbon, 10% ammonia and 60% black carbon. Used to construct the aerosol emissions if horizontally uniform (salsa_emission_mode = 'uniform' ) or parameterized (salsa_emission_mode = 'parameterized' ) aerosol emissions are applied. Then the aerosol number emission is described by input parameters aerosol_flux_dpg, aerosol_flux_sigmag, aerosol_flux_mass_fracs_a and surface_aerosol_flux.
aerosol_flux_sigmag	R(7)	1.8, 2.16, 2.21, 2.0, 2.0, 2.0, 2.0	The standard deviation of the log-normal aerosol number size distribution per aerosol mode for the aerosol emission. A total of 7 different aerosol modes can be applied. Example aerosol modes: nucleation, Aitken, accumulation and coarse mode. Used to construct the aerosol emissions if horizontally uniform (salsa_emission_mode = 'uniform' ) or parameterized (salsa_emission_mode = 'parameterized' ) aerosol emissions are applied. Then the aerosol number emission is described by input parameters aerosol_flux_dpg, aerosol_flux_sigmag, aerosol_flux_mass_fracs_a and surface_aerosol_flux.
bc_salsa_b	C(20)	'neumann'	The bottom boundary condition of the aerosol concentrations. The same condition applies also for gases if the chemistry module is not applied. Allowed are the values 'dirichlet' (constant surface concentration over the entire simulation) and 'neumann' (zero concentration gradient). If any surface emissions of aerosols and gases are applied (see salsa_emission_mode), bc_salsa_b = 'neumann' is required.
bc_salsa_t	C(20)	'neumann'	The top boundary condition of the aerosol (and gas) concentrations. Allowed are the values 'dirichlet' (constant top boundary concentration over the entire simulation), 'neumann' (zero concentration gradient) and 'initial_gradient' (concentration gradient at the top is calculated from the initial concentration profile).
decycle_salsa_lr	L	.F.	Parameter to the switch on the decycling of aerosol particles along the x-axis. The switch applies also for gaseous compounds (H2SO4, HNO3, NH3, OCNV and OCSV) if the chemistry module is not applied. The decycling method per each lateral boundary is set by decycle_method_salsa.
decycle_method_salsa	C(20) * 4	'dirichlet','dirichlet', 'dirichlet','dirichlet'	The decycling method at lateral boundaries, in the following order: left, right, south, north. Decycling of aerosol and gas concentrations is useful, for example, if cyclic boundary conditions are applied and there are some pollutant emissions in the simulation domain. Without decycling, pollutants would keep accumulating into the simulation domain. If decycle_method_salsa = 'dirichlet' , the initial aerosol (and gas) concentrations are used as fixed boundary conditions. If decycle_method_salsa = 'neumann' , a zero concentration gradient is set at the boundary. Decycling is enabled by setting decycle_salsa_ns = .T. and decycle_salsa_lr = .T..
decycle_salsa_ns	L	.F.	Parameter to the switch on the decycling of aerosol particles along the y-axis. The switch applies also for gaseous compounds (H2SO4, HNO3, NH3, OCNV and OCSV) if the chemistry module is not applied. The decycling method per each lateral boundary is set by decycle_method_salsa.
depo_pcm_par	C(20)	'zhang2001'	The method to solve the aerosol size specific dry deposition velocity (in m s-1). Available options: 'zhang2001' (Zhang et al. 2001) 'petroff2010' (Petroff & Zhang, 2010) The surface material is specified with depo_pcm_type.
depo_pcm_type	C(20)	'deciduous_broadleaf'	Leaf type applied in the dry deposition model. Available options: 'evergreen_needleleaf' , 'evergreen_broadleaf' , 'deciduous_needleleaf' and 'deciduous_broadleaf' .
depo_surf_par	C(20)	'zhang2001'	The method to solve the dry deposition velocity (in m s-1) for aerosols over both horizontal and vertical surfaces. Available options: 'zhang2001' (Zhang et al. 2001) 'petroff2010' (Petroff & Zhang, 2010). The land use type applied in the parametrisations are imported from the land and urban surface modules. If the surfaces are not specified using the urban surface or land surface module, the land use type urban is applied for all surfaces.
dpg	R(7)	1.3E-8, 5.4E-8, 8.6E-7, 2.0E-7, 2.0E-7, 2.0E-7, 2.0E-7	The number geometric mean diameter per aerosol mode (in m). A total of 7 different aerosol modes can be applied. Example modes: nucleation, Aitken, accumulation and coarse mode. If initializing_actions includes 'set_constant_profiles' , the initial aerosol size distribution is described by input parameters dpg, sigmag and n_lognorm.
dt_salsa	R	0.1	The time step for calling aerosol dynamic processes of SALSA. For switching on individual processes, see nlcnd, nlcndgas, nlcndh2oae, nlcoag, nldepo, nldepo_pcm, nldepo_surf, nldistupdate and nsnucl.
emiss_factor_main	R	0.0	Constant emission scaling factor for main street types, used if salsa_emission_mode = 'parameterized' .
emiss_factor_side	R	0.0	Constant emission scaling factor for side street types, used if salsa_emission_mode = 'parameterized' .
feedback_to_palm	L	.F.	Parameter to switch on the dynamic feedback to the flow due to condensation of water vapour on aerosol particles. If feedback_to_palm = .F., the salsa module does not interact with the flow.
H2SO4_init	R	1.0	Initial number concentration (in m-3) of gaseous sulphuric acid H2SO4 (g).
HNO3_init	R	1.0	Initial number concentration (in m-3) of gaseous nitric acid HNO3 (g).
listspec	C*3(7)	'SO4', 6 * ' '	List of activated aerosol chemical components. Available options: SO4 = Sulphates OC = Organic carbon BC = Black carbon DU = Dust SS = Sea salt NH = Ammonia NO = Nitrates All chemical components included in the simulation must be activated here.
main_street_id	I(99)	0	Index for identifying main streets following street type classes from 'OpenStreetMap?'. Used if salsa_emission_mode = 'parameterized' .
mass_fracs_a	R(7)	1.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0	Mass fractions of soluble chemical components (subrange 2a). Given in the same order as the list of activated aerosol chemical components listspec.
mass_fracs_b	R(7)	0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0	Mass fractions of insoluble chemical components (subrange 2b). Given in the same order as the list of activated aerosol chemical components listspec. Setting mass_fracs_b > 0.0 and nf2a < 1.0 allows for the description of externally mixed aerosol particle populations in the subrange 2. However, this notably increases the computational demand. If the sum of SUM(mass_fracs_b) = 0.0, all aerosol particles are assumed to be soluble and the subrange 2b is not initialised.
max_street_id	I(99)	0	Maximum index value for identifying all (main and side) streets following street type classes from OpenStreetMap. Used if salsa_emission_mode = 'parameterized' .
n_lognorm	R(7)	1.04E11, 3.23E10, 5.4E6, 0.0, 0.0, 0.0, 0.0	The total aerosol number concentration per aerosol mode (in m-3). A total of 7 different aerosol modes can be applied. Example modes: nucleation, Aitken, accumulation and coarse mode. If initializing_actions includes 'set_constant_profiles' , the initial aerosol size distribution is described by input parameters dpg, sigmag and n_lognorm.
nbin	I(2)	3, 7	Number of aerosol size bins per subrange.
nesting_offline_salsa	L	.T.	Parameter to switch off offline nesting for salsa variables. If If nesting_offline_salsa = .F. , Diriclet conditions are applied at the horizontal boundaries and Neumann at the top boundary. It is preferable to use decycling (decycle_salsa_lr and decycle_salsa_ns) if offline-nesting is specifically turned off for salsa variables.
nesting_salsa	L	.T.	Parameter to switch off self-nesting for salsa variables. If If nesting_salsa = .F. , Diriclet conditions are applied at the horizontal boundaries and Neumann at the top boundary. It is preferable to use decycling (decycle_salsa_lr and decycle_salsa_ns) if self-nesting is specifically turned off for salsa variables.
nf2a	R	1.0	The number fraction allocated to subrange 2a. The number fraction allocated to the subrange 2b will be then 1.0-nf2a.
NH3_init	R	1.0	Initial number concentration (in m-3) of gaseous ammonia NH3 (g).
nj3	I	1	Parametrisation for calculating the apparent formation rate of 3 nm sized aerosol particles (J3, in # s-1). Available options: 1 = condensational sink (Kerminen and Kulmala, 2002) 2 = coagulational sink ([wiki:doc/app/salsaref/ Lehtinen et al. 2007|) 3 = coagS+self-coagulation (Anttila et al. 2010)
nlcnd	L	.F.	Parameter to switch on the condensation of gaseous compounds on aerosol particles.
nlcndgas	L	.F.	Parameter to switch on the condensation of gaseous compounds, excluding water vapour, on aerosol particles. Requires nlcnd = .T..
nlcndgash2oae	L	.F.	Parameter to switch on the condensation of water vapour on aerosol particles. Requires nlcnd = .T..
nlcoag	L	.F.	Parameter to switch on the coagulation of aerosol particles.
nldepo	L	.F.	Parameter to switch of the dry deposition and sedimentation of aerosol particles.
nldepo_surf	L	.F.	Parameter to switch aerosol dry deposition on topography elements (ground, wall, roofs). The parametrisation to calculate the size-dependent deposition velocity is set by parameter depo_surf_type. Requires nldepo = .T..
nldepo_pcm	L	.F.	Parameter to switch on aerosol dry deposition on resolved scale vegetation. The parametrisation to calculate the size-dependent deposition velocity is set by parameter depo_pcm_par. Note that currently the deposition velocity is calculated by default for deciduous broadleaf trees. Requires nldepo = .T..
nldistupdate	L	.T.	Parameter to switch on the aerosol number size distribution update switch. If nldistupdate = .F., aerosol particles that become too small or large in their size bin are not allowed to move to another size bin.
nsnucl	I	0	The nucleation scheme applied. If nsnucl = 0, nucleation is switched off. Available options: 1 = binary nucleation (Vehkamäki et al., 2002) 2 = activation type nucleation (Riipinen et al., 2007) 3 = kinetic nucleation (Sihto et al., 2006) 4 = ternary nucleation (Napari et al., 2002a,b) 5 = organic nucleation (Paasonen et al., 2010) 6 = sum of binary and organic nucleation (Paasonen et al., 2010) 7 = heteromolecular nucleation (Paasonen et al., 2010) 8 = homomolecular nucleation of H2SO4 and heteromolecular nucleation of H2SO4 and organics (Paasonen et al., 2010) 9 = homomolecular nucleation of H2SO4 and organics, and heteromolecular nucleation of H2SO4 and organics (Paasonen et al., 2010). Requires nlcnd = .T.. Note that the nucleation schemes were not evaluated in Kurppa et al. (2019).
OCNV_init	R	1.0	Initial number concentration (in m-3) of gaseous non-volatile organic compounds.
OCSV_init	R	1.0	Initial number concentration (in m-3) of gaseous semi-volatile organic compounds.
read_restart_data_salsa	L	.F.	Read the restart data of the salsa module from the previous run.
reglim	R(3)	3.0E-9, 5.0E-8, 1.0E-5	Aerosol diameter limits for the subranges (in m) in the following order: lower limit of 1, upper limit of 1 and lower limit of 2, upper limit of 2.
salsa_emission_mode	C(20)	'no_emission'	Emission mode for aerosol and gaseous emissions. salsa_emission_mode = 'uniform' sets a horizontally homogeneous surface flux of aerosols based on surface_aerosol_flux, aerosol_flux_dpg, aerosol_flux_sigmag and aerosol_mass_fracs_a. salsa_emission_mode = 'parameterized' sets surface fluxes based on the street type. The aerosol size distribution and mass composition of the emission is given similar to salsa_emission_mode = 'uniform' . The flux is then normalised based on the street type in the static input file (see static input file) and using emission_factor_main, emission_factor_side main_street_id, side_street_id, max_street_id. salsa_emission_mode = 'read_from_file' reads the emission information from the NetCDF aero -information file (see aerosol input file). Note that all chemical components included in the simulation must be activated in listspec. Also bc_salsa_b = 'neumann' is required.
season_z01	I	1	Modelling season if the dry deposition parametrisation by Zhang et al. 2001 is applied (depo_pcm_par = 'zhang2001' and/or depo_surf_par = 'zhang2001' ). Available options: 1 = summer, 2 = autumn (no harvest yet), 3 = late autumn (already frost), 4 = winter and 5 = transitional spring.
side_street_id	I(99)	0	Index for identifying side streets following street type classes from 'OpenStreetMap?'. Used if salsa_emission_mode = 'parameterized' .
sigmag	R(7)	1.8, 2.16, 2.21, 2.0, 2.0, 2.0, 2.0	The standard deviation of the log-normal aerosol number size distribution per aerosol mode. A total of 7 different aerosol modes can be applied. Example modes: nucleation, Aitken, accumulation and coarse mode. If initializing_actions includes 'set_constant_profiles' , the initial aerosol size distribution is described by input parameters dpg, sigmag and n_lognorm.
skip_time_do_salsa	R	0.0	Time after which SALSA is switched on. This parameter can be used to allow the LES model to develop turbulence before aerosol particles and their processes are switched on.
surface_aerosol_flux	R(7)	1.04e+11, 3.23E+10, 5.4E+6, 0.0, 0.0, 0.0, 0.0	The total surface aerosol number flux per aerosol mode (in m-2s-1). A total of 7 different aerosol modes can be applied. Example modes: nucleation, Aitken, accumulation and coarse mode. If salsa_emission_mode= 'uniform', the aerosol number emission is described by input parameters aerosol_flux_dpg, aerosol_flux_sigmag, aerosol_flux_mass_fracs_a and surface_aerosol_flux.
van_der_waals_coagc	L	.F.	Parameter to switch on the van der Waals forces when calculating the collision kernel in the coagulation subroutine. Parametrisation follows Karl et al. (2016).
write_binary_salsa	L	.F.	Write the binary restart data for the salsa module.

The following quantities can be additionally output when the aerosol module SALSA is used:

Quantity name	Meaning	Unit	Remarks
[salsa_g_<gaseous_compound>]	Concentration of <gaseous_compound>	# m-3	Options: 'salsa_g_H2SO4', 'salsa_g_HNO3', 'salsa_g_NH3', 'salsa_g_OCNV','salsa_g_OCSV'. Profile output not available.
salsa_LDSA	Total lung-deposited surface area	µm2 cm-3
[salsa_N_bin<bin number>]	Aerosol number concentration in the aerosol size bin <bin number>	# m-3	Profile output not available.
salsa_N_UFP	Total aerosol number concentration of particles smaller than 0.1 µm in diameter, i.e. ultrafine particles	# m-3
salsa_Ntot	Total aerosol number concentration	# m-3
salsa_PM0.1	Total mass concentration of particulate matter smaller than 0.1 µm in diameter, i.e. ultrafine particles	kg m-3
salsa_PM2.5	Total mass concentration of particulate matter smaller than 2.5 µm in diameter	kg m-3
salsa_PM10	Total mass concentration of particulate matter smaller than 10 µm in diameter	kg m-3
[salsa_s_<chemical_compound>]	Mass concentration of <chemical_compound> in the aerosol phase	kg m-3	Options: 's_BC', 's_DU', 's_NH', 's_NO', 's_OC', 's_SO4', 's_SS'.

Initial & lateral boundary conditions

Parameter Name	Values & Explanation
initializing_actions =	'inifor set_constant_profiles', If large-scale forcings are used only for meteorology, then user defined initial concentrations can be activated by combining 'set_constant_profiles' with 'inifor' separated by a space only in initializing_actions.