gov-uk-dashboards 26.25.0__py3-none-any.whl → 26.27.0__py3-none-any.whl

gov_uk_dashboards/colours.py

@@ -95,8 +95,27 @@ class AFAccessibleColours(Enum):
     ORANGE = "#F46A25"
     DARK_GREY = "#3D3D3D"
     LIGHT_PURPLE = "#A285D1"
-
-    CATEGORICAL = [DARK_BLUE, TURQUOISE, DARK_PINK, ORANGE, DARK_GREY, LIGHT_PURPLE]
+    MUSTARD = "#9C7A00"
+    CRIMSON = "#C62828"
+    OLIVE = "#7A9A01"
+    MAGENTA = "#D81B60"
+    BROWN = "#8C5A2B"
+    TEAL_BLUE = "#1F77B4"
+
+    CATEGORICAL = [
+        DARK_BLUE,
+        TURQUOISE,
+        DARK_PINK,
+        ORANGE,
+        DARK_GREY,
+        LIGHT_PURPLE,
+        MUSTARD,
+        CRIMSON,
+        OLIVE,
+        MAGENTA,
+        BROWN,
+        TEAL_BLUE,
+    ]
 
     # three shades of blue from dark to light to use for sequential data
     BLUE_SEQUENTIAL = ["#12436D", "#2073BC", "#6BACE6"]

gov_uk_dashboards/components/dash/context_card.py

@@ -624,8 +624,8 @@ class ContextCard:
             When True, comparison tags show the difference between the current VALUE and
             the comparison VALUE converted to weeks/days via `convert_days_to_weeks_and_days`.
             Tag prefix becomes:
-              - "slower than ..." if percent-change is positive,
-              - "faster than ..." if percent-change is negative,
+              - "longer than ..." if percent-change is positive,
+              - "shorter than ..." if percent-change is negative,
               - "unchanged from ..." if zero.
             Requires both current and comparison values to be present.
             NOTE: This cannot be True at the same time as `use_previous_value_rather_than_change`.
@@ -877,9 +877,9 @@ class ContextCard:
                 )
 
                 if percentage_change > 0:
-                    comparison_period_text_prefix = "slower than "
+                    comparison_period_text_prefix = "longer than "
                 elif percentage_change < 0:
-                    comparison_period_text_prefix = "faster than "
+                    comparison_period_text_prefix = "shorter than "
                 else:
                     comparison_period_text_prefix = "unchanged from "
 

gov_uk_dashboards/components/plotly/time_series_chart.py

@@ -64,6 +64,7 @@ class TimeSeriesChart:
         filtered_df: pl.DataFrame,
         trace_name_list: list[str],
         dashed_trace_name_list: list[str] = None,
+        trace_colour_groups: list[str, str] = None,
         initially_hidden_traces: Optional[list[str]] = None,
         hover_data_for_traces_with_different_hover_for_last_point: Optional[
             HoverDataByTrace
@@ -99,6 +100,7 @@ class TimeSeriesChart:
         self.filtered_df = filtered_df
         self.trace_name_list = trace_name_list
         self.dashed_trace_name_list = dashed_trace_name_list
+        self.trace_colour_groups = trace_colour_groups
         self.initially_hidden_traces = initially_hidden_traces
         self.legend_dict = legend_dict
         self.trace_name_column = trace_name_column
@@ -125,6 +127,12 @@ class TimeSeriesChart:
             "triangle-up",
             "x",
             "triangle-down",
+            "cross",
+            "star",
+            "pentagon",
+            "hexagon",
+            "triangle-left",
+            "triangle-right",
         ]
         self.number_of_traces_colour_shift_dict = number_of_traces_colour_shift_dict
         self.additional_line = additional_line
@@ -677,27 +685,97 @@ class TimeSeriesChart:
         return df_list
 
     def _get_colour_list(self):
-        """Returns a list of colours."""
+        """Returns a list of colours (one per trace in trace_name_list).
+
+        If `trace_colour_groups` is provided, traces in the same group share a colour.
+        Traces not in any group get their own colour from the palette.
+        """
+        palette = self._get_base_palette()
+        palette = self._apply_colour_shift(palette)
+
+        groups = getattr(self, "trace_colour_groups", None) or []
+        if not groups:
+            return palette[: len(self.trace_name_list)]
+
+        trace_to_group_id = self._build_trace_to_group_id(groups)
+        return self._assign_colours_with_groups(palette, trace_to_group_id)
+
+    def _get_base_palette(self) -> list[str]:
         number_of_traces = len(self.trace_name_list)
         if number_of_traces == 2 and self.filled_traces_dict is None:
