Metadata-Version: 2.1
Name: yeoda
Version: 1.0.0
Summary: yeoda provides datacube classes for reading and writing well-defined and structured earth observation data
Home-page: https://github.com/TUW-GEO/yeoda
Author: TU Wien RS group
Author-email: remote.sensing@geo.tuwien.ac.at
License: MIT
Download-URL: https://github.com/TUW-GEO/yeoda/archive/v0.3.0.tar.gz
Description: <img align="right" src="https://github.com/TUW-GEO/yeoda/raw/master/docs/imgs/yeoda_logo.png" height="300" width="435">
        
        # yeoda
        [![Build Status](https://travis-ci.com/TUW-GEO/yeoda.svg?branch=master)](https://travis-ci.org/TUW-GEO/yeoda)
        [![Coverage Status](https://coveralls.io/repos/github/TUW-GEO/yeoda/badge.svg?branch=master)](https://coveralls.io/github/TUW-GEO/yeoda?branch=master)
        [![PyPi Package](https://badge.fury.io/py/yeoda.svg)](https://badge.fury.io/py/yeoda)
        [![RTD](https://readthedocs.org/projects/yeoda/badge/?version=latest)](https://yeoda.readthedocs.io/en/latest/?badge=latest)
        [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
        
        *Earth Observation (EO) data, I must read.*
        
        <!-- toc -->
        ## Contents
        
          * [Description](#description)
          * [Installation](#installation)
            * [Pip](#pip)
            * [Conda](#conda)
          * [Contribution](#contribution)
          * [Citation](#citation)<!-- endToc -->
        
        ## Description
        *yeoda* stands for **y**our **e**arth **o**bservation **d**ata **a**ccess and provides datacube classes 
        for reading and writing well-defined and structured earth observation data. These datacubes allow to filter, select, split, read and write data independently from the way the data is structured on disk.
        Internally, *yeoda* relies on functionalities provided by [*geopathfinder*](https://github.com/TUW-GEO/geopathfinder) 
        (filepath/filename and folder structure handling library), [*veranda*](https://github.com/TUW-GEO/veranda) (IO classes and higher-level data structure classes for vector and raster data)
        and [*geospade*](https://github.com/TUW-GEO/geospade) (raster and vector geometry/mosaic definitions and operations).
        
        For more details about *yeoda*'s functionality and many use case examples, please check out *yeoda*'s RTD documentation!
        
        ## Installation
        The package can be either installed via pip or if you solely want to work with *yeoda* or contribute, we recommend installing
        it as a conda environment. If you work already with your own environment, please have look at ``conda_env.yml`` or ``setup.cfg`` for the required dependencies.
        
        ### Pip
        To install *yeoda* via pip in your own environment, use:
        ```
        pip install yeoda
        ```
        **ATTENTION**: Packages like *gdal*, *cartopy*, or *geopandas* need more OS support and have more dependencies than other packages and can therefore not be installed solely via pip.
        Thus, for a fresh setup, an existing environment with the conda dependencies listed in ``conda_env.yml`` is expected.
        To create such an environment, you can run:
        ```
        conda create -n "yeoda" -c conda-forge python=3.8 mamba
        conda activate yeoda
        mamba install -c conda-forge python=3.8 gdal geopandas cartopy
        ```
        
        ### Conda
        The packages also comes along with a pre-defined conda environment (``conda_env.yml``). 
        This is especially recommended if you want to contribute to the project.
        The following script will install miniconda and setup the environment on a UNIX
        like system. Miniconda will be installed into ``$HOME/miniconda``.
        ```
        wget http://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh -O miniconda.sh
        bash miniconda.sh -b -p $HOME/miniconda
        export PATH="$HOME/miniconda/bin:$PATH"
        mamba env create -f conda_env.yml
        source activate yeoda
        ```
        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``.
        
        For Windows, use the following setup:
          * Download the latest [miniconda 3 installer](https://docs.conda.io/en/latest/miniconda.html) for Windows
          * Click on ``.exe`` file and complete the installation.
          * Add the folder ``condabin`` folder to your environment variable ``PATH``. 
            You can find the ``condabin`` folder usually under: ``C:\Users\username\AppData\Local\Continuum\miniconda3\condabin``
          * Finally, you can set up the conda environment via:
            ```
            conda env create -f conda_env.yml
            source activate yeoda
            ```
            
        After that you should be able to run 
        ```
        python setup.py test
        ```
        to run the test suite.
        
        ## Contribution
        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.
        If you want to contribute please follow these steps:
        
          * Fork the *yeoda* repository to your account
          * Clone the *yeoda* repository
          * Make a new feature branch from the *yeoda* 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
          
        ## Citation
        
        [![DOI](https://zenodo.org/badge/186986862.svg)](https://zenodo.org/badge/latestdoi/186986862)
        
        If you use this software in a publication then please cite it using the Zenodo DOI.
        Be aware that this badge links to the latest package version.
        
        Please select your specific version at <https://doi.org/10.5281/zenodo.3540693> (link to first release) to get the DOI of that version.
        You should normally always use the DOI for the specific version of your record in citations.
        This is to ensure that other researchers can access the exact research artefact you used for reproducibility.
        
        You can find additional information regarding DOI versioning at <http://help.zenodo.org/#versioning>.
        
Keywords: Earth Observation,Remote Sensing,Data Reader,Data Writer,Data Cube
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Version Control :: Git
Classifier: Programming Language :: Python :: 3.8
Classifier: Natural Language :: English
Description-Content-Type: text/markdown
Provides-Extra: testing
