> For the complete documentation index, see [llms.txt](https://netstim.gitbook.io/leaddbs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://netstim.gitbook.io/leaddbs/lead-or/imaging-setup.md).

# Imaging setup

## Requirements

1. **3D Slicer:** [3D Slicer](https://download.slicer.org/) (v >= 5.2.2) together with the SlicerNetstim, SlicerOpenIGTLink and SlicerIGT extensions should be installed.
2. **ORScene:** An *ORScene* is a file that includes subject images, planning information and atlas-based segmentations ready to loaded into Slicer. It can be created from Lead-DBS and an example dataset is already included in the SlicerNetstim extension.

## Loading sample ORScene

A sample ORScene is included to test the platform. To load it follow the next steps:

1. Open Slicer.
2. Switch to Sample Data module.
3. Scroll down and select STN Planning.

See the following screenshots as reference:

<figure><img src="/files/HyL7dEguFk5AWP6FFLva" alt=""><figcaption><p>Step 2: Switch to Sample Data module.</p></figcaption></figure>

<figure><img src="/files/KTausUAVsx2fINlBR1gf" alt=""><figcaption><p>Step 3: Select STN Planning ORScene.</p></figcaption></figure>

## Creating new ORScene

In order to create an ORScene follow the next steps:

1. Process a subject in Lead-DBS with the **co-registration** and **normalization** steps.
2. Place the surgical planning files under a `leador` subfolder within the subject folder.
3. Load the subject in Lead-DBS and select `Tools > Lead-OR > Create ORScene`. Note that the selected atlas will be put into the scene as well.
4. Drag and drop the `ORScene.mrb` file into Slicer.

See the following screenshots as reference.

<figure><img src="/files/P0urA1rjqzNVzG1FQSWD" alt=""><figcaption><p>Step 2: Lead-DBS subject processed and with Brainlab planning files in respective folder.</p></figcaption></figure>

<figure><img src="/files/GOdqUIZRchUyFeh99jOW" alt=""><figcaption><p>Step 3: Create ORScene from Lead-DBS.</p></figcaption></figure>

<figure><img src="/files/Ah3JXfcc6Lnhq8Wc7l9X" alt=""><figcaption><p>Step 4: Output folder with file to load into Slicer.</p></figcaption></figure>
