.. data_explorer_help.rst

.. This is a port of the original SasView html help file to ReSTructured text
.. by S King, ISIS, during SasView CodeCamp-III in Feb 2015.

Loading Data
============

Introduction_

Load_Data_

Handy_Menu_

Activate_Data_

Remove_Data_

Append_Plot_to_Graph_

Create_New_Plot_

Freeze_Theory_

Send_Data_to_Applications_

.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ

.. _Introduction:

Introduction
------------

*Data Explorer* is a panel that allows the user more interactions with data. 
Some functionalities provided by the *Data Explorer* are also available through 
the context menu of plot panels or other menus within the application.

Under *View* in the menu bar, *Data Explorer* can be toggled between Show and 
Hide by clicking *Show/Hide Data Explorer*.

NOTE! When *Data Explorer* is hidden, all data loaded will be sent directly 
to the current active application, if possible. When *Data Explorer* is 
shown, data go first to the *Data Explorer*.

.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ

.. _Load_Data:

Load Data
---------

To load data, click the button *Load Data*, then select one or more (by holding 
the Ctrl key) files to load into the application. The name of each selected 
file will be listed. Clicking the *+*  symbol will display any available 
metadata.

.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ

.. _Handy_Menu:

Handy Menu
----------

Right-clicking on a loaded dataset (or model calculation, what SasView calls a 
theory) brings up a *Handy Menu* from which it is possible to access Data Info, 
Save the data/theory, or Plot the data/theory.

.. image:: hand_menu.png

.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ

.. _Activate_Data:

Activate Data
-------------

To interact with data it must be activated. This is accomplished by checking 
the box next to the data label. A green tick will appear.

Unchecking/unticking the box deactivates a data set.

There is also a combo box labeled *Selection Options* from which you can 
activate or deactivate multiple data sets.

.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ

.. _Remove_Data:

Remove Data
-----------

WARNING! *Remove Data* will stop any data operations currently using the 
selected data sets.


*Remove Data* removes all reference to selected data from the application.

.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ

.. _Append_Plot_to_Graph:

Append Plot to Graph
--------------------

Click on the button *Append To* to add selected data to a plot panel. Next to 
the button is a combo box containing the names of available plot panels. 
Selecting a name from this combo box will move that plot into focus.
 
If a plot panel is not available, the combo box and button will be 
disabled.

2D Data cannot be appended to any plot panels. This operation can 
only be performed on 1D data and plot panels currently containing 1D data.

.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ

.. _Create_New_Plot:

Create New Plot
---------------

Click on the *New Plot* button to create a new plot panel where the currently 
selected data will be plotted.

.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ

.. _Freeze_Theory:

Freeze Theory
-------------

The *Freeze Theory* button generates data from the selected theory.

NOTE! This operation can only be performed when theory labels are selected.

.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ

.. _Send_Data_to_Applications:

Send to Application
-------------------

Click on the button *Send To* button to send the currently selected data to 
a perspective (for *Fitting*, *P(r) Inversion*, or *Invariant* calculation).
 
The *Single*/*Batch* mode radio buttons only apply to the *Fitting* perspective.

*Batch mode* provides serial (batch) fitting with one model function, that is, 
fitting one data set followed by another. If several data sets need to be 
fitted at the same time, use *Simultaneous* fitting under the *Fitting* 
option on the menu bar.