newsworthycharts 1.62.0__py3-none-any.whl → 1.63.0__py3-none-any.whl

newsworthycharts/__init__.py

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

newsworthycharts/chart.py

@@ -17,7 +17,8 @@ from matplotlib.font_manager import FontProperties
 from matplotlib.backends.backend_agg import FigureCanvasAgg as FigureCanvas
 from matplotlib.figure import Figure
 from matplotlib.ticker import FuncFormatter
-from matplotlib.dates import DateFormatter, num2date
+from matplotlib.dates import DateFormatter, num2date, YearLocator
+
 from langcodes import standardize_tag
 from PIL import Image
 from babel import Locale
@@ -366,7 +367,10 @@ class Chart(object):
         self.ax.plot([0], transform=self.ax.transAxes, **kwargs)
 
     def _set_date_ticks(self, dates):
-        """ Set x ticks and formatters for chart types working on date series """
+        """
+            Set x ticks and formatters for chart types working on date series.
+            Todo: Unify location setting, to be able to support max_ticks everywhere.
+        """
 
         # Number of days on x axis (Matplotlib will use days as unit here)
         xmin, xmax = to_date(self.data.x_points[0]), to_date(self.data.x_points[-1])
@@ -377,9 +381,31 @@ class Chart(object):
             self.ax.set_xticks([x[0] for x in self.ticks])
             self.ax.set_xticklabels([x[1] for x in self.ticks])
 
+        elif self.interval == "decennial":
+            # Get the intervall needed to stay below max_ticks
+            i = 1
+            while len(dates) / i > self.max_ticks:
+                i += 1
+            loc = YearLocator(10 * i)
+            # loc = get_best_locator(delta, len(dates), self.interval)
+            self.ax.xaxis.set_major_locator(loc)
+
+            formatter = Formatter(self._language)
+
+            def fmt(x, pos):
+                d = num2date(x).isoformat()[:10]
+                # 9 years later
+                d2 = str(int(d[:4]) + 9) + d[4:]
+                if len(self.data.x_points) > 7:
+                    return formatter.date(d, "yy") + "–" + formatter.date(d2, "yy")
+                else:
+                    return formatter.date(d, "y") + "–" + formatter.date(d2, "yy")
+            self.ax.xaxis.set_major_formatter(fmt)
+
         elif delta.days > 500:
             ticks = get_year_ticks(xmin, xmax, max_ticks=self.max_ticks)
             self.ax.set_xticks(ticks)
+
             self.ax.xaxis.set_major_formatter(DateFormatter('%Y'))
 
         else:
@@ -667,6 +693,7 @@ class Chart(object):
                 'Creator': f"NWCharts {__version__}",
             }
             """
+
         self._fig.savefig(buf, **args)  # , bbox_inches="tight")
         buf.seek(0)
         self._storage.save(key, buf, img_format, storage_options)

newsworthycharts/lib/locator.py

@@ -42,7 +42,10 @@ def get_best_locator(delta, points, interval=None):
     trying to keep the x axis as clean as possible, while still including
     enough clues for the reader to easily understand the graph.
     """
-    if delta.days > 365 * 150:
+    if interval == "decennial":
+        # Set one tick every 10 years
+        return YearLocator(10)
+    elif delta.days > 365 * 150:
         return YearLocator(100)
     elif delta.days > 365 * 45:
         return YearLocator(20)

newsworthycharts/lib/utils.py

@@ -163,15 +163,21 @@ def outline(color="white", linewidth=3, **kwargs):
 
 def guess_date_interval(data):
     """Return a probable interval, e.g. "montly", given current data."""
-    interval = "yearly"
+    interval = "decennial"
     for serie in data:
         dates = [to_date(x[0]) for x in serie]
         years = [x.year for x in dates]
+
+        # Are there decades with more than one year?
+        if len(years) > len(set(years)):
+            interval = "yearly"
+
         months = [x.month for x in dates]
         yearmonths = [x.strftime("%Y-%m") for x in dates]
         weeks = [str(x.year) + str(x.isocalendar()[1]) for x in dates]
+
         if len(years) > len(set(years)):
-            # there are years with more than one point
+            # Are there years with more than one point?
             unique_months = sorted(list(set(months)))
             if len(unique_months) == 4 \
                     and unique_months[0] + 3 == unique_months[1] \

newsworthycharts/serialchart.py

@@ -73,7 +73,8 @@ class SerialChart(Chart):
         self._ymax = val
 
     def _days_in(self, interval, d=None):
-        """Return number of days in a given period.
+        """
+        Return number of days in a given period. This is used to set bar widths, so approximate is fine.
 
         If only interval is given, use a typical number of days.
         >>>> _days_in(monthly)
@@ -83,6 +84,7 @@ class SerialChart(Chart):
         """
         if d is None:
             return {
+                'decennial': 3652,
                 'yearly': 365,
                 'quarterly': 91,
                 'monthly': 30,
@@ -109,6 +111,10 @@ class SerialChart(Chart):
                 return 7
             elif interval == "daily":
                 return 1
+            elif interval == "decennial":
+                return (
+                    (d + relativedelta(years=10)).replace(day=1, month=1) - d.replace(day=1, month=1)
+                ).days
 
     def _get_annotation_direction(self, index, values):
         """ Given an index and series of values, provide the estimated best
