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


States
---------

Gui is open, no cruise active
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


+------------------+---------------------+---------------+
|  **state**       |   **flags file**    |    **NOTE**   |
+------------------+---------------------+---------------+
|  UHDAS gui is on |     DAS.running     |               |
+------------------+---------------------+---------------+


Relevant files in ``/home/adcp/log``:

::

    - log2005_348_76679.txt.err
    - log2005_348_76679.txt
    - termos38log2005_348_76679.txt
    - termnb150log2005_348_76679.txt
    - oswh_term.log


Cruise active, not logging
~~~~~~~~~~~~~~~~~~~~~~~~~~~



+-------------------+----------------------------+---------------+
|  **state**        |   **flags file**           |    **NOTE**   |
+-------------------+----------------------------+---------------+
| UHDAS gui is on,  |    DAS.running             |               |
| cruise is started |    DAS_while_cruise.running|   link exists |
+-------------------+----------------------------+---------------+



Relevant files in ``/home/adcp/log/``:

::

    - DAS_while_cruise.log.err
    - DAS_while_cruise.log.warn
    - DAS_while_cruise.log

During a cruise
~~~~~~~~~~~~~~~~~~


- gui is running
- cruise is active
- logging is occurring



+-------------------+-----------------------------+---------------+
|  **state**        |   **flags file**            |    **NOTE**   |
+-------------------+-----------------------------+---------------+
|UHDAS gui is on    |    DAS.running              |               |
+-------------------+-----------------------------+---------------+
|cruise is started  |    DAS_while_cruise.running |  link exists  |
+-------------------+-----------------------------+---------------+
|logging is started |  - DAS.logging              |               |
|                   |  - DAS_while_logging.running|               |
|                   |  - (DAS_speedlog.running)   |(if configured)|
+-------------------+-----------------------------+---------------+


Relevant files in ``log/``:

::

  - DAS_while_logging.log.err
  - DAS_while_logging.log.warn
  - DAS_while_logging.log
  - DAS_speedlog.log.warn


**NOT RECOMMENDED**



Closing the UHDAS GUI during operation is NOT recommended, but here is what
you should see:



+--------------------+-----------------------------+------------------------------+
|  **state**         |   **flags file**            |    **NOTE**                  |
|                    |                             |                              |
|UHDAS gui is closed |                             |                              |
+--------------------+-----------------------------+------------------------------+
|cruise is started   |    DAS_while_cruise.running | link exists                  |
+--------------------+-----------------------------+------------------------------+
|logging is started  |   DAS.logging               |  (ser_* processes running)   |
|                    |                             |                              |
|                    |   DAS_while_logging.running |  (processing underway)       |
|                    |                             |                              |
|                    |   (DAS_speedlog.running)    |  (if configured)             |
+--------------------+-----------------------------+------------------------------+