-            colour_list = [
+            return [
                 AFAccessibleColours.DARK_BLUE.value,
                 AFAccessibleColours.ORANGE.value,
-            ]  # if 2 lines should use dark blue & orange as have highest contrast ratio
-        else:
-            colour_list = AFAccessibleColours.CATEGORICAL.value.copy()
+            ]
+        return AFAccessibleColours.CATEGORICAL.value.copy()
+
+    def _apply_colour_shift(self, palette: list[str]) -> list[str]:
+        """Apply number_of_traces_colour_shift_dict; may replace palette with explicit list."""
+        number_of_traces = len(self.trace_name_list)
         colour_shift_dict = (
             {"default": 0}
             if self.number_of_traces_colour_shift_dict is None
             else self.number_of_traces_colour_shift_dict
         )
-
         colour_shift_value = colour_shift_dict.get(
             number_of_traces, colour_shift_dict["default"]
         )
+
         if isinstance(colour_shift_value, list):
-            return colour_shift_value  # list of colours
-        while colour_shift_value > 0:
-            colour_list.append(colour_list.pop(0))
-            colour_shift_value -= 1
-        return colour_list
+            return colour_shift_value
+
+        # rotate left by colour_shift_value
+        shift = int(colour_shift_value)
+        if shift <= 0:
+            return palette
+
+        shift = shift % len(palette)
+        return palette[shift:] + palette[:shift]
+
+    def _build_trace_to_group_id(self, groups: list[list[str]]) -> dict[str, int]:
+        """Validate groups and return a mapping of trace -> group_id."""
+        trace_set = set(self.trace_name_list)
+        trace_to_group_id: dict[str, int] = {}
+
+        for group_id, group in enumerate(groups):
+            for trace in group:
+                if trace not in trace_set:
+                    raise ValueError(
+                        f"trace_colour_groups contains '{trace}', but it's not in trace_name_list."
+                    )
+                if trace in trace_to_group_id:
+                    raise ValueError(
+                        f"Trace '{trace}' appears in more than one trace_colour_group."
+                    )
+                trace_to_group_id[trace] = group_id
+
+        return trace_to_group_id
+
+    def _assign_colours_with_groups(
+        self,
+        palette: list[str],
+        trace_to_group_id: dict[str, int],
+    ) -> list[str]:
+        """Assign one colour per group (first-seen), and one per ungrouped trace."""
+        group_colour: dict[int, str] = {}
+        trace_colour: dict[str, str] = {}
+        colour_idx = 0
+
+        # assign colours to groups in order of first appearance in trace_name_list
+        for trace in self.trace_name_list:
+            group_id = trace_to_group_id.get(trace)
+            if group_id is not None and group_id not in group_colour:
+                group_colour[group_id] = palette[colour_idx % len(palette)]
+                colour_idx += 1
+
+        # apply group colours to grouped traces
+        for trace, group_id in trace_to_group_id.items():
+            trace_colour[trace] = group_colour[group_id]
+
+        # assign colours to ungrouped traces
+        for trace in self.trace_name_list:
+            if trace not in trace_colour:
+                trace_colour[trace] = palette[colour_idx % len(palette)]
+                colour_idx += 1
+
+        return [trace_colour[t] for t in self.trace_name_list]

{gov_uk_dashboards-26.25.0.dist-info → gov_uk_dashboards-26.27.0.dist-info}/METADATA

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: gov_uk_dashboards
-Version: 26.25.0
+Version: 26.27.0
 Summary: Provides access to functionality common to creating a data dashboard.
-Author: Department for Levelling Up, Housing and Communities
+Author: Ministry of Housing, Communities & Local Government
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: setuptools<81.0,>=59.8

