The set of scripts that preprocess and insert MRI data into the database.
Clone or download
Permalink
Failed to load latest commit information.
DTIPrep Perldoc harmonization (#313) Jun 28, 2018
MNI Standardization of permissions for all MRI data files/dirs. Mar 18, 2016
auto/MNI Standardization of permissions for all MRI data files/dirs. Mar 18, 2016
dicom-archive Perldoc harmonization (#313) Jun 28, 2018
docs Fix logging of MRI violations log (#327) Aug 2, 2018
tools Bye bye JIV... (#310) Jul 11, 2018
uploadNeuroDB Fix logging of MRI violations log (#327) Aug 2, 2018
.travis.yml Specified language for Travis Oct 27, 2014
INSTALL.Mac.md update mac readme disclaimer (#128) Jun 21, 2016
README.md Update README, VERSION and perldoc MD files (#325) Jul 12, 2018
VERSION
batch_uploads_imageuploader Perldoc harmonization (#313) Jun 28, 2018
batch_uploads_tarchive Perldoc harmonization (#313) Jun 28, 2018
create.sql Perldoc harmonization (#313) Jun 28, 2018
environment removed unecessary links (#320) Jul 10, 2018
imaging_install.sh removing creation of site incoming directory from the install scripts ( Sep 10, 2018
imaging_install_MacOSX.sh removing creation of site incoming directory from the install scripts ( Sep 10, 2018
load_tarchive_db.sh Modified call to the prod file in load_tarchive_db.sh + replacing /ho… Dec 2, 2014

README.md

This Readme covers release 20.0 of the LORIS Imaging Insertion Pipeline for Ubuntu or CentOS systems

This repo accompanies the LORIS neuroimaging data platform main repo, release 20.0.*.
For documentation and detailed setup information, please see the LORIS-MRI documentation for your installed version.

This repo can be installed on the same VM as the main LORIS codebase, or on a different machine such as a designated fileserver where large imaging filesets are to be stored.

System Requirements

  • Perl
  • MINC toolkit (step 2 below)
  • DICOM toolkit (step 3 below)

On Ubuntu, DICOM toolkit will be installed by the imaging install script (step 4 below). This script will apt-get install dcmtk.

For CentOS: The LORIS wiki Imaging setup page (see Section 1, installing codebase) includes links to older transcripts for CentOS installation and notes on dependencies including DICOM toolkit.

The following installation should be run by the $lorisadmin user. sudo permission is required. See aces/Loris README.md for further information.

Installation

1. Create directories and download Loris-MRI code

sudo mkdir -p /data/$projectname/bin/mri
sudo chown -R lorisadmin:lorisadmin /data/$projectname
cd /data/$projectname/bin
git clone -b master https://github.com/aces/Loris-MRI.git mri

2. Install MINC toolkit from http://bic-mni.github.io/

Download the pre-compiled package for your operating system. Install required dependencies such as imagemagick. Then install your MINC toolkit package:

sudo dpkg -i minc-toolkit<version>.deb

Then source the MINC toolkit environment by running (for bash) source $mincToolsDirectory/minc-toolkit-config.sh or (tcsh) source $mincToolsDirectory/minc-toolkit-config.csh,

where $mincToolsDirectory is the path where the MINC toolkit is installed (e.g. /opt/minc/ OR /opt/minc/$mincToolsVersion/ for more recent installs)

3. Run installer to set up directories, configure environment, install Perl libraries and DICOM toolkit:

cd /data/$projectname/bin/mri/
bash ./imaging_install.sh

You will be asked for the following input:

  • What is the database name? $dbname
  • What is the database host? $dbhost
  • What is the MySQL user? $lorisuser [Use the same mysql user from the Loris installation, i.e. lorisuser]
  • What is the MySQL password?
  • What is the Linux user which the installation will be based on? $lorisadmin
  • What is the project name? $projectname
  • What is your email address?
  • What prod file name would you like to use? default: prod [leave blank]
  • Enter the list of Site names (space separated) site1 site2

If the imaging install script reports errors in creating directories (due to /data/ mount permissions), review and manually execute mkdir/chmod/chown commands starting at imaging_install.sh:L97

Note: The installer will allow Apache to write to the /data/ directories by adding user lorisadmin to the Apache linux group. To ensure this change takes effect, log out and log back into your terminal session before running the imaging pipeline. The installer will also set Apache group ownership of certain /data/ subdirectories.

4. Configure paths and environment

Ensure that /home/lorisadmin/.bashrc includes the statement:

source /data/$projectname/bin/mri/environment

Then source the .bashrc file.

INSTALLATION COMPLETE!

Please refer to the Install section in the LORIS-MRI documentation for your installed version for:

  • customizations and protocol configurations (Section 2.2).
  • verifying that certain fields were correctly populated by imaging_install.sh (Section 2.3).