ulalume3@1: EARLIENT netcdf format checker
ulalume3@1: ------------------------------
ulalume3@1: 
ulalume3@1: The aim of this script is to check if a netcdf file has the correct 
ulalume3@1: format to be used with the EARLINET's Single Calculus Chain.
ulalume3@1: 
ulalume3@1: It can check raw lidar data format as well as ancillary file format 
ulalume3@1: i.e. overlap, sounding, and lidar ratio files.
ulalume3@1: 
ulalume3@1: 
ulalume3@1: .. note::
ulalume3@1:    This script can help you detect some usual mistakes, but does
ulalume3@1:    not necessarily detect all possible errors in the files. In other
ulalume3@1:    words, your file might look OK through this script but still give
ulalume3@1:    errors when used in the SCC. In that case please let me know to add
ulalume3@1:    the appropriate checks in the specifications.
ulalume3@1: 
ulalume3@1:    
ulalume3@1: Dependencies
ulalume3@1: ~~~~~~~~~~~~
ulalume3@1: You need to have the netCDF4 python module installed.
ulalume3@1: 
ulalume3@1: https://pypi.python.org/pypi/netCDF4/
ulalume3@1: 
ulalume3@1: 
ulalume3@1: Command line options
ulalume3@1: ~~~~~~~~~~~~~~~~~~~~
ulalume3@1: 
ulalume3@1: Using the -h option in the command line, you can see the following instructions::
ulalume3@1: 
ulalume3@1:    usage: netcdf_checker.py [-h] [-s {data,overlap,lidar_ratio,sounding}]
ulalume3@1:                          [-l {error,warning,notification}]
ulalume3@1:                          file
ulalume3@1:    positional arguments:
ulalume3@1:       file                  The path of the file to be checked
ulalume3@1: 
ulalume3@1:    optional arguments:
ulalume3@1:       -h, --help            show this help message and exit
ulalume3@1:       -s {data,overlap,lidar_ratio,sounding}, --specs {data,overlap,lidar_ratio,sounding}
ulalume3@1:                         The specificiations to use
ulalume3@1:       -l {error,warning,notification}, --level {error,warning,notification}
ulalume3@1:                         The output level
ulalume3@1: 
ulalume3@1: Examples
ulalume3@1: ~~~~~~~~
ulalume3@1: 
ulalume3@1: Check the format of a data file::
ulalume3@1: 
ulalume3@1:    python netcdf_checker.py 20140101bu00.nc
ulalume3@1: 
ulalume3@1: Check the format of a overlap file::
ulalume3@1: 
ulalume3@1:    python netcdf_checker.py ov_20140101bu00.nc -s overlap
ulalume3@1: 
ulalume3@1: Check a data file and print all messages, including notifications::
ulalume3@1: 
ulalume3@1:    python netcdf_checker.py 20140101bu00.nc -l notification