diff --git a/paper.bib b/paper.bib index d6691392..8728f641 100644 --- a/paper.bib +++ b/paper.bib @@ -167,14 +167,14 @@ @online{dicm_ref_2020 date = {2020}, } -@software{@Li_2016, +@software{Li_2016, title = {DICOM to NIfTI conversion, DICOM and NIfTI tools, NIfTI visualization}, url = {https://github.com/xiangruili/dicm2nii}, urldate = {2024-01-08}, date = {2016}, } @software{noauthor_ezbids, - title = {{ezBIDS}}, + title = {ezBIDS}, url = {https://brainlife.io/ezbids/}, urldate = {2023-08-22}, date = {2023}, diff --git a/paper.md b/paper.md index 0a897d3d..49912125 100644 --- a/paper.md +++ b/paper.md @@ -71,17 +71,17 @@ bibliography: paper.bib The Brain Imaging Data Structure [@gorgolewski_brain_2016] is a standard for organizing and naming neuroimaging data which has quickly become successful and popular in the community with adoption by major brain imaging repositories (e.g. OpenNeuro [@noauthor_openneuro], PublicnEUro [@noauthor_public], CONP [@noauthor_canadian]) and data management tools (e.g. COINS [@landis_coins_2016], XNAT [@marcus_extensible_2007], Loris [@das_loris_2012]). This not only allows data to be shared much more easily, but also enables the development of automated data analysis pipelines, and together improves reproducibility. -The BIDS extension for Positron Emission Tomography (PET-BIDS) [@norgaard_pet-bids_2022] provides a structured data and metadata nomenclature, including all the necessary information to share and report on PET blood and metabolite [@knudsen_guidelines_2020]. Here we present a new code library, developed in both Matlab and Python, allowing the conversion of DICOM [dicm_ref_2020] and ECAT (CTI/Siemens proprietary data format) PET imaging data and metadata (e.g., timing information such as e.g. 'time zero' or blood measurements) into the BIDS specification. +The BIDS extension for Positron Emission Tomography (PET-BIDS) [@norgaard_pet-bids_2022] provides a structured data and metadata nomenclature, including all the necessary information to share and report on PET blood and metabolite [@knudsen_guidelines_2020]. Here we present a new code library, developed in both Matlab and Python, allowing the conversion of DICOM [@dicm_ref_2020] and ECAT (CTI/Siemens proprietary data format) PET imaging data and metadata (e.g., timing information such as e.g. 'time zero' or blood measurements) into the BIDS specification. # Statement of need Conversion tools from native format to BIDS are essential to help researchers to use BIDS. While it exists tools for MRI and MEEG, PET2BIDS is the first tool to convert PET data to BIDS. Because PET2BIDS is a code library, conversion is done using the command line only. PET2BIDS can however also be integrated into software (with a graphical user interface) that aim at more general BIDS conversion, and current efforts are underway integrating PET2BIDS with ezBIDS [@noauthor_ezbids] and BIDSCoins [@zwiers_bidscoin_2022]. -_File conversion_: The conversion for PET data stored in DICOM format to NIfTI is performed using the dcm2niix4pet (.m and .py) functions which are wrapper functions around dcm2niix [@rorden_dcm2nii; @li_first_2016] that extend the image sidecar JSON file generated by dcm2niix with details that are not included in the source images but are required for BIDS. Those information must be provided by the user. The conversion of PET data stored in ECAT format is performed using the newly created ecat2nii (.m .py) functions. The Matlab code relies on the readECAT7.m function writen by BT Christian (1998) and revised by RF Muzic (2002) to read the data, while writing Nifti files relies on nii_tool [@Li_2016]. The Python code was developed to mirror the Matlab code, with further testing of data reading (i.e., which file bits are read according to the PET data frames - see [ecat validation](https://github.com/openneuropet/PET2BIDS/tree/main/ecat_validation)) and writing, relying here on Nibabel [@brett_nipynibabel_2023]. As for DICOM, JSON sidecar file are created from image data but adding PET metadata provided by users. +_File conversion_: The conversion for PET data stored in DICOM format to NIfTI is performed using the dcm2niix4pet (.m and .py) functions which are wrapper functions around dcm2niix [@rorden_dcm2nii; @li_first_2016] that extend the image sidecar JSON file generated by dcm2niix with details that are not included in the source images but are required for BIDS. Those information must be provided by the user. The conversion of PET data stored in ECAT format is performed using the newly created ecat2nii (.m .py) functions. The Matlab code relies on the readECAT7.m function writen by BT Christian (1998) and revised by RF Muzic (2002) to read the data, while writing Nifti files relies on nii_tool [@Li_2016]. The Python code was developed to mirror the Matlab code, with further testing of data reading (i.e., which file bits are read according to the PET data frames - see [ecat validation](https://github.com/openneuropet/PET2BIDS/tree/main/ecat_validation)) and writing, relying here on Nibabel [@brett_nipynibabel_2023]. As for DICOM, JSON sidecar files are created from image data but adding PET metadata provided by users. _PET Metadata_: JSON files created from reading PET scanner data are always missing some of the radiotracer and pharmaceutical information. To accommodate this, a dedicated PET JSON updater was -created. The PET JSON updater functions (updatejsonpetfile.m and xxx.py) takes the original image sidecar JSON file and new metadata to add as input, checks that the full BIDS specification is respected (correct metadata but also consistency of metadata values for the different metadata keys) and updates the image sidecar JSON file. +created. The PET JSON updater functions (updatejsonpetfile.m and xxx.py) takes the existing Nifti sidecar JSON file and new metadata to add as input, checks that the full BIDS specification is respected (correct metadata but also consistency of metadata values for the different metadata keys) and updates the image sidecar JSON file. _Spreadsheet conversion_: tabular data formats are ubiquitous in the PET community in particular to keep track of radiotracer information injected per participant and recording of time and radiotracer concentration from the blood sampling. To facilitate conversion to BIDS, three dedicated functions were created to (i) convert pre-formatted tabular data to image sidecar JSON files, or(ii) use pre-formatted tabular data to update image sidecar JSON files, or (iii) convert a tabular PMOD file to a BIDS blood.tsv file with it's sidecar JSON. (PMOD being a popular commercial pharmacokinetic modelling software [@Burger1997]). Supported formats are .xls, .xlsx, .csv, .tsv and .bld.