Skip to main content

Visualize risk-of-bias in systematic reviews and meta-analyses

Project description

Preview

Python Version License

Critiplot is an open-source Python package for visualizing risk-of-bias (RoB) assessments across multiple evidence synthesis tools:

  • Newcastle-Ottawa Scale (NOS)

  • JBI Critical Appraisal Checklists (Case Report / Case Series)

  • GRADE certainty of evidence

  • ROBIS for systematic reviews

  • It produces publication-ready traffic-light plots and stacked bar charts for summarizing study quality.

  • Python Package: https://pypi.org/project/critiplot/1.0.1/


📥 Installation

# Clone repository
git clone https://github.com/aurumz-rgb/Critiplot-main.git
cd Critiplot-Package

# Install requirements
pip install -r requirements.txt

# Install package locally
pip install .

Requires Python 3.11, Matplotlib, Seaborn, and Pandas.


⚡ Usage

Import the plotting functions from the package:

from critiplot import plot_nos, plot_jbi_case_report, plot_jbi_case_series, plot_grade, plot_robis

Example:

# NOS
plot_nos("tests/sample_nos.csv", "tests/output_nos.png", theme="blue")

# ROBIS
plot_robis("tests/sample_robis.csv", "tests/output_robis.png", theme="smiley")

# JBI Case Report
plot_jbi_case_report("tests/sample_case_report.csv", "tests/output_case_report.png", theme="gray")

# JBI Case Series
plot_jbi_case_series("tests/sample_case_series.csv", "tests/output_case_series.png", theme="smiley_blue")

# GRADE
plot_grade("tests/sample_grade.csv", "tests/output_grade.png", theme="green")

Theme options:

  • NOS, JBI Case Report / Case Series, ROBIS: "default", "blue", "gray", "smiley", "smiley_blue"
  • GRADE: "default", "green", "blue"
  • Default theme is used if omitted.

Notes

  • Generates traffic-light plots and weighted bar charts using Matplotlib / Seaborn.
  • Input data must be a CSV or Excel file following each tool’s required columns.
  • Critiplot is a visualization tool only; it does not compute risk-of-bias.

Info


Example / Result

Here’s an example traffic-light plot generated using Critiplot using different themes.

Example Result NOS

Example Result1 GRADE

Example Result2 ROBIS

Example Result3 JBI Case Report

Example Result4 JBI Case Series


📜 License

Apache 2.0 © 2025 Vihaan Sahu

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

critiplot-1.0.1.tar.gz (17.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

critiplot-1.0.1-py3-none-any.whl (24.1 kB view details)

Uploaded Python 3

File details

Details for the file critiplot-1.0.1.tar.gz.

File metadata

  • Download URL: critiplot-1.0.1.tar.gz
  • Upload date:
  • Size: 17.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for critiplot-1.0.1.tar.gz
Algorithm Hash digest
SHA256 8131a4b6e193198e1d2349df2fafc7168d6a2333e269d81443445f9ac398dd28
MD5 85f2f1a2c8a2cf120aafde6ce139ab9f
BLAKE2b-256 7774381b8847c4fb866d965bf4bb5ddbe76ecccfcf8f1d636c5e68f559e80074

See more details on using hashes here.

File details

Details for the file critiplot-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: critiplot-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 24.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for critiplot-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 9292245a600033d52f7fa96d25671ef3218562c7607a3dba97803f7adb42dd87
MD5 a5adb49a701be64302669761ad31b96e
BLAKE2b-256 f1c7e6fe318add6164e47e831e495c2d94ff390c36e3a8ca11bb2b035c012466

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page