A climate visualization package

climvis offers command line tools to display climate data in your browser.

It was written for the University of Innsbruck's scientific programming lecture as a package template for the assignments.

The additions made by our gruop

• The user inputs a city, not lat lon
• Plot changes in the climate at the selected location
• Snow coverage
• Basic HTML styling
• Added the "uibkvis" command for plotting ACINN data

HowTo

Make sure you have all dependencies installed. These are:

• numpy
• pandas
• xarray
• motionless
• matplotlib
• windrose

Download the package and install it development mode. From the root directory, do:

$ pip install -e .

If you are on a university computer, you should use:

$ pip install --user -e .

Data needed for our version of climvis

Download the datafiles and put them somewhere on your PC. Then you make the file ".climvis.txt" and put it in your HOME directory, and the file shall only contain the path to these files:

• "your_path"/cru_cl1_topography.nc
• "your_path"/cru_ts4.03.1901.2018.pre.dat.nc
• "your_path"/cru_ts4.03.1901.2018.tmp.dat.nc

Command line interface

setup.py defines an "entry point" for a script to be used as a command line program. Currently, the only command installed is cruvis.

After installation, just type:

$ cruvis --help

or

$ uibkvis --help

To see what it can do for you.

Testing

I recommend to use pytest for testing. To test the package, do:

$ pytest .

From the package root directory.

License

With the exception of the setup.py file which was adapted from the sampleproject package, all the code in this repository is dedicated to the public domain.