From 5f4b92c0b98445347a934d999fae746b692bff45 Mon Sep 17 00:00:00 2001 From: Zhen-Qi Liu Date: Thu, 19 Sep 2024 17:26:19 -0400 Subject: [PATCH 1/2] Update docs --- docs/listofmaps.rst | 223 +++++++++++++++++++++++++++++++++++- neuromaps/datasets/utils.py | 2 +- 2 files changed, 223 insertions(+), 2 deletions(-) diff --git a/docs/listofmaps.rst b/docs/listofmaps.rst index 030fb089..eb4edb62 100644 --- a/docs/listofmaps.rst +++ b/docs/listofmaps.rst @@ -859,7 +859,7 @@ gallezot2017-gsk189254-MNI152-1mm PET tracer binding (Vt) to H3 (histamine receptor) -**Demographics**: N = 8, Age = 31.69 +- 8.95 +**Demographics**: N = 8, Age = 31.69 +/- 8.95 **Tags**: receptors, PET @@ -886,6 +886,45 @@ PET tracer binding (Vt) to H3 (histamine receptor) ---- +galovic2021-ge179-MNI152-1mm +============================ + +**Annotation identifier** + +*{'source': 'galovic2021', 'desc': 'ge179', 'space': 'MNI152', 'res': '1mm'}* + +**Full description** + +PET tracer binding (Vt) to NMDA (glutamate receptor) + +**Demographics**: N = 29, Age = 40.9 +/- 12.7 + +**Tags**: receptors, PET + +**How to use** + +.. code:: python + + # get annotation + fetch_annotation(source='galovic2021', desc='ge179', space='MNI152', res='1mm') + + # describe annotation + describe_annotations(('galovic2021', 'ge179', 'MNI152', '1mm')) + + # file location + # $NEUROMAPS_DATA/galovic2021/ge179/MNI152 + + # file name (for surface data, replace L/R to get the other hemisphere) + # source-galovic2021_desc-ge179_space-MNI152_res-1mm_feature.nii.gz + +**References** + - Justine Y Hansen, Golia Shafiei, Ross D Markello, Kelly Smart, Sylvia ML Cox, Martin Nørgaard, Vincent Beliveau, Yanjun Wu, Jean-Dominique Gallezot, Étienne Aumont, and others. Mapping neurotransmitter systems to the structural and functional organization of the human neocortex. Nature neuroscience, 25(11):1569–1581, 2022. + - Marian Galovic, Adam Al-Diwani, Umesh Vivekananda, Francisco Torrealdea, Kjell Erlandsson, Tim D Fryer, Young T Hong, Benjamin A Thomas, Colm J McGinnity, Evan Edmond, and others. In vivo nmda receptor function in people with nmda receptor antibody encephalitis. medRxiv, pages 2021–12, 2021. + - Marian Galovic, Kjell Erlandsson, Tim D Fryer, Young T Hong, Roido Manavaki, Hasan Sari, Sarah Chetcuti, Benjamin A Thomas, Martin Fisher, Selena Sephton, and others. Validation of a combined image derived input function and venous sampling approach for the quantification of [18f] ge-179 pet binding in the brain. Neuroimage, 237:118194, 2021. + - Colm J McGinnity, Alexander Hammers, Daniela A Riaño Barros, Sajinder K Luthra, Paul A Jones, William Trigg, Caroline Micallef, Mark R Symms, David J Brooks, Matthias J Koepp, and others. Initial evaluation of 18f-ge-179, a putative pet tracer for activated n-methyl d-aspartate receptors. Journal of Nuclear Medicine, 55(3):423–430, 2014. + +---- + hcps1200-megalpha-fsLR-4k ========================= @@ -1472,6 +1511,43 @@ PET tracer binding (BPnd) to MOR (mu-opioid receptor) ---- +kim2020-ps13-MNI152-2mm +======================= + +**Annotation identifier** + +*{'source': 'kim2020', 'desc': 'ps13', 'space': 'MNI152', 'res': '2mm'}* + +**Full description** + +PET tracer binding (Vt) to COX-1 (cyclooxygenase-1) + +**Demographics**: N = 10, Age = 29.3 +/- 7.2 + +**Tags**: PET + +**How to use** + +.. code:: python + + # get annotation + fetch_annotation(source='kim2020', desc='ps13', space='MNI152', res='2mm') + + # describe annotation + describe_annotations(('kim2020', 'ps13', 'MNI152', '2mm')) + + # file location + # $NEUROMAPS_DATA/kim2020/ps13/MNI152 + + # file name (for surface data, replace L/R to get the other hemisphere) + # source-kim2020_desc-ps13_space-MNI152_res-2mm_feature.nii.gz + +**References** + - Min-Jeong Kim, Jae-Hoon Lee, Fernanda Juarez Anaya, Jinsoo Hong, William Miller, Sanjay Telu, Prachi Singh, Michelle Y Cortes, Katharine Henry, George L Tye, and others. First-in-human evaluation of [11 c] ps13, a novel pet radioligand, to quantify cyclooxygenase-1 in the brain. European journal of nuclear medicine and molecular imaging, 47:3143–3151, 2020. + - Doug Greve, Paul Wighton, Melanie Ganz, Martin Nørgaard, Paolo Zanotti-Fregonara, Cyril Pernet, Anthony Galassi, Adam Thomas, Nafiseh Ghazanfari, Jeih-San Liow, Granville Matheson, Gitte Knudsen, and Robert Innis. "a pet molecular imaging brain atlas of cyclooxygenase-1 (kim 2021)". 2023. doi:doi:10.18112/openneuro.ds004401.v1.0.1. + +---- + laurikainen2018-fmpepd2-MNI152-1mm ================================== @@ -1508,6 +1584,115 @@ PET tracer binding (Vt) to CB1 (cannabinoid receptor) ---- +lois2018-pbr28-MNI152-2mm +========================= + +**Annotation identifier** + +*{'source': 'lois2018', 'desc': 'pbr28', 'space': 'MNI152', 'res': '2mm'}* + +**Full description** + +PET tracer binding (SUVR) to TSPO (translocator protein) + +**Demographics**: N = 6, Age = 57.8 +/- 8.1 + +**Tags**: PET + +**How to use** + +.. code:: python + + # get annotation + fetch_annotation(source='lois2018', desc='pbr28', space='MNI152', res='2mm') + + # describe annotation + describe_annotations(('lois2018', 'pbr28', 'MNI152', '2mm')) + + # file location + # $NEUROMAPS_DATA/lois2018/pbr28/MNI152 + + # file name (for surface data, replace L/R to get the other hemisphere) + # source-lois2018_desc-pbr28_space-MNI152_res-2mm_feature.nii.gz + +**References** + - Cristina Lois, Iván González, David Izquierdo-García, Nicole R Zürcher, Paul Wilkens, Marco L Loggia, Jacob M Hooker, and H Diana Rosas. Neuroinflammation in huntington’s disease: new insights with 11c-pbr28 pet/mri. ACS chemical neuroscience, 9(11):2563–2571, 2018. + - Ivan Gonzalez and Cristina Lois. hookerlab/huntington-with-pbr28: ACS Chemical Neuroscience submission. 2018. URL: https://doi.org/10.5281/zenodo.1174364, doi:10.5281/zenodo.1174364. + +---- + +lukow2022-ro154513-MNI152-2mm +============================= + +**Annotation identifier** + +*{'source': 'lukow2022', 'desc': 'ro154513', 'space': 'MNI152', 'res': '2mm'}* + +**Full description** + +PET tracer binding (BPnd) to GABAa receptor, alpha5 subunit + +**Demographics**: N = 10, Age = 25.40 +/- 3.20 + +**Tags**: receptors, PET + +**How to use** + +.. code:: python + + # get annotation + fetch_annotation(source='lukow2022', desc='ro154513', space='MNI152', res='2mm') + + # describe annotation + describe_annotations(('lukow2022', 'ro154513', 'MNI152', '2mm')) + + # file location + # $NEUROMAPS_DATA/lukow2022/ro154513/MNI152 + + # file name (for surface data, replace L/R to get the other hemisphere) + # source-lukow2022_desc-ro154513_space-MNI152_res-2mm_feature.nii.gz + +**References** + - Paulina Barbara Lukow, Daniel Martins, Mattia Veronese, Anthony Christopher Vernon, Philip McGuire, Federico Edoardo Turkheimer, and Gemma Modinos. Cellular and molecular signatures of in vivo imaging measures of gabaergic neurotransmission in the human brain. Communications Biology, 5(1):372, 2022. + +---- + +malen2022-raclopride-MNI152-2mm +=============================== + +**Annotation identifier** + +*{'source': 'malen2022', 'desc': 'raclopride', 'space': 'MNI152', 'res': '2mm'}* + +**Full description** + +PET tracer binding (BPnd) to D2 (dopamine receptor) + +**Demographics**: N = 156, Age = 27.76 +/- 9.44 + +**Tags**: receptors, PET + +**How to use** + +.. code:: python + + # get annotation + fetch_annotation(source='malen2022', desc='raclopride', space='MNI152', res='2mm') + + # describe annotation + describe_annotations(('malen2022', 'raclopride', 'MNI152', '2mm')) + + # file location + # $NEUROMAPS_DATA/malen2022/raclopride/MNI152 + + # file name (for surface data, replace L/R to get the other hemisphere) + # source-malen2022_desc-raclopride_space-MNI152_res-2mm_feature.nii.gz + +**References** + - Tuulia Malén, Tomi Karjalainen, Janne Isojärvi, Aki Vehtari, Paul-Christian Bürkner, Vesa Putkinen, Valtteri Kaasinen, Jarmo Hietala, Pirjo Nuutila, Juha Rinne, and others. Atlas of type 2 dopamine receptors in the human brain: age and sex dependent variability in a large pet cohort. NeuroImage, 255:119149, 2022. + +---- + margulies2016-fcgradient01-fsLR-32k =================================== @@ -2928,6 +3113,42 @@ PET tracer binding (Vt) to KOR (kappa-opioid receptor) ---- +wey2016-martinostat-MNI152-2mm +============================== + +**Annotation identifier** + +*{'source': 'wey2016', 'desc': 'martinostat', 'space': 'MNI152', 'res': '2mm'}* + +**Full description** + +PET tracer binding (SUVR) to class 1 HDAC isoforms 1, 2, and 3 (histone deacetylase) + +**Demographics**: N = 8, Age = 28.6 +/- 7.6 + +**Tags**: PET + +**How to use** + +.. code:: python + + # get annotation + fetch_annotation(source='wey2016', desc='martinostat', space='MNI152', res='2mm') + + # describe annotation + describe_annotations(('wey2016', 'martinostat', 'MNI152', '2mm')) + + # file location + # $NEUROMAPS_DATA/wey2016/martinostat/MNI152 + + # file name (for surface data, replace L/R to get the other hemisphere) + # source-wey2016_desc-martinostat_space-MNI152_res-2mm_feature.nii.gz + +**References** + - Hsiao-Ying Wey, Tonya M Gilbert, Nicole R Zürcher, Angela She, Anisha Bhanot, Brendan D Taillon, Fredrick A Schroeder, Changing Wang, Stephen J Haggarty, and Jacob M Hooker. Insights into neuroepigenetics through human histone deacetylase pet imaging. Science translational medicine, 8(351):351ra106–351ra106, 2016. + +---- + xu2020-FChomology-fsLR-32k ========================== diff --git a/neuromaps/datasets/utils.py b/neuromaps/datasets/utils.py index 29736754..d68ab544 100644 --- a/neuromaps/datasets/utils.py +++ b/neuromaps/datasets/utils.py @@ -565,7 +565,7 @@ def _gen_doc_listofmaps_rst(listofmaps_file): " # file location", f" # $NEUROMAPS_DATA/{entry['rel_path']}", "", - " # file name (for surface data, replace" + " # file name (for surface data, replace " "L/R to get the other hemisphere)", f" # {entry['fname']}", "" From b8bdb900d02087527bf054dde8d41a6e904746ef Mon Sep 17 00:00:00 2001 From: Zhen-Qi Liu Date: Thu, 19 Sep 2024 18:08:37 -0400 Subject: [PATCH 2/2] Add license --- docs/listofmaps.rst | 10 ++++++++++ neuromaps/datasets/data/meta.json | 20 ++++++++++++++++++++ neuromaps/datasets/utils.py | 8 ++++++++ 3 files changed, 38 insertions(+) diff --git a/docs/listofmaps.rst b/docs/listofmaps.rst index eb4edb62..4206f79c 100644 --- a/docs/listofmaps.rst +++ b/docs/listofmaps.rst @@ -1542,6 +1542,8 @@ PET tracer binding (Vt) to COX-1 (cyclooxygenase-1) # file name (for surface data, replace L/R to get the other hemisphere) # source-kim2020_desc-ps13_space-MNI152_res-2mm_feature.nii.gz +**License**: `CC0 `_ + **References** - Min-Jeong Kim, Jae-Hoon Lee, Fernanda Juarez Anaya, Jinsoo Hong, William Miller, Sanjay Telu, Prachi Singh, Michelle Y Cortes, Katharine Henry, George L Tye, and others. First-in-human evaluation of [11 c] ps13, a novel pet radioligand, to quantify cyclooxygenase-1 in the brain. European journal of nuclear medicine and molecular imaging, 47:3143–3151, 2020. - Doug Greve, Paul Wighton, Melanie Ganz, Martin Nørgaard, Paolo Zanotti-Fregonara, Cyril Pernet, Anthony Galassi, Adam Thomas, Nafiseh Ghazanfari, Jeih-San Liow, Granville Matheson, Gitte Knudsen, and Robert Innis. "a pet molecular imaging brain atlas of cyclooxygenase-1 (kim 2021)". 2023. doi:doi:10.18112/openneuro.ds004401.v1.0.1. @@ -1615,6 +1617,8 @@ PET tracer binding (SUVR) to TSPO (translocator protein) # file name (for surface data, replace L/R to get the other hemisphere) # source-lois2018_desc-pbr28_space-MNI152_res-2mm_feature.nii.gz +**License**: `MIT `_ + **References** - Cristina Lois, Iván González, David Izquierdo-García, Nicole R Zürcher, Paul Wilkens, Marco L Loggia, Jacob M Hooker, and H Diana Rosas. Neuroinflammation in huntington’s disease: new insights with 11c-pbr28 pet/mri. ACS chemical neuroscience, 9(11):2563–2571, 2018. - Ivan Gonzalez and Cristina Lois. hookerlab/huntington-with-pbr28: ACS Chemical Neuroscience submission. 2018. URL: https://doi.org/10.5281/zenodo.1174364, doi:10.5281/zenodo.1174364. @@ -1652,6 +1656,8 @@ PET tracer binding (BPnd) to GABAa receptor, alpha5 subunit # file name (for surface data, replace L/R to get the other hemisphere) # source-lukow2022_desc-ro154513_space-MNI152_res-2mm_feature.nii.gz +**License**: `CC BY 4.0 `_ + **References** - Paulina Barbara Lukow, Daniel Martins, Mattia Veronese, Anthony Christopher Vernon, Philip McGuire, Federico Edoardo Turkheimer, and Gemma Modinos. Cellular and molecular signatures of in vivo imaging measures of gabaergic neurotransmission in the human brain. Communications Biology, 5(1):372, 2022. @@ -1688,6 +1694,8 @@ PET tracer binding (BPnd) to D2 (dopamine receptor) # file name (for surface data, replace L/R to get the other hemisphere) # source-malen2022_desc-raclopride_space-MNI152_res-2mm_feature.nii.gz +**License**: `CC0 `_ + **References** - Tuulia Malén, Tomi Karjalainen, Janne Isojärvi, Aki Vehtari, Paul-Christian Bürkner, Vesa Putkinen, Valtteri Kaasinen, Jarmo Hietala, Pirjo Nuutila, Juha Rinne, and others. Atlas of type 2 dopamine receptors in the human brain: age and sex dependent variability in a large pet cohort. NeuroImage, 255:119149, 2022. @@ -3144,6 +3152,8 @@ PET tracer binding (SUVR) to class 1 HDAC isoforms 1, 2, and 3 (histone deacetyl # file name (for surface data, replace L/R to get the other hemisphere) # source-wey2016_desc-martinostat_space-MNI152_res-2mm_feature.nii.gz +**License**: `CC0 `_ + **References** - Hsiao-Ying Wey, Tonya M Gilbert, Nicole R Zürcher, Angela She, Anisha Bhanot, Brendan D Taillon, Fredrick A Schroeder, Changing Wang, Stephen J Haggarty, and Jacob M Hooker. Insights into neuroepigenetics through human histone deacetylase pet imaging. Science translational medicine, 8(351):351ra106–351ra106, 2016. diff --git a/neuromaps/datasets/data/meta.json b/neuromaps/datasets/data/meta.json index a72287b2..dcbccdf3 100644 --- a/neuromaps/datasets/data/meta.json +++ b/neuromaps/datasets/data/meta.json @@ -1266,6 +1266,10 @@ "demographics": { "N": 10, "age": "29.3 +/- 7.2" + }, + "license": { + "type": "CC0", + "url": "https://creativecommons.org/publicdomain/zero/1.0/" } }, { @@ -1324,6 +1328,10 @@ "demographics": { "N": 6, "age": "57.8 +/- 8.1" + }, + "license": { + "type": "MIT", + "url": "https://github.com/hookerlab/huntington-with-pbr28/blob/v1.0.0/LICENSE" } }, { @@ -1351,6 +1359,10 @@ "demographics": { "N": 10, "age": "25.40 +/- 3.20" + }, + "license": { + "type": "CC BY 4.0", + "url": "https://creativecommons.org/licenses/by/4.0/" } }, { @@ -1378,6 +1390,10 @@ "demographics": { "N": 156, "age": "27.76 +/- 9.44" + }, + "license": { + "type": "CC0", + "url": "https://creativecommons.org/publicdomain/zero/1.0/" } }, { @@ -2491,6 +2507,10 @@ "demographics": { "N": 8, "age": "28.6 +/- 7.6" + }, + "license": { + "type": "CC0", + "url": "https://creativecommons.org/publicdomain/zero/1.0/" } }, { diff --git a/neuromaps/datasets/utils.py b/neuromaps/datasets/utils.py index d68ab544..5629d944 100644 --- a/neuromaps/datasets/utils.py +++ b/neuromaps/datasets/utils.py @@ -579,6 +579,14 @@ def _gen_doc_listofmaps_rst(listofmaps_file): "" ] + if "license" in meta_entry: + output += [ + "**License**: " + f"`{meta_entry['license']['type']} " + f"<{meta_entry['license']['url']}>`_", + "" + ] + output.append("**References**") for bib_category in ["primary", "secondary"]: for bib_item in meta_entry["refs"][bib_category]: