NOS-TLPlot Logo

NOS-TLPlot

Newcastle-Ottawa Scale Traffic Light Visualization Tool for Systematic Reviews.

License Journal DOI Zenodo DOI Version Last Commit GitHub Issues Uses streamlit Maintenance Status Active Built For Researchers

About NOS-TLPlot

NOS-TLPlot is an open-source Python tool for visualizing Newcastle–Ottawa Scale (NOS) risk-of-bias assessments. It converts NOS star ratings into publication-ready traffic-light plots and 13 specialized visualizations, enabling reviewers and readers to interpret study-level risk-of-bias results clearly and reproducibly.

Scope-Limited & Focused

Designed exclusively for NOS evaluations of non-randomised studies in systematic reviews and meta-analyses.

13 Visualization Types

Traffic-light plots, radar charts, heatmaps, item heatmaps, stacked star profiles, donut charts, lollipop charts, and more.

Publication-Ready Output

Export figures in .png, .pdf, .svg, .tiff formats with the traffic-light, grayscale, ocean and sage themes.

Multiple Interfaces

Streamlit web app (local host deploy + Online) for interactive use and command-line interface for batch processing and automation.

Launch NOS-TLPlot GitHub Repository Python Package (PyPI) R Package (nos.tlplotR)
Main Streamlit app busy or not working? You can use the mirror below:
NOS-TLPlot mirror

Visualization Types

1. Traffic-Light Bubble Plot
2. Domain Radar Chart
3. Theme Radar Chart
4. Domain Heatmap
5. Item-Level Star Heatmap
6. Stacked Domain Stars
7. Score Table
8. Risk Donut Chart
9. Star Ratings Matrix
10. Total Score Lollipop
11. Overall Risk Pie
12. Stacked Area Risk Chart
13. NOS Visualization Grid

Note: Radar plots (both thematic and domain-based) will not be generated if the number of studies exceeds 5.

Input Data Format & Template

Note:

The tool is case-sensitive. Accordingly, the exact use of uppercase and lowercase characters, as presented in the NOS-TLPlot template, must be strictly adhered to.

NOS Template

Your NOS data file should strictly follow this structure:

Author, Year Representativeness Non-exposed Selection Exposure Ascertainment Outcome Absent at Start Comparability (Age/Gender) Comparability (Other) Outcome Assessment Follow-up Length Follow-up Adequacy Total Score Overall RoB
Study 1, 2019 1 1 1 1 1 0 1 1 1 8 Low
Study 2, 2024 1 1 1 1 1 0 1 1 0 7 Moderate
Total Stars Interpretation Risk Category
7 to 9 High-quality study Low RoB
4 to 6 Moderate-quality study Moderate RoB
0 to 3 Poor-quality study High RoB

Methods Section Text

For including NOS-TLPlot in your systematic review methods section:

"Risk of bias for included non-randomized studies was assessed using the Newcastle–Ottawa Scale (NOS). Visualization and synthesis of domain-level NOS scores were performed using NOS-TLPlot (v3.0.1), an open-source Python-based tool that generates traffic-light plots and other visual formats for NOS-based risk-of-bias representation (Sahu, 2026; DOI: 10.5334/jors.635)."

Packages

NOS-TLPlot ships as installable packages, so grab them without cloning anything.

Python

pip install nos-tlplot

PyPI page · how to use it

R

remotes::install_github("nos-tlplot/nos.tlplotR")

package docs · how to use it

Support & Contact

Have questions or need assistance with NOS-TLPlot? This tool is designed for reproducible research, and I am here to help you integrate it into your systematic review workflow.

You can open a GitHub Issue or send an email directly for guidance, troubleshooting, or feature requests.

Citation

If you use NOS-TLPlot in your research, please cite the Software article:

Sahu, V. (2026). NOS-TLPlot: A Specialized Python Tool for Visualizing Newcastle–Ottawa Scale Risk-of-Bias Assessments. Journal of Open Research Software, 14(1), 7. https://doi.org/10.5334/jors.635

Note: The software's code is also available as a citable, archivable artifact on Zenodo: https://doi.org/10.5281/zenodo.17065214