:orphan: .. _release_5_7_0: =============================== 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 :ref:`developers` 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. - `apps diffs `_ - `doc diffs `_ - `docker-files diffs `_