RD Controls Software Release Note 144.8<P> <b> SwicDisplay</b>

RD Controls Software Release Note 144.8

SwicDisplay

John DeVoy

December 16, 1996

SwicDisplay is an X Window application that graphically displays SWIC readings. The data is displayed as a series of scans. The horizontal and vertical components of each scan are displayed as histograms. Additional information (position, gain, voltage, status) is displayed alongside the histograms. The data is collected at time T6 plus 8 seconds.

Starting

To run SwicDisplay, select ``SwicDisplay'' (item 32) from the menu, select ``EPCR SwicDisplay'' from the Epicure pull-down menu in the session manager, or type ``run epicure_programs:swicdisplay'' in any DECterm or DCL window.

Quitting

To exit SwicDisplay, select ``Exit'' from the ``File'' pull-down menu.

Groups

SwicDisplay displays SWICs in groups. The individual user may define both the list of groups that are available, and the contents of each group. To select a group, use the ``Group'' options menu on the main screen.

Inspecting Groups

To find out what groups are defined, and the contents of each, select ``Groups/SWICs'' from the ``Edit'' pull-down menu. The leftmost list in the dialog box is a list of all the groups that are defined. Selecting a group will cause the middle list to display the SWICs contained in that group. The list on the right is a list of all the SWICs in the database.

Adding a Group

To create a new empty group, type the name into the ``New Group'' text box. Then press the ``Add'' button to add it to the group. A new empty group will be created.

Deleting a Group

To delete a group, use mouse-button 2 to drag the name of the group to the garbage can. When the lid of the can opens, drop the group in. It will be deleted from the list.

Adding a SWIC to a Group

To add a SWIC to a group, first select the desired group from the list of groups. Then either: drag a SWIC (using mouse-button 2) from the list of SWICs on the right into the list of SWICs for the selected group; or type the name into the ``New SWIC'' text box and press the ``Add'' button. In either case, the SWIC will be added to the list of SWICs belonging to the selected group.

Deleting a SWIC from a Group

To delete a SWIC from a group, first select the desired group from the list of groups. Then use mouse-button 2 to drag the name of the SWIC to the garbage can. When the lid of the can opens, drop the SWIC in. It will be deleted from the list.

Specifying Scanner, High Voltage and FIFO Devices

Unless told otherwise, SwicDisplay assumes that device name of the scanner associated with a SWIC is the device name of the SWIC, with an ``S'' appended. The name of the high voltage device is assumed the be name of the SWIC with ``HV'' appended. Similarly, the name of FIFO (1032D) device is assumed the be name of the scanner with ``D'' appended. (The FIFO device is used to read the marker positions.)

To override the above defaults, select ``Groups/SWICs'' from the ``Edit'' pull-down menu. Select the desired SWIC from the list of SWICs in the database (that is, the rightmost list). Then specify a new device name for the scanner, high voltage device and/or the FIFO device.

Center Wire

At the user's option, a thick vertical line can be drawn to mark the center wires of the horizontal and vertical plots. Select ``Show Center'' from the options pull-down menu to toggle the center line marker.

Modes

The main screen of SwicDisplay displays data in one of three modes: ``All SWICs'' mode, ``All Scans'' mode, and ``All Spills'' mode. To select the mode, use the ``Mode'' options menu on the main screen.

All SWICs Mode

In ``All SWICs'' mode, one scan from each SWIC in the group is displayed. For each SWIC, the name of the SWIC is given by the SWIC label to the left of the horizontal plot. In this mode, the ``SWIC'' options menu on the main screen is disabled. The user may select the scan to be displayed using the ``Scan'' slider. Readings from any of the five previous cycles may be selected using the ``Relative Time'' slider.

All Scans Mode

In ``All Scans'' mode, all of the scans from a selected SWIC are displayed. For each scan, the number of the scan is given by the Scan label to the left of the horizontal plot. In this mode, the ``Scan'' slider is disabled. The user may select the SWIC to be displayed using the ``SWIC'' options menu. Any of up to five prior readings may be selected using the ``Relative Time'' slider.

All Spills Mode

In ``All Spills'' mode, a sequence of plots from the five previous cycles of a particular scan of a particular SWIC are displayed. For each plot, the relative time of the plot is given by the Time label to the left of the horizontal plot. The label ``Current'' identifies the most recent data, ``-1'' identifies the data immediately prior, etc., up to ``-5''. In this mode, the ``Relative Time'' slider is disabled. The user may select the SWIC to be displayed using the ``SWIC'' options menu. The scan to be displayed may be selected using the ``Scan'' slider.

Setting the Position, Gains, Voltage

The user may set the position, horizonal gain, vertical gain, and voltage of a SWIC. The current settings are displayed in a column to left of the horizontal plot, and are updated once a cycle. After specifying the new settings for all the devices that you want to change (as described below,) press the ``Set To'' button. The new settings will be sent to the device(s). If any settings cause an error, then a dialog box will be popped up that contains the text of the error message(s).

To specify the new position of a SWIC (in or out) use the toggle button next to the label indicating the current position. A label to the right of the button will indicate what the new setting will be.

To specify a new horizontal or vertical gain, type a new value into the appropriate text field next to the label showing the current gain. When it is sent, the gain will be rounded up to the nearest power of two.

To specify a new high voltage, type a new value into the voltage text field next to the label showing the current high voltage. If the high voltage cannot be set remotely, then this text field will be disabled.

Error messages

The most recent status returned from the SWIC scanner (along with a time stamp) is displayed below the horizontal and vertical plots. Since most of the data comes from the scanner, the full text of the status message is dislayed. The time stamp shown is the time at which the particular data being shown was collected. If the time stamp does not change from one spill to the next, it is assumed that the data is invalid, and a large ``X'' is drawn over the plot. The ``X'' is also drawn if the scanner returns no data for a particular scan. If the status indicates an error, then an abbreviated form of the message is also displayed in place of the horizontal and vertical gain readings.

If the high voltage device returns an error, then an abreviated form of the error message is displayed in place of the high voltage reading.

If the SWIC returns an error, then an abreviated form of the error message is displayed in place of the position reading.

If the FIFO device returns an error, then an abreviated form of the error message is displayed in the label that normally displays the marker positions.

Printing the screen

At any time, the user may send a screen dump to a PostScript printer.

To specify a print queue, pop up the Printers dialog box by selecting ``Select Printer'' from the ``Options'' pull-down menu. The dialog box presents a suggested list of printers. The user may select one of the suggested queues, or may type the name of a new one. The name of the queue will be remembered; it is not necessary to re-specify the queue each time.

To send a screen dump to the queue specified above, press the print button on the main screen. Be sure the main screen is uncovered before pressing the button.

Keywords: RDCS, SWIC, Beamline, tuning, X

Distribution: normal

Security, Privacy, Legal

rwest@fsus04.fnal.gov