aican-research / breast-cancer-stats

:cherry_blossom: Notebooks for making publish-worthy visualizations using WHO breast cancer data

breast-cancer-stats

This repository contains useful notebook examples on how to extract and visualize breast cancer data from the World Health Organization (WHO) database.

Examples

Example notebooks are available in the apps/ directory.

They can also be accessed by clicking their respective CoLab badge below:

Use case	Notebook	Tests
Incidence rate world map
Mortality rate world map
Overall cancer statistics
Survival country comparison
Cancer incidence over time
Cancer mortality over time
Cancer incidence over time w.r.t. age
Cancer mortality over time w.r.t. age

Dependencies

The Notebooks were tested against Python 3.8 on macOS operating system. Continuous integration tests are also performed for all notebooks on Ubuntu 20.04 operating system (see here). They are also compatible with Google CoLab and should be quite robust against other setups.

The following dependencies were used and are installed as part of the notebooks:

• pandas
• plotly
• nbformat
• kaleido

Troubleshooting

Note that all rendered results could be interactive, but we have set Plotly's show(renderer="png"), to enable the result to be shown in the output on CoLab, on GitHub, and locally. To get interactive figures on CoLab set show(renderer="colab"), or locally use the default show(). GitHub only support static figures.

License

The code in this repository is released under MIT license.

Note that the CSV files originate from WHO-related websites. Global data from Cancer Today (powered by GLOBOCAN 2020) and Nordic data from NORDCAN. If you use these figures or datasets, please, cite the appropriate references. Information on how to cite these can be found here and here, respectively.

Citation

If you found this project useful, please, consider citing it in your research article:

@software{andre_pedersen_2023_8224208,
  author       = {André Pedersen},
  title        = {andreped/breast-cancer-stats: v0.1.0},
  month        = aug,
  year         = 2023,
  publisher    = {Zenodo},
  version      = {v0.1.0},
  doi          = {10.5281/zenodo.8224207},
  url          = {https://doi.org/10.5281/zenodo.8224207}
}