HIS Files (ASCII) - BLVIEW - CL31 - CL51

HIS files are log files that contain measurement data in ASCII format.

HIS files are generated automatically for level 2 (L2) and level 3 (L3) data. Manually generated HIS files contain level 3 data.

Table 1. HIS Files

His File Property	Automatically Generated Files	Manually Generated Files (Export)
Data	Level 2, level 3	Level 3
Preset	Default and all existing presets (separate files for each preset)	User-selectable preset
Storage location	C:\BLView\History\<year>\<month>	C:\Program Files (x86)\Vaisala\BLView\bin\History\<month>

The filename is of format <CEILOMETER_NAME>_<DATA_LEVEL>_<PRESET>_<DD>.his.

An example of a filename: CEILOMETER_1_LEVEL_2_DEFAULT_27.his.

Table 2. Fields of HIS Filenames

Name	Description	Value
CEILOMETER_NAME	Ceilometer identifier as defined in ceilometer	CEILOMETER_1
DATA_LEVEL	Identification of the data level	LEVEL_2
PRESET	Algorithm information (L3 files only)	DEFAULT
DD	Day of month	27

Table 3. Level 2 HIS Files

Property	Description
CREATEDATE	Timestamp in format YYYY-MM-DD hh:mm:ss (UTC)
UNIXTIME	Timestamp (Unix time)
CEILOMETER	Ceilometer identifier
PERIOD	Data update period in seconds
BS_PROFILE	Signal backscatter profile rendered with the resolution of 10 and height of 4500 meters (14 760 ft)

Table 4. Level 3 HIS Files

Property	Description
CREATEDATE	Timestamp in format YYYY-MM-DD hh:mm:ss (UTC)
UNIXTIME	Timestamp (Unix time)
CEILOMETER	Ceilometer identifier
PERIOD	Data update period in seconds
SAMPLE_COUNT	Number of level 2 samples used to compute this level 3
BL_HEIGHT_1	First boundary layer height candidate (meters) (-999 if no candidate)
BL_HEIGHT_2	Second boundary layer height candidate (meters) (-999 if no candidate)
BL_HEIGHT_3	Third boundary layer height candidate (meters) (-999 if no candidate)
BL_INDEX_1	Quality index for first boundary layer height candidate (-999 if no candidate)
BL_INDEX_2	Quality index for second boundary layer height candidate (-999 if no candidate)
BL_INDEX_3	Quality index for third boundary layer height candidate (-999 if no candidate)
MEAN_LAYER_HEIGHT	Hourly average mixing layer height
MEAN_LAYER_INDEX	Quality index for the hourly average mixing layer height
CLOUD_STATUS	Cloud detection status, 0 - 4
CLOUD_1	First cloud base (meters) or vertical visibility (meters) (-999 if no cloud base or vertical visibility)
CLOUD_2	Second cloud base (meters) or highest received signal in vertical visibility (meters) (-999 if no cloud base or vertical visibility)
CLOUD_3	Third cloud base (meters) (-999 if no cloud base)
PARAMETERS	Level 2 to level 3 algorithm parameters

Here is an example of a level 3 HIS file with custom parameters.

History file
CREATEDATE, UNIXTIME, CEILOMETER, PERIOD, SAMPLE_COUNT, BL_HEIGHT_1, BL_HEIGHT_2, BL_HEIGHT_3, BL_INDEX_1, BL_INDEX_2, BL_INDEX_3, MEAN_LAYER_HEIGHT, MEAN_LAYER_INDEX, CLOUD_STATUS, CLOUD_1, CLOUD_2, CLOUD_3, PARAMETERS
2018-04-23 00:00:00, 1524441600, CL31 - C2, 16, 82, 70, 320, 600, 2, 1, 2, 83, 1, 1, 7405, -999, -999, 1_360_1_3120_10_30_4000_3_0_1_500_1000_4000_60
2018-04-23 00:00:16, 1524441616, CL31 - C2, 16, 81, 70, 320, 600, 2, 1, 2, 83, 1, 1, 7445, -999, -999, 1_360_1_3120_10_30_4000_3_0_1_500_1000_4000_60
2018-04-23 00:00:32, 1524441632, CL31 - C2, 16, 81, 70, 320, 600, 2, 1, 2, 83, 1, 1, 7405, -999, -999, 1_360_1_3120_10_30_4000_3_0_1_500_1000_4000_60

Property	Description / Value
CREATEDATE	2018-02-28 22:00:00
UNIXTIME	1519855200
CEILOMETER	HelsinkiNE
PERIOD
SAMPLE_COUNT	82
BL_HEIGHT_1	350
BL_HEIGHT_2	-999 (no candidate)
BL_HEIGHT_3	-999 (no candidate)
BL_INDEX_1	3
BL_INDEX_2	-999 (no candidate)
BL_INDEX_3	-999 (no candidate)
MEAN_LAYER_HEIGHT	190
MEAN_LAYER_INDEX	3
CLOUD_STATUS	0
CLOUD_1	-999 (no cloud base or vertical visibility)
CLOUD_2	-999 (no cloud base or vertical visibility)
CLOUD_3	-999 (no cloud base)
PARAMETERS	1_360_1_3120_10_30_4000_3_0_1_500_1000_4000_60