What’s new#

v0.3.0 Cocuy (16 Jan. 2023)#

_images/plot_v003_cocuy.png

This release turns hyoga into more than just a visualization tool. Two functions were added to open online elevation data (GEBCO) and monthly climatologies (CHELSA) in custom projections that can be used as PISM input files for paleoglacier modelling about anywhere on Earth. Minor bugs were fixed. Code coverage decreased to 67 percent.

Breaking changes#

  • Add rioxarray as a required dependency (see new features).

Deprecations#

New features#

Bug fixes#

Documentation#

  • Document opening reprojected bootstrapping and atmospheric online data, and rework parts of datasets chapter outline (#53, PR63).

v0.2.2 (16 Dec. 2022)#

This release implements profile interpolation and scale bars, both documented in new examples, and fixes a bug in grid interpolation to axes coordinates. Continuous integration has been improved with lazy tests for all plot methods, and monitoring of code coverage, increased from 33 to 73 percent in this release.

New features#

Bug fixes#

  • Fix grid interpolation on non-cartopy axes (#45).

Internal changes#

  • Add very simple tests for all plot methods (#37, PR49).

  • Compute code coverage and upload to codecov.io (#38, PR47).

  • Add docs, tests and codecov badges in readme file (PR48).

  • Add automatic delivery on PyPI (#39, PR50).

v0.2.1 (1 Dec. 2022)#

This release removes the required dependency on cartopy by implementing own downloaders for Natural Earth and other (and future) data. All dependencies, and the docs, can be built with pip. Plot methods set aspect ratio to equal, and coordinate labels are hidden by default. Development has moved on a feature-branch squash workflow (as xarray and geopandas).

Breaking changes#

Deprecations#

New features#

  • Remove dependency on cartopy (#25, PR28).

  • Set aspect ratio equal when plotting datasets (#26, PR31).

  • Hide map axes and labels when plotting datasets (#30, PR34).

Bug fixes#

  • Add missing required dependency on requests.

Documentation#

Internal changes#

  • Cache data in XDG_CACHE_HOME if variable if present in environment.

  • Add downloaders in hyoga.open.downloader (#25, PR28).

  • Check for shapefile .dbf, .prj, .shx (#29, PR35).

  • Add minimal continuous integration, no tests yet (PR32).

v0.2.0 Bale (1 Nov. 2022)#

_images/plot_v002_bale.png

This is a minor release implementing several cartographic features. It adds custom colormaps and plot methods for shaded reliefs, and an interface to open and plot Natural Earth data and paleoglacier extents. The documentation uses a new theme. A logo and new examples were added. The package structure has been reworked to better serve future plans.

Breaking changes#

  • Add new required dependencies on cartopy and geopandas. Cartopy is only used to download Natural Earth data, and may no longer be required in future versions (#25).

Deprecations#

  • Function hyoga.demo.get() (returning an url) is deprecated, use hyoga.open.example() (returning a dataset) instead.

New features#

Documentation#

Internal changes#

  • Move dataset accessor to hyoga.core.accessor.

  • Move hyoga configuration to hyoga.core.config.

  • Move function to open example data to hyoga.open.example.

  • Move functions to open local files to hyoga.open.local.

  • Move dataset plot methods to hyoga.plot.datasets.

v0.1.2 (1 Aug 2022)#

This release includes better masks and a dependency on cf_xarray. Plot methods now search for standard variable land_ice_area_fraction for masking and default to using a configurable ice thickness masking point. Masking with where remains available and a new documentation page explains Masking and selection features.

Breaking changes#

Deprecations#

  • The threshold argument in Dataset.hyoga.interp() is deprecated and will be removed in v0.3. Use the glacier_masking_point parameter in hyoga.config or an ice mask instead (see new features).

New features#

  • Plot methods now look for land_ice_area_fraction (instead of land_ice_thickness) to determine which grid cells are glacierized.

  • Add accessor method Dataset.hyoga.assign() to assign new variables by CF-compliant standard names.

  • Add accessor method Dataset.hyoga.assign_icemask() to assign an ice mask variable with standard name land_ice_area_fraction.

  • Add accessor method Dataset.hyoga.where_icemask() to filter glacier variable according to land_ice_area_fraction.

  • Add hyoga.config with a glacier_masking_point config parameter, an ice thickness threshold used as a fallback if land_ice_area_fraction is missing in the dataset.

Internal changes#

  • Method Dataset.hyoga.getvar() now uses cf_xarray to retrieve data variables by their standard name. Thus cf_xarray is now a required dependency (#12).

  • Add module hyoga.conf implementing a config object to store additional parameters in the future.

Documentation#

  • A new documentation page shortly explains Masking and selection features.

  • A new example has been added to show that interpolation also works when surface topography is provided instead of bedrock topography.

v0.1.1 (8 Mar 2021)#

This release includes bug fixes and documentation improvements, including more lightweight demo data. There are new examples in the gallery demonstrating the computation of bedrock isostatic adjustment from a reference topography, and interpolating model results on higher-resolution topography for enhanced visualization.

Deprecations#

  • Functions demo.pism_gridded() and demo.pism_series() are deprecated. Use demo.get('pism.alps.out.2d') and demo.get('pism.alps.out.1d') instead.

Bug fixes#

Documentation#

  • Examples in the documentation use smaller files currently hosted in a separate Github repository hyoga-data (#11). You may want to delete the previous, 400 MB file in ~/.cache/hyoga.

  • New examples have been added to demonstrate plotting bedrock isostasy and interpolated model output (Examples gallery, #11).

v0.1.0 Akaishi (1 Mar 2021)#

_images/plot_v001_akaishi.png

Nothing is old, everything is new. This is the first version!