Installation

pip install imdtrack            # core: pandas + pyarrow (reads the published parquet)
pip install imdtrack[xarray]    # + xarray/numpy for .to_xarray()
pip install imdtrack[plot]      # + cartopy/matplotlib for map plotting
pip install imdtrack[all]       # xarray + numpy + openpyxl

Or with uv:

uv add imdtrack                 # into a project  (or: uv pip install imdtrack)

Optional extras

Extra	Adds	For
(none)	pandas, pyarrow	loading the data as DataFrames
xarray	xarray, numpy	to_xarray()
plot	cartopy, matplotlib	plot_track() / plot_tracks() maps
pipeline	openpyxl	parsing the IMD workbook yourself (source="imd")

Note

cartopy has no Python 3.14 wheel yet, so [plot] needs Python ≤ 3.13 (or a conda / system GEOS + PROJ to build it). Conda packaging is on the way — see the conda/ recipe.

Requirements

Python 3.9+. The core install is pure-Python and depends only on pandas and pyarrow, so imd.load() works everywhere; the heavier extras are opt-in.