Welcome to the documentation for EOmaps!#

Here you can find detailed explanations on all the features and functionalities of EOmaps.

Found a bug or got an idea for an interesting feature?

Get all information you need to start contributing to EOmaps!

πŸš€ Contribution Guide
GitHub

Open an issue or start a discussion on GitHub!

https://github.com/raphaelquast/EOmaps/

Getting Started#

To get started, have a look at the πŸ› Installation instructions and the 🌱 Basics section to learn how to use EOmaps!

In addition, there is also the 🧰 Companion Widget GUI that can be used to interactively edit/compare/overlay maps and explore the features and functionalities.

Data Visualization#

Want to visualize some data? Have a look at the πŸ”΄ Data Visualization section to learn how to create beautiful maps with your datasets!

EOmaps provides a variety of plot-shapes so you can select a shape that suits the structure, size and spatial representativeness of your data:

Ellipses
Ellipses
Rectangles
Rectangles
Geodesic Circles
Geodesic Circles
Scatter Points
Scatter Points
Contour
Contour plots
Hexbin
Hexbin plots
Voronoi Diagram
Voronoi Diagram
Delaunay Triangulation
Delaunay Triangulation
Raster
Raster
Shade Raster
Shade Raster
Shade Points
Shade Points

Map Features#

EOmaps provides many useful tools to customize your maps.

Add basic map features (coastlines, ocean-coloring etc. ) to the map.

🌡 NaturalEarth features

Add imagery provided by WebMap services to the map.

πŸ›° WebMap layers

Create zoomed-in views on specific regions of a map.

πŸ”¬ Inset Maps

Add vector geometries to the map.

πŸ’  Vector Data

Add markers, annotations, lines, logos etc. to the map.

πŸ• Annotations, Markers, Logos …

Add a scalebar to the map.

πŸ“ Scalebars

Add a compass (or North Arrow) to the map.

🧭 Compass (or North Arrow)

Add grid-lines (and optionally grid-labels) to the map.

β–¦ Gridlines

Interactivity#

With a few lines of code, you can turn your maps into interactive data-analysis widgets!

A graphical user-interface to interact with the map.

🧰 Companion Widget

Turn your maps into interactive data-analysis widgets.

πŸ›Έ Callbacks

Interactively re-arrange and re-size axes of a figure.

πŸ—οΈ Layout Editor

Interactively draw geometries on a map and export them as shapefiles.

✏️ Draw shapes on the map

A collection of utility widgets (layer-sliders, layer-selectors)

πŸ”¦ Utilities

A collection of Jupyter Widgets (for Jupyter Notebooks)

πŸ•Ή Jupyter Widgets

Miscellaneous#

Details on logging.

πŸ“šLogging

How to use the eomaps command-line interface.

β›­ Command Line Interface

Read data from NetCDF, GeoTIFF or CSV files.

πŸ“¦ Reading data

Additional functions and properties that might come in handy.

πŸ”Έ Miscellaneous

API Reference#

EOmaps API reference

Detailed information on the API of EOmaps.

API Reference

Examples#

Make sure to check out the Examples for an overview of the capabilities (incl. source code)!

EOmaps Examples

Detailed examples of EOmaps.

πŸ—Ί EOmaps examples