andyrids · andyrids · Jan 25, 2025 · Jan 21, 2025 · Jan 21, 2025 · Jan 21, 2025
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 <!-- Added | Changed | Deprecated | Removed | Fixed -->
 
+## [0.2.0] - 2025-01-23
+
+### Added
+
+- PyPalettes library dependency, providing 2500+ palettes.
+- Colormap reverse flag parameter added to dataclock function.
+- Chart polar spine color parameter added to dataclock.
+- Chart polar grid color parameter added to dataclock.
+
+### Changed
+
+- Wedge label logic moved to `dataclocklib.utility.add_wedge_labels`.
+- Temporal aggregation logic moved to `dataclocklib.utility.aggregate_temporal_columns`.
+
 ## [0.1.8] - 2025-01-20
 
 ### Added
@@ -26,7 +40,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Moved colorbar logic to `dataclocklib.utility.add_colorbar`.
 - Dataclock arguments; `chart_title`, `chart_subtitle`, `chart_period`, `chart_source` are keyword only.
 
-
 ## [0.1.7] - 2025-01-15
 
 ### Added

diff --git a/README.md b/README.md
@@ -35,22 +35,62 @@ data = pd.read_parquet(
     "https://raw.githubusercontent.com/andyrids/dataclocklib/main/tests/data/traffic_data.parquet.gzip"
 )
 
-graph_data, fig, ax = dataclock(
-    data=data.query("Date_Time.dt.year.eq(2015)"),
+chart_data, fig, ax = dataclock(
+    data=data,
+    date_column="Date_Time",
+    mode="DOW_HOUR",
+    spine_color="darkslategrey",
+    grid_color="black",
+    default_text=False
+)
+```
+
+![Data clock chart](https://raw.githubusercontent.com/andyrids/dataclocklib/main/docs/source/_static/images/sphinx_guide_chart_1.png)
+
+```python
+import pandas as pd
+from dataclocklib.charts import dataclock
+
+data = pd.read_parquet(
+    "https://raw.githubusercontent.com/andyrids/dataclocklib/main/tests/data/traffic_data.parquet.gzip"
+)
+
+chart_data, fig, ax = dataclock(
+    data=data,
+    date_column="Date_Time",
+    mode="DOW_HOUR",
+    spine_color="darkslategrey",
+    grid_color="black",
+    default_text=True
+)
+```
+
+![Data clock chart](https://raw.githubusercontent.com/andyrids/dataclocklib/main/docs/source/_static/images/sphinx_guide_chart_2.png)
+
+```python
+import pandas as pd
+from dataclocklib.charts import dataclock
+
+data = pd.read_parquet(
+    "https://raw.githubusercontent.com/andyrids/dataclocklib/main/tests/data/traffic_data.parquet.gzip"
+)
+
+chart_data, fig, ax = dataclock(
+    data=data,
     date_column="Date_Time",
-    agg_column="Number_of_Casualties",
-    agg="sum",
     mode="DOW_HOUR",
-    cmap_name="CMRmap_r",
-    chart_title="UK Traffic Accident Casualties",
-    chart_subtitle=None,
-    chart_period="Period: 2015",
-    chart_source="www.kaggle.com/datasets/silicon99/dft-accident-data",
     default_text=True,
+    spine_color="darkslategrey",
+    grid_color="black",
+    chart_title="**CUSTOM TITLE**",
+    chart_subtitle="**CUSTOM SUBTITLE**",
+    chart_period="**CUSTOM PERIOD**",
+    chart_source="Source: UK Department for Transport",
+    dpi=150
 )
 ```
 
-![Data clock chart](https://raw.githubusercontent.com/andyrids/dataclocklib/main/docs/source/_static/images/sphinx_index_chart_1.png)
+![Data clock chart](https://raw.githubusercontent.com/andyrids/dataclocklib/main/docs/source/_static/images/sphinx_guide_chart_3.png)
 
 ```python
 import pandas as pd
@@ -60,22 +100,27 @@ data = pd.read_parquet(
     "https://raw.githubusercontent.com/andyrids/dataclocklib/main/tests/data/traffic_data.parquet.gzip"
 )
 
-graph_data, fig, ax = dataclock(
+chart_data, fig, ax = dataclock(
     data=data.query("Date_Time.dt.year.eq(2010)"),
     date_column="Date_Time",
-    agg_column=None,
-    agg="count",
+    agg_column="Number_of_Casualties",
+    agg="sum",
     mode="DOW_HOUR",
-    cmap_name="RdYlGn_r",
-    chart_title="UK Traffic Accidents",
+    cmap_name="X26",
+    cmap_reverse=True,
+    spine_color="honeydew",
+    grid_color="honeydew",
+    default_text=True,
+    chart_title="UK Traffic Accident Casualties",
     chart_subtitle=None,
     chart_period="Period: 2010",
-    chart_source="www.kaggle.com/datasets/silicon99/dft-accident-data",
-    default_text=True,
+    chart_source="Source: https://data.dft.gov.uk/road-accidents-safety-data/dft-road-casualty-statistics-collision-last-5-years.csv",
+    dpi=300
 )
 ```
 
-![Data clock chart](https://raw.githubusercontent.com/andyrids/dataclocklib/main/docs/source/_static/images/sphinx_index_chart_2.png)
+![Data clock chart](https://raw.githubusercontent.com/andyrids/dataclocklib/main/docs/source/_static/images/sphinx_guide_chart_4.png)
+
 
 ## Installation
 

diff --git a/docs/source/_static/images/sphinx_guide_chart_1.png b/docs/source/_static/images/sphinx_guide_chart_1.png
diff --git a/docs/source/_static/images/sphinx_guide_chart_2.png b/docs/source/_static/images/sphinx_guide_chart_2.png
diff --git a/docs/source/_static/images/sphinx_guide_chart_3.png b/docs/source/_static/images/sphinx_guide_chart_3.png
diff --git a/docs/source/_static/images/sphinx_guide_chart_4.png b/docs/source/_static/images/sphinx_guide_chart_4.png
diff --git a/docs/source/guide.ipynb b/docs/source/guide.ipynb
diff --git a/docs/source/tutorial.ipynb b/docs/source/tutorial.ipynb
diff --git a/pyproject.toml b/pyproject.toml
@@ -27,6 +27,7 @@ keywords = ["matplotlib", "dataclock", "visualisation", "analysis"]
 dependencies = [
     "matplotlib",
     "pandas[parquet]>=2.2.2",
+    "pypalettes>=0.1.5",
 ]
 
 [dependency-groups]