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