app-plot3Dobjects

This App allows you to plot 3D objects in .vtk format in four different views: axial, coronal, left, and right sagittal.

Author

• Lindsey Kitchell (kitchell@indiana.edu)

Funding

Citations

We kindly ask that you cite the following articles when publishing papers and code using this code.

1. Kitchell, Lindsey. Shape Analysis of Human White Matter Tracts: An Examination of Normal Morphological Variability and the Association Between Morphology, Brain Size, and Behavior. Indiana University. 2020
2. Avesani, P., McPherson, B., Hayashi, S. et al. The open diffusion data derivatives, brain data upcycling via integrated publishing of derivatives and reproducible open cloud services. Sci Data 6, 69 (2019). https://doi.org/10.1038/s41597-019-0073-y

Running the App

On Brainlife.io

You can submit this App online at https://brainlife.io/app/596cdb1a88ae6f0021531d6a# via the "Execute" tab.

Running Locally (on your machine)

1. git clone this repo.
2. Inside the cloned directory, create config.json with something like the following content with paths to your input files.

{
   "surfaces": "../surfaces/"
}

If you have singlarity install on your local machine:

3. Launch the App by executing main

./main

Otherwise:

3. execute main.py in python

Sample Datasets

If you don't have your own input file, you can download sample datasets from Brainlife.io, or you can use Brainlife CLI.

Output

The output of this app will be a folder with images of the 3d surfaces.

Dependencies

This App only requires singularity to run. If you don't have singularity, you will need to install following dependencies.

• Python