{ "info": { "author": "Sinergise EO research team", "author_email": "eoresearch@sinergise.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "Intended Audience :: Education", "Intended Audience :: Science/Research", "License :: OSI Approved :: MIT License", "Operating System :: MacOS", "Operating System :: Microsoft :: Windows", "Operating System :: Unix", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Topic :: Scientific/Engineering" ], "description": "[![Package version](https://badge.fury.io/py/eo-learn.svg)](https://pypi.org/project/eo-learn/)\n[![Build Status](https://travis-ci.org/sentinel-hub/eo-learn.svg?branch=master)](https://travis-ci.org/sentinel-hub/eo-learn)\n[![Docs status](https://readthedocs.org/projects/eo-learn/badge/?version=latest)](https://eo-learn.readthedocs.io)\n[![License](https://img.shields.io/pypi/l/eo-learn.svg)](https://github.com/sentinel-hub/eo-learn/blob/master/LICENSE)\n[![Overall downloads](http://pepy.tech/badge/eo-learn)](https://pepy.tech/project/eo-learn)\n[![Last month downloads](https://pepy.tech/badge/eo-learn/month)](https://pepy.tech/project/eo-learn)\n[![codecov](https://codecov.io/gh/sentinel-hub/eo-learn/branch/master/graph/badge.svg)](https://codecov.io/gh/sentinel-hub/eo-learn)\n\n\n# eo-learn\n**eo-learn makes extraction of valuable information from satellite imagery easy.**\n\nThe availability of open Earth observation (EO) data through the Copernicus and Landsat programs represents an\nunprecedented resource for many EO applications, ranging from ocean and land use and land cover monitoring,\ndisaster control, emergency services and humanitarian relief. Given the large amount of high spatial resolution\ndata at high revisit frequency, techniques able to automatically extract complex patterns in such _spatio-temporal_\ndata are needed.\n\n**`eo-learn`** is a collection of open source Python packages that have been developed to seamlessly access and process\n_spatio-temporal_ image sequences acquired by any satellite fleet in a timely and automatic manner. **`eo-learn`** is\neasy to use, it's design modular, and encourages collaboration -- sharing and reusing of specific tasks in a typical\nEO-value-extraction workflows, such as cloud masking, image co-registration, feature extraction, classification, etc. Everyone is free\nto use any of the available tasks and is encouraged to improve the, develop new ones and share them with the rest of the community.\n\n**`eo-learn`** makes extraction of valuable information from satellite imagery as easy as defining a sequence of operations to be performed on satellite imagery. Image below illustrates a processing chain that maps water in satellite imagery by thresholding the Normalised Difference Water Index in user specified region of interest.\n\n![eo-learn-workflow0illustration](docs/source/figures/eo-learn-illustration.png)\n\n**`eo-learn`** _library acts as a bridge between Earth observation/Remote sensing field and Python ecosystem for data science and machine learning._ The library is written in Python and uses NumPy arrays to store and handle remote sensing data. Its aim is to make entry easier for non-experts to the field of remote sensing on one hand and bring the state-of-the-art tools for computer vision, machine learning, and deep learning existing in Python ecosystem to remote sensing experts.\n\n## Package Overview\n\n**`eo-learn`** is divided into several subpackages according to different functionalities and external package dependencies. Therefore it is not necessary for user to install entire package but only the parts that he needs.\n\nAt the moment there are the following subpackages:\n\n- **`eo-learn-core`** - The main subpackage which implements basic building blocks (`EOPatch`, `EOTask` and `EOWorkflow`) and commonly used functionalities.\n- **`eo-learn-coregistration`** - The subpackage that deals with image co-registraion.\n- **`eo-learn-features`** - A collection of utilities for extracting data properties and feature manipulation.\n- **`eo-learn-geometry`** - Geometry subpackage used for geometric transformation and conversion between vector and raster data.\n- **`eo-learn-io`** - Input/output subpackage that deals with obtaining data from Sentinel Hub services or saving and loading data locally.\n- **`eo-learn-mask`** - The subpackage used for masking of data and calculation of cloud masks.\n- **`eo-learn-ml-tools`** - Various tools that can be used before or after the machine learning process.\n- **`eo-learn-visualization`** - Visualization tools for core elements of eo-learn.\n\n## Installation\n\nThe package requires Python version **>=3.5** . It can be installed with:\n\n```bash\npip install eo-learn\n```\n\nIn order to avoid heavy package dependencies it is possible to install each subpackage separately:\n```bash\npip install eo-learn-core\npip install eo-learn-coregistration\npip install eo-learn-features\npip install eo-learn-geometry\npip install eo-learn-io\npip install eo-learn-mask\npip install eo-learn-ml-tools\npip install eo-learn-visualization\n```\n\nBefore installing `eo-learn` on **Windows** it is recommended to install the following packages from [Unofficial Windows wheels repository](https://www.lfd.uci.edu/~gohlke/pythonlibs/):\n\n```bash\ngdal\nrasterio\nshapely\nfiona\n```\n\nOne of dependecies of `eo-learn-mask` subpackage is `lightgbm` package. On windows it requires 64 bit Python distribution. If having problems during installation please check [LightGBM installation guide](https://lightgbm.readthedocs.io/en/latest/Installation-Guide.html).\n\nA part of subpackage `eo-learn-visualization` requires additional dependencies which don't get installed by default. Those can be installed with\n\n```bash\npip install eo-learn-visualization[FULL]\n```\n\n## Documentation\n\nFor more information on the package content, visit [readthedocs](https://eo-learn.readthedocs.io/).\n\n## Contributions\n\nIf you would like to contribute to `eo-learn`, check out our [contribution guidelines](./CONTRIBUTING.md).\n\n## Blog posts and papers\n\n * [Introducing eo-learn](https://medium.com/sentinel-hub/introducing-eo-learn-ab37f2869f5c) (by Devis Peressutti)\n * [Land Cover Classification with eo-learn: Part 1 - Mastering Satellite Image Data in an Open-Source Python Environment](https://medium.com/sentinel-hub/land-cover-classification-with-eo-learn-part-1-2471e8098195) (by Matic Lubej)\n * [Land Cover Classification with eo-learn: Part 2 - Going from Data to Predictions in the Comfort of Your Laptop](https://medium.com/sentinel-hub/land-cover-classification-with-eo-learn-part-2-bd9aa86f8500) (by Matic Lubej)\n * [Land Cover Classification with eo-learn: Part 3 - Pushing Beyond the Point of \u201cGood Enough\u201d](https://medium.com/sentinel-hub/land-cover-classification-with-eo-learn-part-3-c62ed9ecd405) (by Matic Lubej)\n * [Innovations in satellite measurements for development](https://blogs.worldbank.org/opendata/innovations-satellite-measurements-development)\n * [Use eo-learn with AWS SageMaker](https://medium.com/@drewbo19/use-eo-learn-with-aws-sagemaker-9420856aafb5) (by Drew Bollinger)\n * [Spatio-Temporal Deep Learning: An Application to Land Cover Classification](https://www.researchgate.net/publication/333262625_Spatio-Temporal_Deep_Learning_An_Application_to_Land_Cover_Classification) (by Anze Zupanc)\n * [Tree Cover Prediction with Deep Learning](https://medium.com/dataseries/tree-cover-prediction-with-deep-learning-afeb0b663966) (by Daniel Moraite)\n\n## Questions and Issues\n\nFeel free to ask questions about the package and its use cases at [Sentinel Hub forum](https://forum.sentinel-hub.com/) or raise an issue on [GitHub](https://github.com/sentinel-hub/eo-learn/issues).\n\nYou are welcome to send your feedback to the package authors, EO Research team, through any of [Sentinel Hub communication channel](https://sentinel-hub.com/develop/communication-channels).\n\n\n## License\n\nSee [LICENSE](https://github.com/sentinel-hub/eo-learn/blob/master/LICENSE).\n\n## Acknowledgements\n\nThis project has received funding from the European Union\u2019s Horizon 2020 research and innovation programme under grant agreement No. 776115.", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/sentinel-hub/eo-learn", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "eo-learn", "package_url": "https://pypi.org/project/eo-learn/", "platform": "", "project_url": "https://pypi.org/project/eo-learn/", "project_urls": { "Homepage": "https://github.com/sentinel-hub/eo-learn" }, "release_url": "https://pypi.org/project/eo-learn/0.6.0/", "requires_dist": null, "requires_python": ">=3.5", "summary": "Earth observation processing framework for machine learning in Python", "version": "0.6.0" }, "last_serial": 5777048, "releases": { "0.3.0": [ { "comment_text": "", "digests": { "md5": "5aeb2e52a094d20b290fa238d367755d", "sha256": "5ee14c00b301630c3b9eeaddadc5ae3dd12b2fe8ed80210f2978a1e63085bd02" }, "downloads": -1, "filename": "eo-learn-0.3.0.tar.gz", "has_sig": false, "md5_digest": "5aeb2e52a094d20b290fa238d367755d", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5,<3.7", "size": 3188, "upload_time": "2018-08-21T22:10:01", "url": "https://files.pythonhosted.org/packages/a7/bd/3982f48aaaf0aecf8852e1be58538242656061f88e37a7b90af3ea6a7400/eo-learn-0.3.0.tar.gz" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "d37bbb85d075cb8256e8a47089cec83f", "sha256": "ba723fb0712e838565d05868724139ab3e2f2f6ebfaf27cd0367e886f27173e7" }, "downloads": -1, "filename": "eo-learn-0.3.1.tar.gz", "has_sig": false, "md5_digest": "d37bbb85d075cb8256e8a47089cec83f", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5,<3.7", "size": 3209, "upload_time": "2018-09-03T11:25:07", "url": "https://files.pythonhosted.org/packages/02/05/1a2742598447735ffdc2165ec9dad1c4ba5bc066b87edfc8443c37dd8b40/eo-learn-0.3.1.tar.gz" } ], "0.3.2": [ { "comment_text": "", "digests": { "md5": "2a9ecb88cf681855a9e692ad0a001067", "sha256": "bff03be28f17e2b783b32625411d094e004af98a670df72d2f185f25f03c1dee" }, "downloads": -1, "filename": "eo-learn-0.3.2.tar.gz", "has_sig": false, "md5_digest": "2a9ecb88cf681855a9e692ad0a001067", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5,<3.7", "size": 4011, "upload_time": "2018-10-08T16:40:02", "url": "https://files.pythonhosted.org/packages/d4/ef/51bdd83e5ba747e4114064faf3b1356f90e83d7ab9e165db452f8a80dd3b/eo-learn-0.3.2.tar.gz" } ], "0.3.3": [ { "comment_text": "", "digests": { "md5": "6fda08a141a38cab6e52d693f22a09ea", "sha256": "c18be572b5dd8c914698269f2e6d1fdb98b9e26feaa6facb91c5a5a547abf2a9" }, "downloads": -1, "filename": "eo-learn-0.3.3.tar.gz", "has_sig": false, "md5_digest": "6fda08a141a38cab6e52d693f22a09ea", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5,<3.7", "size": 4046, "upload_time": "2018-10-23T14:35:51", "url": "https://files.pythonhosted.org/packages/62/e5/5de119ce9fc0d60f1dcb507405cdbb6052901c8010da3a1def918d35d443/eo-learn-0.3.3.tar.gz" } ], "0.4.0": [ { "comment_text": "", "digests": { "md5": "ae2dceb458e1955d2257fd2ee6924cc7", "sha256": "540ad82ce2cd1e9318bbfa0ba85d18e430c0121985185e9ba47294088ccd2b51" }, "downloads": -1, "filename": "eo-learn-0.4.0.tar.gz", "has_sig": false, "md5_digest": "ae2dceb458e1955d2257fd2ee6924cc7", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 4174, "upload_time": "2018-12-11T18:02:15", "url": "https://files.pythonhosted.org/packages/ea/40/0ffae6756cafc9b3ebcc460b1fe21c115a902899d8f91891b68bedd4218e/eo-learn-0.4.0.tar.gz" } ], "0.4.1": [ { "comment_text": "", "digests": { "md5": "771eae806df9f04118a63408c4716f5f", "sha256": "2a69004abe397288de3cc4ad7505b367b0e02f79f2beeb127f0049d3308bc667" }, "downloads": -1, "filename": "eo-learn-0.4.1.tar.gz", "has_sig": false, "md5_digest": "771eae806df9f04118a63408c4716f5f", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 4172, "upload_time": "2019-01-09T10:37:14", "url": "https://files.pythonhosted.org/packages/dc/3f/03fd4bcb3b1ed5bc78f045267e0fce6b16cbc10532924dc5642e906ccc88/eo-learn-0.4.1.tar.gz" } ], "0.4.2": [ { "comment_text": "", "digests": { "md5": "2699f0bdfbb6d88b98f49fa320444735", "sha256": "c4833a4e2befd3e2f2f277b9dfc6afb3b461bf468275623f5cfa911f1fee4bf7" }, "downloads": -1, "filename": "eo-learn-0.4.2.tar.gz", "has_sig": false, "md5_digest": "2699f0bdfbb6d88b98f49fa320444735", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 5558, "upload_time": "2019-02-04T11:16:37", "url": "https://files.pythonhosted.org/packages/a9/80/232c5c13f66e685d2f79a7633713891c0932167a4ea13e8b27a5575cad53/eo-learn-0.4.2.tar.gz" } ], "0.5.0": [ { "comment_text": "", "digests": { "md5": "afd3e103e19d87cdae727335e57873c5", "sha256": "ed07f28171dcdbb2b6d35cd8159ca63b3e2d4b13e4000df0640db88c008387e0" }, "downloads": -1, "filename": "eo-learn-0.5.0.tar.gz", "has_sig": false, "md5_digest": "afd3e103e19d87cdae727335e57873c5", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 5897, "upload_time": "2019-06-20T16:25:48", "url": "https://files.pythonhosted.org/packages/9b/5f/59ed16ea395eb6f45f58f920d4b901b1af6ad62a14cc8afb53bc4e4dd389/eo-learn-0.5.0.tar.gz" } ], "0.5.1": [ { "comment_text": "", "digests": { "md5": "8b8cb1e14e7fa45656c9a998a9f9d2ea", "sha256": "9a2a5e67d1b791f5e78aef726ed5830cdc951eced16af78e753d9fca9e9990c0" }, "downloads": -1, "filename": "eo-learn-0.5.1.tar.gz", "has_sig": false, "md5_digest": "8b8cb1e14e7fa45656c9a998a9f9d2ea", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 6000, "upload_time": "2019-06-22T23:55:20", "url": "https://files.pythonhosted.org/packages/1a/de/6b0a3f9da9a80eb60ef00eb3d954bd326f5d0c2a0d3da90eb4590b434a6e/eo-learn-0.5.1.tar.gz" } ], "0.5.2": [ { "comment_text": "", "digests": { "md5": "c90f484b1c5b251d83b093460a820a39", "sha256": "d299bd65f528c4c8175700d7977cd3920d011622e984646848adfe7b9a465b78" }, "downloads": -1, "filename": "eo-learn-0.5.2.tar.gz", "has_sig": false, "md5_digest": "c90f484b1c5b251d83b093460a820a39", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 5997, "upload_time": "2019-06-23T03:19:55", "url": "https://files.pythonhosted.org/packages/ac/48/7c2f97feaf238f7e4636e3f6a60b25d178fdca18a8feabf3a2843965690c/eo-learn-0.5.2.tar.gz" } ], "0.6.0": [ { "comment_text": "", "digests": { "md5": "38ee4d4beae991817253a53477a81155", "sha256": "ecaf86b2e645bd28c091320029d784d0f6c4c9fd51c61eeaf491709f7c03ea8b" }, "downloads": -1, "filename": "eo-learn-0.6.0.tar.gz", "has_sig": false, "md5_digest": "38ee4d4beae991817253a53477a81155", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 6414, "upload_time": "2019-09-03T16:55:36", "url": "https://files.pythonhosted.org/packages/a7/0c/a31b4aafa4b1fb4071c571b550b9d41f79cb58486bc67b8262f892423e4e/eo-learn-0.6.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "38ee4d4beae991817253a53477a81155", "sha256": "ecaf86b2e645bd28c091320029d784d0f6c4c9fd51c61eeaf491709f7c03ea8b" }, "downloads": -1, "filename": "eo-learn-0.6.0.tar.gz", "has_sig": false, "md5_digest": "38ee4d4beae991817253a53477a81155", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 6414, "upload_time": "2019-09-03T16:55:36", "url": "https://files.pythonhosted.org/packages/a7/0c/a31b4aafa4b1fb4071c571b550b9d41f79cb58486bc67b8262f892423e4e/eo-learn-0.6.0.tar.gz" } ] }