newsworthycharts 1.59.0__tar.gz → 1.60.0__tar.gz

{newsworthycharts-1.59.0 → newsworthycharts-1.60.0}/PKG-INFO

@@ -1,15 +1,29 @@
 Metadata-Version: 2.1
 Name: newsworthycharts
-Version: 1.59.0
+Version: 1.60.0
 Summary: Matplotlib wrapper to create charts and publish them on Amazon S3
 Home-page: https://github.com/jplusplus/newsworthycharts
-Download-URL: https://github.com/jplusplus/newsworthycharts/archive/1.59.0.tar.gz
+Download-URL: https://github.com/jplusplus/newsworthycharts/archive/1.60.0.tar.gz
 Author: Jens Finnäs and Leo Wallentin, J++ Stockholm
 Author-email: stockholm@jplusplus.org
 License: MIT
 Requires-Python: >=3.9
 Description-Content-Type: text/x-rst
 License-File: LICENSE.txt
+Requires-Dist: boto3>=1.26
+Requires-Dist: matplotlib==3.9.2
+Requires-Dist: langcodes>=3.3
+Requires-Dist: Babel<3,>=2.14.0
+Requires-Dist: PyYAML>=3
+Requires-Dist: adjustText==0.7.3
+Requires-Dist: numpy>2
+Requires-Dist: python-dateutil<3,>=2
+Requires-Dist: Pillow==10.4.0
+Requires-Dist: requests>=2.22
+Requires-Dist: matplotlib-label-lines==0.5.1
+Requires-Dist: geopandas>1
+Requires-Dist: mapclassify==2.6.1
+Requires-Dist: fiona>=1.0
 
 This  module contains methods for producing graphs and publishing them on Amazon S3, or in the location of your choice.
 
@@ -123,8 +137,8 @@ These settings are available for all chart types:
 - yline = None  # A horizontal line across the chart (Matplotlib: axhline)
 - labels = []  # Optionally one label for each dataset
 - annotations = []  # Manually added annotations
-- interval = None  # yearly|quarterly|monthly|weekly|daily
-- units = 'number'  # number|percent|degrees
+- interval = None  # yearly, quarterly, monthly, weekly, daily
+- units = 'number'  # number, percent, degrees
 - show_ticks = True  # toggle category names, dates, etc
 - subtitle = None
 - note = None
