ACTRIS Cloudnet data processing

Cloudnet data processing glue code.

Installation

The data processing tools are distributed as a Docker container as a part of the Cloudnet development toolkit. Refer to README of the dev-toolkit repository on how to set up the CLU development environment.

Scripts

Once the CLU development environment is running, start the cloudnet-processing container by running:

./run-bash

The scripts are located in scripts/ folder and should be run from the root:

./scripts/<script_name.py> --arg1 foo --arg2 bar ...

The following scripts are provided:

cloudnet.py

The main wrapper for running all the processing steps.

usage: cloudnet.py [-h] [-s SITES] [-p PRODUCTS] [-i INSTRUMENTS] [-m MODELS] [-u UUIDS]
                   [--start YYYY-MM-DD] [--stop YYYY-MM-DD] [-d YYYY-MM-DD]
                   [-c {process,plot,qc,freeze,dvas,fetch,hkd}] [--raw]

Arguments:

Short	Long	Default	Description
-h	--help		Show help and exit.
-s	--sites		E.g, hyytiala,granada.
-p	--products		E.g. lidar,classification,l3-cf.
-i	--instruments		E.g. mira-35,hatpro.
-m	--models		E.g. ecmwf,gdas1.
-u	--uuids		Instrument UUIDs, e.g. db58480f-58ca-49ad-995c-6c3b89e9a0fc.
	--start	five days ago	Starting date (included).
	--stop	current day	Stopping date (included).
-d	--date		Single date to be processed. Alternatively, --start and --stop can be defined.
-c	--cmd	process	Command to be executed.
	--raw		Fetch raw data. Only applicable if the command is fetch.

Shortcut for the --products argument:

Shortcut	Meaning
l1b	disdrometer,doppler-lidar,lidar,mwr,radar,weather-station,model
l1c	categorize,categorize-voodoo,mwr-l1c,doppler-lidar-wind
l2	classification,iwc,lwc,drizzle,ier,der,mwr-single,mwr-multi,classification-voodoo
l3	l3-cf,l3-iwc,l3-lwc
doppy	doppler-lidar,doppler-lidar-wind
voodoo	categorize-voodoo,classification-voodoo
mwrpy	mwr-l1c,mwr-single,mwr-multi
standard	All products except experimental and Level 3.

Notes:

• --products has no effect when fetching raw data.

submit-data-to-dev.py

Submit raw files to data portal in your development environment.

usage: submit-data-to-dev.py [-h] -s SITE -i INSTRUMENT -d DATE --pid PID filename

Positional arguments:

Name	Description
filename	Raw file to submit.

Options:

Short	Long	Description
-h	--help	Show help and exit.
-s	--site	Submit data to site, e.g, hyytiala.
-d	--date	Date to submit, e.g. 2023-10-27.
-i	--instrument	Instrument to submit, e.g. chm15k.
	--pid	Instrument PID to submit.

worker.py

Launch a worker with ./scripts/worker.py to process incoming tasks. Used mainly in production to process data in real-time.

Licence

MIT