ZPYin / ALiE

Atmospheric Lidar Intercomparison Evaluator

Atmospheric Lidar Intercomparison Evaluator Software

This repository includes code for analyzing atmospheric lidars within China Meteorological Administration (CMA) Lidar Network. Main features are:

• Data Conversion
• Data Preprocessing
• Internal Validation (internalChk)
• External Comparison (externalChk)

Matlab (b2017). We will not take care of bugs running under lower version of Matlab.

Download

You can download the code by Git.

cd {/path/to/work_directory}
git clone https://gitee.com/mualidar/cma-lidar-comparison

Update

The repository is under maintenance. New features and bug fixes would be applied. We recommend to use the latest version of the code base. You can update the code by the command below

cd {/path/to/work_directory/cma-lidar-comparison}
git pull origin master

Usage

Structure of the code

The functionality of the code is guided by the configuration file, which is a YAML format file. With different configurations, the code can do internal validation or external comparison or both. See the example below,

cd {/path/to/work_directory/cma-lidar-comparison}
setupLEToolbox   % include the code into the matlab search directories

LEMain('/path/to/configFile', 'flagReadData', true, 'flagQL', true, 'flagDebug', false);   % show lidar quicklooks
% Regarding the usage of LEMain, you can check by type in `help LEMain`

%    % Usecase 1: make quicklook (lidar quicklook)
%    LEMain('config.yml', 'flagReadData', true, 'flagQL', true);
%    % Usecase 2: internal check (internal validation)
%    LEMain('config.yml', 'flagReadData', true, 'flagInternalChk', true);
%    % Usecase 3: external check (external comparison)
%    LEMain('config.yml', 'flagReadData', true, 'flagExternalChk', true);
%    % Usecase 4: debug mode (debug mode)
%    LEMain('config.yml', 'flagReadData', 'flagInternalChk', true, 'flagDebug', true);
%    % Turn on watermark (add watermarks for the figures)
%    LEMain('config.yml', 'flagReadData', 'flagInternalChk', true, 'flagWaterMark', true);

More information of the configuration file can be found here.

Authors

Zhenping Yin Email: [e-mail] School of Remote Sensing and Information Engineering Wuhan University

If you used this code in your research, please cite the reference below, as a support for our work.

1. Wang, L.; Yin, Z.; Bu, Z.; Wang, A.; Mao, S.; Yi, Y.; Müller, D.; Chen, Y.; Wang, X. Quality assessment of aerosol lidars at 1064 nm in the framework of the MEMO campaign. Atmos. Meas. Tech. 2023, 16, 4307-4318, doi:10.5194/amt-16-4307-2023.