{gov_uk_dashboards-26.25.0.dist-info → gov_uk_dashboards-26.27.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
 gov_uk_dashboards/__init__.py,sha256=OqwrcJmNWlyzGe8wEy_lkIgRihjvdtSYhcx43TEvpVU,1281
-gov_uk_dashboards/colours.py,sha256=ju_2FIeTARqG4BQo_2jIwo6trD5yOc8ulhaVj7KJ8hw,2858
+gov_uk_dashboards/colours.py,sha256=igBgM9qj-gxRFfggnu_J6a1irRHfIn4D06WwfWvi7Gw,3155
 gov_uk_dashboards/constants.py,sha256=xsBbONNbsrmTfj2tD8VScmtlwB0ymQ1AfaxDXSJ7kWs,1807
 gov_uk_dashboards/log_kpi.py,sha256=xDhb-ex16MfQ1RHQF99huv2FNRu5EKM30bIXYqCnd6g,1023
 gov_uk_dashboards/symbols.py,sha256=Ca7kWylg5iLzYyninqsk7FPvefz1qvz8UEKmB1VYcxY,425
@@ -49,7 +49,7 @@ gov_uk_dashboards/components/dash/card_full_width.py,sha256=KnpkB3krgLxp1MoqEZaz
 gov_uk_dashboards/components/dash/collapsible_panel.py,sha256=6A90xiTLU0b5e4jaWcisTbsf_82nRBvGapbyETd5m70,1192
 gov_uk_dashboards/components/dash/comparison_la_filter_button.py,sha256=u53Vmuz4MJ0J8RSVXGEFvDgzXIp_-JpDDE4o9VijoDw,671
 gov_uk_dashboards/components/dash/context_banner.py,sha256=gy0qKhseiM1oUyRS1X8_HrJuah-WaWN6yeZOHoGzAl4,1009
-gov_uk_dashboards/components/dash/context_card.py,sha256=lE_srpi4HW06HzRKZFdWigLnLfZvgKqN6uOTXbgPPfI,39481
+gov_uk_dashboards/components/dash/context_card.py,sha256=MvxIuYg3yK-ipTHAcNDXc2TiX-J2uPZv9M5IEeWbOmE,39483
 gov_uk_dashboards/components/dash/dashboard_container.py,sha256=KC2isR0NShxUYCl_pzDEAS4WK5pFrLMp4m2We3AqiwM,512
 gov_uk_dashboards/components/dash/data_quality_banner.py,sha256=VLuAndN9xVFuMWFLqoPlolAJt08H9_rQa5x7jqde_RQ,2945
 gov_uk_dashboards/components/dash/details.py,sha256=ENkSBKd6XZTq0X7Jn0-zPaO1qR4F7zPNX-RLAXKVvAI,1107
@@ -90,7 +90,7 @@ gov_uk_dashboards/components/plotly/captioned_figure.py,sha256=XPY1MUbpKs0pEHvnU
 gov_uk_dashboards/components/plotly/choropleth_map.py,sha256=U9RmS3MZGloQAt9HoSYh3Xad205DDfZOjz91ZD_ydbI,9849
 gov_uk_dashboards/components/plotly/enums.py,sha256=ibzWxGd8E01swHGIdYIMGSLOZJh4Q8ON0Zyc92JBFno,892
 gov_uk_dashboards/components/plotly/stacked_barchart.py,sha256=oGgCA08Y-jHzWwOv3knfBPtFE8vPUwOs7E5PrqVExq0,19165
-gov_uk_dashboards/components/plotly/time_series_chart.py,sha256=XefuriycHQXI7ETWtkM0aMoUwK88ugo2iXiJ5X4IY1Q,27793
+gov_uk_dashboards/components/plotly/time_series_chart.py,sha256=YZgBBBpR4KwxijShgmB8rBAaCDzPfkdz5B_hk6j_4PI,30816
 gov_uk_dashboards/figures/__init__.py,sha256=FusPSoLDgFFRC0v3t_agHkVPG66fIjlrPlPaCyFefno,718
 gov_uk_dashboards/figures/line_chart.py,sha256=3fr5HVwOnuuR6xZ5t0UXB0U2I803yhTjDZMkf1ttstY,2955
 gov_uk_dashboards/figures/enums/__init__.py,sha256=sZyTdNROAxAZa93OR_Wz4XYZtdFqLSLud0if6l5dscY,203
@@ -121,8 +121,8 @@ gov_uk_dashboards/lib/testing_functions/barchart_data_test_assertions.py,sha256=
 gov_uk_dashboards/lib/testing_functions/data_test_assertions.py,sha256=1Icy7NZXw6hI_-7QAUaHqjjPKViY0jcFEASlk6Ul2tg,4162
 gov_uk_dashboards/lib/testing_functions/data_test_helper_functions.py,sha256=JoptoXJORuIdrhweVlp9fhX-ew2GtIkctIotpHWBQDQ,9635
 gov_uk_dashboards/lib/testing_functions/timeseries_data_test_assertions.py,sha256=SJa3WLgFqf7Y1W0sxsOew_-4m3689cjynRjoCyBK5WQ,1240
-gov_uk_dashboards-26.25.0.dist-info/licenses/LICENSE,sha256=GDiD7Y2Gx7JucPV1JfVySJeah-qiSyBPdpJ6RHCEHTc,1126
-gov_uk_dashboards-26.25.0.dist-info/METADATA,sha256=qgMJmWFtHDfatFmtJM-VrDNyf3943tRAsdteFwTMD_g,5903
-gov_uk_dashboards-26.25.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-gov_uk_dashboards-26.25.0.dist-info/top_level.txt,sha256=gPaN1P3-H3Rgi2me6tt-fX_cxo19CZfA4PjlZPjGRpo,18
-gov_uk_dashboards-26.25.0.dist-info/RECORD,,
+gov_uk_dashboards-26.27.0.dist-info/licenses/LICENSE,sha256=GDiD7Y2Gx7JucPV1JfVySJeah-qiSyBPdpJ6RHCEHTc,1126
+gov_uk_dashboards-26.27.0.dist-info/METADATA,sha256=15y3ZBsvY6flcLEKR92lDBB8_lfENQq08-I-pioiUSw,5902
+gov_uk_dashboards-26.27.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+gov_uk_dashboards-26.27.0.dist-info/top_level.txt,sha256=gPaN1P3-H3Rgi2me6tt-fX_cxo19CZfA4PjlZPjGRpo,18
+gov_uk_dashboards-26.27.0.dist-info/RECORD,,