Import/Export

5.1 Workspace

5.1.1 What is it?

A workspace is a folder (for example named 'root') containing all data (sets, sub sets and image collections).

• A set is a folder containing folders and/or NIfTI files (.nii)
• A sub set is a folder inside a folder representing the parent set, containing folders and/or NIfTI files (.nii)
• An image collection is a folder containing only NIfTI files (.nii)
• Warning : check your folder, if it contains the root folder, it may fail.

5.1.2 Import workspace

To import your workspace, you have to respect the structure shown in the previous section. Select the button "Workspace" in the menu. Then click on "Import from workspace".

Then, choose a directory. This directory will be the root of your workspace. That mean all the data (sets, and image collections) will be in it, directly. For an example, see the previous section image.

To avoid any loss of data, a check will be made. If an error occurs, your workspace does not meet one of the following prerequisites:

• Our workspace does not respect the structure. To fix it, please read the previous section to understand why your structure is not correct.
• Some sets or subsets have the same name (in your workspace OR between your workspace and the current state of the software). To fix it, please check your sets names.
• Some image collection have the same name (in your workspace OR between your workspace and the current state of the software). To fix it, please check your image collections names.

5.1.3 Export workspace

To export your workspace, select the button "Workspace" in the menu. Then click on "Export workspace". Then, select a directory where the workspace will be saved.

One you saved your workspace, you can exit the software. You will be able to import it again later, in another instance of the software. If you reimport it in the same instance, then you will have an error. That's because all your data is already in the software (and name the same way), even if you changed some things in it.

We recommand to save your work when your done. And load your workspace when you come back at it, with another instance of the software.

5.2 Export an Image Collection

To export your selcted image Collection, select the button "Export data" in the main page of the software. This operation let you choose between the export to NifTI and the export to CSV. The pop-up shown remember you the number of image collection and NifTI image selected.

5.2.1 As a NIfTI file

After this step, to export as a NifTI file, select the button "Export to NIfTI" and click "Apply". This operation let you choose where you want to save these files.

To take less place on the computer, NIfTI images are compressed ("nii.gz").

Note : this operation will save all the NIfTI files on your computer. Please check that you have enough space on your computer before this operation, to prevent any damage.

5.2.2 As a CSV (Excel) file

After this step, to export as a CSV file, select the button "Export to CSV" and click to "Apply". An other pop-up will appear. This let you choose between "Export all points" (all the points with an intensity other than 0) and "Export only the centroid of each file". After choosing your export way, click on the "Apply" button and choose where you want to save the CSV file.

The first line of the CSV contains the header of each column. These are :

• File_Name_NIfTI : file name of the file associate to voxel.
• Surgeon_ID : ID of the surgeon who make this file.
• Patient_ID : ID of the patient.
• Localisation : area of the brain.
• Point_Name : voxel name.
• Type_Of_Answer : brain fonctionnality associate to this voxel.
• X : X coordinate.
• Y : Y coordinate.
• Z : Z coordinate.
• Intensity : voxel intensity.

Only "File_Name_NIfTI", "Point_Name", "X", "Y", "Z" and "Intensity" are auto-implemented by the software. The others columns are here to add medical informations.