due date: 2022-07-01
code freeze: 2022-06-24

description:

changed environment:

new features:

• Warning class added. Allows creating warning maps from generic 2d-maps, or form Hazard or Impact objects.
• Set of lines and polygons util functions. Exposures with lines and/or polygons can be disaggregated to points, which can be used to compute impacts that can be reaggregated afterward.

updated features:

• Offline mode for API client enabled. Results from the CLIMADA data api can be cached and re-used later without internet connection.

minor changes:

• Most tutorials and guides have been overhauled and consolidated.
• Updated API wrapper functions: get clearer error messages when data doesn't exist and added method to get the standard centroids to create new hazards.

due date: 2022-01-31
code freeze: 2022-01-25

changed environment:

• cartopy >= 0.20 (0.18 - 0.19)
• cfgrib 0.9.7 - 0.9.9 (>= 0.9.7)
• contextily 1.0 - 1.1 (1.0)
• numba != 0.55.0
• rasterio >= 1.2.7 (1.1 - 1.2.6)

updated features:

• new function get_admin1_geometries: return GeoDataFrame with geometries of admin 1 regions within given countries.
• 'set_' method deprecated. New methods 'from_'.
• '+init CRS specs' deprecated.
• data-api client refactored:
  • method names changed, list_data_type_infos returns only data types with active datasets (data types with only test data are hidden)
  • concatenation of CLIMADA objects was removed from get_hazard and get_exposures
• util.interpolate
  • refactoring: the module util.interpolate was removed and the methods therein were refactored and integrated in util.coordinates.
  • a new method _nearest_neighbor_euclidean was added to find nearest neighbors with a k-d tree using Euclidean metric.
  • the default distance for exposure.assign_centroids was changed to euclidean. This is faster than haversine for (quasi-)gridded data but less accurate.
• TCTracks.from_ibtracs_netcdf: now stores selected agency for each track variable
• Uncertainty Quantification
  • renaming module from uncertainty_quantification to unsequa
  • updating of all plotting methods
  • addition of helper methods for the most common uncertainty input parameters for exposures, hazard, impact functions, entities, measures.
• hazard.select works with extent.
• addition of hazard.select_tight to reduce a hazard to a box around an exposure.
• adaptations to Natural Earth (v5.0.0) from 2021-12-08. The file format has changed and posed a problem to the shapefile.Reader, which consequently was replaced by shapereader.Reader.
  Note: This may lead to a KeyError 'GDP_MD' in various places, e.g. climada.util.finance.nat_earth_adm0. To come over it, remove the cached Natural Earth files in ~/.local/share/cartopy/shapefiles/natural_earth/.

due date: 2021-10-01

description: This is the first release of the core package after CLIMADA sources have been devided into climada_python (core) and climada_petals (extensions).

changed environment:

• cartopy 0.20 and higher are not accepted yet, because of their changes in the CRS objects.
• rasterio 1.2.7 an higher are not accepted yet, also because of their changes in the CRS objects.

updated features:

• uncertainty_quantification: a complete rewriting of the module and its API. Now it can do uncertainty and sensitivity analysis for impact and cost benefit. All the data is stored in a data class with pandas dataframes attributes. Several plotting methods have been added. Saving and loading from hdf5 files has been added.
• impacts_funcs: added two easily modifiable generic impact functions (a step and a sigmoid function) which can be used for a broad range of hazards and resolutions.
• api_client: added convenience methods for creating CLIMADA objects from files accessible through the api, get_hazard, get_exposures and get_litpop,
  and for collecting dataset information into data frames: into_datasets_df, into_files_df.

minor changes:

• litpop: fix of faulty shape handling for admin1 shapes with a hole (e.g. Brandenburg)
• litpop: remove parameter reproject_first (and functionality for reproject_first=False in _get_litpop_single_polygon)
• litpop: minor improvements in readability and code efficiency, incl. better documentation
• config: the setup_logging function was removed from the module, to change the logging level programmatically config.LOGGER.setLevel can be used.