ATLAS configuration file reference¶
Generated reference
This page was generated by ATLAS 1.2.0.rc4 from the parser schema, src/atlas_actris/templates/config_template_flavor.py, and the explicit selection in src/atlas_actris/templates/template_profiles.py.
The corresponding generated full INI template is config_file.ini.
System¶
| Parameter | Description | Type | Category | Default | Limits / allowed values | Example | Version history |
|---|---|---|---|---|---|---|---|
station_id |
Station ID (e.g. SCC/EARLINET station ID) | str |
mandatory | empty parameter --> ignored or automatic selection |
the |
Unchanged from previous ATLAS versions. | |
lidar_name |
Human-readable name of the lidar system. | str |
optional | empty parameter --> ignored or automatic selection |
THELISYS |
Unchanged from previous ATLAS versions. | |
station_name |
Human-readable name of the station. | str |
optional | empty parameter --> ignored or automatic selection |
Thessaloniki |
Unchanged from previous ATLAS versions. | |
lidar_id |
SCC lidar ID | int |
optional | empty parameter --> ignored or automatic selection |
199 |
Unchanged from previous ATLAS versions. | |
version_name |
Human-readable version name of the lidar configuration. | str |
optional | empty parameter --> ignored or automatic selection |
default |
Unchanged from previous ATLAS versions. | |
version_id |
SCC version ID | int |
optional | empty parameter --> ignored or automatic selection |
1 |
Unchanged from previous ATLAS versions. | |
configuration_name |
Human-readable name of the configuration. | str |
optional | empty parameter --> ignored or automatic selection |
Nighttime |
Unchanged from previous ATLAS versions. | |
configuration_id |
SCC configuration ID | int |
optional | empty parameter --> ignored or automatic selection |
665 |
Unchanged from previous ATLAS versions. | |
station_altitude |
Station altitude above sea level in meters. | float |
optional | empty parameter --> ignored or automatic selection |
Range: 0 to 5000 | 60 |
Renamed in ATLAS 1.0.0 from altitude. Old name removed in ATLAS 1.0.0. Parameter renamed during the ATLAS 1.0.0 schema cleanup. |
station_latitude |
Station latitude in decimal degrees. | float |
optional | empty parameter --> ignored or automatic selection |
Range: -90 to 90 | 40.63 |
Renamed in ATLAS 1.0.0 from latitude. Old name removed in ATLAS 1.0.0. Parameter renamed during the ATLAS 1.0.0 schema cleanup. |
station_longitude |
Station longitude in decimal degrees. | float |
optional | empty parameter --> ignored or automatic selection |
Range: -180 to 180 | 22.96 |
Renamed in ATLAS 1.0.0 from longitude. Old name removed in ATLAS 1.0.0. Parameter renamed during the ATLAS 1.0.0 schema cleanup. |
zenith_angle |
Lidar pointing zenith angle in degrees. | float |
optional | empty parameter --> ignored or automatic selection |
Range: 0 to 85 | 0 |
Unchanged from previous ATLAS versions. |
azimuth_angle |
Lidar pointing azimuth angle in degrees. | float |
optional | empty parameter --> ignored or automatic selection |
Range: 0 to 360 | 0 |
Unchanged from previous ATLAS versions. |
Channels¶
| Parameter | Description | Type | Category | Default | Limits / allowed values | Example | Version history |
|---|---|---|---|---|---|---|---|
recorder_channel_id |
Recorder channel IDs as they appear in the raw lidar files. For PollyXT raw files use ascending numbers starting from 1 as the recorder channel ID. For SCC raw files the recorder_channel_id corresponds to the scc_channel_id. | list[str] |
mandatory | empty parameter --> ignored or automatic selection |
BT0, BC0 |
Unchanged from previous ATLAS versions. | |
scc_channel_id |
SCC channel IDs corresponding to each recorder_channel_id entry. | list[int] |
optional | empty parameter --> ignored or automatic selection |
1893, 1895, 1700 |
Unchanged from previous ATLAS versions. | |
telescope_type |
ATLAS telescope type identifier for each channel. Choose among: #• n: first near range telescope (sort by descending expected distance of full overlap order) #• m: second near range telescope #• l: third near range telescope #• f: first far range telescope (sort by ascending expected distance of full overlap order) #• g: second far range telescope #• h: third far range telescope #• x: first standalone telescope #• y: second standalone telescope #• z: third standalone telescope |
list[str] |
mandatory | empty parameter --> ignored or automatic selection |
Allowed values: n, f, x, m, g, y, l, h, z | x, x, x, x, x, x, y, y, y, y, y, y, z, z |
Unchanged from previous ATLAS versions. |
channel_type |
ATLAS channel type identifier for each channel. Choose among: #• p: co-polar #• c: cross-polar #• t: total (no depolarization) #• v: vibrational Raman #• r: rotational Raman #• a: Cabannes (HSRL) #• f: fluorescence #• d: dual field of view |
list[str] |
mandatory | empty parameter --> ignored or automatic selection |
Allowed values: p, c, t, v, r, a, f | c, c, p, p, v, v, c, c, p, p, r, r, t, t |
Unchanged from previous ATLAS versions. |
acquisition_mode |
ATLAS acquisition mode identifier for each channel. Use: a for analog channels, p for photon channels #• a: for analog channels #• p: for photon channels |
list[str] |
optional | empty parameter --> ignored or automatic selection |
Allowed values: a, p | a, p, a, p, a, p, a, p, a, p, a, p, a, p, a, p, a, p, a, a |
Unchanged from previous ATLAS versions. Modified identifiers with respect to pre v1.0.0 versions. In the past identifier 0 was used for analog channels and identifier 1 was used for photon channels. |
channel_subtype |
ACTRIS channel subtype identifier for each channel. Choose among: #• r: Signal Reflected from a PBS #• t: Signal Transmitted through a PBS #• n: N2 Ramal line #• o: O2 Ramal line #• w: H2O Ramal line #• c: CH4 Ramal line #• h: High Rotational Raman #• l: Low Rotational Raman #• a: Mie (aerosol) HSRL signal #• m: Molecular HSRL signal #• b: Broadband Fluorescence #• s: Spectral Fluorescence #• x: No specific subtype |
list[str] |
mandatory | empty parameter --> ignored or automatic selection |
Allowed values: r, t, n, o, w, c, h, l, a, m, b, s, x | r, r, t, t, n, n, t, t, r, r, x, x, x, x |
Unchanged from previous ATLAS versions. |
zero_bin |
Bin index corresponding to the trigger/zero range for each channel. | list[int] |
recommended | 0 |
0, 0, 0 |
Renamed in ATLAS 1.0.0 from daq_trigger_offset. Old name removed in ATLAS 1.0.0. Parameter renamed during the ATLAS 1.0.0 schema cleanup. |
|
dead_time |
Dead time of photon-counting channels in nanoseconds. | list[float] |
recommended | empty parameter --> ignored or automatic selection |
Range: 0.0 to 5.0 | _, 3.7, _, 3.7, _, 3.7, _, 3.7, _, 3.7, _, 3.7, _, _ |
Unchanged from previous ATLAS versions. |
background_low_bin |
Lower bin index of the background region for each channel. Used for the background calculation/correction. The bin index corresponds to the original signal range bins prior to the zero bin correction. ATLAS assumes 1 as the first bin index. | list[int] |
recommended | empty parameter --> ignored or automatic selection |
Range: 0 to 32768 | 100, 100, 100, 100, 100, 100, 100, 100,100, 100, 100, 100, 14000, 14000 |
Unchanged from previous ATLAS versions. |
background_high_bin |
Upper bin index of the background region for each channel. Used for the background calculation/correction. The bin index corresponds to the original signal range bins prior to the zero bin correction. ATLAS assumes 1 as the first bin index. | list[int] |
recommended | empty parameter --> ignored or automatic selection |
Range: 0 to 32768 | 900, 900, 900, 900, 900, 900, 900, 900, 900, 900, 900, 900, 16000, 16000 |
Unchanged from previous ATLAS versions. |
G |
Polarization cross talk parameter G for each channel. Use 1. for non-polarization channels if the cross-talk is unknown. | list[float] |
recommended | empty parameter --> ignored or automatic selection |
Range: -2 to 2.0 | 1.002, 1.002, 1.002, 1.002, 1., 1., 1., 1., 1., 1., 1., 1., 1., 1. |
New in ATLAS 1.0.0. |
H |
Polarization cross talk H for each channel. Use 0. for non-polarization channels if the cross-talk is unknown. | list[float] |
recommended | empty parameter --> ignored or automatic selection |
Range: -2 to 2.0 | -0.987, -0.987, 0.987, 0.987, 0., 0., -0.97, -0.97, 0.97, 0.97, 0., 0., 0., 0. |
New in ATLAS 1.0.0. |
emitted_wavelength |
Emitted laser wavelength for each channel in nm. Defaults to 1064.14, 532.07, and 354.71 for 1064, 532, and 1064 related channels. It is recommended to either provide it with 2 decimal point accuracy or leave empty if it is not accurately known. | list[float] |
optional | empty parameter --> ignored or automatic selection |
Range: 200.0 to 3000.0 | 354.71, 354.71, 354.71, 354.71, 354.71, 354.71, 532.07, 532.07, 532.07, 532.07, 532.07, 532.07, 1064.14, 1064.14 |
Unchanged from previous ATLAS versions. |
detected_wavelength |
Detected wavelength for each channel in nm. It corresponds to the central wavelength of the interference filter. It is recommended to provide it with 2 decimal point accuracy. | list[float] |
optional | empty parameter --> ignored or automatic selection |
Range: 200.0 to 3000.0 | 354.75, 354.75, 354.73, 354.73, 386.70, 386.70, 532.02, 532.02, 532.04, 532.04, 607.40, 607.40, 1064.10, 1064.10 |
Unchanged from previous ATLAS versions. |
channel_bandwidth |
Interference-filter bandwidth for each channel in nm.It is recommended to provide it with 2 decimal point accuracy. | list[float] |
recommended | 1.0 |
Range: 0.05 to 150.0 | 0.55, 0.55, 0.51, 0.51, 1.10, 1.10, 0.50, 0.50, 0.51, 0.51, 1.15, 1.15, 1.05, 1.05 |
Unchanged from previous ATLAS versions. |
bins |
Number of range bins for each channel. | list[int] |
optional | empty parameter --> ignored or automatic selection |
Range: 512 to 32768 | 16384, 16384, 16384, 16384, 16384, 16384, 16384, 16384, 16384, 16384, 16384, 16384, 16384, 16384 |
Unchanged from previous ATLAS versions. |
data_acquisition_range |
Data acquisition range for each analog channel in mV. Use _ for photon channels. | list[float] |
optional | empty parameter --> ignored or automatic selection |
Minimum: 0.0 | 100., 100., 100., 100., 100., 100., 100., 100., 100., 100., 100., 100., 500., 500. |
Unchanged from previous ATLAS versions. |
range_resolution |
Range resolution for each channel in meters. | list[float] |
optional | empty parameter --> ignored or automatic selection |
Range: 1.0 to 30.0 | 3.75, 3.75, 3.75, 3.75, 3.75, 3.75, 3.75, 3.75, 3.75, 3.75, 3.75, 3.75, 7.5, 7.5 |
Unchanged from previous ATLAS versions. |
laser_repetition_rate |
Laser repetition rate for each channel in Hz. | list[float] |
optional | empty parameter --> ignored or automatic selection |
Range: 10.0 to 10000.0 | 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 100, 100 |
Unchanged from previous ATLAS versions. |
polarization_calibration¶
| Parameter | Description | Type | Category | Default | Limits / allowed values | Example | Version history |
|---|---|---|---|---|---|---|---|
ch_r |
ATLAS channel ID for the reflected polarization channels. If unsure of the actual ATLAS channel ID, process once without filling up this section. The ATLAS channel ID is reported in the header of the plots for each channel. | list[str] |
recommended | empty parameter --> ignored or automatic selection |
0355xcar, 0355xcpr, 0532ypar, 0532ypar |
Moved in ATLAS 1.0.0 from settings_file. Old names removed in ATLAS 1.0.0. Since v1.0.0 the parameters related to polarazation channel pairs have been moved to the configuration file. |
|
ch_t |
ATLAS channel ID for the transmitted polarization channels. If unsure of the actual ATLAS channel ID, process once without filling up this section. The ATLAS channel ID is reported in the header of the plots for each channel. | list[str] |
recommended | empty parameter --> ignored or automatic selection |
0355xpat, 0355xppt, 0532ycat, 0532ycat |
Moved in ATLAS 1.0.0 from settings_file. Old names removed in ATLAS 1.0.0. Since v1.0.0 the parameters related to polarazation channel pairs have been moved to the configuration file. |
|
K |
Cross talk parameter K for polarization calibration. | list[float] |
recommended | 1.0 |
Range: 0.5 to 2.0 | 1.1520, 1.1520, 0.9804, 0.9804 |
Moved in ATLAS 1.0.0 from settings_file. Old names removed in ATLAS 1.0.0. Since v1.0.0 the parameters related to polarazation channel pairs have been moved to the configuration file. |
R_to_T_transmission_ratio |
Transmission ratio between reflected and transmitted polarization paths. Provide when different ND filters are used for the polarization calibration and the Rayleigh measurements. | list[float] |
recommended | 1.0 |
Range: 0.001 to 1000.0 | 5.64, 5.64, 10.7, 10.7 |
Moved in ATLAS 1.0.0 from settings_file. Old names removed in ATLAS 1.0.0. Since v1.0.0 the parameters related to polarazation channel pairs have been moved to the configuration file. |
eta |
Polarization calibration factor eta. Provide it only in case there is no dedicated polarisation calibration measurement but the calibration factor is known from apolarization calibration performed on a different day. This parameter is mainly used for testing. | list[float] |
recommended | 1.0 |
Range: 0.001 to 1000.0 | 1.0 |
New in ATLAS 1.0.0. |
gluing¶
| Parameter | Description | Type | Category | Default | Limits / allowed values | Example | Version history |
|---|---|---|---|---|---|---|---|
ch_n |
Near-range channel IDs used for signal gluing. | list[str] |
recommended | empty parameter --> ignored or automatic selection |
0532xcnr |
Unchanged from previous ATLAS versions. | |
ch_f |
Far-range channel IDs used for signal gluing. | list[str] |
recommended | empty parameter --> ignored or automatic selection |
0532xcfr |
Unchanged from previous ATLAS versions. |
water_vapour¶
| Parameter | Description | Type | Category | Default | Limits / allowed values | Example | Version history |
|---|---|---|---|---|---|---|---|
ch_w |
Water-vapour Raman channel IDs. | list[str] |
recommended | empty parameter --> ignored or automatic selection |
0407xwpr |
Unchanged from previous ATLAS versions. | |
ch_v |
Reference channel IDs used with water-vapour channels. | list[str] |
recommended | empty parameter --> ignored or automatic selection |
0387xvpr |
Unchanged from previous ATLAS versions. | |
wv_calibration_factor |
Water-vapour calibration factor. | list[float] |
recommended | 1.0 |
1.0 |
Unchanged from previous ATLAS versions. |
temperature¶
| Parameter | Description | Type | Category | Default | Limits / allowed values | Example | Version history |
|---|---|---|---|---|---|---|---|
ch_h |
High-rotational-Raman channel IDs for temperature retrievals. | list[str] |
recommended | empty parameter --> ignored or automatic selection |
0353xhpr |
Unchanged from previous ATLAS versions. | |
ch_l |
Low-rotational-Raman channel IDs for temperature retrievals. | list[str] |
recommended | empty parameter --> ignored or automatic selection |
0353xlpr |
Unchanged from previous ATLAS versions. | |
alpha_prime |
Temperature calibration coefficient alpha prime. | list[float] |
recommended | 1.0 |
1.0 |
Unchanged from previous ATLAS versions. | |
beta_prime |
Temperature calibration coefficient beta prime. | list[float] |
recommended | 1.0 |
1.0 |
Unchanged from previous ATLAS versions. | |
gamma_prime |
Temperature calibration coefficient gamma prime. | list[float] |
recommended | 1.0 |
1.0 |
Unchanged from previous ATLAS versions. |