GeoGIF
Make GIFs from time-stacked xarray.DataArrays (time, [optional band], y, x), dead-simple.
from geogif import gif, dgif
gif(data_array)
dgif(dask_data_array).compute()
The "geo" part is a lie, actually. The arrays don't have to be geospatial in nature. But I called it GeoGIF because:
- Wanting to animate a time-stack of imagery (like you'd get from stackstac) is a common task in the earth-observation/geospatial world.
- I think
GeoGIFis a hilarious idea1.
1: To ruin the joke, it sounds like GeoTIFF, a ubiquitous geospatial image format. If you also think this is a funny idea, and believe you'd have a better use for the name than I do, I'd happily cede it to you.
Installation
pip install geogif
Documentation
See https://geogif.readthedocs.io/en/latest/.
Development
GeoGIF is managed by Poetry, so be sure that's installed first. To develop locally, first fork or clone the repo. Then, to set up a virtual environment and install the necessary dependencies:
cd geogif
poetry install -E tests -E docs
Running Tests
GeoGIF has some basic end-to-end tests, written with Hypothesis. To run:
pytest
This will take ~30 seconds (longer the first time), as Hypothesis generates fake data to root out possible errors.
Code style
GeoGIF is formatted with shed, in order to allow for as few opinions as possible.
1 Nov 1, 2021
1 Dec 9, 2021
30 Dec 24, 2022
1 Jan 31, 2022
7 Dec 15, 2022
350 Jan 2, 2023
23 Jan 4, 2022
2 Aug 4, 2022
3 Dec 29, 2021
2 Aug 15, 2022
1.2k Dec 30, 2022
1.3k Dec 31, 2022
2.3k Jan 1, 2023
6 Oct 27, 2022
30 Dec 31, 2022
5 Apr 9, 2022
15 Dec 22, 2022
4 Nov 8, 2021
152 Dec 13, 2022