International Atomic Energy Agency
Wagramer Strasse 5, P.O.Box 100, A-1400 Vienna, Austria
Tel:(+43 1) 2600-21714; Fax:(+43 1) 26007





ZVView
Graphic Software for Nuclear Data Analysis
Version 9.2

Download: /ndspub/zvview/






User's Guide


Created: by VZ, 11/1998
Modified: by PO, 05/1999
by VZ, 06/1999
by VZ, 10/1999












Viktor Zerkin, 1996-1999
zerkin@iaeand.iaea.org

















Abstract

ZVView is a multi-platform software designed for nuclear reactions data evaluators to perform efficient interactive visual analysis of cross section data retrieved from EXFOR and ENDF libraries. The main function of ZVView is plotting and inter comparison of data, including variety of options for looking into numerous details of graphical, numerical and bibliographic information involved, along with a possibility to analyse results of own evaluation. ZVView allows user to change plotting attributes, logarithmic and linear scales, zooming, split plot to sub-windows, smoothing by least square method, choose authors to be plotted and scan their points, changing language on the fly, saving picture in Postscript and PCX formats, etc.


1. Technical Requirements

ZVView has been developed, tested and installed on the following platforms:
OS Processor Executable Size Graphics Requirements
Open VMSDEC-Alphazvv90a.exe512.Kb X-windows VMS-7.1
DECUNIXDEC-Alphazvv88u.exe472.Kb X-windows  
AIX-4.2RS6000zvv88r.exe719.Kb X-windows  
LinixIntelzvv90l.exe796.Kb X-windows  
MS-DOSIntelzvv88d.exe 125.Kb EGA
VGA
SVGA
MS-DOS 3.3 and higher, MS-Mouse driver for modes higher than 640*480, ~500 Kb RAM available for EXE programs (depends on data)
W-3.1/9x/NTIntelzvv88w.exe263.Kb any 16-bit
W-9x/NTIntelzvv90nt.exe260.Kb any 32-bit


2. Installation

2.a) Installation for standalone use

VMS-7.1
Define symbol ZVV:
..$ zvv:==$sa1:[path]zvv89a.exe
To run Zvview use symbol ZVV in Unix style (see Example 1.)

MS-DOS, Linux, DECUNIX, AIX/R6000
Copy executable into directory that is included into the system environment PATH. To run ZVView type executable name with parameters (see Example 2.)

Windows-3.1, Windows-95, Windows-NT
Associate* files of the type .zvv, .zvd with application \path\zvv88w.exe
Prepare by any editor text file with extension .zvv putting there list of parameters (see Example 3.).
Double click to the file .zvv will invoke ZVView.

* You may associate files with extension .zvv by double clicking or "more manually":
Example for W-NT:
Explorer --> View --> Options --> File Types --> New Type --> fill in form:
    Description of Type:    zvd
    Content Type (MIME):    images/zvd
    Default Extension:      zvd
    Action:                 open


  --> Edit --> fill in form:





2.b) Installation for use with Web browser

Netscape 3.
On Alpha VMS check symbol:
$ sh sym zvv
$ zvv=="sa1:[pubsoft.zvv]zvv_alpha.exe"
    --> Options
        --> General Preferences
            --> Helpers
                --> New
                    --> Set up:
                          Description: ZVD
                                 Type: images/zvd
                               Suffix: zvd
                  [check] Application: zvv %s


Netscape 4.
    --> Edit
        --> Preferences
            --> Navigator
                --> Applications
                    --> New Type
                        --> Set up:
                         Description Type: ZVD
                           File extention: zvd
                                MIME Type: images/zvd
                       Application to use: /path/zvview.exe %1
                    for Unix: Application: /path/zvview.exe %s


Internet Explorer.
It will work automatically if you already installed ZVView for standalone use. If not, Explorer will propose you to define Application for file extention 'zvd', and you will define ZVView (see 2.a).

Operations with use ZVView as a helper (viewer) have been checked in the following environment: Netscape Navigator and Communicator on VMS, DECUNIX, W-3.1, W-95, W-NT, Linux and Internet Explorer on W-95, W-NT.


3. Execution

ZVView can handle up to 16 different files with data in several formats. User either supplies specification for files to be preceeded, or uses files with 'default' extensions. The format and content of data files can be specified by option (switch) that follows the file name:
/t - experimental data, computational format '.table' generated by CSISRS*
/r - reference file '.xref' generated by CSISRS*
/d - evaluated data, computational format '.dat' generated by ENDF*
/3 - evaluated data in ENDF format, MF=3 (point wise data)
/u - title (control) file
    * On-line Nuclear Data Services on Alpha/VMS

Default extentions (case insensetive):

        /t   .TABLE, .TAB
        /x   .XREF, .XRE
        /d   .DAT
        /3   .DAT3, .MT3
        /u   .TITLE, .TIT, .TXT
