<p align="center">
<a href=https://github.com/raphaelquast/EOmaps>
<img src="https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/logo.png?raw=true" alt="EOmaps logo" width="55%">
</a>
</p>
| Tests | Package | Documentation | License | Citation |
|:-:|:-:|:-:|:-:|:-:|
| [](https://github.com/raphaelquast/EOmaps/actions/workflows/testMaps.yml) [](https://codecov.io/gh/raphaelquast/EOmaps) | [](https://pypi.org/project/eomaps/) [](https://anaconda.org/conda-forge/eomaps) | [](https://eomaps.readthedocs.io/en/latest/?badge=latest) | [](https://github.com/raphaelquast/EOmaps/blob/master/LICENSE) | [](https://zenodo.org/badge/latestdoi/410829039) |
<a href="https://www.buymeacoffee.com/raphaelquast" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/yellow_img.png" alt="Buy Me A Coffee" align="right" style="height: 25px !important;" ></a>
<a href="https://app.gitter.im/#/room/#EOmaps:gitter.im" target="_blank"><img src="https://img.shields.io/gitter/room/raphaelquast/EOmaps?style=social" alt="chat on gitter" align="left" style="height: 20px !important;" ></a>
----
# EOmaps - Interactive maps in python!
**EOmaps** is a <tt>python</tt> package to visualize and analyze geographical datasets.
It is built on top of [matplotlib](https://matplotlib.org/) and [cartopy](https://scitools.org.uk/cartopy/docs/latest/) and provides an intuitive and easy-to-use interface to speed up and simplify the creation and comparison of maps.
> For a quick hands-on introduction, checkout this article on dev.to:
> [Geographic data visualization and analysis with EOmaps: Interactive maps in python!](https://dev.to/raphaelquast/geographic-data-visualization-and-analysis-with-eomaps-interactive-maps-in-python-48e1)
>
> ---
### What can EOmaps do for you?
- Create [▤ multi-layered maps](https://eomaps.readthedocs.io/en/latest/api_basics.html#layer-management) and interactively compare different layers with each other
- [🔴 Visualize datasets](https://eomaps.readthedocs.io/en/latest/api_data_visualization.html) with millions of datapoints and handle reprojections
- Provide a comprehensive set of tools to customize the map
- [🌵NaturalEarth features](https://eomaps.readthedocs.io/en/latest/api_naturalearth_features.html)
- [📏Scalebars](https://eomaps.readthedocs.io/en/latest/api_scalebar.html)
- [▦ Gridlines](https://eomaps.readthedocs.io/en/latest/api_gridlines.html)
- [🛰 WebMap layers](https://eomaps.readthedocs.io/en/latest/api_webmaps.html)
- [🏕 Annotations, Markers, Lines, Logos...](https://eomaps.readthedocs.io/en/latest/api_annotations_markers_etc.html)
- . . .
- Get a useful [🧰 CompanionWidget](https://eomaps.readthedocs.io/en/latest/api_companion_widget.html) GUI
- Use [🛸 Callbacks](https://eomaps.readthedocs.io/en/latest/api_callbacks.html) to interact with the figure
- Interactively re-arrange multiple maps in a figure with the [🏗️ LayoutEditor](https://eomaps.readthedocs.io/en/latest/api_layout_editor.html)
- [🗺 Export](https://eomaps.readthedocs.io/en/latest/api_basics.html#image-export-jpeg-png-svg-etc) publication ready high resolution images (png, jpeg, tiff, ...)
or export figures as vektor graphics (svg, eps, pdf ...)
- . . . and much more!
Checkout the [🌱 Basics](https://eomaps.readthedocs.io/en/latest/api_basics.html) in the documentation to get started!
<img src=https://eomaps.readthedocs.io/en/latest/_images/intro.png width=50%>
## 🔨 Installation
To install EOmaps (and all its dependencies) via the [conda](https://docs.conda.io/projects/conda/en/stable/) package-manager, simply use:
```python
conda install -c conda-forge eomaps
```
> ... to get a <u>**huge speedup**</u>, use [mamba](https://mamba.readthedocs.io/en/latest/) to solve the dependencies!
> ```python
> conda install -c conda-forge mamba
> mamba install -c conda-forge eomaps
> ```
Need more information?
- Have a look at the [🐛Installation](https://eomaps.readthedocs.io/en/latest/installation.html) instructions in the docs.
- Checkout the quickstart guide [🚀 From 0 to EOmaps](https://eomaps.readthedocs.io/en/latest/FAQ.html#from-0-to-eomaps-a-quickstart-guide).
## 📖 Documentation
Make sure to have a look at the <a href=https://eomaps.readthedocs.io/en/latest><b>📖 Documentation </b></a> which provides a lot of <a href=https://eomaps.readthedocs.io/en/latest/EOmaps_examples.html><b>🌐Examples</b></a> on how to create awesome interactive maps (incl. 🐍 source code)!
## ✔️ Citation
Did EOmaps help in your research?
Support the development and add a citation to your publication!
[](https://zenodo.org/badge/latestdoi/410829039)
## 🌟 Contribute
Interested in contributing to EOmaps? Awesome!
- Checkout the [🚀 Contribution Guide](https://eomaps.readthedocs.io/en/latest/contribute.html) on how to get started!
> Found a bug or got an idea for an interesting feature?
> Open an [issue](https://github.com/raphaelquast/EOmaps/issues) or start a [discussion](https://github.com/raphaelquast/EOmaps/discussions), and I'll see what I can do!
---------------
<center><img src="https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/minigifs/companion_widget.gif?raw=true" alt="EOmaps example 6" width=50%></center>
<table>
<tr>
<td valign="center" style="width:50%">
<img src="https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/fig6.gif?raw=true" alt="EOmaps example 6">
</td>
<td valign="center">
<img src="https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/minigifs/advanced_wms.gif?raw=true" alt="EOmaps example 2">
</td>
</tr>
<tr>
<td valign="center">
<img src="https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/fig9.gif?raw=true" alt="EOmaps example 9">
</td>
<td valign="center">
<img src="https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/fig4.gif?raw=true" alt="EOmaps example 4">
</td>
</tr>
<tr>
<td valign="center">
<img src="https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/fig7.gif?raw=true" alt="EOmaps example 7">
</td>
<td valign="center">
<img src="https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/fig3.gif?raw=true" alt="EOmaps example 8">
</td>
</tr>
<tr>
<td valign="center">
<img src="https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/minigifs/layout_editor.gif?raw=true" alt="EOmaps inset-maps">
</td>
<td valign="center">
<img src="https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/fig8.gif?raw=true" alt="EOmaps example 3">
</td>
</tr>
<tr>
<td valign="center">
<img src="https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/example_lines.png?raw=true" alt="EOmaps example 9">
</td>
<td valign="center">
<img src="https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/inset_maps.png?raw=true" alt="EOmaps example 4">
</td>
</tr>
</table>
----
## ☕ Support
The development of EOmaps is supported by:
<a href="https://www.tuwien.at/en/mg/geo/rs"><img height=30 align=left src="https://github.com/raphaelquast/EOmaps/assets/22773387/1ad88e68-eb16-4549-8159-8b4a6db8ab28"> TU Wien Department of Geodesy and Geoinformation - Research Area Remote Sensing</a>
<br/>
## 🌼 Thanks to
- [Jakob Quast](https://quastquest.jimdofree.com/) for designing the nice logo!
Raw data
{
"_id": null,
"home_page": "https://github.com/raphaelquast/maps",
"name": "EOmaps",
"maintainer": "Raphael Quast",
"docs_url": null,
"requires_python": "",
"maintainer_email": "raphael.quast@geo.tuwien.ac.at",
"keywords": "visualization,plotting,maps,geographical data",
"author": "Raphael Quast",
"author_email": "raphael.quast@geo.tuwien.ac.at",
"download_url": "https://files.pythonhosted.org/packages/64/7b/c620032e585b2c45002ea76ecadcf34a6e4a5b77e605f3e6e719cc37aa26/EOmaps-7.3.3.tar.gz",
"platform": null,
"description": "\n<p align=\"center\">\n <a href=https://github.com/raphaelquast/EOmaps>\n <img src=\"https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/logo.png?raw=true\" alt=\"EOmaps logo\" width=\"55%\">\n </a>\n</p>\n\n| Tests | Package | Documentation | License | Citation |\n|:-:|:-:|:-:|:-:|:-:|\n| [](https://github.com/raphaelquast/EOmaps/actions/workflows/testMaps.yml) [](https://codecov.io/gh/raphaelquast/EOmaps) | [](https://pypi.org/project/eomaps/) [](https://anaconda.org/conda-forge/eomaps) | [](https://eomaps.readthedocs.io/en/latest/?badge=latest) | [](https://github.com/raphaelquast/EOmaps/blob/master/LICENSE) | [](https://zenodo.org/badge/latestdoi/410829039) |\n\n<a href=\"https://www.buymeacoffee.com/raphaelquast\" target=\"_blank\"><img src=\"https://www.buymeacoffee.com/assets/img/custom_images/yellow_img.png\" alt=\"Buy Me A Coffee\" align=\"right\" style=\"height: 25px !important;\" ></a>\n<a href=\"https://app.gitter.im/#/room/#EOmaps:gitter.im\" target=\"_blank\"><img src=\"https://img.shields.io/gitter/room/raphaelquast/EOmaps?style=social\" alt=\"chat on gitter\" align=\"left\" style=\"height: 20px !important;\" ></a>\n\n----\n\n# EOmaps - Interactive maps in python!\n\n**EOmaps** is a <tt>python</tt> package to visualize and analyze geographical datasets.\n\nIt is built on top of [matplotlib](https://matplotlib.org/) and [cartopy](https://scitools.org.uk/cartopy/docs/latest/) and provides an intuitive and easy-to-use interface to speed up and simplify the creation and comparison of maps.\n\n> For a quick hands-on introduction, checkout this article on dev.to: \n> [Geographic data visualization and analysis with EOmaps: Interactive maps in python!](https://dev.to/raphaelquast/geographic-data-visualization-and-analysis-with-eomaps-interactive-maps-in-python-48e1)\n>\n> ---\n\n### What can EOmaps do for you?\n\n- Create [\u25a4 multi-layered maps](https://eomaps.readthedocs.io/en/latest/api_basics.html#layer-management) and interactively compare different layers with each other\n- [\ud83d\udd34 Visualize datasets](https://eomaps.readthedocs.io/en/latest/api_data_visualization.html) with millions of datapoints and handle reprojections\n- Provide a comprehensive set of tools to customize the map\n - [\ud83c\udf35NaturalEarth features](https://eomaps.readthedocs.io/en/latest/api_naturalearth_features.html)\n - [\ud83d\udccfScalebars](https://eomaps.readthedocs.io/en/latest/api_scalebar.html)\n - [\u25a6 Gridlines](https://eomaps.readthedocs.io/en/latest/api_gridlines.html)\n - [\ud83d\udef0 WebMap layers](https://eomaps.readthedocs.io/en/latest/api_webmaps.html)\n - [\ud83c\udfd5 Annotations, Markers, Lines, Logos...](https://eomaps.readthedocs.io/en/latest/api_annotations_markers_etc.html)\n - . . .\n- Get a useful [\ud83e\uddf0 CompanionWidget](https://eomaps.readthedocs.io/en/latest/api_companion_widget.html) GUI\n- Use [\ud83d\udef8 Callbacks](https://eomaps.readthedocs.io/en/latest/api_callbacks.html) to interact with the figure\n- Interactively re-arrange multiple maps in a figure with the [\ud83c\udfd7\ufe0f LayoutEditor](https://eomaps.readthedocs.io/en/latest/api_layout_editor.html)\n- [\ud83d\uddfa Export](https://eomaps.readthedocs.io/en/latest/api_basics.html#image-export-jpeg-png-svg-etc) publication ready high resolution images (png, jpeg, tiff, ...) \nor export figures as vektor graphics (svg, eps, pdf ...)\n- . . . and much more! \n\nCheckout the [\ud83c\udf31 Basics](https://eomaps.readthedocs.io/en/latest/api_basics.html) in the documentation to get started!\n\n<img src=https://eomaps.readthedocs.io/en/latest/_images/intro.png width=50%>\n\n## \ud83d\udd28 Installation\n\nTo install EOmaps (and all its dependencies) via the [conda](https://docs.conda.io/projects/conda/en/stable/) package-manager, simply use:\n```python\nconda install -c conda-forge eomaps\n```\n> ... to get a <u>**huge speedup**</u>, use [mamba](https://mamba.readthedocs.io/en/latest/) to solve the dependencies!\n> ```python\n> conda install -c conda-forge mamba\n> mamba install -c conda-forge eomaps\n> ```\nNeed more information?\n- Have a look at the [\ud83d\udc1bInstallation](https://eomaps.readthedocs.io/en/latest/installation.html) instructions in the docs.\n- Checkout the quickstart guide [\ud83d\ude80 From 0 to EOmaps](https://eomaps.readthedocs.io/en/latest/FAQ.html#from-0-to-eomaps-a-quickstart-guide).\n\n## \ud83d\udcd6 Documentation\n\nMake sure to have a look at the <a href=https://eomaps.readthedocs.io/en/latest><b>\ud83d\udcd6 Documentation </b></a> which provides a lot of <a href=https://eomaps.readthedocs.io/en/latest/EOmaps_examples.html><b>\ud83c\udf10Examples</b></a> on how to create awesome interactive maps (incl. \ud83d\udc0d source code)!\n\n## \u2714\ufe0f Citation\nDid EOmaps help in your research? \nSupport the development and add a citation to your publication!\n\n[](https://zenodo.org/badge/latestdoi/410829039)\n\n\n## \ud83c\udf1f Contribute\n\nInterested in contributing to EOmaps? Awesome!\n\n- Checkout the [\ud83d\ude80 Contribution Guide](https://eomaps.readthedocs.io/en/latest/contribute.html) on how to get started!\n\n> Found a bug or got an idea for an interesting feature? \n> Open an [issue](https://github.com/raphaelquast/EOmaps/issues) or start a [discussion](https://github.com/raphaelquast/EOmaps/discussions), and I'll see what I can do! \n\n\n---------------\n\n\n<center><img src=\"https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/minigifs/companion_widget.gif?raw=true\" alt=\"EOmaps example 6\" width=50%></center>\n\n\n<table>\n <tr>\n <td valign=\"center\" style=\"width:50%\">\n <img src=\"https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/fig6.gif?raw=true\" alt=\"EOmaps example 6\">\n </td>\n <td valign=\"center\">\n <img src=\"https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/minigifs/advanced_wms.gif?raw=true\" alt=\"EOmaps example 2\">\n </td>\n </tr>\n <tr>\n <td valign=\"center\">\n <img src=\"https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/fig9.gif?raw=true\" alt=\"EOmaps example 9\">\n </td>\n <td valign=\"center\">\n <img src=\"https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/fig4.gif?raw=true\" alt=\"EOmaps example 4\">\n </td>\n </tr>\n <tr>\n <td valign=\"center\">\n <img src=\"https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/fig7.gif?raw=true\" alt=\"EOmaps example 7\">\n </td>\n <td valign=\"center\">\n <img src=\"https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/fig3.gif?raw=true\" alt=\"EOmaps example 8\">\n </td>\n </tr>\n <tr>\n <td valign=\"center\">\n <img src=\"https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/minigifs/layout_editor.gif?raw=true\" alt=\"EOmaps inset-maps\">\n </td>\n <td valign=\"center\">\n <img src=\"https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/fig8.gif?raw=true\" alt=\"EOmaps example 3\">\n </td>\n </tr>\n <tr>\n <td valign=\"center\">\n <img src=\"https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/example_lines.png?raw=true\" alt=\"EOmaps example 9\">\n </td>\n <td valign=\"center\">\n <img src=\"https://github.com/raphaelquast/EOmaps/blob/master/docs/_static/inset_maps.png?raw=true\" alt=\"EOmaps example 4\">\n </td>\n </tr>\n</table>\n\n----\n\n## \u2615 Support\n\nThe development of EOmaps is supported by:\n\n<a href=\"https://www.tuwien.at/en/mg/geo/rs\"><img height=30 align=left src=\"https://github.com/raphaelquast/EOmaps/assets/22773387/1ad88e68-eb16-4549-8159-8b4a6db8ab28\"> TU Wien Department of Geodesy and Geoinformation - Research Area Remote Sensing</a>\n\n<br/>\n\n## \ud83c\udf3c Thanks to\n\n- [Jakob Quast](https://quastquest.jimdofree.com/) for designing the nice logo!\n\n\n",
"bugtrack_url": null,
"license": "GNU General Public License v3 or later (GPLv3+)",
"summary": "A library to create interactive maps of geographical datasets.",
"version": "7.3.3",
"project_urls": {
"Homepage": "https://github.com/raphaelquast/maps"
},
"split_keywords": [
"visualization",
"plotting",
"maps",
"geographical data"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "da7a3e5535baeff5d4cccece447d51fcd53b1ee35f5bb1a0c06bdf477992f782",
"md5": "2fd4fed76e0eb965b0a9f6a136ffbf99",
"sha256": "1922e8809c36f315cf64488fa87d97b1aa23f28d029c5603fb524fc90b8b1a8e"
},
"downloads": -1,
"filename": "EOmaps-7.3.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2fd4fed76e0eb965b0a9f6a136ffbf99",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 548643,
"upload_time": "2023-12-20T12:28:48",
"upload_time_iso_8601": "2023-12-20T12:28:48.951964Z",
"url": "https://files.pythonhosted.org/packages/da/7a/3e5535baeff5d4cccece447d51fcd53b1ee35f5bb1a0c06bdf477992f782/EOmaps-7.3.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "647bc620032e585b2c45002ea76ecadcf34a6e4a5b77e605f3e6e719cc37aa26",
"md5": "a51e723f78353a05daaf29c5e8ad3954",
"sha256": "9a5a9e594edcfbec8a16c49a83b0bc352eaa58386e3ea7f14ba0cd1996ca5f7b"
},
"downloads": -1,
"filename": "EOmaps-7.3.3.tar.gz",
"has_sig": false,
"md5_digest": "a51e723f78353a05daaf29c5e8ad3954",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 521950,
"upload_time": "2023-12-20T12:28:52",
"upload_time_iso_8601": "2023-12-20T12:28:52.213313Z",
"url": "https://files.pythonhosted.org/packages/64/7b/c620032e585b2c45002ea76ecadcf34a6e4a5b77e605f3e6e719cc37aa26/EOmaps-7.3.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-20 12:28:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "raphaelquast",
"github_project": "maps",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "eomaps"
}
JSON