@@ -284,11 +290,14 @@ class SerialChart(Chart):
 
                 # add highlight marker
                 if highlight_value:
-                    self.ax.plot(highlight_date, highlight_value,
-                                 c=color,
-                                 marker='o',
-                                 markersize=5,
-                                 zorder=zo)
+                    self.ax.plot(
+                        highlight_date,
+                        highlight_value,
+                        c=color,
+                        marker='o',
+                        markersize=5,
+                        zorder=zo,
+                    )
 
             elif self.type[i] == "bars":
                 # Put first series on top

{newsworthycharts-1.62.0.dist-info → newsworthycharts-1.63.0.dist-info}/METADATA

@@ -1,9 +1,9 @@
 Metadata-Version: 2.1
 Name: newsworthycharts
-Version: 1.62.0
+Version: 1.63.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.62.0.tar.gz
+Download-URL: https://github.com/jplusplus/newsworthycharts/archive/1.63.0.tar.gz
 Author: Jens Finnäs and Leo Wallentin, J++ Stockholm
 Author-email: stockholm@jplusplus.org
 License: MIT
@@ -18,11 +18,11 @@ 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: Pillow ==11.0.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: mapclassify ==2.8.1
 Requires-Dist: puremagic >=1
 
 This  module contains methods for producing graphs and publishing them on Amazon S3, or in the location of your choice.
@@ -154,13 +154,13 @@ These settings are available for all chart types:
 
 **SerialChart**
 
-- type = 'line'  # line|bar|stacked_bar
+- type = 'line'  # line|bars
 - bar_width = 0.9  # percent of data point width
 - allow_broken_y_axis = True|False  # default depends on chart type
 - baseline = 0  # The “zero” line. Useful for plotting deviations, e.g. temperatures above/below mean
 - baseline_annotation = None  # A label for the baseline
 - line_width = None  # To override style settings
-- max_ticks = 10  # Maximum number of ticks on the x axis
+- max_ticks = 10  # Maximum number of ticks on the x axis. *Only used with yearly|decennial data* (this is yet to be fixed)
 - ticks = None  # Custom ticks on the x axis, as a list of lists or tuples: `[(2013-01-01, "-13"), (2014-01-01, "-14"), (2015-01-01, "-15")]`
 - ymin = None  # Minimum value on y axis. If None, it will be calculated from data
 - ymax = None  # Maximum value on y axis. If None, it will be calculated from data
@@ -248,11 +248,16 @@ Roadmap
   - 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.63.0
+
+  - Added `interval: decennial` to SerialChart. Will be autodetected if all data points are 10 years apart.
+  - Pillow==11.0.0
+  - mapclassify==2.8.1
+
 - 1.62.0
 
   - max_ticks default is now 10 in SerialChart and 7 in ScatterPlot

{newsworthycharts-1.62.0.dist-info → newsworthycharts-1.63.0.dist-info}/RECORD

@@ -1,14 +1,14 @@
-newsworthycharts/__init__.py,sha256=2OKp_SEJ9C3NBNq_s_fceXBptJodNLYB2Ex2BwTLymE,1160
+newsworthycharts/__init__.py,sha256=iyEaSC-FB3CheUeksBH1o0BZMMCGczVcLniWDXND5Us,1160
 newsworthycharts/bubblemap.py,sha256=nkocWmpiFgfjEuJGAsthjY5X7Q56jXWsZHUGXw4PwgE,2587
 newsworthycharts/categoricalchart.py,sha256=LwOZ3VbNy9vzvoK0s77AkbfMt4CXVDSAhnsnBInUIrE,14764
-newsworthycharts/chart.py,sha256=bCUkNKjFfuGRN6_VRQ-yCHla5LIMZ9H9a16upWbeWmY,30681
+newsworthycharts/chart.py,sha256=e118gGQbFpRJZl3SWLhVCBatclG80eFdojrxJn8td5g,31664
 newsworthycharts/choroplethmap.py,sha256=bCLf4kcchp1C2djg5AxcOM8BdbaMj0xg7UHrZsDafhI,8013
 newsworthycharts/datawrapper.py,sha256=RRkAVTpfP4updKxUIBaSmKuBi2RUVPaBRF8HDQhlGGA,11250
 newsworthycharts/map.py,sha256=c409jEO4L8Yr780sJRC0RchR44roAlgOUDAkuk1SfRg,6057
 newsworthycharts/rangeplot.py,sha256=NE1W9TnmlpK6T3RvBJOU3nd73EXqkj17OY9i5zlw_cQ,8366
 newsworthycharts/scatterplot.py,sha256=l2w2JkA_4WzxQG9XG1Pn62IlJOdCMm1VemMiZL0rEfU,4959
 newsworthycharts/seasonalchart.py,sha256=rr55yqJUkaYDR9Ik98jes6574oY1U8t8LwoLE3gClW4,1967
