clock_plot provides a simple way to visualize timeseries data, mapping 24 hours onto the 360 degrees of a polar plot

Last update: Aug 24, 2022

Related tags

Overview

clock_plot

clock_plot provides a simple way to visualize timeseries data mapping 24 hours onto the 360 degrees of a polar plot. For usage, please see the examples.ipynb Jupyter notebook

Installation

To install this package run: pip install clock_plot

Available features

Time features are automatically generated for your timeseries. These features include:

Feature	Type	Description	Example Values
year	int	Calendar year	2022
month	str	Calendar month	"January"
year_month	int	Calendar year and month in the format YYYYMM	202201
day	int	Day of calendar year	25
date	str	Expressed in the format YYYY-MM-DD	"2022-01-25"
week	int	ISO week of the calendar year	5
dayofweek	str	Short version of day of week	"Tue"
weekend	str	Either "weekday" or "weekend", where "weekend" is Saturday and Sunday	"weekend" (Sat/Sun) "weekday" (Mon-Fri)
hour	int	Hour of the day in 24 clock	14
minute	int	Minute of the hour	42
degrees	int	Angle around 24 hour clock-face measured in degrees	341
season	str	Season of the year defined based on month, with Winter being Dec-Feb	"Winter" (Dec-Feb) "Spring" (Mar-May) "Summer" (Jun-Aug) "Autumn" (Sep-Nov)

These can be used to filter your data and format your plot.

For example you could filter for a particular year, plot seasons with different colors and weekday vs weekend days with different line dashes. Examples of this are given in examples.ipynb

When should you use these plots?

Radar/polar plots (of which clock plots are a special case) are much maligned by visualisation experts, and for good reason. Whilst some of the common limitations are overcome with clock plots, two key ones remain:

It is harder to read quantitative values than on a linear axis
Areas scale quadratically (with the square of the value) rather than linearly, which can lead to overestimation of differences

Clock plots are therefore most suited for cases where understanding absolute values is less important and one or more of the following is true:

behaviour around midnight is particularly important
there are a 2-3 daily peaks and understanding at a glance when those are occurring is more important than their exact magnitude
you want a distinctive, eye-catching graphic to engage people with your work

Note that they are particularly poorly suited to:

timeseries with negative values (the radial axis becomes very unintuitive)
timeseries with little within day variation (you just get circles!)

If you're not sure which is best for a particular use case, you can quickly toggle between a clock plot and a linear plot by adding mode="line" to your clock_plot call.

You might also like...

Plot, scatter plots and histograms in the terminal using braille dots

Comments

Add the option to toggle to a standard line plot

Clock plots aren't always the best choice. Add a section to the readme exploring when they should be used, as well as an easy toggle back to an ordinary line plot.

opened by samyoung-dsci 0
Switch to using "Noon" and "Midnight" by default

Add text_noon argument to enable showing 0 and 12 as "Midnight" and " Noon" to improve interpretability. Set default behaviour to True.

opened by samyoung-dsci 0

Releases(v0.2.1)

v0.2.1(Apr 5, 2022)

Add the option to toggle to a standard line plot
Source code(tar.gz)
Source code(zip)
v0.2(Apr 5, 2022)

Add text_noon argument to enable showing 0 and 12 as "Midnight" and " Noon" to improve interpretability. Set default behaviour to True.
Source code(tar.gz)
Source code(zip)

clock_plot provides a simple way to visualize timeseries data, mapping 24 hours onto the 360 degrees of a polar plot

Related tags

Overview

clock_plot

Installation

Available features

When should you use these plots?

You might also like...

Plot, scatter plots and histograms in the terminal using braille dots

Streamlit component for Let's-Plot visualization library

a python function to plot a geopandas dataframe

Small project to recursively calculate and plot each successive order of the Hilbert Curve

Info for The Great DataTas plot-a-thon

It's an application to calculate I from v and r. It can also plot a graph between V vs I.

Plot and save the ground truth and predicted results of human 3.6 M and CMU mocap dataset.

Plot-configurations for scientific publications, purely based on matplotlib

A tool to plot and execute Rossmos's Formula, that helps to catch serial criminals using mathematics

Comments

Add the option to toggle to a standard line plot

Switch to using "Noon" and "Midnight" by default

Releases(v0.2.1)

v0.2.1(Apr 5, 2022)

v0.2(Apr 5, 2022)

Owner

a python function to plot a geopandas dataframe

CPG represent!

JupyterHub extension for ContainDS Dashboards

Extensible, parallel implementations of t-SNE

A small collection of tools made by me, that you can use to visualize atomic orbitals in both 2D and 3D in different aspects.

A tool for automatically generating 3D printable STLs from freely available lidar scan data.

GitHub Stats Visualizations : Transparent

Generate visualizations of GitHub user and repository statistics using GitHub Actions.

Learn Data Science with focus on adding value with the most efficient tech stack.

Curvipy - The Python package for visualizing curves and linear transformations in a super simple way

Seismic Waveform Inversion Toolbox-1.0

Python implementation of the Density Line Chart by Moritz & Fisher.

The plottify package is makes matplotlib plots more legible

This is a super simple visualization toolbox (script) for transformer attention visualization ✌

The Metabolomics Integrator (MINT) is a post-processing tool for liquid chromatography-mass spectrometry (LCMS) based metabolomics.

Automatically Visualize any dataset, any size with a single line of code. Created by Ram Seshadri. Collaborators Welcome. Permission Granted upon Request.

Parallel t-SNE implementation with Python and Torch wrappers.

This is Pygrr PolyArt, a program used for drawing custom Polygon models for your Pygrr project!

Leyna's Visualizing Data With Python