.. ......................................
.. UHDAS/CODAS restructured text document
.. ......................................


.. dataviewer.py  documentation master file, copied from edit_doc 2018-09-03
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

.. _dataviewer-compare-mode:


Compare  Mode
---------------


Compare mode is basically Edit Mode but with these differences:

**added**

  - Panel Window:

         * ability to display 2 ADCPs
         * additional velocity DIFFERENCE fields between the two instruments

  - Control Window:

        * Selectors to manually edit either database

  - Topography Window:

        * choice of which sonar is displayed


**not present**

  - Seabed Selector
  - Thresholds




Overview of the Windows
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


**Control Window**:

The Dataviewer View Mode has 3 tabs.
     - **Plot**:  (:ref:`control  <compare_mode_gui_plot_tab_annot>`  what is viewed)
     - **Log**: show time ranges requested so far
     - **Help**: a little help (under construction).
       Most help is in the web pages you are reading right now


.. image:: /images/dataviewer_compare_mode/compare-mode-control_annot.png
   :alt: Panel window
   :scale: 70

|

**Panel Window**:

The only thing you can do in the panel window
is pan or zoom, but if multi-cursor is enabled in the Control window, the
red line in the panel plot matches the corresponding position in the topography
window.

Click :ref:`here  <compare_mode_dataviewer_panels_annot>` for an annotated snapshot.

.. image:: /images/dataviewer_compare_mode/compare-mode-panels.png
   :alt: Panel window
   :scale: 40

|


**Topography Window**:

The topography window is designed to view
ocean velocity vectors over ocean topgraphy.  You can change some of the
display settings (vector averaging in vertical and time, and length of
vectors).  You can pan and zoom (but the topography does not increase in
resolution).  If Multicursor is enabled in the Control window, the
red line in the panel plot matches the corresponding position in the topography
window.

In compare mode, you can also choose which sonar to view.


Click :ref:`here   <compare_mode_dataviewer_topofig_annot>` for an annotated example.

.. image:: /images/dataviewer_compare_mode/compare_mode_topography.png
   :alt: Topgraphy window
   :scale: 50


|

**Layout**:

The windows and controls are designed to have the panels on the right,
control on the bottom left, and topography on the upper left, but of
course you can do what suites you.

.. image:: /images/dataviewer_compare_mode/compare-mode-layout.png
   :alt: Panel window
   :scale: 30


(Return to :ref:`TOP<dataviewer-compare-mode>`)