-newsworthycharts/serialchart.py,sha256=DSqCyjyjViXN7IBKteM1JI4t3OyXlYGi3LvqmXrpAY0,27359
+newsworthycharts/serialchart.py,sha256=WrCWyDDRkXBXSqNyIhoBnm7A5RR2_wlluFPYirq_Snw,27686
 newsworthycharts/storage.py,sha256=myERhlpvXyExXxUByBq9eW1bWkCyfH9SwTZbsWSyy3Q,4301
 newsworthycharts/stripechart.py,sha256=9B6PX2MyLuKNQ8W0OGdKbP0-U32kju0K_NHHwwz_J68,1547
 newsworthycharts/custom/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -19,17 +19,17 @@ newsworthycharts/lib/colors.py,sha256=U04TDkvoMQkcldRFXfnwyLOTwq1SWW2se-Ad-DNcw9
 newsworthycharts/lib/datalist.py,sha256=fsO_esZBt4Aw_4n_l2LuswAYArbM-8Z8G9DAXo1oVZU,5376
 newsworthycharts/lib/formatter.py,sha256=GNH43hE0bC17OgiV8LYH3YUrEhm7OJh9XzfSV4HVtHo,4838
 newsworthycharts/lib/geography.py,sha256=K0_teFmuPJwXX7Py-amJB_1YY5_gL2kBYhz1LrRCyTg,584
-newsworthycharts/lib/locator.py,sha256=73ZqAvvLBhnWd0rKEHTyPiIL1H3MFHiUlb8aRKEm4FA,2938
+newsworthycharts/lib/locator.py,sha256=rJHdgiA0LASRzdLINhTeU5zOoq1TCMgge4KOBWSagnM,3041
 newsworthycharts/lib/mimetypes.py,sha256=bL9HtVWbn2Of39LcBt4u4yelkr4bGZiyebq3OfLnfFY,237
-newsworthycharts/lib/utils.py,sha256=2Ko0dNFw2eHd32zQwJFUsgDkJGWSl6VacZs4AFPgrc8,7038
+newsworthycharts/lib/utils.py,sha256=Io_yBHxUDTXw-9GvsizdSXnYvE_7ZtDKiWpLTAXpHfA,7171
 newsworthycharts/maps/se-4.gpkg,sha256=oWw5j7FPVpI0ig67jNDim8qSn5SG8rcHp0014-uTKZM,290816
 newsworthycharts/maps/se-7.gpkg,sha256=Vmvqudq_ZtgV0sd6TY6kuk7vzqmYZCJmaxtsJ87q2a8,331776
 newsworthycharts/rc/newsworthy,sha256=vbYTav1w3DmB5tpaaV7Xl5q7TQJsc9eou6pLCoWc2vs,1589
 newsworthycharts/translations/datawrapper_regions.csv,sha256=fzZcQRX6RFMlNNP8mpgfYNdR3Y0QAlQxDXk8FXTaWWI,9214
 newsworthycharts/translations/regions.py,sha256=Nv1McQjggD4S3JRu82rDMTG3pqUVR13E5-FBpSYbm98,239
 newsworthycharts/translations/se_municipalities.csv,sha256=br_mm-IvzQtj_W55_ATREhJ97jWnCweBFlDAVY2EBxA,7098
-newsworthycharts-1.62.0.dist-info/LICENSE.txt,sha256=Sq6kGICrehbhC_FolNdXf0djKjTpv3YqjFCIYsxdQN4,1069
-newsworthycharts-1.62.0.dist-info/METADATA,sha256=X5hJsyp_VkwOSMXUYKnLkQUCdBGHzDt_k9Tv_Hb4Tkw,29127
-newsworthycharts-1.62.0.dist-info/WHEEL,sha256=cVxcB9AmuTcXqmwrtPhNK88dr7IR_b6qagTj0UvIEbY,91
-newsworthycharts-1.62.0.dist-info/top_level.txt,sha256=dn_kzIj8UgUCMsh1PHdVEQJHVGSsN7Z8YJF-8xXa8n0,17
-newsworthycharts-1.62.0.dist-info/RECORD,,
+newsworthycharts-1.63.0.dist-info/LICENSE.txt,sha256=Sq6kGICrehbhC_FolNdXf0djKjTpv3YqjFCIYsxdQN4,1069
+newsworthycharts-1.63.0.dist-info/METADATA,sha256=25lu-t46S5NLSLrKSyy5QdMSPgqLmcHtmyEdYhvRRCU,29278
+newsworthycharts-1.63.0.dist-info/WHEEL,sha256=cVxcB9AmuTcXqmwrtPhNK88dr7IR_b6qagTj0UvIEbY,91
+newsworthycharts-1.63.0.dist-info/top_level.txt,sha256=dn_kzIj8UgUCMsh1PHdVEQJHVGSsN7Z8YJF-8xXa8n0,17
+newsworthycharts-1.63.0.dist-info/RECORD,,