/qa4sm-reader

Read QA4SM results (netcdf files), create box plots, maps and statistics. All the fancy stuff that happens after a validation finishes.

Primary LanguagePythonMIT LicenseMIT

qa4sm_reader

https://coveralls.io/repos/github/awst-austria/qa4sm-reader/badge.svg?branch=master

qa4sm_reader is a python package to read and plot the result files of the qa4sm service.

Installation

This package should be installable through pip (not yet tough, see development):

pip install qa4sm_reader

Usage

This package is used to analyze a qa4sm netCDF output file and produce all relevant plots and maps.

Development Setup

The project was setup using pyscaffold and closely follows the recommendations.

Install Dependencies

For Development we recommend creating a conda environment.

cd qa4sm-reader
conda env create #  create environment from requirements.rst
conda activate qa4sm-reader
python setup.py develop #  Links the code to the environment

To remove the environment again, run:

conda deactivate
conda env remove -n qa4sm_reader

Code Formatting

To apply pep8 conform styling to any changed files [we use yapf](https://github.com/google/yapf). The correct settings are already set in setup.cfg. Therefore the following command should be enough:

yapf file.py --in-place

Testing

For testing, we use py.test:

pytest

The dependencies are automatically installed by pytest-runner when you run the tests. The test-dependencies are listed in the testing field inside the [options.extras_require] section of setup.cfg. For some reasons, the dependencies are not installed as expected. To workaround, do:

pip install pytest-cov

The files used for testing are included in this package. They are however subject to other terms and conditions.

Known Issues

No known issues - please open an issue in case you come across a malfunctioning in the package.