Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/raphaelquast/EOmaps
A library to create interactive maps of geographical datasets
https://github.com/raphaelquast/EOmaps
cartopy earth-observation geospatial gis interactive-maps interactive-visualization mapping matplotlib plotting python visualization
Last synced: 9 days ago
JSON representation
A library to create interactive maps of geographical datasets
- Host: GitHub
- URL: https://github.com/raphaelquast/EOmaps
- Owner: raphaelquast
- License: gpl-3.0
- Created: 2021-09-27T09:54:17.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2023-12-19T15:14:20.000Z (12 months ago)
- Last Synced: 2023-12-19T16:50:56.645Z (12 months ago)
- Topics: cartopy, earth-observation, geospatial, gis, interactive-maps, interactive-visualization, mapping, matplotlib, plotting, python, visualization
- Language: Python
- Homepage: https://eomaps.readthedocs.io/
- Size: 79.7 MB
- Stars: 281
- Watchers: 5
- Forks: 20
- Open Issues: 27
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- jimsghstars - raphaelquast/EOmaps - A library to create interactive maps of geographical datasets (Python)
README
| Tests & Review | [](https://github.com/raphaelquast/EOmaps/actions/workflows/testMaps.yml) | [](https://codecov.io/gh/raphaelquast/EOmaps) | [](https://github.com/pyOpenSci/software-submission/issues/138) |
| :---------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------: |
| Package & Documentation | [](https://pypi.org/project/eomaps/) | [](https://anaconda.org/conda-forge/eomaps) | [](https://eomaps.readthedocs.io/en/latest/?badge=latest) |
| License & Citation | [](https://github.com/raphaelquast/EOmaps/blob/master/LICENSE) | [](https://zenodo.org/badge/latestdoi/410829039) | |
----
A python package to visualize and analyze geographical datasets.
EOmaps aims to provide a comprehensive, flexible, well-documented and easy-to-use API to create publication-ready maps that can directly be used for interactive data analysis.
## What can I do with EOmaps?
**EOmaps** is built on top of [matplotlib](https://matplotlib.org/) and [cartopy](https://scitools.org.uk/cartopy/docs/latest/) and integrates well with the scientific python infrastructure (e.g., [numpy](https://numpy.org/), [pandas](https://pandas.pydata.org/), [geopandas](https://geopandas.org/), [xarray](https://xarray.dev/) etc.), allowing you to visualize point-, raster- or vector-datasets provided in almost any format you can imagine, no matter if you're dealing with just a few unsorted datapoints or multi-dimensional stacks of global high-resolution datasets.
Figures created with EOmaps are multi-layered, so you can (transparently) overlay and interactively compare your datasets with ease. With the accompanying GUI widget, you can quickly switch layers, change the layout, examine the large collection of features and web-map services, and explore the capabilities of EOmaps.
Once you're map is ready, you can export it as high-resolution image or vector-graphic for further editing.
Leveraging the powers of matplotlib, you can also embed interactive maps in Jupyter Notebooks, on a webpage or in GUI frameworks like Qt, tkinter etc..
> [!IMPORTANT]
>
> EOmaps is 100% free and open-source.
> As such, acknowledgement is extremely important to allow continued support and development of the package.
>
> Did EOmaps help in your research? $\Rightarrow$ **Add a ✔️ Citation to your publication!**
>
> 
>
>
> BibTeX
>
> The following BibTeX entry uses a DOI that always points to the latest release of EOmaps!
> (You can get the DOI for a specific version form the zenodo-page)
>
> ```bibtex
> @software{eomaps,
> author = {Raphael Quast},
> title = {EOmaps: A python package to visualize and analyze geographical datasets.},
> doi = {10.5281/zenodo.6459598},
> url = {https://doi.org/10.5281/zenodo.6459598}
> }
> ```
>
>
>
## 🚀 Getting started
Head over to the start-page of the 📖 Documentation to get an overview of all available features and functionalities!
> [!TIP]
> 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)
## 🔨 Installation
To install **EOmaps** (and all its dependencies) with the [conda](https://docs.conda.io/projects/conda/en/stable/) package-manager, simply use:
```python
conda install -c conda-forge eomaps
```
> [!TIP]
> To get a **huge speedup**, use [mamba](https://mamba.readthedocs.io/en/latest/) to solve the dependencies!
> ```python
> mamba install -c conda-forge eomaps
> ```
> Advanced users can also use `pip` to install **EOmaps** (and selectively install optional dependency groups)
> ```pyhton
> pip install eomaps # install only minimal required dependencies
> pip install eomaps[all] # install all optional dependencies
> ...
> ```
For more detailes, have a look at the [Installation Instructions](https://eomaps.readthedocs.io/en/dev/installation.html) or the quickstart guide ["From 0 to EOmaps"](https://eomaps.readthedocs.io/en/dev/quickstart_quide.html#quickstart-guide)!
## 🌟 Contribute
Interested in contributing to EOmaps? **Awesome!**
You can find detailed instructions on how to setup EOmaps for development in the [Contribution Guide](https://eomaps.readthedocs.io/en/dev/contribute/contribute.html)!
> 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!
---------------
----
## ☕ Support
The development of EOmaps has been supported by:
TU Wien Department of Geodesy and Geoinformation - Research Area Remote Sensing
## 🌼 Thanks to
- [Jakob Quast](https://quastquest.jimdofree.com/) for designing the nice logo!