Visualize risk-of-bias in systematic reviews and meta-analyses
Project description
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
- Web version also exists of this Package.
- Github: https://github.com/aurumz-rgb/Critiplot-main
- Web: https://critiplot.vercel.app
Example / Result
Here’s an example traffic-light plot generated using Critiplot using different themes.
NOS
GRADE
ROBIS
JBI Case Report
JBI Case Series
📜 License
Apache 2.0 © 2025 Vihaan Sahu
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8131a4b6e193198e1d2349df2fafc7168d6a2333e269d81443445f9ac398dd28
|
|
| MD5 |
85f2f1a2c8a2cf120aafde6ce139ab9f
|
|
| BLAKE2b-256 |
7774381b8847c4fb866d965bf4bb5ddbe76ecccfcf8f1d636c5e68f559e80074
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9292245a600033d52f7fa96d25671ef3218562c7607a3dba97803f7adb42dd87
|
|
| MD5 |
a5adb49a701be64302669761ad31b96e
|
|
| BLAKE2b-256 |
f1c7e6fe318add6164e47e831e495c2d94ff390c36e3a8ca11bb2b035c012466
|