Library and converter tools for interop between BART and GE Healthcare's Orchestra.
If you can build bart and you can build the orchestra-sdk examples, you should be able to build these tools.
These tools are intended for research purposes only and come with no warranty. These tools are NOT FOR DIAGNOSTIC USE. See LICENSE for details.
These tools use the GE Orchestra API. The Orchestra SDK is copyright GE Healthcare.
- Tested with BART v0.7.00 (commit f071aebf2491491b8a662bfd0cfd951ea63d5bd9). Requires some light modification of Makefile (included)
- Tested with OpenBLAS-0.3.15. Requires building from source within Docker
- Requires docker
Starting in Orchestra 2.0.x, we need to build ox-bart within the supplied Docker container. This is a little tricky because it requires installing BART on HELiOS 6.10, which is quite old. Therefore, we need to build OpenBLAS from source and change some Makefile paths for Docker. We also have to update the RedHat repo index to point to GE's open HELiOS repo: http://linux.gehealthcare.com/HELiOS6/HELiOS-6.10/os/x86_64/Packages/.
Note: this will overwrite some files in the BART directory. It is recommended to use a clean version of BART and set the TOOLBOX_PATH appropriately
- Download the Orchestra Docker file and place in Orchestra sdk. It should have a name similar to
cpp-sdk. - Download OpenBLAS source from the website
- Download and install Docker. Follow the website for all setup instructions
- Set
TOOLBOX_PATHto the top-level BART directory, e.g. - Set
OX_INSTALL_DIRECTORYto the top-level Orchestra sdk directory, e.g. - Set
OPENBLAS_PATHto the OpenBLAS source code directory e.g.
Example:
export TOOLBOX_PATH=/home/jtamir/bart
export OX_INSTALL_DIRECTORY=/home/jtamir/orchestra-sdk
export OPENBLAS_PATH=/home/jtamir/OpenBLAS-0.3.15Build the tools with
./docker_build.shAfter docker is installed and the Orchestra SDK is downloaded, the script build_ox_2.0_from_scratch.sh should install everything else including dependencies. For step-by-step instructions, read below:
It is recommended to install following the official docker instructions from the Docker website.
We will create a workspace folder in the home directory. Feel free to change the destination directory as desired.
mkdir orchestra
cd orchestraSave orchestra-sdk-2.0-1 to orchestra/. ls orchestra/orchestra-sdk-2.0-1 should list something like:
3p Examples include lib license build.sh cpp-sdk.tar.gz openDockerContainer.sh
Clone the repositories and checkout appropriate versions. Also set the environment variables
git clone [email protected]:mrirecon/ox-bart.git
git clone [email protected]:xianyi/OpenBLAS.git
git clone [email protected]:mrirecon/bart.git
pushd bart
git checkout f071aebf2491491b8a662bfd0cfd951ea63d5bd9
export TOOLBOX_PATH=`pwd`
popd
pushd OpenBLAS
git checkout tags/v0.3.15
export OPENBLAS_PATH=`pwd`
popd
pushd orchestra-sdk-2.0-1
OX_INSTALL_DIRECTORY=`pwd`
popdFinally,
cd ox-bart
./docker_build.shIf all went well, you will find binary files located in orchestra/ox-bart/bin/:
cd bin
./ScanArchiveToBart
You can also access the BartIO library under orchestra/ox-bart/lib.
It can be helpful to check which libraries are linked to the binaries with the ldd command:
ldd ./ScanArchiveToBart
# linux-vdso.so.1 (0x00007ffd64fdf000)
# libz.so.1 => /lib/x86_64-linux-gnu/libz.so.1 (0x00007fa390329000)
# libpthread.so.0 => /lib/x86_64-linux-gnu/libpthread.so.0 (0x00007fa390306000)
# libdl.so.2 => /lib/x86_64-linux-gnu/libdl.so.2 (0x00007fa390300000)
# librt.so.1 => /lib/x86_64-linux-gnu/librt.so.1 (0x00007fa3902f3000)
# libfftw3f_threads.so.3 => /lib/x86_64-linux-gnu/libfftw3f_threads.so.3 (0x00007fa3902e9000)
# libopenblas.so.0 => /lib/x86_64-linux-gnu/libopenblas.so.0 (0x00007fa38e15c000)
# libstdc++.so.6 => /lib/x86_64-linux-gnu/libstdc++.so.6 (0x00007fa38df42000)
# libm.so.6 => /lib/x86_64-linux-gnu/libm.so.6 (0x00007fa38ddf3000)
# libgomp.so.1 => /lib/x86_64-linux-gnu/libgomp.so.1 (0x00007fa38ddae000)
# libgcc_s.so.1 => /lib/x86_64-linux-gnu/libgcc_s.so.1 (0x00007fa38dd91000)
# libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007fa38db9f000)
# /lib64/ld-linux-x86-64.so.2 (0x00007fa390362000)
# libfftw3f.so.3 => /lib/x86_64-linux-gnu/libfftw3f.so.3 (0x00007fa38d98f000)
# libgfortran.so.5 => /lib/x86_64-linux-gnu/libgfortran.so.5 (0x00007fa38d6c7000)
# libquadmath.so.0 => /lib/x86_64-linux-gnu/libquadmath.so.0 (0x00007fa38d67d000)- Tested with BART v0.6.00 (e1a4303). Currently does not support CUDA builds (trivial fix)
- Tested with Ox v1.10 (older versions not currently supported)
- Requires cmake 3.6 or higher
Must have BART installed without CUDA
Set TOOLBOX_PATH to the top-level BART directory, e.g.
export TOOLBOX_PATH=/home/jtamir/bartSet OX_INSTALL_DIRECTORY to the top-level Orchestra sdk directory, e.g.
export OX_INSTALL_DIRECTORY=/home/jtamir/orchestra-sdk
Build the tools with
./build.shThe tools and libraries can be found under bin/ and lib/
Use to convert a Pfile to a BART cfl/hdr file.
Usage: PfileToBart [options] --pfile <Pfile> --output <kspace>
Write <Pfile> data into BART-formatted file <kspace>.
--fft flags performs an FFT on the data along flags
--ifft flags performs an IFFT on the data along flags
--fftmod flags performs an FFTMod on the data along flags
--weights <file> output channel weights to <file>Use to convert a ScanArchive to a BART cfl/hdr file.
Usage: ScanArchiveToBart [options] --file <ScanArchive> --output <kspace>
Write <ScanArchive> data into BART-formatted file <kspace>.
--fft flags performs an FFT on the data along flags
--ifft flags performs an IFFT on the data along flags
--fftmod flags performs an FFTMod on the data along flags
--weights <file> output channel weights to <file>Takes a Pfile and a bart kspace file, and generates Dicoms using the Ox Dicom chain, e.g. gradwarp, resizing, etc.
Usage: BartToDicom [options] --pfile <Pfile> --input <kspace>
Write BART-formatted data in <kspace> to dicom using Pfile info.
--fft flags performs an FFT on the data along flags
--ifft flags performs an IFFT on the data along flags
--fftmod flags performs an FFTMod on the data along flags
--weights <weights> inputs custom channel weightsUsage: NoiseCov --input <NoiseStatistics> --covar <covar> --noise <noise> --optmat <optmat>
Write noise data and covariance matrix files to BART-formatted dataUsage: CalibrationData --pfile <Pfile> --input <RawCalibration> --body <body_coil>
Write body coil pre-scan h5 data into BART-formatted file based on dimensions in <Pfile>