Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[ENH] Extract graphs from impact page #585

Merged
merged 8 commits into from
Dec 6, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
123 changes: 3 additions & 120 deletions docs/impact/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,126 +37,6 @@ adherence to FAIR principles (Findable, Accessible, Interoperable, and Reusable,
[Wilkinson, et al, 2016](https://www.nature.com/articles/sdata201618)) and to actively
lower barriers to adoption.

## Measuring BIDS Impact

### Datasets

Over the years, the number of shared datasets available to the public has
greatly increased. At its heart, adoption of the BIDS standard across datasets
aids in the sharing of data and collaboration of research through the standardization
of descriptive files names and the organization of data. BIDS organized datasets are
available through public repositories such as [Openneuro.org](https://openneuro.org/)
and the number of publicly available BIDS datasets continues to grow every year.

<!-- use snippet to include a file
https://facelessuser.github.io/pymdown-extensions/extensions/snippets/#snippets-notation
-->

--8<-- "tmp/openneuro_data_growth.html"

### Citation Count

As the adoption of the BIDS standard across neuroimaging datasets has grown, so have
citations for work that uses BIDS data and BIDS apps. To aid in searching for publications
relevant to the BIDS standard, we have included some examples of BIDS references that are
centralized in a [zotero group](https://www.zotero.org/groups/5111637/bids)

<!-- use snippet to include a file
https://facelessuser.github.io/pymdown-extensions/extensions/snippets/#snippets-notation
-->

--8<-- "tmp/citation_per_year.html"

### GitHub stars
GitHub stars quantify the number of users that have marked a repository as a favorite and have
chosen to follow the changes made to that repository. Below is a table of GitHub repos that are
associated with the BIDS standard and their star count. By tracking repo interest via GitHub stars,
we can quantify which BIDS-associated tools are of the highest interest to the research community.

| repository | stars |
| ----------------- | ------------------------------------------------------------------------------------------ |
| fmriprep | ![GitHub Repo stars](https://img.shields.io/github/stars/nipreps/fmriprep) |
| mriqc | ![GitHub Repo stars](https://img.shields.io/github/stars/nipreps/mriqc) |
| bids-standard | ![GitHub Repo stars](https://img.shields.io/github/stars/bids-standard/bids-specification) |
| bids-starter-kit | ![GitHub Repo stars](https://img.shields.io/github/stars/bids-standard/bids-starter-kit) |
| pybids | ![GitHub Repo stars](https://img.shields.io/github/stars/bids-standard/pybids) |
| qsiprep | ![GitHub Repo stars](https://img.shields.io/github/stars/PennLINC/qsiprep) |
| bids-matlab | ![GitHub Repo stars](https://img.shields.io/github/stars/bids-standard/bids-matlab) |
| statistical model | ![GitHub Repo stars](https://img.shields.io/github/stars/bids-standard/stats-models) |
| bids-validator | ![GitHub Repo stars](https://img.shields.io/github/stars/bids-standard/bids-validator) |

### Downloads

| package | downloads |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------ |
| bids-validator | ![npm](https://img.shields.io/npm/dm/bids-validator) ![Docker Pulls](https://img.shields.io/docker/pulls/bids/validator) |
| pybids | ![PyPI - Downloads](https://img.shields.io/pypi/dm/pybids) |
| bids-schema | ![PyPI - Downloads](https://img.shields.io/pypi/dm/bidsschematools) |
| statistical model | ![PyPI - Downloads](https://img.shields.io/pypi/dm/bsmschema) |

For the number of docker pulls of specific BIDS apps, please check the
[BIDS app dashboard](https://bids-website.readthedocs.io/en/latest/tools/bids-apps.html).

### Contributors

Our list of contributors are captured in our
[contributor appendix](https://bids-specification.readthedocs.io/en/latest/99-appendices/01-contributors.html).
We update the contributor appendix every specification release. As of July 2023,
we have over 300 credited contributors.

The table below provides a brief account of the number of contributors per repository. Estimated demographics and affiliations
of contributors is also provided below.

| repository | all-contributors | github |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| bids-standard | ![GitHub contributors (via allcontributors.org)](https://img.shields.io/github/all-contributors/bids-standard/bids-specification) | ![GitHub Repo stars](https://img.shields.io/github/contributors/bids-standard/bids-specification) |
| bids-starter-kit | ![GitHub contributors (via allcontributors.org)](https://img.shields.io/github/all-contributors/bids-standard/bids-starter-kit) | ![GitHub Repo stars](https://img.shields.io/github/contributors/bids-standard/bids-starter-kit) |
| bids-validator | ![GitHub contributors (via allcontributors.org)](https://img.shields.io/github/all-contributors/bids-standard/bids-validator) | ![GitHub Repo stars](https://img.shields.io/github/contributors/bids-standard/bids-validator) |
| pybids | | ![GitHub Repo stars](https://img.shields.io/github/contributors/bids-standard/pybids) |
| bids-matlab | ![GitHub contributors (via allcontributors.org)](https://img.shields.io/github/all-contributors/bids-standard/bids-matlab) | ![GitHub Repo stars](https://img.shields.io/github/contributors/bids-standard/bids-matlab) |
| statistical model | | ![GitHub Repo stars](https://img.shields.io/github/contributors/bids-standard/stats-models) |

#### Gender of contributors

Guessed with [gender-guesser](https://pypi.org/project/gender-guesser/)

<!-- use snippet to include a file
https://facelessuser.github.io/pymdown-extensions/extensions/snippets/#snippets-notation
-->

--8<-- "data/people/gender.md"

#### Contributors affiliations

<!-- use snippet to include a file
https://facelessuser.github.io/pymdown-extensions/extensions/snippets/#snippets-notation
-->

--8<-- "data/people/affiliations.md"

<!-- use snippet to include a file
https://facelessuser.github.io/pymdown-extensions/extensions/snippets/#snippets-notation
-->

--8<-- "tmp/affiliations.html"

### GitHub dependents

<!--
TODO add automation to update regularly.

pip install -U github-dependents-info
github-dependents-info --repo bids-standard/pybids --badgemarkdownfile ./dashboard.md
-->

<!-- gh-dependents-info-used-by-start -->

<!-- gh-dependents-info-used-by-end -->

| repository | dependents |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| pybids | [![](https://img.shields.io/static/v1?label=Used%20by&message=596&color=informational&logo=slickpic)](https://github.com/bids-standard/pybids/network/dependents) |

## BIDS History

Since its origin, the BIDS standard has revolutionized the way in which neuroimaging
Expand Down Expand Up @@ -209,6 +89,9 @@ We have a
that is crowdsourcing imaging centers, institutes, databases around the world
that have implemented BIDS as their organizational structure.

We also measured the general BIDS impact across multiple domains (datasets, citations...).
Read more on the [Impact Dashboards page](./measuring.md).

### Neurostars

We also track the interest and usage of the BIDS standard via discussions on Neurostars
Expand Down
103 changes: 103 additions & 0 deletions docs/impact/measuring.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,103 @@
# Measuring BIDS Impact

## Datasets

Over the years, the number of shared datasets available to the public has
greatly increased. At its heart, adoption of the BIDS standard across datasets
aids in the sharing of data and collaboration of research through the standardization
of descriptive files names and the organization of data. BIDS organized datasets are
available through public repositories such as [Openneuro.org](https://openneuro.org/)
and the number of publicly available BIDS datasets continues to grow every year.

<!-- use snippet to include a file
https://facelessuser.github.io/pymdown-extensions/extensions/snippets/#snippets-notation
-->

--8<-- "tmp/openneuro_data_growth.html"

## Citation Count

As the adoption of the BIDS standard across neuroimaging datasets has grown, so have
citations for work that uses BIDS data and BIDS apps. To aid in searching for publications
relevant to the BIDS standard, we have included some examples of BIDS references that are
centralized in a [zotero group](https://www.zotero.org/groups/5111637/bids)

<!-- use snippet to include a file
https://facelessuser.github.io/pymdown-extensions/extensions/snippets/#snippets-notation
-->

--8<-- "tmp/citation_per_year.html"

## GitHub stars

GitHub stars quantify the number of users that have marked a repository as a favorite and have
chosen to follow the changes made to that repository. Below is a table of GitHub repos that are
associated with the BIDS standard and their star count. By tracking repo interest via GitHub stars,
we can quantify which BIDS-associated tools are of the highest interest to the research community.

| repository | stars |
| ----------------- | ------------------------------------------------------------------------------------------ |
| fmriprep | ![GitHub Repo stars](https://img.shields.io/github/stars/nipreps/fmriprep) |
| mriqc | ![GitHub Repo stars](https://img.shields.io/github/stars/nipreps/mriqc) |
| bids-standard | ![GitHub Repo stars](https://img.shields.io/github/stars/bids-standard/bids-specification) |
| bids-starter-kit | ![GitHub Repo stars](https://img.shields.io/github/stars/bids-standard/bids-starter-kit) |
| pybids | ![GitHub Repo stars](https://img.shields.io/github/stars/bids-standard/pybids) |
| qsiprep | ![GitHub Repo stars](https://img.shields.io/github/stars/PennLINC/qsiprep) |
| bids-matlab | ![GitHub Repo stars](https://img.shields.io/github/stars/bids-standard/bids-matlab) |
| statistical model | ![GitHub Repo stars](https://img.shields.io/github/stars/bids-standard/stats-models) |
| bids-validator | ![GitHub Repo stars](https://img.shields.io/github/stars/bids-standard/bids-validator) |

## Downloads

| package | downloads |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------ |
| bids-validator | ![npm](https://img.shields.io/npm/dm/bids-validator) ![Docker Pulls](https://img.shields.io/docker/pulls/bids/validator) |
| pybids | ![PyPI - Downloads](https://img.shields.io/pypi/dm/pybids) |
| bids-schema | ![PyPI - Downloads](https://img.shields.io/pypi/dm/bidsschematools) |
| statistical model | ![PyPI - Downloads](https://img.shields.io/pypi/dm/bsmschema) |

For the number of docker pulls of specific BIDS apps, please check the
[BIDS app dashboard](https://bids-website.readthedocs.io/en/latest/tools/bids-apps.html).

## Contributors

Our list of contributors are captured in our
[contributor appendix](https://bids-specification.readthedocs.io/en/latest/99-appendices/01-contributors.html).
We update the contributor appendix every specification release. As of July 2023,
we have over 300 credited contributors.

The table below provides a brief account of the number of contributors per repository. Estimated demographics and affiliations
of contributors is also provided below.

| repository | all-contributors | github |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| bids-standard | ![GitHub contributors (via allcontributors.org)](https://img.shields.io/github/all-contributors/bids-standard/bids-specification) | ![GitHub Repo stars](https://img.shields.io/github/contributors/bids-standard/bids-specification) |
| bids-starter-kit | ![GitHub contributors (via allcontributors.org)](https://img.shields.io/github/all-contributors/bids-standard/bids-starter-kit) | ![GitHub Repo stars](https://img.shields.io/github/contributors/bids-standard/bids-starter-kit) |
| bids-validator | | ![GitHub Repo stars](https://img.shields.io/github/contributors/bids-standard/bids-validator) |
| pybids | | ![GitHub Repo stars](https://img.shields.io/github/contributors/bids-standard/pybids) |
| bids-matlab | ![GitHub contributors (via allcontributors.org)](https://img.shields.io/github/all-contributors/bids-standard/bids-matlab) | ![GitHub Repo stars](https://img.shields.io/github/contributors/bids-standard/bids-matlab) |
| statistical model | | ![GitHub Repo stars](https://img.shields.io/github/contributors/bids-standard/stats-models) |

### Gender of contributors

Guessed with [gender-guesser](https://pypi.org/project/gender-guesser/)

<!-- use snippet to include a file
https://facelessuser.github.io/pymdown-extensions/extensions/snippets/#snippets-notation
-->

--8<-- "data/people/gender.md"

### Contributors affiliations

<!-- use snippet to include a file
https://facelessuser.github.io/pymdown-extensions/extensions/snippets/#snippets-notation
-->

--8<-- "data/people/affiliations.md"

<!-- use snippet to include a file
https://facelessuser.github.io/pymdown-extensions/extensions/snippets/#snippets-notation
-->

--8<-- "tmp/affiliations.html"
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -169,6 +169,7 @@ nav:
- Using MkDocs macros: extensions/macros_doc.md
- Impact:
- impact/index.md
- impact/measuring.md
- Merch: https://www.teepublic.com/user/bids
- Contact:
- contact/index.md
Expand Down
Loading