eofigs

Analysis-aware, publication-ready figures for Earth observation research.

eofigs turns Earth observation analysis outputs (rasters, time series, validation pairs) into journal-ready figures that know the analysis, the variable and the printed size:

• Recipe figures for common analyses: trend with significance, event composites, and later recovery, burn severity, disturbance and divergence.
• A variable library with fixed colour maps, symbols and units, so NDVI, LST or GPP look the same in every figure, and their anomalies and trends get zero-centred diverging colours.
• Print-size rendering: rasters are read and reduced to the pixels the printed figure needs, from its width in mm and its dpi, keeping memory use and PDF size small.
• Journal presets and one-call export to vector PDF plus 600 dpi PNG or TIFF, with a check of size, resolution, smallest font, font embedding and colour-blind safety.

Gallery

Study area map: Swat valley	Study area map: single column	House style
Journal style and export	Large raster at print size	Trend and significance
Trend map: Swat valley NDVI 2001–2024	Trend map with latitude profile	Built-in palettes
Event composite: Swat hot-dry months	Event composite with significance	Accuracy scatter: ICESat-2 against a DEM
Accuracy scatter: calibration and validation

More in the gallery, with the code for each figure.

Installation

pip install eofigs

eofigs needs Python 3.11 or newer. On Windows and macOS, conda-forge is the simplest source of its geospatial libraries; see the installation guide.

Quick start

import numpy as np
import eofigs

eofigs.set_style("elsevier")  # fonts, sizes and widths of the journal
rng = np.random.default_rng(1)
field = rng.gamma(5, 30, 300)  # observed aboveground biomass (Mg ha⁻¹)
model = 0.9 * field + rng.normal(10, 20, 300)  # predicted
fig = eofigs.accuracy_scatter(field, model, variable="agb")
print(fig.eofigs_layout["caption"])  # a ready caption sentence
print(eofigs.check_figure(fig))  # size, dpi, smallest font, fonts, colour-blind safety
eofigs.save_figure(fig, "fig_agb")  # vector PDF and a 600 dpi raster

More in the quickstart and the gallery.

Run with Docker

A container image with eofigs and its geospatial stack (cartopy, rioxarray, geopandas, fonts) is published on GitHub Container Registry for each release (0.1.0, latest; dev follows the main branch):

docker run --rm -v "$PWD":/work ghcr.io/kmkamilkhel/eofigs:0.1.0 python script.py

Roadmap

Available in v0.1: set_style, style, new_figure, label_panels, save_figure, check_figure, cvd_preview, tidy_axes, palettes, variable, register_variable, fit_raster, trend, figure_set, study_area_map, add_north_arrow, add_scale_bar, add_inset, trend_map, event_composite and accuracy_scatter.

v0.1

v0.2: burn severity, recovery and disturbance recipes, SHAP and partial dependence styling, confusion matrix, Google Earth Engine input through Xee at print scale.

v0.3: R package with matching function names.

Contributing

Questions and ideas are welcome in Discussions; bugs and feature requests in Issues. See CONTRIBUTING.md and the Code of Conduct.

Citation

If you use eofigs, please cite it using the metadata in CITATION.cff.

License

MIT. See LICENSE. Data files have their own licences, listed in DATA_LICENSES.md.