/horos-bids-output

Horos plugin for BIDS output. Stanford Center for Reproducible Neuroscience coding sprint 2017.

Primary LanguageObjective-CGNU General Public License v3.0GPL-3.0

Horos (Osirix) Bids Output Extension

OsiriX / Horos plugin for BIDS output. Created during Stanford Center for Reproducible Neuroscience coding sprint 2017. The plugin allows creation of fundamental BIDS structure from within Horos GUI, based on a mapping between sequence name and BIDS terms entered by user.

Plugin interface

Information for users

Installation

Download the HorosBidsOutput.horosplugin from the releases page above. If you have Horos installed, double-clicking the .horosplugin file should launch horos with a prompt and install the plugin for the current user.

Alternatively, the file can be manually placed in: ~/Library/Application Support/Horos/Plugins/. Regardless of the installation method, the plugin can then be made available to all users through Horos' Plugins Manager.

On MacOS Catalina and above, the plugin will be blocked by the Gatekeeper (the developer cannot be verified). If you trust the plugin, you can remove the "quarantine" attribute from the Terminal by navigating to the downloaded file and executing xattr -c HorosBidsOutput.horosplugin. Then, proceed with installation as described above.

Dependencies: dcm2niix

Bids Output Extension works by launching dcm2niix, which has to be available. To install dcm2niix, go to dcm2niix releases page and download the executable.

The dcm2niix executable can be placed anywhere on your computer. However, if an executable file named dcm2niix is found in your home directory, Bids Output Extension will use it by default.

Usage

For usage instructions, see the project wiki.

Caveats

  1. Please keep in mind that the aim of the plugin is to create the fundamental BIDS structure, and the resulting dataset will most likely require some manual tweaks to become complete. This may include filling in some JSON fields (only the strictly obligatory ones are present) and adding stimulus information.
  2. Field maps are handled only in the case of one phasediff and two magnitude images (based on the Siemens Trio output).
  3. Not all BIDS suffixes are available in the GUI. For more details, see the known limitations section of project wiki.

About Osirix / Horos

OsiriX and Horos are DICOM image viewers / database browsers. Horos is based upon OsiriX. The plugin development switched from OsiriX to Horos prior to 0.1 release, but it is likely that the plugin will be compatible with both.

Horos: website, github

OsiriX: website, github

About Brain Imaging Data Structure

See bids.neuroimaging.io

Information for developers

Things to change after cloning

  1. OsiriXAPI.framework is not included in this repository (the folder is just a placeholder). Use the API taken from here.
  2. In Xcode, choose Edit Scheme.
    1. In the Info tab, set Executable to Horos (or OsiriX).
    2. In the Arguments tab, add the following argument passed on launch: --LoadPlugin $(BUILT_PRODUCTS_DIR)/$(PRODUCT_NAME).$(WRAPPER_EXTENSION)

Useful resources

This materials helped me start writing the plugin and I am immensely grateful to their creators.