Metadata-Version: 2.4
Name: qa4sm_reader
Version: 0.12
Summary: Processes output of qa4sm.eodc.eu (NetCDF file), creating plots and providing the data in other formats.
Author-email: TU Wien <support@qa4sm.eu>
License: mit
Project-URL: Homepage, https://github.com/awst-austria/qa4sm-reader
Project-URL: Documentation, https://qa4sm-reader.readthedocs.io/en/latest/
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
License-File: LICENSE.txt
License-File: AUTHORS.rst
Requires-Dist: importlib-metadata; python_version < "3.8"
Requires-Dist: xarray>=2024.0.0
Requires-Dist: pandas
Requires-Dist: numpy
Requires-Dist: netcdf4<1.7.3
Requires-Dist: h5netcdf
Requires-Dist: matplotlib
Requires-Dist: pyQt5
Requires-Dist: seaborn
Requires-Dist: cartopy>=0.23.0
Requires-Dist: colorcet
Requires-Dist: parse
Requires-Dist: scipy
Requires-Dist: pygeogrids
Requires-Dist: pytesmo
Provides-Extra: testing
Requires-Dist: pytest-cov; extra == "testing"
Requires-Dist: coverage; extra == "testing"
Requires-Dist: pytest; extra == "testing"
Provides-Extra: building
Requires-Dist: setuptools>=46.1.0; extra == "building"
Requires-Dist: setuptools_scm[toml]>=5; extra == "building"
Requires-Dist: wheel; extra == "building"
Requires-Dist: packaging; extra == "building"
Requires-Dist: build; extra == "building"
Requires-Dist: twine; extra == "building"
Provides-Extra: docs
Requires-Dist: sphinx<7,>=3.2.1; extra == "docs"
Requires-Dist: sphinx_rtd_theme; extra == "docs"
Requires-Dist: mock; extra == "docs"
Requires-Dist: pillow; extra == "docs"
Requires-Dist: recommonmark; extra == "docs"
Requires-Dist: readthedocs-sphinx-ext; extra == "docs"
Requires-Dist: myst_parser; extra == "docs"
Requires-Dist: nbsphinx; extra == "docs"
Dynamic: license-file

============
qa4sm_reader
============

|ci| |cov| |pip|

.. |ci| image:: https://github.com/awst-austria/qa4sm-reader/actions/workflows/build.yml/badge.svg?branch=master
   :target: https://github.com/awst-austria/qa4sm-reader/actions

.. |cov| image:: https://coveralls.io/repos/awst-austria/qa4sm-reader/badge.png?branch=master
  :target: https://coveralls.io/r/awst-austria/qa4sm-reader?branch=master

.. |pip| image:: https://badge.fury.io/py/qa4sm-reader.svg
    :target: https://badge.fury.io/py/qa4sm-reader


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

.. code::

    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.

.. code::

    cd qa4sm-reader
    conda env create python=3.10 #  create environment from requirements.rst
    conda activate qa4sm_reader
    conda env update -f environment.yml -n qa4sm_reader
    pip install -e .

To remove the environment again, run:

.. code::

    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:

.. code::

    yapf file.py --in-place

Testing
-------

For testing, we use ``py.test``:

.. code::

    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:

.. code::

    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.


.. _qa4sm service: https://qa4sm.eu
.. _pyscaffold: https://pyscaffold.org
.. _pytest-runner: https://github.com/pytest-dev/pytest-runner
.. _terms and conditions: https://qa4sm.eu/terms
.. _open an issue: https://github.com/awst-austria/qa4sm-reader/issues
