Hyoga

Hyoga is a thin wrapper arround xarray to read and plot PISM output. In the future, I hope to find the time and funds to let it grow into a more developed library around CF-compliant glacier and ice sheet models. Hyoga (氷河) is the Japanese word for glacier (lit. ice river).

Warning

The project is still in a very early stage and comes with absolutely no warranty. I will do my best to develop backward-compatible and document pending breaking changes with “future warnings”. Still, things may break.

Note

Hyoga is growing fast. This is the documentation for the latest Github commit, which may include significant changes since the latest Pypi release (see What’s new).

Get in touch

At this point I am quite likely to follow my own development roadmap rather than external suggestions. Still, if you are using hyoga, please feel free to report bugs on Github, and to get in touch with suggestions per email.

Note

Hyoga is being developed on an entirely voluntary basis. I will be looking for funds to support my living. However, I have no prior experience with funding such open-source scientific software, and thus any suggestion or help will be greatly appreciated.

History

The idea for an object-oriented ice-sheet-model plotting library came in 2013. At that time, I began developing an extension of the python-netcdf4 Dataset class in a little Python 2 package called iceplotlib, which has been used by some of my co-workers. But soon the little work I had done became very, very largely outpaced by the powerful new additions to the Python geoscience ecosystem cartopy, pandas, dask, and xarray.

In late 2019 as I began looking for a new academic position, a new library building on these tools imposed itself as the evident technical ground for future work. But proposals were rejected and I abandoned the idea again for several months. Hyoga’s first version was released on March 1st, 2021, exactly one year after my last position ended. The rest of the story is yet to be written.

Citing

Every hyoga release of is long-term archived in Zenodo and attributed a DOI. This badge always indicates the latest record: doi.

License

Hyoga is available under the GNU General Public License v3.0+.