== Overview ==

[[TracNav(doc/app/partoc|nocollapse)]]
[[TracNav(doc/tec/salsatoc|nocollapse)]]

[[NoteBox(note,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 **[wiki:doc/tec/aerosol SALSA main page]**.)]]


== Parameter list ==
'''NAMELIST group name: {{{salsa_parameters}}}''' \\

||='''Parameter Name'''  =||='''[../fortrantypes FORTRAN Type]'''  =||='''Default Value'''  =||='''Explanation'''  =||
|----------------
{{{#!td style="vertical-align:top"
[=#advect_particle_water '''advect_particle_water''']
}}}
{{{#!td style="vertical-align:top"
L
}}}
{{{#!td style="vertical-align:top"
.T.
}}}
{{{#!td
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 ([wiki:doc/app/salsaref/ Stokes and Robinson, 1966]).
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#bc_salsa_b '''bc_salsa_b''']
}}}
{{{#!td style="vertical-align:top"
C(20)
}}}
{{{#!td style="vertical-align:top"
'neumann'
}}}
{{{#!td
The bottom boundary condition of the aerosol (and gas) concentrations. 

Allowed are the values '' 'dirichlet' '' (constant surface concentration over the entire simulation) and 'neumann' (zero concentration gradient).

If the aerosol (ans gaseous) emissions are defined as surface fluxes, '''bc_salsa_b''' = '' 'neumann' '' is required.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#bc_salsa_t '''bc_salsa_t''']
}}}
{{{#!td style="vertical-align:top"
C(20)
}}}
{{{#!td style="vertical-align:top"
'neumann'
}}}
{{{#!td
The top boundary condition of the aerosol (and gas) concentrations.

Allowed are the values '' 'dirichlet' '' (constant top boundary concentration over the entire simulation) and '' 'neumann' '' (zero concentration gradient).
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#decycle_lr '''decycle_lr''']
}}}
{{{#!td style="vertical-align:top"
L
}}}
{{{#!td style="vertical-align:top"
.F.
}}}
{{{#!td
Parameter to the switch on the decycling of aerosol particles along x. The switch applies also for gaseous compounds (H2SO4, HNO3, NH3, OCNV and OCSV) if the chemistry model is not applied. 

The decycling method per each lateral boundary is set by [#decycle_method decycle_method].
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#decycle_method '''decycle_method''']
}}}
{{{#!td style="vertical-align:top"
C(20) * 4
}}}
{{{#!td style="vertical-align:top"
'dirichlet','dirichlet',\\'dirichlet','dirichlet'
}}}
{{{#!td
The decycling method at lateral boundaries, in the following order: left, right, south, north.

If '''decycle_method''' = 'dirichlet', the initial aerosol (and gas) concentrations are copied to the ghost layers and the first three grid points at the boundary. 

If '''decycle_method''' = 'neumann', a zero concentration gradient is set at the boundary.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#decycle_ns '''decycle_ns''']
}}}
{{{#!td style="vertical-align:top"
L
}}}
{{{#!td style="vertical-align:top"
.F.
}}}
{{{#!td
Parameter to the switch on the decycling of aerosol particles along y. The switch applies also for gaseous compounds (H2SO4, HNO3, NH3, OCNV and OCSV) if the chemistry model is not applied. 

The decycling method per each lateral boundary is set by [#decycle_method decycle_method].
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#depo_topo_type '''depo_topo_type''']
}}}
{{{#!td style="vertical-align:top"
C(20)
}}}
{{{#!td style="vertical-align:top"
'zhang2001'
}}}
{{{#!td
The method to solve the aerosol size specific dry deposition velocity (in m s-1) over an urban surface. 
Available options:
'zhang2001' ([wiki:doc/app/salsaref/ Zhang et al. 2001])
'petroff2010' ([wiki:doc/app/salsaref/ Petroff & Zhang, 2010]).

Note that the surface material is not specified in the included parametrisations.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#depo_vege_type '''depo_vege_type''']
}}}
{{{#!td style="vertical-align:top"
C(20)
}}}
{{{#!td style="vertical-align:top"
'zhang2001'
}}}
{{{#!td
The method to solve the aerosol size specific dry deposition velocity (in m s-1). 
Available options:
'zhang2001' ([wiki:doc/app/salsaref/Zhang et al. 2001])
'petroff2010' ([wiki:doc/app/salsaref/Petroff & Zhang, 2010])

Note that currently the deposition velocity is calculated by default for deciduous broadleaf trees.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#dpg '''dpg''']
}}}
{{{#!td style="vertical-align:top"
R(7)
}}}
{{{#!td style="vertical-align:top"
0.013, 0.054, 0.86, 0.2, 0.2, 0.2, 0.2
}}}
{{{#!td
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 [#isdtyp isdtyp]= 1, the initial aerosol size distribution is described by input parameters '''dpg''', [#sigmag sigmag] and [#n_lognorm n_lognorm].
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#dt_salsa '''dt_salsa''']
}}}
{{{#!td style="vertical-align:top"
R
}}}
{{{#!td style="vertical-align:top"
0.1
}}}
{{{#!td
Time step for calling aerosol dynamic processes of SALSA. For switching on individual processes, see [#nlcnd nlcnd], [#nlcndgas nlcndgas], [#nlcndh2oae nlcndh2oae], [#nlcoag nlcoag], [#nldepo nldepo], [#nldepo_vege nldepo_vege], [#nldepo_topo nldepo_topo], [#nldistupdate nldistupdate] and [#nsnucl nsnucl].
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#feedback_to_palm '''feedback_to_palm''']
}}}
{{{#!td style="vertical-align:top"
L
}}}
{{{#!td style="vertical-align:top"
.F.
}}}
{{{#!td
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. 
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#H2SO4_init '''H2SO4_init''']
}}}
{{{#!td style="vertical-align:top"
R
}}}
{{{#!td style="vertical-align:top"
1.0
}}}
{{{#!td
Initial number concentration (in m^-3^) of gaseous sulphuric acid H2SO4 (g). 
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#HNO3_init '''HNO3_init''']
}}}
{{{#!td style="vertical-align:top"
R
}}}
{{{#!td style="vertical-align:top"
1.0
}}}
{{{#!td
Initial number concentration (in m^-3^) of gaseous nitric acid HNO3 (g). 
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#igctyp '''igctyp''']
}}}
{{{#!td style="vertical-align:top"
I
}}}
{{{#!td style="vertical-align:top"
1
}}}
{{{#!td
Gas concentration initialisation type.

If '''igctyp''' = 1, the whole modelling domain is initialised with values given in [#H2SO4_init H2SO4_init], [#HNO3_init HNO3_init], [#NH3_init NH3_init], [#OCNV_init OCNV_init] and [#OCSV_init OCSV_init].

If '''igctyp''' = 2, the initial gas concentrations are read from the input file PIDS_CHEM. In this case, also vertical profiles can be provided. 
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#isdtyp '''isdtyp''']
}}}
{{{#!td style="vertical-align:top"
I
}}}
{{{#!td style="vertical-align:top"
1
}}}
{{{#!td
Aerosol size distribution initialisation type.

If '''isdtyp''' = 1, the whole modelling domain is initialised with a constant log-normal aerosol size distribution described by input parameters [#dpg dpg], [#sigmag sigmag] and [#n_lognorm n_lognorm]. 

If '''isdtyp''' = 2, the initial aerosol size distribution is read from the input file PIDS_AERO. In this case, also a vertical profile of the aerosol size distribution can be provided. 
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#listspec '''listspec''']
}}}
{{{#!td style="vertical-align:top"
C*3(7)
}}}
{{{#!td style="vertical-align:top"
'SO4', 
6 * '   '
}}}
{{{#!td
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.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#mass_fracs_a '''mass_fracs_a''']
}}}
{{{#!td style="vertical-align:top"
R(7)
}}}
{{{#!td style="vertical-align:top"
1.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0
}}}
{{{#!td
Mass fractions of soluble chemical components (subrange 2a). 

Given in the same order as the list of activated aerosol chemical components [#listspec listspec].
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#mass_fracs_b '''mass_fracs_b''']
}}}
{{{#!td style="vertical-align:top"
R(7)
}}}
{{{#!td style="vertical-align:top"
0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0
}}}
{{{#!td
Mass fractions of insoluble chemical components (subrange 2b).

Given in the same order as the list of activated aerosol chemical components [#listspec listspec].

Setting '''mass_fracs_b''' > 0.0 and [#nf2a 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.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#n_lognorm '''n_lognorm''']
}}}
{{{#!td style="vertical-align:top"
R(7)
}}}
{{{#!td style="vertical-align:top"
1.04E5, 3.23E4, 5.4, 0.0, 0.0, 0.0, 0.0
}}}
{{{#!td
The total aerosol number concentration per aerosol mode (in cm^-3^). A total of 7 different aerosol modes can be applied.  Example modes: nucleation, Aitken, accumulation and coarse mode. 

If [#isdtyp isdtyp] = 1, the initial aerosol size distribution is described by input parameters [#dpg dpg], [#sigmag sigmag] and '''n_lognorm'''.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#nbin '''nbin''']
}}}
{{{#!td style="vertical-align:top"
I(2)
}}}
{{{#!td style="vertical-align:top"
3, 7
}}}
{{{#!td
Number of aerosol size bins per subrange.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#nf2a '''nf2a''']
}}}
{{{#!td style="vertical-align:top"
R
}}}
{{{#!td style="vertical-align:top"
1.0
}}}
{{{#!td
The number fraction allocated to subrange 2a. The number fraction allocated to the subrange 2b will be then 1.0-nf2a.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#NH3_init '''NH3_init''']
}}}
{{{#!td style="vertical-align:top"
R
}}}
{{{#!td style="vertical-align:top"
1.0
}}}
{{{#!td
Initial number concentration (in m^-3^) of gaseous ammonia NH3 (g). 
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#nj3 '''nj3''']
}}}
{{{#!td style="vertical-align:top"
I
}}}
{{{#!td style="vertical-align:top"
1
}}}
{{{#!td
Parametrisation for calculating the apparent formation rate of 3 nm sized aerosol particles (J,,3,,, in # s^-1^). \\
Available options:\\
1 = condensational sink ([wiki:doc/app/salsaref/ Kerminen and Kulmala, 2002])\\
2 = coagulational sink ([wiki:doc/app/salsaref/ Lehtinen et al. 2007|)\\
3 = coagS+self-coagulation ([wiki:doc/app/salsaref/ Anttila et al. 2010]) 
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#nlcnd '''nlcnd''']
}}}
{{{#!td style="vertical-align:top"
L
}}}
{{{#!td style="vertical-align:top"
.F.
}}}
{{{#!td
Parameter to switch on the condensation of gaseous compounds on aerosol particles.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#nlcndgas '''nlcndgas''']
}}}
{{{#!td style="vertical-align:top"
L
}}}
{{{#!td style="vertical-align:top"
.F.
}}}
{{{#!td
Parameter to switch on the condensation of gaseous compounds, excluding water vapour, on aerosol particles. 

Requires [#nlcnd nlcnd] = .T..
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#nlcndgash2oae '''nlcndgash2oae''']
}}}
{{{#!td style="vertical-align:top"
L
}}}
{{{#!td style="vertical-align:top"
.F.
}}}
{{{#!td
Parameter to switch on the condensation of water vapour on aerosol particles. 

Requires [#nlcnd nlcnd] = .T..
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#nlcoag '''nlcoag''']
}}}
{{{#!td style="vertical-align:top"
L
}}}
{{{#!td style="vertical-align:top"
.F.
}}}
{{{#!td
Parameter to switch on the coagulation of aerosol particles. 
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#nldepo '''nldepo''']
}}}
{{{#!td style="vertical-align:top"
L
}}}
{{{#!td style="vertical-align:top"
.F.
}}}
{{{#!td
Parameter to switch of the dry deposition and sedimentation of aerosol particles.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#nldepo_topo '''nldepo_topo''']
}}}
{{{#!td style="vertical-align:top"
L
}}}
{{{#!td style="vertical-align:top"
.F.
}}}
{{{#!td
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_topo_type depo_topo_type].

Requires [#nldepo nldepo] = .T..
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#nldepo_vege '''nldepo_vege''']
}}}
{{{#!td style="vertical-align:top"
L
}}}
{{{#!td style="vertical-align:top"
.F.
}}}
{{{#!td
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_vege_type depo_vege_type].

Note that currently the deposition velocity is calculated by default for deciduous broadleaf trees.

Requires [#nldepo nldepo] = .T..
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#nldistupdate '''nldistupdate''']
}}}
{{{#!td style="vertical-align:top"
L
}}}
{{{#!td style="vertical-align:top"
.T.
}}}
{{{#!td
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.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#nsnucl '''nsnucl''']
}}}
{{{#!td style="vertical-align:top"
I
}}}
{{{#!td style="vertical-align:top"
0
}}}
{{{#!td
The nucleation scheme applied. 
If '''nsnucl''' = 0, nucleation is switched off.\\

Available options:\\
1 = binary nucleation ([wiki:doc/app/salsaref/ Vehkamäki et al., 2002])\\
2 = activation type nucleation ([wiki:doc/app/salsaref/ Riipinen et al., 2007])\\
3 = kinetic nucleation ([wiki:doc/app/salsaref/ Sihto et al., 2006])\\
4 = ternary nucleation ([wiki:doc/app/salsaref/ Napari et al., 2002a,b])\\
5 = organic nucleation ([wiki:doc/app/salsaref/ Paasonen et al., 2010])\\
6 =  sum of binary and organic nucleation ([wiki:doc/app/salsaref/ Paasonen et al., 2010])\\
7 =  heteromolecular nucleation ([wiki:doc/app/salsaref/ Paasonen et al., 2010])\\
8 =  homomolecular nucleation of H2SO4 and heteromolecular nucleation of H2SO4 and organics ([wiki:doc/app/salsaref/ Paasonen et al., 2010])\\
9 =  homomolecular nucleation of H2SO4 and organics, and heteromolecular nucleation of H2SO4 and organics ([wiki:doc/app/salsaref/ Paasonen et al., 2010]).

Requires [#nlcnd nlcnd] = .T..

Note that the nucleation schemes were not evaluated in[wiki:doc/app/salsaref/ Kurppa et al. (2018)]. 
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#OCNV_init '''OCNV_init''']
}}}
{{{#!td style="vertical-align:top"
R
}}}
{{{#!td style="vertical-align:top"
1.0
}}}
{{{#!td
Initial number concentration (in m^-3^) of gaseous non-volatile organic compounds.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#OCSV_init '''OCSV_init''']
}}}
{{{#!td style="vertical-align:top"
R
}}}
{{{#!td style="vertical-align:top"
1.0
}}}
{{{#!td
Initial number concentration (in m^-3^) of gaseous semi-volatile organic compounds.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#read_restart_data_salsa '''read_restart_data_salsa''']
}}}
{{{#!td style="vertical-align:top"
L
}}}
{{{#!td style="vertical-align:top"
.F.
}}}
{{{#!td
Read the restart data of the salsa module from the previous run. 
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#reglim '''reglim''']
}}}
{{{#!td style="vertical-align:top"
R(3)
}}}
{{{#!td style="vertical-align:top"
3.0E-9, 5.0E-8, 1.0E-5
}}}
{{{#!td
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.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#salsa_source_mode '''salsa_source_mode''']
}}}
{{{#!td style="vertical-align:top"
C(20)
}}}
{{{#!td style="vertical-align:top"
'no_source'
}}}
{{{#!td
Source mode for aerosol and gaseous emissions. 

Setting '''salsa_source_mode''' = 'read_from_file' reads the source information from the NetCDF aero -information file. 

Note that all chemical components included in the simulation must be activated in [#listspec listspec].
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#sigmag '''sigmag''']
}}}
{{{#!td style="vertical-align:top"
R(7)
}}}
{{{#!td style="vertical-align:top"
1.8, 2.16, 2.21, 2.0, 2.0, 2.0, 2.0
}}}
{{{#!td
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 [#isdtyp isdtyp] = 1, the initial aerosol size distribution is described by input parameters [#dpg dpg], '''sigmag''' and [#n_lognorm n_lognorm].
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#skip_time_do_salsa '''skip_time_do_salsa''']
}}}
{{{#!td style="vertical-align:top"
R
}}}
{{{#!td style="vertical-align:top"
0.0
}}}
{{{#!td
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.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#van_der_waals_coagc '''van_der_waals_coagc''']
}}}
{{{#!td style="vertical-align:top"
L
}}}
{{{#!td style="vertical-align:top"
.F.
}}}
{{{#!td
Parameter to switch on the van der Waals forces when calculating the collision kernel in the coagulation subroutine. Parametrisation follows [wiki:doc/app/salsaref/ Karl et al. (2016)]. 
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#write_binary_salsa '''write_binary_salsa''']
}}}
{{{#!td style="vertical-align:top"
L
}}}
{{{#!td style="vertical-align:top"
.F.
}}}
{{{#!td
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'''  =||
|----------------
{{{#!td style="vertical-align:top"
['''g_<gaseous_compound>''']
}}}
{{{#!td style="vertical-align:top"
Concentration of <gaseous_compound>
}}}
{{{#!td style="vertical-align:top"
# m^-3^
}}}
{{{#!td
Options: 'g_H2SO4', 'g_HNO3', 'g_NH3', 'g_OCNV','g_OCSV'.

Time-averaged output not available.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#LDSA '''LDSA''']
}}}
{{{#!td style="vertical-align:top"
Total lung-deposited surface area
}}}
{{{#!td style="vertical-align:top"
µm^2^ cm^-3^

}}}
{{{#!td

}}}
|----------------
{{{#!td style="vertical-align:top"
['''N_bin<bin number>''']
}}}
{{{#!td style="vertical-align:top"
Aerosol number concentration in the aerosol size bin <bin number>
}}}
{{{#!td style="vertical-align:top"
# m^-3^

}}}
{{{#!td
Time-averaged output not available.
}}}
|----------------
{{{#!td style="vertical-align:top"
[=#Ntot '''Ntot''']
}}}
{{{#!td style="vertical-align:top"
Total aerosol number concentration
}}}
{{{#!td style="vertical-align:top"
# m^-3^

}}}
{{{#!td

}}}
|----------------
{{{#!td style="vertical-align:top"
[=#PM2.5 '''PM2.5''']
}}}
{{{#!td style="vertical-align:top"
Total mass concentration of particulate matter smaller than 2.5 µm in diameter

}}}
{{{#!td style="vertical-align:top"
kg m^-3^

}}}
{{{#!td

}}}
|----------------
{{{#!td style="vertical-align:top"
[=#PM10 '''PM10''']
}}}
{{{#!td style="vertical-align:top"
Total mass concentration of particulate matter smaller than 10 µm in diameter

}}}
{{{#!td style="vertical-align:top"
kg m^-3^

}}}
{{{#!td

}}}
|----------------
{{{#!td style="vertical-align:top"
['''s_<chemical_compound>''']
}}}
{{{#!td style="vertical-align:top"
Mass concentration of <chemical_compound> in the aerosol phase

}}}
{{{#!td style="vertical-align:top"
kg m^-3^

}}}
{{{#!td
Options: 's_BC', 's_DU', 's_NH', 's_NO', 's_OC', 's_SO4', 's_SS'.

Time-averaged output available only for black carbon (BC).
}}}