v5.7.0 release notes

Follow the links to see changes that have been made to the master branch of each repository since the last release (v5.7.0) on April 21, 2020.

These changes should appear in the next release. If you need them now, see Developers’ Guide for instructions on cloning and installing from the master branch.

To see documentation that has already been developed to accompany any new features listed below, click on the “dev” branch of the documentation, in the menu on the left hand side of this page.

Changes that are not backward compatible

General changes

Changes to classic

None.

See classic diffs

Changes to clawutil

  • Support added for flagregions and FlagRegionData, see flagregions.html.

  • Support added for gzip/bzip2 unpacking in get_remote_file.

  • Changes to Makefile.common to add make notebook_htmls target to turn Jupyter notebooks into html files using nbconvert, and make readme to better handle converting README.rst into README.html.

See clawutil diffs

Changes to visclaw

  • Several updates to Matlab tools.

  • Added particle_tools.py for plotting particle paths when using Lagrangian gauges.

  • Added plottools.pcolorcells to better plot data on finite volume grid cells.

  • Improvements to how animations are made on html pages and other updates to animation_tools.py.

  • Improve colorbar options and better colorbars when using colormaps.add_colormaps.

  • Change default behavior in frametools.py when looping over all patches: skip those that lie outside of rectangle specified by xlimits and ylimits to improve speed. Can over-ride this by setting plotaxes.skip_patches_outside_xylimits = False.

See visclaw diffs

Changes to riemann

  • Updates to a few Riemann solvers

See riemann diffs

Changes to amrclaw

  • Allow setting max1d in setrun.py.

  • Close output files properly in valout.f90

  • Some support for Lagrangian gauges but not yet fully implemented except in geoclaw.

  • Introduce new flagregions to replace regions eventually, see flagregions.html.

  • New region_tools.py module with class RuledRectangle in particular, useful in specifying flagregions. See ruled_rectangles.

See amrclaw diffs

Changes to geoclaw

  • Support for “Lagrangian gauges” that can be used for particle tracking to help visualize the flow. See lagrangian_gauges.html.

  • Many changes to how fgmax grids are specified and handled. The new code is much faster if there are lots of fgmax points (tested up to around 7 million). You can now specify points near the coastline up to some elevation much more easily for problems where you know higher ground will never be inundated. Points can also be specifed using file specified with the same format as a topofile (with topo_type==3) with 0/1 values indicating which points are to be used as fgmax points. For more about all these changes, see fgmax.html.

  • Improvements to fgmax_tools.py module.

  • New routine set_eta_init.f90 added that can be used to specify a spatially varying initial elevation eta = B + h. The default version handles subsidence or uplift specified in dtopo files. See set_eta_init.

  • Improvements to kmltools.py to facilitate making kml versions of plots, including pcolorcells_for_kml to make png files that align better, fgmax2kml for plotting fgmax results, and better support to plot polygonal outlines of flagregions that are RuledRectangles.

  • New option added to allow specifying a force_dry_init array that indicates cells that should be forced to be dry (h = 0) when initialized, even if the topography elevation is below sea_level. This allows better modeling of coastal regions where there is dry land below sea level but protected by dikes or levies. See force_dry.html.

  • New marching_front.py module with tools to identify dry land protected by dikes or to select fgmax points connected to the shore by land below some specified elevation. See marching_front.html.

  • Many other minor fixes and improvements.

See geoclaw diffs

Changes to PyClaw

Mostly minor changes.

For changes in PyClaw, see the PyClaw changelog.

See pyclaw diffs

Other Clawpack Repositories

The repositories below are not included in the Clawpack tarfile or pip install, but changes to these repositories may also be of interest.