Skip to main content

chartcheck

Score any chart against a 13-item Data Visualization Checklist, right inside a Jupyter notebook.

Install

pip install chartcheck

Use

from chartcheck import chartcheck

df, fig = chartcheck()

You will be prompted for each of the 13 items. Enter 0, 1, or 2, then optionally type a short justification (press Enter to skip).

Score Meaning
2 The chart clearly meets this standard.
1 Partially meets it; a reader could still be misled or slowed down.
0 Does not meet it.

When you finish, chartcheck() displays and returns:

  • df - a pandas DataFrame with #, Category, Item, Score, and Justification.
  • fig - a matplotlib 100% stacked bar chart showing, for each of the 5 categories (Text, Arrangement, Color, Story, Overall), the share of possible points earned vs. missed. The larger the missed segment, the more the chart is deficient there.

Evaluating the total score

Point total Conclusion
18-26 Visualization is effective
10-17 Visualization needs improvement
0-9 Visualization is not effective

Options

  • chartcheck(show=False) - return the DataFrame and figure without displaying them.
  • chartcheck(inputs=[...]) - supply answers programmatically (score, justification, score, ...).
  • plot_category_scores(df) - redraw the chart from a saved DataFrame.

License

MIT

Metadata

Release files for chartcheck 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for chartcheck 0.1.0
File Size Uploaded
chartcheck-0.1.0.tar.gz 6.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for chartcheck 0.1.0
File Interpreter ABI Platform
chartcheck-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 13.3 kB

Release files / chartcheck-0.1.0.tar.gz

Download URL chartcheck-0.1.0.tar.gz
Size 6.5 kB
Tags Source
SHA-256 checksum
How to use checksums
f0b826a4f90d9593071139d2bd3acb3383b2ac11a7e59ace867675527ce67eda
BLAKE2b-256 checksum
How to use checksums
198566cb2521816c481d0718834490781ce648938f6d2f6df78d4c4dd77b2645
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.1

Release files / chartcheck-0.1.0-py3-none-any.whl

Download URL chartcheck-0.1.0-py3-none-any.whl
Size 6.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b5b994186253045dcdc920b9d5adc563d22cb9327644233ad1bf87922501d19f
BLAKE2b-256 checksum
How to use checksums
bad18d6772b038f75e96ab3aca224a9d1bfd6f50a5b2cce61312c9187ab5ec7f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.1

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page