Please note that as long as \(\omega radlib\) releases are within the
0.y.z series, the API cannot be considered stable. We will try to avoid sudden API breaks via deprecation warnings. All \(\omega radlib\) releases come without any warranty. Release notes might be incomplete. See here for a complete record of changes.
You can install the latest \(\omega radlib\) release from PyPI via
$ pip install wradlib or specific version via
$ pip install wradlib==x.y.z. The recommended installation process is described in Getting Started.
Nothing, so far
- Added functions to match the precipitation radar of GPM/TRMM platforms with ground radar observations in 3D (
- Added example notebook of GPM/TRMM-GR matching
- Revised docs and build proces. Use codecov for coverage testing. Use suprocesses for testing on CI.
wradlib.vis.plot_rhi. Added contour and filled contour plotting.
- Consolidate raster handling functions with respect to raster origin. Added
- New notebook examples covering wradlib-tour, classification
- Added reading WX-format to RADOLAN reader
wradlib.io.read_RADOLAN_compositeto also accept file-handles
wradlib.io.read_Rainbowto also accept file-handles
- Added reading groups to
wradlib.qual.cum_beam_block_fracto compute cumulative beam blockage
- Added earth curvature display to beam blockage
wradlib.georef.read_gdal_valuesto read multiband data
- Fix documentation inconsistencies
- Fix calculation of pulse volume in
- Use dedicated OSR IsSame() in
wradlib.util.find_bbox_indicesto account for origin.
wradlib.ipol.cart2irregular_splineto account for data/coordinate origin.
- Several minor fixes
- examples and tutorials are provided as jupyter notebooks
- docs are directly created from notebooks (see full workflow here)
- structured notebooks with parent notebook, where appropriate
- documentation reviewed and adapted
- docstrings reviewed, added links to notebooks where appropriate, cosmetic changes
- package notebooks and converted python scripts with pypi-sdist
- added tutorials on how to use notebooks and a breif Python introduction
- deploy untagged MICRO-version changes to test-pypi
- reworked citation handling
- added reading capability of new radolan FZ product
- added use of dedicated wradlib-repo, WRADLIB_DATA env variable and data file retrieving functions
- add ability to read gzipped dx data
wradlib.io.read_Rainbowto read product pixmap data from rainbow5 files
- removed bug reading lists in
- fixed offset bug in
- fixed incompatibility issue of ipol module with scipy 0.18.0
- several minor fixes
- As of now \(\omega radlib\) is python3 compatible.
- Docstrings, tests and examples as well as the documentation have been reviewed and fixed.
- main \(\omega radlib\) repository is now hosted here on github.
- \(\omega radlib\) docs are now hosted on github, but with custom domain.
\(\omega radlib\) is constantly tested on travis-ci wradlib within a miniconda python environment with the latest python27, python34 and python35 interpreters on linux OS. We also check code coverage for all pull requests and additions with coveralls.
- georef.create_projstr, also removed deprecated decorators
New experimental module
zonalstats: it supports computation of zonal statistics (so far mean and variance) for target polygons.
Typical applications would be the computation of average catchment rainfall from polar or cartesian grids. Check out the
module documentation and the new examples.
\(\omega radlib\) functions concerned with georeferencing will only use projection information based on OSR objects. This version will help you to adapt your code base to this change before next minor release: Using deprecated PROJ.4 strings in call to the following functions/classes:
vpr.make_3D_grid will generate a DeprecationWarning and try to correct old calling method at runtime.
Added ability to handle georeferenced raster and vector data
Port of PyRadarMet partial beamblockage calculations by DEM
- In georef module a new helper function create_osr is added. This function helps to create an osr object for specific projections.
- Bugfix: add multiplication of grid resolution in
wradlib.georef.get_radolan_gridmerged from v0.5.1
- Several convenience functions for reading, transforming and projecting as well as plotting rasterfiles and shapefiles including example
- Calculation of partial/cumulative beamblockage with example
- The behaviour of wradlib.adjust.AdjustMFB has been changed. Control parameters are no longer passed via the
__call__function, but, as for all other adjustment classes, via the initialisation of an adjustment object. Documentation has been revised to make the behaviour more transparent. The parameter ‘biasby’ has been replaced by a dictionary mfb_args that carries all parameters that control the behaviour of AdjustMFB.
Function georef.create_projstr is deprecated.
Bugfix: add multiplication of grid resolution in
wradlib.georef.get_radolan_grid merged from v0.4.2
0.6.0 on, \(\omega radlib\) functions concerned with georeferencing will only use projection information based on OSR objects. This version will help you to adapt your code base to this change before using version
0.6.0: Any use of proj4 strings will generate a deprecation warning with the following functions/classes:
- Two functions exposed documentation library section: wradlib.io.read_safnwc and wradlib.vis.plot_max_plan_and_vert
- New features, changes and deprecations will be addressed in the documentation in the future. This is by highlighting them as New in Version X.Y.Z, Changed in Version X.Y.Z or Deprecated since Version X.Y.Z
Bugfix: add multiplication of grid resolution in
From now on, \(\omega radlib\) will generate warnings if keyword parameters of \(\omega radlib\) functions will be or have been changed. This is achieved by using
wradlib.util.apichange_kwargs as a decorator (see
apichange_example.py for examples how these warnings might look like). Please take these warnings seriously and adapt your applications before stepping to a new \(\omega radlib\) release.
- Fixed a broken proj4 string for DWD radolan polarstereographic projection in function
- Added RADOLAN tutorial to the documentation. Together with that came new function to retrieve the RADOLAN composite grid.
- Adding section
Release notesto the documentation.
- comprehensive RADOLAN tutorial, examples, and example data: http://wradlib.org/wradlib-docs/latest/tutorial_radolan_format.html
- enhanced wradlib.io.read_RADOLAN_composite to read EX product
Visually most strikingly, we moved to a new style in our online documentation.
However, the most important change introduced with this release was to remove a number of deprecated functions that will not be supported anymore (see list below). Users who want to use these functions need to fall back to
0.2.0 (not recommended). Accordingly, examples and documentation has been revised in order to remove all remaining usage of deprecated functions and also fix some documentation issues.
In addition, we removed three outdated tutorial (on clutter detection, convertion and rainfall accumulation) and replaced the two latter by a more concise tutorial “Converting reflectivity to rainfall”.
Finally, we use one “central” bibliography for literature cross-referencing now (see http://wradlib.org/wradlib-docs/latest/zreferences.html).
- New style of online docs (http://wradlib.org/wradlib-docs), using sphinx_rtd_theme
- Added Tutorial http://wradlib.org/wradlib-docs/latest/tutorial_get_rainfall.html
- New organisation of bibliography: http://wradlib.org/wradlib-docs/latest/zreferences.html
The following functions/classes that were marked as deprecated before have been removed with this release:
0.2.0 is the first new release of \(\omega radlib\) after more than three years of
0.0.1. The changes that have accumulated during this time are too many to list them here. Let’s just say that from here on, we will keep track of changes in \(\omega radlib\) releases more thoroughly.
0.1.1 was the first experimental \(\omega radlib\) release.