Welcome to the documentation for EOmaps!

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

Interested in contributing to EOmaps?

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

Open an issue on GitHub or head over to the 🚀 Contribution Guide to see how to setup EOmaps for development!

Getting Started

To get started, have a look at the 🌱 Basics section to get to know the basic concepts of 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	Rectangles	Geodesic Circles	Raster	Scatter Points
Contour	Voronoi Diagram	Delaunay Triangulation	Shade Raster	Shade Points

Map Features

EOmaps provides many useful tools to customize your maps.

🔬 Inset Maps Create zoomed-in views on specific regions of a map.	🌵 NaturalEarth features Add basic map features (coastlines, ocean-coloring etc. ) to the map.
🛰 WebMap layers Add imagery provided by WebMap services (ts, wms, wmts, xyz) to the map.	💠 Vector Data Add vector geometries to the map.
🏕 Annotations, Markers, Logos, etc. Add markers, annotations, lines, logos etc. to the map.	📏 Scalebars Add a scalebar to the map.
🧭 Compass (or North Arrow) Add a compass (or North Arrow) to the map.	▦ Gridlines Add grid-lines (and optionally grid-labels) to the map.

Interactivity

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

🧰 Companion Widget A graphical user-interface to interact with the map.	🛸 Callbacks Turn your maps into interactive data-analysis widgets.
🏗️ Layout Editor Interactively re-arrange and re-size axes of a figure.	✏️ Draw shapes on the map Interactively draw geometries on a map and export them as shapefiles.
🔦 Utilities A collection of utility widgets (layer-sliders, layer-selectors)

Miscellaneous

📚Logging Details on logging.	⛭ Command Line Interface How to use the command-line interface eomaps.
📦 Reading data Read data from NetCDF, GeoTIFF or CSV files.	🔸 Miscellaneous Additional functions and properties that might come in handy.

Examples

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

				…