Difference between revisions of "Documentation/4.0/SlicerApplication/LoadingData"
Line 17: | Line 17: | ||
=Add Data= | =Add Data= | ||
The '''Add data''' dialog allows you to load virtually any type of data that Slicer can handle. It should be used as the default way of loading data, with the exception of DICOM which has its own interface. Data is added to the existing scene. | The '''Add data''' dialog allows you to load virtually any type of data that Slicer can handle. It should be used as the default way of loading data, with the exception of DICOM which has its own interface. Data is added to the existing scene. | ||
− | <gallery widths=" | + | <gallery widths="300px" perrow="4"> |
image:SlicerApplication-AddData-Empty.png|This is how the dialog looks like. | image:SlicerApplication-AddData-Empty.png|This is how the dialog looks like. | ||
image:SlicerApplication-FileAddData.png|File/Add Data | image:SlicerApplication-FileAddData.png|File/Add Data | ||
Line 27: | Line 27: | ||
==="Add Data" Functionality=== | ==="Add Data" Functionality=== | ||
*The '''Choose Directory to Add''' button adds all files inside the selected directory to the file list. | *The '''Choose Directory to Add''' button adds all files inside the selected directory to the file list. | ||
− | *The '''Choose Files(s) to Add''' button adds all selected files to the file list. | + | *The '''[[#Choose File Dialog|Choose Files(s) to Add]]''' button adds all selected files to the file list. |
− | *The '''Show Options''' checkbox shows/hides the option column which controls properties assigned to an object at loading time. Here you can identify a file as a label map or a streamline. | + | *The '''[[#Show Options|Show Options]]''' checkbox shows/hides the option column which controls properties assigned to an object at loading time. Here you can identify a file as a label map or a streamline. |
*The '''Reset''' button clears the entire list of files to load. | *The '''Reset''' button clears the entire list of files to load. | ||
*The '''Ok''' button loads all datasets in the list, and | *The '''Ok''' button loads all datasets in the list, and | ||
*The '''Cancel''' button aborts the entire load. | *The '''Cancel''' button aborts the entire load. | ||
− | ===Choose File Dialog=== | + | ====Choose File Dialog==== |
{|width="100%" | {|width="100%" | ||
|valign="top"| | |valign="top"| | ||
− | After clicking on the “Choose Files to Add” button, a new file dialog opens. | + | After clicking on the “Choose Files to Add” button, a new file dialog opens.<br> |
It is possible to select multiple files using ''CTRL-click'' and multiple contiguous files with ''SHIFT-click''.<br> | It is possible to select multiple files using ''CTRL-click'' and multiple contiguous files with ''SHIFT-click''.<br> | ||
{{warning}} Selecting a <code>.mrml</code> file will '''add''' all the files referenced in the scene; it is not necessary to manually select those files, they would be loaded twice. | {{warning}} Selecting a <code>.mrml</code> file will '''add''' all the files referenced in the scene; it is not necessary to manually select those files, they would be loaded twice. | ||
Line 43: | Line 43: | ||
|} | |} | ||
− | === | + | ===Show Options=== |
− | + | <gallery widths="300px" perrow="4"> | |
− | + | image:SlicerApplication-AddData-SelectedFiles.png|Once the files are selected in the '''Choose File(s)''' dialog, they are listed in the '''Add Data''' dialog. | |
− | + | image:SlicerApplication-AddData-ChangeType.png|You can review the selected files, and ensure they will be correctly loaded.<br> The checkbox in the '''File''' column control whether to load the file or not. <br> The '''Description''' column shows the type of file automatically detected. | |
− | |||
− | |||
− | |||
− | |||
− | You can review the selected files, and ensure they will be correctly loaded. | ||
− | |||
− | |||
It is used to select the reader to load a file. Some file extensions (e.g. <code>.vtk</code>) can contain different types, e.g. ''Volumes'', ''Models'' or ''Fiber bundles''. You must ensure the correct type is selected. | It is used to select the reader to load a file. Some file extensions (e.g. <code>.vtk</code>) can contain different types, e.g. ''Volumes'', ''Models'' or ''Fiber bundles''. You must ensure the correct type is selected. | ||
− | + | image:SlicerApplication-AddData-ShowOptions.png|Some types (e.g. ''Volumes'' or ''Scalar Overlay'') can take extra parameters before loading<br>Checking the box of '''Show Options''' shows a new column that contains the loading options if any. | |
− | + | </Gallery> | |
− | + | ||
− | |||
− | Some types (e.g. ''Volumes'' or ''Scalar Overlay'') can take extra parameters before loading | ||
− | |||
− | |||
− | |||
− | |||
=Add Volume Data= | =Add Volume Data= |
Revision as of 18:23, 20 February 2012
Home < Documentation < 4.0 < SlicerApplication < LoadingData
Contents
Introduction
Slicer can load a large variety of data in multiple ways. For Dicom data, please refer to the DICOM module documentation. For almost everything else (including scenes), you can use the Add Data dialog. For a listing of supported data formats see here. Please note that some of the formats listed are only partially supported.
For some of the more complicated formats (DWI in particular) it is recommended to first convert the DICOM data into the nrrd
format using the DICOM to nrrd converter and then to load the nrrd file into Slicer. Many vendors are using non standard way to describe their DWI data in the DICOM headers. The DICOM to nrrd documentation contains a listing of specific formats that have been debugged and tested.
Add Sample Data
This module downloads a number of sample data sets from the internet. These data sets can be used for testing of slicer capabilities. Please refer to the Sample Data module documentation.
Add DICOM Data
Beginning with Slicer 4.0, Slicer holds DICOM data in a local data base. DICOM data can be imported from disk or retrieved from a PACS system (after proper setup). Please refer to the DICOM module documentation.
Add Data
The Add data dialog allows you to load virtually any type of data that Slicer can handle. It should be used as the default way of loading data, with the exception of DICOM which has its own interface. Data is added to the existing scene.
"Add Data" Functionality
- The Choose Directory to Add button adds all files inside the selected directory to the file list.
- The Choose Files(s) to Add button adds all selected files to the file list.
- The Show Options checkbox shows/hides the option column which controls properties assigned to an object at loading time. Here you can identify a file as a label map or a streamline.
- The Reset button clears the entire list of files to load.
- The Ok button loads all datasets in the list, and
- The Cancel button aborts the entire load.
Choose File Dialog
After clicking on the “Choose Files to Add” button, a new file dialog opens. |
Show Options
Add Volume Data
This dialog is deprecated. The Add Volume dialog allows you to load volume files into the existing scene. |
There are 2 Ways to Open the Add Volume Dialog
|
Options
At the bottom of the dialog, a list of components offer options and controls on how to load the selected volume(s)
|
Favorites
When searching for files, in order to quickly find your data, it is possible to use favorites, symbolic links saved and restored for each session. |
|
To create a symbolic link, you drag&drop a directory from the right panel to the left panel. It will be remembered next time you start slicer. |