Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/aican-research/breast-cancer-stats

:cherry_blossom: Notebooks for making publish-worthy visualizations using WHO breast cancer data
https://github.com/aican-research/breast-cancer-stats

breast-cancer cancer google-colab incidence jupyter jupyter-notebook mortality plotly prevalence statistics stats survival temporal time trend visualization who world-health-organization world-map

Last synced: 3 days ago
JSON representation

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

Awesome Lists containing this project

README

        

# [breast-cancer-stats](https://github.com/AICAN-Research/breast-cancer-stats#breast-cancer-stats)

[![license](https://img.shields.io/github/license/DAVFoundation/captain-n3m0.svg?style=flat-square)](https://github.com/DAVFoundation/captain-n3m0/blob/master/LICENSE)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.8232699.svg)](https://doi.org/10.5281/zenodo.8232699)
Open In Colab
![CI](https://github.com/AICAN-Research/breast-cancer-stats/workflows/incidence/badge.svg)

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



## [Examples](https://github.com/AICAN-Research/breast-cancer-stats#examples)

Example notebooks are available in the [apps/](https://github.com/AICAN-Research/breast-cancer-stats/tree/main/apps) directory.

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

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

## [Dependencies](https://github.com/AICAN-Research/breast-cancer-stats#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](https://github.com/AICAN-Research/breast-cancer-stats/actions)). 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](https://pypi.org/project/pandas/)
* [plotly](https://pypi.org/project/plotly/)
* [nbformat](https://pypi.org/project/nbformat/)
* [kaleido](https://pypi.org/project/kaleido/)

## [Troubleshooting](https://github.com/AICAN-Research/breast-cancer-stats#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](https://github.com/AICAN-Research/breast-cancer-stats#license)

The code in this repository is released under [MIT license](https://github.com/AICAN-Research/breast-cancer-stats/blob/main/LICENSE).

Note that the CSV files originate from WHO-related websites. Global data from [Cancer Today](https://gco.iarc.fr/today/home)
(powered by GLOBOCAN 2020) and Nordic data from [NORDCAN](https://nordcan.iarc.fr/en).
If you use these figures or datasets, please, cite the appropriate
references. Information on how to cite these can be found [here](https://gco.iarc.fr/today/about#references) and
[here](https://nordcan.iarc.fr/en/about), respectively.

## [Citation](https://github.com/AICAN-Research/breast-cancer-stats#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}
}
```