Each file can contain several functions, total number of functions in all files is limited to 16.

Example 1: Open VMS execution command involving 4 data files and 1 text (title) file:
run ZVView:
    $ zvv f1.dat/3 f2.dat/d f3.table/t f3.xref/r title.tit
If ZVView is invoked without parameters, it expects existence of the file 'execute.zvv'. The code reads this file line by line, and looks for names of data files.

Example 2: file 'execute.zvv' consists of 4 lines containing names of 3 data files and 1 text file:
execute.zvv:
    f1.dat/3
    f2.dat/d
    f3.table/t
    title.tit
run ZVView:
    $ zvv 

Example 3: file 'execute.zvv' consists of 1 line with the name of the composite file 'al27na.zvv', where the file 'al27na.zvv' consists of 6 lines with names of 5 data files and 1 text file
execute.zvv:
    @al27na.zvv
al27na.zvv:
    al27na.table/t
    al27na.xref/r
    al27na_6.dat/d
    al27na_f.dat/d
    al27na_r.dat/d
    title.tit
run ZVView:
    $ zvv 

It should be noted that, as soon as the reference file exists, it must follow the table file. The files f1.dat, f2.dat, f3.table, f3.xref are nuclear data files, the file title.tit is the text file.

The 'title.tit' contains the title (header) of the graphical image created by the ZVView, names of X and Y axis, type of scales, ranges of scales, grids, initial size of window, appearance of buttons and text information about comparing functions. All those parameters are optional and are applied if they appear in the 'title' file. In an example below, the 'title.txt' consists of 20 lines:
title.txt:
    tit: {+55}Mn(n,{|g}){+56}Mn
    tit2: Experimental data and evaluations
    x-scale: log
    y-scale: log
    x-units: kev
    y-units: barn
    y-range: 1E-4 1e2
    x-range: 1e-4 1e5
    x-grid: 0
    y-grid: 1
    lx-win: 1000
    ly-win: 700
    buttons: 1
    nostat: 1
    x: E
    x-long: Incident Energy
    y: Cross Section
    !neq: all
    eq: 30942002 = 30982002
    eq: 40975 = 41001
    neq: 40244


4. How it works

ZVView works with functions Yi=Y(Xi), where i is the index of the data point of a given function. Each function represents a set of data points such as experimental cross sections of 1 or several experiments retrieved from the CSISRS database, or a curve of cross sections retrieved from an evaluated data library. The functions are identified by their sequence number f1,f2,...,f64 (16 for versions below 8.9). The sequence numbers are generated by ZVView.

After loading the data, the code identifies functions and defines 'Automatic range' using min and max of X and Y for the whole set of functions. Then, the code generates a window on the screen, creates plots of X and Y axis, followed by plots of each function. Functions are plotted in different style, depending on the type of data. Finally, the code writes explanatory information at the bottom of the screen, draws the MARKER and waits for commands from user.

User can give commands by a keyboard or by a mouse. The code ZVView analyzes the command and executes it.

A lot of commands can be given by using the MARKER that marks a data point of selected (currently scanned) function. The code draws graphical presentation of the MARKER at its actual location. At the bottom of the screen, the code provides numerical information describing the MARKER location (sequence number of the data function, index referring to the marked data point, its absolute position in terms of X and Y values - see Fig.1). In addition, for each function, the code identifies a point (X) located next to the marker and provides information on its index, Y-value and the corresponding X-value.

At the beginning, the MARKER is drawn like a short line under the point referring to the index 1 of the function no 1, that means the point [X(1),Y(1)]. User can move MARKER in different directions by increasing or decreasing an index of the marked point, or by changing the number of the marked function. MARKER location can be used in different ways, for example as a point to define a new range of the displayed window.

Fig.1 explains meaning of terms adopted in present document.


Fig.1.
n Term Explanation
1 Marker Pointer to current position of currently scanned function
2 Marked Point Point on currently scanned function reffered by Marker
3 Marked Function Currently scanned function
4 X-Range Currently displayed window on X-axis
5 Y-Range Currently displayed window on Y-axis
6 Plank Bar showing current X, Y ranges on automatic range.
7 Statistics Information to compare functions
8 Nearest Point Point on each function with X nearest to Marker: Index, Y, X
9 Local Maximum Maximum Y of each function in current X-Range
10 Marker Location Index, X, Y (Marker) and related information (depend of function)
11 Marker Location Short help

5. Interaction

User can interact with ZVView in several ways explained below.

  1. Move MARKER along .
  2. Change displayed window by setting .
  3. Change function attributes .
  4. Other plotting settings .


6. Dialogue

In order to input parameters or make a choice, ZVView uses dialogue systems 'Input' and 'Menu'. 'Input' allows user to input different types of parameters (strings, numbers, alternatives and others). 'Menu' provides choice from a set of alternatives.

