AMS Geneva Memo

The SCOPE progam

The program SCOPE.EXE is a kind of digital scope. This program has been adapted to numerous hardware configurations, most probably you will use it with the Geneva PC test system or with the TDR VME system, or with a file.

This memo is not intended to be a complete user manual. I do expect people to play a little bit and figure out some obvious things by themselves.

You must have a good default.set file (look at AMS Geneva memo: The default.set file). The default parameters are read from it, but you will be able to change them interactively inside the program.

Most of the commands are just one letter, some other will need a numeric input.

The list of the most useful commands is displayed at the startup of the program. If the hardware is not present, the program will work anyway but using Monte Carlo data!

This program uses graphics and tries to guess your graphic card. You need to have the proper graphic driver for your graphic card and declared it in default.set

The commands:

single letter commands:

p: toggle between pedestal and no pedestal subtraction

a: toggle between common noise and non common noise subtraction

k: toggle clustering (needs pedestal and common noise subtraction)

t: toggle betwenn normal/test mode (not supported on all plateforms).

s: divide by sigma (not fully supported yet, can cause problems)

q: quit

up arrow zoom in vertical direction

down arrow zoom out vertical direction

prev page: pan up

next page: pan down

home: zoom in x direction

end: unzoom in x direction

r: reset to default coordinates

u: toggle between update and non update modes

w: toggle FFT

r: read temperature sensor (hexadecimal name and temperature in degrees C)

h: some cryptic help

v: shows the version of all libraries that were used to compile the scope program. Quote this every time you have a complain on the code.

use space bar to freeze display (in fact all non existing single letter commands will do that) then any key to continue

commands that request a numeric parameter:

n: change numbers of VAs (if in normal mode) go to VA n strip m (if in test mode).

d: change the dac value in MIPS

What the various things on the screen mean:

Status line on top of the screen:

AC: common noise is subtracted

DC: common noise is not subtracted

PED: pedestal are subtracted

MC: Monte Carlo data

SIG: sigma divided

TEST: test mode

INT: internal trigger

EXT: external trigger

WAIT: waiting for external trigger

FFT: fast Fourier transform applied

DYN: dynamical pedestal substraction

KLU: cluster algorithm applied

CUMUL: non update mode

the first number is the distance between 2 horizontal lines in ADC counts

the second is the value of the first horizontal line

the third is the value of the top of the screen

internal/external trigger

number of VA(S1 S2 K) (depends on actual hardware)

trigger to hold delay in nsec

DAC value

event number

Status line at bottom of the screen

first number: number of the first VA displayed the left of the screen

second number: unit for the distance between two vertical bars

Lines on the screen

horizontal green line indicates 0 level

horizontal blue lines indicates constant ADC levels, status line on top of the page enables to compute the value of each line

white line indicates good channel value

red line indicates bad channel value (good and bad as read from calib.cal)

Green surface indicates cluster (you need PED and AC and KLU)

Vertical lines delimitate VA (time in test mode, frequency in FFT)