/**

\page org_mitk_views_datamanager The DataManager

\imageMacro{data-manager.svg,"Icon of the Data Manager",2.00}

\tableofcontents

\section QmitkDataManagerIntroduction Introduction

The Datamanager is the central componenent to manage medical data like images, surfaces, etc.. 
After loading one or more data into the Datamanager the data are shown in the four-view window, the so called Standard View.
The user can now start working on the data by just clicking  into the standard view or by using the MITK-modules such as "Segmentation" or "Basic Image Processing".

\imageMacro{QmitkDatamanager_Overview.png,"How MITK looks when started",16.00}


\section QmitkDataManagerLoading Loading Data

There are three ways of loading data into the Datamanager as so called Data-Elements.

The user can just drag and drop data into the Datamanager or directly into one of the four parts of the Standard View. 
He can as well use the Open-Button in the right upper corner. Or he can use the standard "File->Open"-Dialog on the top.

A lot of file-formats can be loaded into MITK, for example

<ul>
<li> 2D-images/3D-volumes with or without several timesteps (*.dcm, *.ima, *.pic, ...)
<li> Surfaces (*.stl, *.vtk, ...)
<li> Pointsets (*.mps)
<li> ...
</ul>

The user can also load a series of 2D images (e.g. image001.png, image002.png ...) to a MITK 3D volume. 
To do this, just drag and drop one of those 2D data files into the Datamanager by holding the ALT key.

After loading one or more data into the Datamanager they appear as Data-Elements in a sorted list inside the Datamanager. 
Data-Elements can also be sorted hierarchically as a parent-child-relation.
For example after using the Segmentation-Module on Data-Element1 the result is created as Data-Element2, which is a child of Data-Element1 (see Screenshot1).
The order can be changed by drag and drop.

\imageMacro{QmitkDatamanager_ParentChild.png,"Screenshot1",9.61}

The listed Data-Elements are shown in the standard view.
Here the user can scale or rotate the medical objects or he can change the cutting planes of the object by just using the mouse inside this view.

\section QmitkDataManagerSaving Saving Data

There are two ways of saving data from the Datamanger. The user can either save the whole project with all Data-Elements by clicking on "File"->"Save Project"
or he can save single Data-Elements by right-clicking->"Save", directly on a Data-Element. 
When saving the whole project, the sorting of Data-Elements is saved as well. By contrast the sorting is lost, when saving a single Data-Element.

\section QmitkDataManagerProperties Working with the Datamanager

\subsection QmitkDataManagerPropertiesList List of Data-Elements

The Data-Elements are listed in the Datamanager. 
As described above the elements can be sorted hierarchically as a parent-child-relation.
For example after using the Segmentation-Module on Data-Element1 the result is created as Data-Element2, which is a child of Data-Element1 (see Screenshot1). 
By drag and drop the sorting of Data-Elements and their hierarchical relation can be changed.

\subsection QmitkDataManagerPropertiesVisibility Visibility of Data-Elements

By default all loaded Data-Elements are visible in the standard view.
The visibility can be changed by right-clicking on the Data-Element and then choosing "Toogle visibility".
The box in front of the Data-Element in the Datamanager shows the visibility.
A green-filled box means a visible Data-Element, an empty box means an invisible Data-Element (see Screenshot1).

\subsection QmitkDataManagerPropertiesRepresentation Representation of Data-Elements

There are different types of representations how to show the Data-Element inside the standard view. By right-clicking on the Data-Element all options are listed (see Screenshot2 and Screenshot 3).

<ul>
<li> An arbitrary color can be chosen
<li> The opacity can be changed with a slide control
<li> In case of images a texture interpolation can be switched on or off. The texture interpolation smoothes the image, so that no single pixels are visible anymore.
<li> In case of surfaces the surface representation can be changed between points, wireframe or surface.
<li> Global reinit updates all windows to contain all the current data:

     -  The orientation of the worldgeometry, which basically defines the rendering space, is set to the standard coordinate system, i.e. [(0,0,1);(0,1,0);(0,0,1)]
     -  The size of the worldgeometry is calculated, so that it includes all loaded data (depends on size and position of your data)
     -  The spacing is set to the smallest existing spacing regarding your data

     Reinit updates a single data item and fits the windows to contain only this data item:

     -  The orientation of the worldgeometry, is aligned according to the orientation of the currently selected datanode
     -  The size of the worldgeometry is set to the size of the currently selected datanode
     -  The spacing is set to the spacing of the currently selected datanode

</ul>

\imageMacro{QmitkDatamanager_ImageProperties.png,"Screenshot2: Properties for images",10.56}
\imageMacro{QmitkDatamanager_SurfaceProperties.png,"Screenshot3: Properties for surfaces",11.01}


\subsection QmitkDataManagerPropertiesPreferences Preferences

For the datamanager there are already some default hotkeys like the del-key for deleting a Data-Element. The whole list is seen in Screenshot4.
From here the Hotkeys can also be changed. The preference page is found in "Window"->"Preferences".

\imageMacro{QmitkDatamanager_Preferences.png,"Screenshot4",16.00}

\section QmitkDataManagerPropertyList Property List

The Property List displays all the properties the currently selected Data-Element has. Which properties these are depends on the Data-Element. Examples are opacity, shader, visibility. These properties can be changed by clicking on the appropriate field in the "value" column.

\imageMacro{QmitkDatamanager_PropertyList.png,"Screenshot5: Property List",7.85}

*/
