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!


Open an issue or start a discussion on GitHub!

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:

Geodesic Circles
Scatter Points
Voronoi Diagram
Delaunay Triangulation
Shade Raster
Shade Points

Map Features

EOmaps provides many useful tools to customize your maps.

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

Add imagery provided by WebMap services to the map.

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

Add vector geometries to the map.

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

Add a scalebar to the map.

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

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


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.

Turn your maps into interactive data-analysis widgets.

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

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

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

A collection of Jupyter Widgets (for Jupyter Notebooks)


Details on logging.

How to use the eomaps command-line interface.

Read data from NetCDF, GeoTIFF or CSV files.

Additional functions and properties that might come in handy.

API Reference

EOmaps API reference

Detailed information on the API of EOmaps.


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

Example 1 - Basic data visualization
Example 2 - Customize the appearance of the map
Example 3 - Data-classification and multiple Maps in a figure
Example 4 - Callbacks - turn your maps into interactive widgets
Example 5 - Overlays, markers and annotations
Example 6 - WebMap services and layer-switching
Example 7 - Vector data - interactive geometries
Example 8 - Using Scalebars
Example 9 - Data analysis widgets - Timeseries and histograms
Example 10 - Data analysis widgets - Select 1D slices of a 2D dataset
Example 11 - Inset-maps - get a zoomed-in view on selected areas
Example 12 - Lines and Annotations
Example 13 - Gridlines and Grid Labels
Example 14 - Contour plots and Contour Levels