Metadata-Version: 2.1
Name: smos
Version: 0.3.2
Summary: SMOS (Soil Moisture and Ocean Salinity) image data readers and TS converter
Home-page: https://github.com/TUW-GEO/smos
Author: TU Wien
Author-email: remote.sensing@geo.tuwien.ac.at
License: mit
Project-URL: Documentation, https://smos.readthedocs.io/en/latest/
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Description-Content-Type: text/x-rst; charset=UTF-8
License-File: LICENSE.txt
License-File: AUTHORS.rst
Requires-Dist: importlib-metadata; python_version < "3.8"
Requires-Dist: numpy<2,>=1.13.0
Requires-Dist: scipy
Requires-Dist: pandas
Requires-Dist: dask[distributed]
Requires-Dist: xarray
Requires-Dist: netCDF4
Requires-Dist: repurpose>=0.13.1
Requires-Dist: pyresample
Requires-Dist: pygeogrids>=0.3.2
Requires-Dist: pynetcf>=0.5.1
Requires-Dist: pygeobase
Requires-Dist: ease_grid
Requires-Dist: trollsift
Requires-Dist: h5py
Requires-Dist: more_itertools
Requires-Dist: cf-xarray==0.8.4
Requires-Dist: qa4sm_preprocessing>=0.3
Provides-Extra: testing
Requires-Dist: pytest-cov; extra == "testing"
Requires-Dist: pytest; extra == "testing"

====
SMOS
====

|ci| |cov| |pip| |doc| |doi|

.. |ci| image:: https://github.com/TUW-GEO/smos/actions/workflows/build.yml/badge.svg?branch=master
   :target: https://github.com/TUW-GEO/smos/actions

.. |cov| image:: https://coveralls.io/repos/github/TUW-GEO/smos/badge.svg?branch=master
  :target: https://coveralls.io/github/TUW-GEO/smos?branch=master

.. |pip| image:: https://badge.fury.io/py/smos.svg
    :target: http://badge.fury.io/py/smos

.. |doc| image:: https://readthedocs.org/projects/smos/badge/?version=latest
   :target: http://smos.readthedocs.org/

.. |doi| image:: https://zenodo.org/badge/167011732.svg
   :target: https://zenodo.org/badge/latestdoi/167011732


SMOS (Soil Moisture and Ocean Salinity) data readers and time series conversion tools.

Works great in combination with `pytesmo <https://github.com/TUW-GEO/pytesmo>`_.


Documentation & Software Citation
=================================
To see the latest full documentation click on the docs badge at the top.
To cite this package follow the Zenodo badge at the top and export the citation there.

Installation
============

Before installing this package via pip, please install the necessary
`conda <http://conda.pydata.org/miniconda.html>`_ dependencies:

.. code::

    $ conda create -n smos python=3.12
    $ conda env update -f environment.yml -n smos


Then

.. code::

    $ pip install smos

should work.

Example installation script
---------------------------

The following script will install miniconda and setup the environment on a UNIX
like system. Miniconda will be installed into ``$HOME/miniconda``.

.. code::

   wget https://repo.continuum.io/miniconda/Miniconda-latest-Linux-x86_64.sh -O miniconda.sh
   bash miniconda.sh -b -p $HOME/miniconda
   export PATH="$HOME/miniconda/bin:$PATH"
   git clone git@github.com:TUW-GEO/smos.git smos
   cd smos
   conda env create -f environment.yml
   source activate smos

This script adds ``$HOME/miniconda/bin`` temporarily to the ``PATH`` to do this
permanently add ``export PATH="$HOME/miniconda/bin:$PATH"`` to your ``.bashrc``
or ``.zshrc``

The second to last line in the example activates the ``smos`` environment.

After that you should be able to run:

.. code::

    pytest

to run the test suite.


Supported Products
==================

Currently the following products are supported, additional products can be
added.

- `SMOS IC <https://www.catds.fr/Products/Available-products-from-CEC-SM/SMOS-IC>`_: SMOS INRA-CESBIO (SMOS-IC) 25 km
- `SMOS L4 RZSM <https://www.catds.fr/Products/Available-products-from-CEC-SM/L4-Land-research-products>`_: SMOS CATDS-CESBIO (SMOS L4 RZSM) 25 km
- `SMOS L2 Science Product <https://earth.esa.int/eogateway/catalog/smos-science-products>`_: SMOS L2 Science Products (MIR_SMUDP2) 25 km
- SMOS L3

Build Docker image
==================
- Check out the repo at the branch/tag/commit you want bake into the image
- Make sure you have docker installed and run the command (replace the tag `latest`
  with something more meaningful, e.g. a version number)

.. code::

    docker build -t smos:latest . 2>&1 | tee docker_build.log

This will execute the commands from the Dockerfile. I.e. install a new environment
from the environment.yml file and install the checked out version of the smos
package.

To build and publish the image online, we have a GitHub Actions workflow in
``.github/workflows/docker.yml``

Contribute
==========

We are happy if you want to contribute. Please raise an issue explaining what
is missing or if you find a bug. We will also gladly accept pull requests
against our master branch for new features or bug fixes.


Guidelines
----------

If you want to contribute please follow these steps:

- Fork the smos repository to your account
- make a new feature branch from the smos master branch
- Add your feature
- please include tests for your contributions in one of the test directories
  We use py.test so a simple function called test_my_feature is enough
- submit a pull request to our master branch
