ALCF is written in Python and Fortran. Installation on Linux is recommended. Installation on other operating systems may be possible and planned in the future, but is not described here at the moment.
Install the following required software:
- gfortran and gcc (usually available in Linux distribution repositories)
- Python 3 (usually pre-installed on Linux distributions)
Download and unpack the latest ALCF version, and run commands below in the unpacked directory.
Before compiling the dependencies, you might need to install the following packages: gfortran, libexpat-dev, m4, libcurl4-openssl-dev and zlib1g-dev, python3-setuptools, python3-pip and eccodes. Install with:
# Debian, Devuan, Ubuntu: apt-get install gfortran libexpat-dev m4 libcurl4-openssl-dev zlib1g-dev python3-setuptools python3-pip libeccodes-tools # Fedora: yum install make patch g++ gfortran expat-devel m4 libcurl-devel zlib-devel python3-setuptools python3-pip eccodes
./download_dep ./build_dep make
download_dep will automatically download required libraries and
will compile the libraries (it might take up to 5 minutes to finish).
To install in system directories:
pip3 install https://github.com/peterkuma/ds-python/archive/master.zip \ https://github.com/peterkuma/aquarius-time/archive/master.zip \ https://github.com/peterkuma/pst/archive/master.zip python3 setup.py install
To install in user directories (make sure
~/.local/bin is in the environmental variable
pip3 install --user https://github.com/peterkuma/ds-python/archive/master.zip \ https://github.com/peterkuma/aquarius-time/archive/master.zip \ https://github.com/peterkuma/pst/archive/master.zip python3 setup.py install --user
You should now be able to run ALCF in the terminal:
alcf - Tool for processing of automatic lidar and ceilometer (ALC) data and intercomparison with atmospheric models. Usage: alcf <cmd> [<options>] alcf <cmd> --help Arguments: - `cmd`: see Commands below - `options`: command options Options: `--help`: print help for command Commands: - `convert`: convert input instrument or model data to ALCF standard NetCDF - `model`: extract model data at a point or along a track - `cosp`: simulate lidar measurements from model data using COSP - `lidar`: process lidar data - `stats`: calculate cloud occurrence statistics - `plot`: plot lidar data - `plot_stats`: plot lidar statistics