Superblockify

**************************

* ✨ First major release ✨
* 📦 Prepared for osmnx 2.0.0 and shipped `cities.yml` in pypi package.
* ⚙️ Added function to set log level and added python versions 3.11 and 3.12.
* 🔄 Merged several pull requests improving settings, README, dependencies, and project structure.
* 🐛 Fixed coverage for special case, tests, and code style issues.
* 📝 Updated README with CI/CD badges, improved documentation, and unified capitalization.
* 🗒️ Updated Changelog, Version, and Website Copyright.
* 📝 Licensed work under GNU AGPLv3.
* 📊 IO operations enhanced with graph reduction.
* 🗒️ Logging improvements: silenced numba compilation, reprojected debug messages.
* ⚙️ Parallelization updates: removed `num_workers` and `chunk_size`.
* 🧪 Testing updates: increased util coverage, added response 502 as `xfail`.
* 🆕 New features: Betweenness Centrality Cutoff, Reduced path filling.
* 🐛 Fixes: notebook formatting, GEOSException in tesselation, missing attribute.
* 🔄 Merged pull request: `🌐 Added Betweenness Centrality Cutoff
<https://github.com/NERDSITU/superblockify/pull/82>`_.
* 📝 Misc changes: deactivated colormap logging,
unified nodes and edges into one variable.
* 📊 Improved analysis scripts

**************************

* 📊 Unified Plot image format/suffix in config
* 🔢 Key Figures: lightweight results for analysis, see
:func:`superblockify.partitioning.utils.get_key_figures`.
* 💾 Lightweigth metric saving
* 🆔 Added ISO 3166 country codes
* 🏙️ City Crawling: Get cities from Springer Website Table. Useful functions to add
OSM relation IDs to the cities. Moved cities to `cities.yml` file.
* 🌆 City List format specification.
* 🗒️ Adjust logging for better usefullness. Add and remove some log messages.
* 📚️ Added `mamba` to the installation instructions and changed standard environment
name.
* ⬆️ Demand Change: Added Superblock aggregate statistics for the betweennesses.

**************************

* ✨ Second release ✨
* ⬆️ Integrated final graph statistics and Superblock statistics.
* 🏡 Moved Coverage to Codecov |codecov-badge|.
* ⬆️ Display basic graph stats at Partitioner initialization.
Abstract base class :class:`superblockify.partitioning.base.BasePartitioner`.
* ⬆️ Geopackage export: Resolve Superblock cell option. If set to True, the Superblock cells are
resolved to polygons. Normally, only the edges are exported.
Added general graph stats with OSM boundary polygon.

.. |codecov-badge| image:: https://codecov.io/gh/NERDSITU/superblockify/branch/main/graph/badge.svg?token=AS72IFT2Q4
:target: https://codecov.io/gh/NERDSITU/superblockify
:height: 2ex

**************************

* 🔧 Sped up population distribution in
:func:`superblockify.population.approximation.get_edge_population`.
* ⬆️ Add population and density to Superblocks
* 🐛 Fix: Graph import projection order. Un-skewed distance attribute.

**************************

* 📚️ Documented approaches in reference notebooks :ref:`Population Data`,
:ref:`Street Tessellation`, and :ref:`Street Population Density`.
* ⬆️ Added population preprocessing for for every tesselated edge. This enables an
efficient population density aggregation for any given superblock.
See modules in :mod:`superblockify.population`.
* ⬆️ Automated population data download and preprocessing of the GHS-POP - R2023A dataset
<https://ghsl.jrc.ec.europa.eu/ghs_pop2023.php>.
* ⬆️ Added graph attribute `boundary`, used for calculating the total area of the city.
* ⬆️ Added general graph statistics :mod:`superblockify.metric.graph_stats`.
Including spatial clustering and anisotropy.

**************************

* ⬆️ Added Partitioner based on Betweenness Centrality.
* 🐛 Fix segfault in betweenness centrality calculation caused by testcase with one node
graph.