@@ -223,13 +237,33 @@ To deploy a new version to [PyPi](https://pypi.org/project/newsworthycharts):
 
 Roadmap
 -------
-  - Adding more base maps
-  - Getting rid of custom settings-hack
+
+  - Get rid of custom settings-hack
+  - Remove custom charts (add missing api interfaces to Chart class instead)
+  - Remove DataWrapper class (out-of-scope)
   - Custom month locator with equal-width month bars
+  - Add color-ramp choropleth maps, as an alternative to binning
 
 Changelog
 ---------
 
+- 1.60.0
+
+  - [BREAKING] The default number of bins in maps is now 5, not 9
+  - [BREAKING] Default color ramp for choropleth maps is now `YlGn`
+  - GeoPandas 1.x
+  - numpy 2.x
+  - matplotlib==3.9.2
+  - Pillow==10.4.0
+  - Improved nan handling in labelling continuous choropleth maps
+  - Replace deprecated `.unary_union` with `.union_all()`
+  - Choropleth map legends now print spans for binned data
+  - Use Matplotlib's legend for choropleth maps, to have the same style as other charts, and for much improved flexibility
+  - Inset maps now (finally!) work with continuous data
+  - Better error handling in categorical maps
+  - Cast all categorical values to strings in categorical maps
+  - Replace deprecated imghdr with puremagic in tests
+
 - 1.59.0
 
   - Added `.highlight_annotation` to enable turning off the textual annotation on the highlighted point

newsworthycharts-1.59.0/newsworthycharts.egg-info/PKG-INFO → newsworthycharts-1.60.0/README.rst

@@ -1,16 +1,3 @@
-Metadata-Version: 2.1
-Name: newsworthycharts
-Version: 1.59.0
-Summary: Matplotlib wrapper to create charts and publish them on Amazon S3
-Home-page: https://github.com/jplusplus/newsworthycharts
-Download-URL: https://github.com/jplusplus/newsworthycharts/archive/1.59.0.tar.gz
-Author: Jens Finnäs and Leo Wallentin, J++ Stockholm
-Author-email: stockholm@jplusplus.org
-License: MIT
-Requires-Python: >=3.9
-Description-Content-Type: text/x-rst
-License-File: LICENSE.txt
-
 This  module contains methods for producing graphs and publishing them on Amazon S3, or in the location of your choice.
 
 It is written and maintained for `Newsworthy <https://www.newsworthy.se/en/>`_, but could possibly come in handy for other people as well.
@@ -123,8 +110,8 @@ These settings are available for all chart types:
 - yline = None  # A horizontal line across the chart (Matplotlib: axhline)
 - labels = []  # Optionally one label for each dataset
 - annotations = []  # Manually added annotations
-- interval = None  # yearly|quarterly|monthly|weekly|daily
-- units = 'number'  # number|percent|degrees
+- interval = None  # yearly, quarterly, monthly, weekly, daily
+- units = 'number'  # number, percent, degrees
 - show_ticks = True  # toggle category names, dates, etc
 - subtitle = None
 - note = None
@@ -223,13 +210,33 @@ To deploy a new version to [PyPi](https://pypi.org/project/newsworthycharts):
 
 Roadmap
 -------
-  - Adding more base maps
-  - Getting rid of custom settings-hack
+
+  - Get rid of custom settings-hack
+  - Remove custom charts (add missing api interfaces to Chart class instead)
+  - Remove DataWrapper class (out-of-scope)
   - Custom month locator with equal-width month bars
+  - Add color-ramp choropleth maps, as an alternative to binning
 
 Changelog
 ---------
 
+- 1.60.0
+
+  - [BREAKING] The default number of bins in maps is now 5, not 9
+  - [BREAKING] Default color ramp for choropleth maps is now `YlGn`
+  - GeoPandas 1.x
+  - numpy 2.x
+  - matplotlib==3.9.2
+  - Pillow==10.4.0
+  - Improved nan handling in labelling continuous choropleth maps
+  - Replace deprecated `.unary_union` with `.union_all()`
+  - Choropleth map legends now print spans for binned data
+  - Use Matplotlib's legend for choropleth maps, to have the same style as other charts, and for much improved flexibility
+  - Inset maps now (finally!) work with continuous data
+  - Better error handling in categorical maps
+  - Cast all categorical values to strings in categorical maps
+  - Replace deprecated imghdr with puremagic in tests
+
 - 1.59.0
 
   - Added `.highlight_annotation` to enable turning off the textual annotation on the highlighted point

{newsworthycharts-1.59.0 → newsworthycharts-1.60.0}/newsworthycharts/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "1.59.0"
+__version__ = "1.60.0"
 
 from .chart import Chart
 from .choroplethmap import ChoroplethMap

{newsworthycharts-1.59.0 → newsworthycharts-1.60.0}/newsworthycharts/choroplethmap.py

@@ -6,6 +6,7 @@ import geopandas as gpd
 import numpy as np
 import pandas as pd
 import mapclassify
+import matplotlib.patches as mpatches
 
 
 class ChoroplethMap(Map):
@@ -29,15 +30,27 @@ class ChoroplethMap(Map):
 
         df = self._prepare_map_data()
 
-        if self.categorical:
-            # We'll categorize manually further down the line,
-            # to easier implement custom coloring
-            pass
-            # df["data"] = pd.Categorical(
-            #     df["data"],
-            #     ordered=True,
-            # )
-        else:
+        args = {
+            "categorical": True,
+            "legend": True,  # bug in geopandas, fixed in master but not released
+            "legend_kwds": {
+                "loc": "upper left",
+                "bbox_to_anchor": (1.05, 1.0),
+            },
+            "edgecolor": "white",
+            "linewidth": 0.2,
+            "missing_kwds": {
+                "color": "gainsboro",
+            },
+        }
+        # This should be adjusted per basemap
+        label_kwargs = {
+            "bbox_to_anchor": (0.92, 0.95),
+            "loc": "upper left",
+        }
+
+        patches = []  # for legend
+        if not self.categorical:
             # mapclassify doesn't work well with nan values,
             # but we to keep them for plotting, hence
             # this hack with cutting out nan's and re-pasting them below
@@ -58,44 +71,57 @@ class ChoroplethMap(Map):
             _dict = _has_value[["id", "cats"]].set_index("id").to_dict()
             df["data"] = df["id"].map(_dict["cats"])
 
-        args = {
-            "categorical": True,
-            "legend": True,  # bug in geopandas, fixed in master but not released
-            "legend_kwds": {
-                "loc": "upper left",
-                "bbox_to_anchor": (1.05, 1.0),
-            },
-            "edgecolor": "white",
-            "linewidth": 0.2,
-            "missing_kwds": {
-                "color": "gainsboro",
-            },
-        }
-        # This should be adjusted per basemap
-        label_kwargs = {
-            "bbox_to_anchor": (0.92, 0.95),
-            "loc": "upper left",
-        }
-        if not self.categorical:
-            args["cmap"] = self.color_ramp
-            args["column"] = "data"
-        if self.categorical:
-            cat = df[~df["data"].isna()]["data"].unique()
+            # args["column"] = "data"
+            # args["cmap"] = self.color_ramp
+            # We can not provide vmin/vmax to geopandas, so we need to
+            # normalize the data ourselves, otherwise the inset maps will be off
+            import matplotlib.cm as cm
+            import matplotlib as mpl
+            norm = mpl.colors.Normalize(vmin=df["data"].min(), vmax=df["data"].max())
+            mapper = cm.ScalarMappable(norm=norm, cmap=self.color_ramp)
+            df["color"] = df["data"].apply(lambda x: mapper.to_rgba(x) if not np.isnan(x) else "gainsboro")
+            df["color"] = df["color"].fillna("gainsboro")
+            args["color"] = df["color"]
+
+            # Add labels legend (manually, Geopandas is too crude as of now)
+            fmt = self._get_value_axis_formatter()
+            for idx, cat in enumerate(binning.bins):
+                # cat is the upper limit of each category
+                if binning.counts[idx] == 1:
+                    txt_val = fmt(cat)
+                elif idx == 0:
+                    txt_val = f"– {fmt(cat)}"
+                else:
+                    txt_val = f"{fmt(binning.bins[idx - 1])} – {fmt(cat)}"
+                patches.append(mpatches.Patch(color=mapper.to_rgba(cat), label=txt_val))
+
+        elif self.categorical:
+            # We'll categorize manually further down the line,
+            # to easier implement custom coloring
+            # df["data"] = pd.Categorical(
+            #     df["data"],
+            #     ordered=True,
+            # )
+
+            cat = df[~df["data"].isna()]["data"].astype(str).unique()
             args["categories"] = cat
             if self.colors:
                 color_map = self.colors
             else:
                 color_map = {}
+                if len(cat) > len(self._nwc_style["qualitative_colors"]):
+                    raise ValueError(
+                        "Too many categories for the available colors in the current style. " +  # noqa:W504
+                        "Add a custom color map, or use a style with more categorical colors!"
+                    )
                 for idx, cat in enumerate(cat):
                     color_map[cat] = self._nwc_style["qualitative_colors"][idx]
-            df["color"] = df["data"].map(color_map)
+            df["color"] = df["data"].astype(str).map(color_map)
             df["color"] = df["color"].fillna("gainsboro")
             args["color"] = df["color"]
 
             # Geopandas does not handle legend if color keyword is used
             # We need to add it ourselves
-            import matplotlib.patches as mpatches
-            patches = []
             for label, color in color_map.items():
                 # A bit of an hack:
                 # Check if this corresponds to one of our predefined
@@ -104,44 +130,20 @@ class ChoroplethMap(Map):
                     color = self._nwc_style[f"{color}_color"]
                 patch = mpatches.Patch(color=color, label=label)
                 patches.append(patch)
-            self.ax.legend(
-                handles=patches,
-                **label_kwargs
-            )
+        if self.missing_label:
+            patches.append(mpatches.Patch(color="gainsboro", label=self.missing_label))
 
-        fig = df.plot(ax=self.ax, **args)
+        df.plot(ax=self.ax, **args)
         # Add outer edge
-        gpd.GeoSeries(df.unary_union).plot(
+        gpd.GeoSeries(df.union_all()).plot(
             ax=self.ax,
             edgecolor="lightgrey",
             linewidth=0.2,
             facecolor="none",
             color="none",
         )
-        self.ax.axis("off")
-
-        # Format numbers in legend
-        if not self.categorical:
-            leg = fig.get_legend()
-            fmt = self._get_value_axis_formatter()
-            remove_last = False
-            for lbl in leg.get_texts():
-                val = lbl.get_text()
-                if val == "NaN":  # as returned by mapclassify
-                    if self.missing_label is not None:
-                        val = self.missing_label
-                    else:
-                        remove_last = True
-                        val = ""
-                else:
-                    val = float(val)
-                    val = fmt(val)
-                lbl.set_text(val)
-            if remove_last:
-                del leg.legend_handles[-1]
-                texts = [lbl.get_text() for lbl in leg.get_texts()]
-                fig.legend(handles=leg.legend_handles, labels=texts, **label_kwargs)
 
+        self.ax.axis("off")
         for inset in self.insets:
             if "prefix" in inset:
                 _df = df[df["id"].str.startswith(inset["prefix"])].copy()
@@ -150,12 +152,11 @@ class ChoroplethMap(Map):
             if _df["data"].isnull().all():
                 # Skip if no data
                 continue
-            if self.categorical:
-                # We need a series matching the filtered data
-                args["color"] = _df["color"]
+
+            args["color"] = _df["color"]
             args["legend"] = False
             axin = self.ax.inset_axes(inset["axes"])
-            gpd.GeoSeries(_df.unary_union).plot(
+            gpd.GeoSeries(_df.union_all()).plot(
                 ax=axin,
                 edgecolor="lightgrey",
                 linewidth=0.3,
@@ -169,3 +170,8 @@ class ChoroplethMap(Map):
             r, (a, b, c, d) = self.ax.indicate_inset_zoom(axin)
             for _line in [a, b, c, d]:
                 _line.set_visible(False)
+
+        self.ax.legend(
+            handles=patches,
+            **label_kwargs,
+        )

{newsworthycharts-1.59.0 → newsworthycharts-1.60.0}/newsworthycharts/map.py

@@ -87,10 +87,10 @@ class Map(Chart):
 
     def __init__(self, *args, **kwargs):
         super(Map, self).__init__(*args, **kwargs)
-        self.bins = kwargs.get("bins", 9)
+        self.bins = kwargs.get("bins", 5)
         self.binning_method = kwargs.get("binning_method", "natural_breaks")
         self.colors = kwargs.get("colors", None)
-        self.color_ramp = kwargs.get("color_ramp", "YlOrRd")
+        self.color_ramp = kwargs.get("color_ramp", "YlGn")  # YlOrRd
         self.categorical = kwargs.get("categorical", False)
         self.base_map = None
         self.missing_label = None

newsworthycharts-1.59.0/README.rst → newsworthycharts-1.60.0/newsworthycharts.egg-info/PKG-INFO

@@ -1,3 +1,30 @@
+Metadata-Version: 2.1
+Name: newsworthycharts
+Version: 1.60.0
+Summary: Matplotlib wrapper to create charts and publish them on Amazon S3
+Home-page: https://github.com/jplusplus/newsworthycharts
+Download-URL: https://github.com/jplusplus/newsworthycharts/archive/1.60.0.tar.gz
+Author: Jens Finnäs and Leo Wallentin, J++ Stockholm
+Author-email: stockholm@jplusplus.org
+License: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/x-rst
+License-File: LICENSE.txt
+Requires-Dist: boto3>=1.26
+Requires-Dist: matplotlib==3.9.2
+Requires-Dist: langcodes>=3.3
+Requires-Dist: Babel<3,>=2.14.0
+Requires-Dist: PyYAML>=3
+Requires-Dist: adjustText==0.7.3
+Requires-Dist: numpy>2
+Requires-Dist: python-dateutil<3,>=2
+Requires-Dist: Pillow==10.4.0
+Requires-Dist: requests>=2.22
+Requires-Dist: matplotlib-label-lines==0.5.1
+Requires-Dist: geopandas>1
+Requires-Dist: mapclassify==2.6.1
+Requires-Dist: fiona>=1.0
+
 This  module contains methods for producing graphs and publishing them on Amazon S3, or in the location of your choice.
 
 It is written and maintained for `Newsworthy <https://www.newsworthy.se/en/>`_, but could possibly come in handy for other people as well.
@@ -110,8 +137,8 @@ These settings are available for all chart types:
 - yline = None  # A horizontal line across the chart (Matplotlib: axhline)
 - labels = []  # Optionally one label for each dataset
 - annotations = []  # Manually added annotations
-- interval = None  # yearly|quarterly|monthly|weekly|daily
-- units = 'number'  # number|percent|degrees
+- interval = None  # yearly, quarterly, monthly, weekly, daily
+- units = 'number'  # number, percent, degrees
 - show_ticks = True  # toggle category names, dates, etc
 - subtitle = None
 - note = None
@@ -210,13 +237,33 @@ To deploy a new version to [PyPi](https://pypi.org/project/newsworthycharts):
 
 Roadmap
 -------
-  - Adding more base maps
-  - Getting rid of custom settings-hack
+
+  - Get rid of custom settings-hack
+  - Remove custom charts (add missing api interfaces to Chart class instead)
+  - Remove DataWrapper class (out-of-scope)
   - Custom month locator with equal-width month bars
+  - Add color-ramp choropleth maps, as an alternative to binning
 
 Changelog
 ---------
 
+- 1.60.0
+
+  - [BREAKING] The default number of bins in maps is now 5, not 9
+  - [BREAKING] Default color ramp for choropleth maps is now `YlGn`
+  - GeoPandas 1.x
+  - numpy 2.x
+  - matplotlib==3.9.2
+  - Pillow==10.4.0
+  - Improved nan handling in labelling continuous choropleth maps
+  - Replace deprecated `.unary_union` with `.union_all()`
+  - Choropleth map legends now print spans for binned data
+  - Use Matplotlib's legend for choropleth maps, to have the same style as other charts, and for much improved flexibility
+  - Inset maps now (finally!) work with continuous data
+  - Better error handling in categorical maps
+  - Cast all categorical values to strings in categorical maps
+  - Replace deprecated imghdr with puremagic in tests
+
 - 1.59.0
 
   - Added `.highlight_annotation` to enable turning off the textual annotation on the highlighted point

{newsworthycharts-1.59.0 → newsworthycharts-1.60.0}/newsworthycharts.egg-info/requires.txt

@@ -1,13 +1,14 @@
+boto3>=1.26
+matplotlib==3.9.2
+langcodes>=3.3
 Babel<3,>=2.14.0
-Pillow==10.3.0
 PyYAML>=3
 adjustText==0.7.3
-boto3>=1.26
-geopandas==0.14.4
-langcodes>=3.3
-mapclassify==2.6.1
-matplotlib-label-lines==0.5.1
-matplotlib==3.9.0
-numpy<2,>=1.21.0
+numpy>2
 python-dateutil<3,>=2
+Pillow==10.4.0
 requests>=2.22
+matplotlib-label-lines==0.5.1
+geopandas>1
+mapclassify==2.6.1
+fiona>=1.0

{newsworthycharts-1.59.0 → newsworthycharts-1.60.0}/setup.py

@@ -25,18 +25,19 @@ setup(
     python_requires='>=3.9',
     install_requires=[
         "boto3>=1.26",
-        "matplotlib==3.9.0",
+        "matplotlib==3.9.2",
         "langcodes>=3.3",
         "Babel>=2.14.0,<3",
         "PyYAML>=3",
         "adjustText==0.7.3",
-        "numpy>=1.21.0,<2",
+        "numpy>2",
         "python-dateutil>=2,<3",
-        "Pillow==10.3.0",
+        "Pillow==10.4.0",
         "requests>=2.22",
         "matplotlib-label-lines==0.5.1",
-        "geopandas==0.14.4",
+        "geopandas>1",
         "mapclassify==2.6.1",
+        "fiona>=1.0",
     ],
     setup_requires=["flake8"],
     include_package_data=True,

{newsworthycharts-1.59.0 → newsworthycharts-1.60.0}/test/test_main.py

@@ -1,12 +1,12 @@
 """ py.test tests for Newsworthycharts
 """
 import pytest
+import puremagic
+import numpy as np
 from newsworthycharts import Chart, SerialChart, CategoricalChart, CHART_ENGINES
 from newsworthycharts.storage import DictStorage, LocalStorage
-from imghdr import what
 from PIL import Image
 from hashlib import md5
-import numpy as np
 
 # store test charts to this folder for visual verfication
 OUTPUT_DIR = "test/rendered_charts"
@@ -20,7 +20,7 @@ def test_generating_png():
     c.render("test", "png")
 
     assert "png" in container
-    assert what(container["png"]) == "png"
+    assert puremagic.from_stream(container["png"]) == ".png"
 
 
 def test_generating_webp():
@@ -30,7 +30,7 @@ def test_generating_webp():
     c.render("test", "webp")
 
     assert "webp" in container
-    assert what(container["webp"]) == "webp"
+    assert puremagic.from_stream(container["webp"]) == ".webp"
     im = Image.open(container["webp"])
     assert im.size == (800, 600)
 
@@ -43,7 +43,7 @@ def test_dynamic_init():
     c.render("test", "png")
 
     assert "png" in container
-    assert what(container["png"]) == "png"
+    assert puremagic.from_stream(container["png"]) == ".png"
 
 
 def test_factory_function():
@@ -56,7 +56,7 @@ def test_factory_function():
     c.render("test", "png")
 
     assert "png" in container
-    assert what(container["png"]) == "png"
+    assert puremagic.from_stream(container["png"]) == ".png"
 
     # Make sure it works in a child class
     c = SerialChart.init_from({