Difference between revisions of "Documentation/Nightly/SlicerApplication/LoadingData"

From Slicer Wiki
Jump to: navigation, search
 
(8 intermediate revisions by 3 users not shown)
Line 4: Line 4:
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
  
 +
{{TOC_right}}
 +
 +
=Read this first=
 +
In most cases, "drag and drop" works as a way for loading data.
  
 
=Introduction=
 
=Introduction=
Slicer can load a large variety of data in multiple ways. For Dicom data, please refer to the [[Documentation/{{documentation/version}}/Modules/DICOM|DICOM]] module documentation. For almost everything else (including scenes), you can use the '''Add Data''' dialogue. For a listing of supported data formats see [[Documentation/{{documentation/version}}/SlicerApplication/SupportedDataFormat|here]]. Please note that some of the formats listed are only partially supported.
+
Slicer can load a large variety of data in multiple ways. For DICOM data, please refer to the [[Documentation/{{documentation/version}}/Modules/DICOM|DICOM]] module documentation. For almost everything else (including scenes), you can use the '''Add Data''' dialogue. For a listing of supported data formats see [[Documentation/{{documentation/version}}/SlicerApplication/SupportedDataFormat|this list]]. 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 <code>nrrd</code> format using the [[Documentation/{{documentation/version}}/Modules/DicomToNrrdConverter|DICOM to nrrd converter]] and then to load the nrrd file into Slicer. Many vendors are using non standard ways 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.
 
For some of the more complicated formats (DWI in particular) it is recommended to first convert the DICOM data into the <code>nrrd</code> format using the [[Documentation/{{documentation/version}}/Modules/DicomToNrrdConverter|DICOM to nrrd converter]] and then to load the nrrd file into Slicer. Many vendors are using non standard ways 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.
Line 19: Line 23:
 
The '''Add Data''' dialogue 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''' dialogue 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="300px"  heights="200px" perrow="2">
 
<gallery widths="300px"  heights="200px" perrow="2">
image:SlicerApplication-AddData-Empty.png|[[Documentation/{{documentation/version}}/SlicerApplication/KeyboardShortcuts|CTRL-A]] is an application-wide key combination for bringing up the Add Data dialogue.
+
image:SlicerApplication-AddData-Empty.png|[[Documentation/{{documentation/version}}/SlicerApplication/KeyboardShortcuts|CTRL-A]] (Command-A on Mac) is an application-wide key combination for bringing up the Add Data dialogue.
image:SlicerApplication-FileAddData.png|File/Add Data contains another link to bring up this dialogue
+
image:SlicerApplication-FileAddData-4.4.png|File/Add Data contains another link to bring up this dialogue
 
image:SlicerApplication-AddData-SlicerWelcome-mj.png|Shortcuts to the dialogue are in the Load/Save toolbar and in the [[Documentation/{{documentation/version}}/Modules/SlicerWelcome|Welcome]] module
 
image:SlicerApplication-AddData-SlicerWelcome-mj.png|Shortcuts to the dialogue are in the Load/Save toolbar and in the [[Documentation/{{documentation/version}}/Modules/SlicerWelcome|Welcome]] module
 
image:DragNDrop_Slicer.png|'''Drag & Drop''' multiple files (e.g. data, scenes etc.) and folders on the application will bring up the Add Data dialogue with the corresponding documents.
 
image:DragNDrop_Slicer.png|'''Drag & Drop''' multiple files (e.g. data, scenes etc.) and folders on the application will bring up the Add Data dialogue with the corresponding documents.
Line 31: Line 35:
 
*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 '''[[#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.
  
Line 43: Line 47:
 
<gallery widths="350px"  heights="200px">
 
<gallery widths="350px"  heights="200px">
 
image:SlicerApplication-AddData-SelectedFiles.png|Once the files are selected in the '''Choose File(s)''' dialogue, they are listed in the '''Add Data''' dialogue.
 
image:SlicerApplication-AddData-SelectedFiles.png|Once the files are selected in the '''Choose File(s)''' dialogue, they are listed in the '''Add Data''' dialogue.
image:SlicerApplication-AddData-ChangeType.png|You can review the selected files, and ensure that they were properly identified before loading.<br> The checkbox in the '''File''' column controls whether to load the file or not. This is handy, if you change your mind about which files to load.<br> The '''Description''' column shows the type of file automatically detected.
+
image:SlicerApplication-AddData-ChangeType.png|You can review the selected files, and ensure that they were properly identified before loading.<br> The checkbox in the '''File''' column controls whether to load the file or not. This is useful if you change your mind about which files to load.<br> The '''Description''' column shows the type of file automatically detected.
 
It is used to select the reader which loads 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 which loads 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 objects (e.g. ''Volumes'' or ''Scalar Overlay'') can take additional specifications before loading<br>Checking the '''Show Options''' box results in the display of additional columns containing loading options, if any.
 
image:SlicerApplication-AddData-ShowOptions.png|Some objects (e.g. ''Volumes'' or ''Scalar Overlay'') can take additional specifications before loading<br>Checking the '''Show Options''' box results in the display of additional columns containing loading options, if any.
Line 58: Line 62:
 
=Misc.=
 
=Misc.=
 
==Add Sample Data==
 
==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.  
+
This command provides an option to download a variety of anonymized datasets for learning and testing in Slicer. Because the datasets are hosted in a remote repository, a network connection is required to access them.  
 
* For more information about this module, please refer to the [[Documentation/{{documentation/version}}/Modules/SampleData|'''Sample Data Module''']] documentation.
 
* For more information about this module, please refer to the [[Documentation/{{documentation/version}}/Modules/SampleData|'''Sample Data Module''']] documentation.
 
<gallery widths="350px"  heights="200px">
 
<gallery widths="350px"  heights="200px">
Image:SampleData2012-02-21.png|The Sample Data Module allows downloading of sample data from a webserver.
+
Image:SampleData2017-10-10.png|The Sample Data Module allows downloading of sample data from a webserver.
 
</Gallery>
 
</Gallery>
  

Latest revision as of 19:35, 12 February 2019

Home < Documentation < Nightly < SlicerApplication < LoadingData


For the latest Slicer documentation, visit the read-the-docs.



Read this first

In most cases, "drag and drop" works as a way for loading data.

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 dialogue. For a listing of supported data formats see this list. 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 ways 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 Data Add DICOM Data Misc.

Add Data

The Add Data dialogue 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 Dialogue

Show Options

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).

  • For more information about this module, please refer to the DICOM module documentation.

Misc.

Add Sample Data

This command provides an option to download a variety of anonymized datasets for learning and testing in Slicer. Because the datasets are hosted in a remote repository, a network connection is required to access them.

  • For more information about this module, please refer to the Sample Data Module documentation.

Favorites

In order to quickly navigate to particular locations in your file system, it is possible to define shortcuts, also known as Favorites.

Information for Developers

Consider reading the Developers/IO page for information about programmatically loading and writing files.