From 4e6ac5029b39867268115d466220d4737705c071 Mon Sep 17 00:00:00 2001 From: Rockets2theMoon Date: Thu, 5 Dec 2024 09:12:02 -0800 Subject: [PATCH 1/7] second pass impact page --- docs/impact/dashboards.md | 103 ++++++++++++++++++++++++++++++++ docs/impact/index.md | 122 +------------------------------------- mkdocs.yml | 1 + 3 files changed, 106 insertions(+), 120 deletions(-) create mode 100644 docs/impact/dashboards.md diff --git a/docs/impact/dashboards.md b/docs/impact/dashboards.md new file mode 100644 index 00000000..571fc6c5 --- /dev/null +++ b/docs/impact/dashboards.md @@ -0,0 +1,103 @@ +# Dashboards +## 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. + + + +--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) + + + +--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/) + + + +--8<-- "data/people/gender.md" + +#### Contributors affiliations + + + +--8<-- "data/people/affiliations.md" + + + +--8<-- "tmp/affiliations.html" diff --git a/docs/impact/index.md b/docs/impact/index.md index d4fbe5e3..d4eb2520 100644 --- a/docs/impact/index.md +++ b/docs/impact/index.md @@ -30,126 +30,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. - - - ---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) - - - ---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/) - - - ---8<-- "data/people/gender.md" - -#### Contributors affiliations - - - ---8<-- "data/people/affiliations.md" - - - ---8<-- "tmp/affiliations.html" - -### GitHub dependents - - - - - - - -| 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 @@ -202,6 +82,8 @@ 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, etc). Read more on the [Impact Dashboards page](/docs/impact/dashboards.md). + ### Neurostars We also track the interest and usage of the BIDS standard via discussions on Neurostars diff --git a/mkdocs.yml b/mkdocs.yml index 7945fe24..7ac3d1fc 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -169,6 +169,7 @@ nav: - Using MkDocs macros: extensions/macros_doc.md - Impact: - impact/index.md + - impact/dashboards.md - Merch: https://www.teepublic.com/user/bids - Contact: - contact/index.md From 656d630b9be7a17eca929f5f9483e11b0b33cb40 Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Thu, 5 Dec 2024 17:20:28 +0000 Subject: [PATCH 2/7] [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --- docs/impact/dashboards.md | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/impact/dashboards.md b/docs/impact/dashboards.md index 571fc6c5..a5f97709 100644 --- a/docs/impact/dashboards.md +++ b/docs/impact/dashboards.md @@ -3,12 +3,12 @@ ### 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. +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.