Command
(Key)
Response
'Input' features
Enter
ESC
After user types a string, Enter (VMS: Return) and ESC keys should be used to accept / reject the string
When user does not change the value of the string where the cursor is located, Enter and ESC keys should be used to accept or reject the whole table
Left, Right, BackSpace, Insert, Home, End, Delete Provide the usual effect
Up / Down Go to previous/next input field
F1 Short help appears
F2 Menu mode for choice among several values of alternative

'Menu' features
Enter Accept the choice
ESC Reject the choice


7. Saving Pictures and Printing


7.a) Saving Picture in PCX file

For VMS, Linux, MS-Windows, DECUNIX, AIX:
LShift/D:
create color '.pcx' file
LCtrl/D:
create black and white '.pcx' file
For MS-DOS:
Alt/Shift/D:
save screen in '.pcx' file
Use PaintBrush to edit and print under Windows.
Use XV (Unix,VMS,...) to save in GIF format and then print by NETSCAPE or save by XV directly to .PS format.


7.b) Saving Picture in PostScript file.

PostScript output realized by ZVView 8.9 and later versions.
LShift/P
then, after additional dialogue program will create files in current directory with names: zv00.ps, zv01.ps, etc.


Appendix 1.

Summary of Commands

The Appendix summarizes commands that can be used by a user. Specified below is a command (a character to by typed, or a key to be pressed at the keyboard) and the response of the ZVView.

Command Response
Key(s) MouseButton* [SubCommand Response]
*Note: a) You can use (click by mouse) those buttons to call most of given commands
          b) After mouse stays a few seconds at the button a small help will appear
F1 On-line help
F2 On-line menu
Esc, Q Quit
Shift/K Draw/not buttons at the top of screen

a. Marker Movement
arrow Left, Right Change index by +1, -1
arrow Up, Down Change function number by +1, -1
Ctrl/Left, Ctrl/Right Jump to next or previous peak
Home, End Go to begin or end of X-axis window
*Note: In the Open VMS use keys <InsertHere>, <Remove> instead of <Home>, <End>.

b. Window Changing

The window, that means that part of the full plot that will be actually displayed at the screen, can be changed in 3 ways. By setting the position of the marker at the boundary of the displayed plot, by selecting a space around the marker, and by commands defining the scale.
[   ] X boundary (left/right) set up to X(Marker)
B H Y boundary (top/bottom) set up to Y(Marker)
Space X scale set up to +-1% points around marker
LShift/Space X scale set up to +-2% points around marker
RShift/Space X scale set up to +-5% points around marker
Shift/A   Window adjusts to starting scale
PageDown, PageUp Set next/previous X-axis window
Y Set Y-window automatically, X-window does not change
Shift/Y Set "some" percents for Y-window
X   Set X-window automatically, Y-window does not change
+ - Increase/decrease X-axis window size (each step = 2x)
A Set new Y-window and X-window manually
L Set Logarithmic/Linear Y-scale
Shift/L Set Logarithmic/Linear X-scale

c. Handling

User can modify displayed functions by several commands. (Function means a set of experimental data as generated by CSISRS or a curve of evaluated cross sections from ENDF/B).
S Input parameters: How to draw function
Last option: Smoothing draw/not
LShift/S Setting of smoothing parameters
Note: 'Type' means level of smoothing, if type=0: the code does not draw the curve
E Exclude/include functions from picture
K Define quadrant for functions
R   Redraw (refresh) picture
C On/off multi-windows screen
P On/off Range-Bar
N On/off statistics at the bottom of the screen
O Draw graphic marked function only (exclude others)
I Invert palette of the screen
M Change shape of the MARKER in the following sequence:
short --> long --> short [X-value] --> short [Y-value] --> short [X-value][Y-value] --> short
RShift/M Rotation of text over the MARKER
T Leave MARKER on the screen
Note: After redrawing screen these images disappear

d. Save Picture
LShift/D   Create 256-color zvXX.pcx file in current directory
LCtrl/D   Create black/white zvXX.pcx file in current directory
LShift/P After input parameters and confirmation, creates zvXX.pcx file in current directory
Note: If you already have driven authors list, it will appear automatically in your PostScript output.

e. Other Commands
F4 Scan list of authors of data of the marked function.
Then:
I insert/not to the list of viewed authors (yellow)
Enter scan the table of experimental points of chosen author
Esc go back to Marker
F5 Scan list of experimental points around the Marker.
Then:
Enter set Marker to the chosen point
Esc go back to Marker
F Set regime same/different symbols for drawing of points
LShift/U
RShift/U
U


Draw legends of curves and authors which have point in current window
Draw legends of curves and all authors
Draw legends with last location of the box and other parameters.
Then:
Mouse left button drags the table to new location on the screen
R refresh the picture
S Set parameters of legend box:
user can split box with legends to several parts, set up their width and location; then move them by mouse on the screen separatly.
Esc go back to Marker