microsegments 0.2.0__tar.gz → 0.2.2__tar.gz

{microsegments-0.2.0 → microsegments-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: microsegments
-Version: 0.2.0
+Version: 0.2.2
 Summary: Where do transit vehicles linger? Count vehicle position observations per micro-segment of a line, from GTFS + AVL / GTFS-RT positions.
 Project-URL: Homepage, https://github.com/GaspardMerten/microsegments
 Project-URL: Repository, https://github.com/GaspardMerten/microsegments
@@ -150,8 +150,10 @@ is therefore about 20 s of presence.
 | `excess_obs_per_h`, `log2_ratio` | see `metrics.py` | |
 
 All values are ratios of sums over the selected days (optionally post-stratified by weekday). Stop zones
-(30 m before to 60 m after each stop) can be masked to bring out signals and junctions. Colour scales are
-fixed per metric (p98 over 6–21 h), so hours and weekdays compare directly.
+(30 m before to 60 m after each stop) can be masked to bring out signals and junctions. The colour scale is
+one fixed function of the value for every line, period, hour and option (`microsegments.scale`): values are
+brought to seconds per passage per 30 m of track and read on the STIB speed ramp (green 4 s ≈ 27 km/h, red
+14 s ≈ 7.5 km/h, dark red ≥ 24 s); both excesses share it as 3 s + excess.
 
 ## Missing data and GTFS versions
 

{microsegments-0.2.0 → microsegments-0.2.2}/README.md

@@ -112,8 +112,10 @@ is therefore about 20 s of presence.
 | `excess_obs_per_h`, `log2_ratio` | see `metrics.py` | |
 
 All values are ratios of sums over the selected days (optionally post-stratified by weekday). Stop zones
-(30 m before to 60 m after each stop) can be masked to bring out signals and junctions. Colour scales are
-fixed per metric (p98 over 6–21 h), so hours and weekdays compare directly.
+(30 m before to 60 m after each stop) can be masked to bring out signals and junctions. The colour scale is
+one fixed function of the value for every line, period, hour and option (`microsegments.scale`): values are
+brought to seconds per passage per 30 m of track and read on the STIB speed ramp (green 4 s ≈ 27 km/h, red
+14 s ≈ 7.5 km/h, dark red ≥ 24 s); both excesses share it as 3 s + excess.
 
 ## Missing data and GTFS versions
 

{microsegments-0.2.0 → microsegments-0.2.2}/src/microsegments/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.2.0'
-__version_tuple__ = version_tuple = (0, 2, 0)
+__version__ = version = '0.2.2'
+__version_tuple__ = version_tuple = (0, 2, 2)
 
 __commit_id__ = commit_id = None

{microsegments-0.2.0 → microsegments-0.2.2}/src/microsegments/html/export.py

@@ -6,6 +6,7 @@ matrix, profile, hotspots and coverage calendar work offline. Leaflet's CSS is i
 from __future__ import annotations
 
 import html
+import warnings
 import json
 import re
 from importlib import resources
@@ -49,14 +50,15 @@ def _default_title(c: dict, lang: str) -> str:
 
 def render(analysis_or_contract, *, title: str | None = None, lang: str = "fr", tiles: bool = True,
            scales: dict | None = None, description: str | None = None, **contract_kw) -> str:
-    """The full HTML document as a string. ``scales``: fixed colour-scale tops, e.g.
-    ``{"oph": 20, "opp": 3, "ex": 1.5, "oph10": 8}`` (or ``{"oph": {"true": 20, "false": 6}}`` per
-    stop-zone toggle); default: p98 of the 6-21 h values. ``contract_kw`` go to ``to_contract`` when an
-    Analysis / RunResult is given."""
+    """The full HTML document as a string. ``contract_kw`` go to ``to_contract`` when an Analysis /
+    RunResult is given. The colour scale is fixed for every page (``microsegments.scale``); ``scales`` is
+    deprecated and ignored."""
     c = dict(_contract(analysis_or_contract, **contract_kw))
     c["tiles"] = bool(tiles)
     if scales:
-        c["scales"] = scales
+        warnings.warn("render(scales=...) is ignored: the colour scale is fixed (microsegments.scale)",
+                      DeprecationWarning, stacklevel=2)
+    c.pop("scales", None)
     if title:
         c["title"] = title
     page_title = c.get("title") or _default_title(c, lang)