mapflow 0.2.14

A Python library to export xarray.DataArray as video files

mapflow

mapflow transforms 3D xr.DataArray (time, y, x) into video files in one line of code.

Documentation

The full documentation is available at mapflow.readthedocs.io.

Installation

pip install mapflow

Or:

conda install -c conda-forge -y mapflow

Features

• Automatic Coordinate Detection: Identifies x, y, and time coordinates in xarray DataArrays, with fallback options for manual input if needed.
• CRS Handling: Detects the Coordinate Reference System (CRS) of the data or accepts user-defined CRS when unavailable.
• Robust Colorbar: Generates a colorbar that handles outliers effectively while allowing customization.
• Built-in World Borders: Includes default world border data but supports user-provided GeoSeries or GeoDataFrames.
• Simplified Visualization: The plot_da function provides a one-line alternative to cartopy for quick plotting.

Animate

import xarray as xr
from mapflow import animate

ds = xr.tutorial.open_dataset("era5-2mt-2019-03-uk.grib")
animate(da=ds['t2m'].isel(time=slice(120)), path='animation.mp4', video_width=1280, pad_inches=0.2)

https://github.com/user-attachments/assets/3c84b380-62b2-4156-937f-5682a1c59457

Static plot

import xarray as xr
from mapflow import plot_da

ds = xr.tutorial.open_dataset("era5-2mt-2019-03-uk.grib")
plot_da(da=ds['t2m'].isel(time=0))