Upcoming Releases

new release

due date: 2022-01-??

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)
  • list_dataset_infos has a limit of returned datasets (default: 100)
  • concatenation of CLIMADA objects was removed from get_hazard and get_exposures
• util.interpolate
  • refactoring: the module util.interpolate was remove 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.

v3.0.0

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.