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 Tools=>Customize User Toolbar).

  • To use Quick View with Excel- or ASCII data files please check import options first. (File=>Import Options). The following settings should be selected for the example files \UniPlot\Addin\rs_auto\*.xls:

    ../../_images/QV-Import-en.png

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

    ../../_images/QV-Select-en.png

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

    ../../_images/QV-Search-en.png

  • Click OK to return to the Select Files dialog box. Choose the files Test1.xls and Test5.xls and then press OK.

    ../../_images/QV-Select2-en.png

  • 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.

    ../../_images/QV-Channel-en.png

    This will produce the following output:

    ../../_images/QuickView.png

Modifying Templates

The function File=>Channel Quick View uses templates files which are stored in the directory 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:

  • 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.
  • Simple.ipw: A very simple template with two template pages.
  • SmallDiagrams.ipw: A template with one page. The page contains 12 small diagrams.

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

../../_images/QV-Default-en.png

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 Script\rs_qv_st.ic into the uniplot/autoload directory or in the directory C:/Documents and Settings/User Name/Local Settings/UniPlot/autoload. Here you can modify the file. Choose UniScript=>Save/Execute to translate the file.

Programming

The functions for the command File=>Channel Quick View can be found in the files rs_qv.ic, rs_qv_dg.ic, rs_qv_i.ic, rs_qv_st.ic in the 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);
}

See also

File=>File Quick View, Data=>Data Exchange (Page)

id-127550