.. highlightlang:: us

.. index:: File=>Channel Quick View

.. index:: Channel Quick View
.. index:: File=>QV Channels
.. index:: File=>QV Files
.. index:: y^file-channel-quick-view

.. _filechannel-quick-view:
.. _file-channel-quick-view:

File=>Channel Quick View
------------------------

This command creates x/y or t/y overlay plots of selected channels for 
one or more data files.

The channel and file selection can be changes after the document has been
created. To access these commands add the toolbar buttons **File=>QV Channels**
and **File=>QV Files** to the user toolbar (see 
:ref:`tools-customize-user-toolbar`). 

* To use Quick View with Excel- or ASCII data files please check import options
  first. (:ref:`fileimport-options`). The following settings should be 
  selected for the example files :file:`\\UniPlot\\Addin\\rs_auto\\*.xls`:

  .. image:: S:/uniplot-obj/images/QV-Import-en.*

* To create a report with the quick view function, choose
  **File=>Channel Quick View** to open the following dialog box:

  .. image:: S:/uniplot-obj/images/QV-Select-en.*

* To specify the search filter for data files, click the
  **Search Filter** button to open the following dialog box:

  .. image:: S:/uniplot-obj/images/QV-Search-en.*

* Click OK to return to the **Select Files** dialog box.
  Choose the files :file:`Test1.xls` and 
  :file:`Test5.xls` and then press OK.

  .. image:: S:/uniplot-obj/images/QV-Select2-en.*

* In the following Channel Selection dialog box, choose ``EngSpd`` from
  the x-channel combo box and select ``EngPwr``, ``SAEPwr``, 
  ``SAETrq``, ``SB`` and ``SZ`` as y-channels.

  .. image:: S:/uniplot-obj/images/QV-Channel-en.*

  This will produce the following output:

  .. image:: S:/uniplot-obj/images/QuickView.*

**Modifying Templates**

The function **File=>Channel Quick View** uses templates files which 
are stored in the directory :file:`UniPlot\\Template\\QV`. New 
templates should be stored in this directory. If you modify the 
templates shipped with UniPlot, save them under a new name to avoid 
the files being overwritten by an UniPlot update.
Currently, UniPlot comes with 3 templates:

* :file:`default.ipw`: This template can plot up to 8 channels on one page. If
  for example you select 10 channels UniPlot will create a document with two
  pages. The first page would contain 8 diagrams and the second page 2 diagrams.

* :file:`Simple.ipw`: A very simple template
  with two template pages.

* :file:`SmallDiagrams.ipw`: A template with
  one page. The page contains 12 small diagrams.

Lets have a look at the template file :file:`default.ipw`.

.. image:: S:/uniplot-obj/images/QV-Default-en.*

The file contains 10 pages. The name of the first page is
``Background- Landscape``. This page will be used as the background for the
diagrams. The page contains two so called field functions, two place-holders
(text enclosed in ``$``- signs), a frame and a simple logo.

``@f{legendFile(Diagram 1)}{Legend}``

``@f{documentname(drive.path.name.ext)}{D:\UNIPLOT\TEMPLATE\QV\DEFAULT.IPW}``

``$(1)Page Title$``

``$(2)Page Subtitle$``

The ``Background-Portrait`` page will be used as the background page 
for pages in portrait format. This page is not used in this template. 
The pages with the names ``1`` to ``8`` are all in landscape format.

The two pages ``Background-Landscape`` and ``Background-Portrait`` 
are optional.

The following pages have the names ``1`` to ``8``. The number refers to the
number of diagrams in the page. Page ``1`` contains one diagram, page ``2``
contains two diagrams and page ``8`` contains eight diagrams. Example: If the
user selects 6 channels, the function **File=>Channel Quick View** uses the page
with the name ``6`` (if available). The page **must** contain 6 diagrams if the
page name is ``6``.

If you select 10 channels, the first page will show 8 channels and the 
second page 2 channels.

If you select 22 channels, a document with 3 pages will be created. 
The first page will show 8 channels the second page 8 and the third 
page 6 channels.

A template file does not need to have all consecutive pages. A template 
can contain pages with the names ``1``, ``2`` and ``4``.

**Modifying dataset styles**

In this version dataset styles are "hard coded". To change the colors, markers
etc. copy the file :file:`Script\\rs_qv_st.ic` into the :file:`uniplot/autoload`
directory or in the directory 
:file:`C:/Documents and Settings/User Name/Local Settings/UniPlot/autoload`.
Here you can modify the file. Choose :ref:`uniscript-save-execute` to translate 
the file.

**Programming**

The functions for the command **File=>Channel Quick View** can be 
found in the files :file:`rs_qv.ic`, :file:`rs_qv_dg.ic`, 
:file:`rs_qv_i.ic`, :file:`rs_qv_st.ic` in the 
:file:`script` directory.

::

   def Sample_1()
   {
       ssPath = GetRootDirectory() + "Samples/";
       svFiles = ssPath + ["Test1", "Test2"] + ".xls";
       ssXChannel = "EngSpd";
       svChannels = ["SB", "SZ", "EngPwr", "SAEPwr"];
       svText = ["Text1", "Text2"];
       bShowFileOpenDlg = 0;
       bShowChannelSelectDlg = 0;
       bShowTextInputDlg = 0;
       ssTemplate = "Default";

       rvOptions = [bShowFileOpenDlg, bShowChannelSelectDlg, bShowTextInputDlg]
       QV_MainProg(ssTemplate, svFiles, ssXChannel, svChannels, svText, rvOptions);
   }

.. seealso::
   :ref:`filefile-quick-view`,
   :ref:`datadata-exchange-(page)`

:sub:`id-127550`