Table of Contents
TScan - A trivial scanner (event display)
tscan <options>
Minimum useful syntax:
tscan -i <event_file_name>
Tscan is an event display.
The best way to use tscan is to put an xterm window at the bottom
left corner of the screen, start tscan there, put tscan window at top
right corner of the screen. This way you can see the text output in the
xterm window as you perform various operations in tscan. This output is
important, do not ignore it. Make sure that tscan window has the keyboard
focus, not the xterm window (move the mouse to it or click on it, depending
on your window manager setup).
Also make sure that your xterm has auto-wrap
around turned on, otherwise you might miss useful information in lines
longer than 80 characters as it happens sometimes with track information.
Also making the xterm window wider helps in such case.
For more description
go to http://www.ps.uci.edu/~tomba/sk/tscan/
It is very useful
to manipulate the range of the color scale while viewing the event. In
time (and residuals) view press "-" "=" to shift the scale and "_" "+"
to contract and expand it. It helps examine entry/exit points and searching
for muon decays. In charge view use "+" to examine areas with a lot of
charge (exit points for example). Also "z" and "Z" can help emphasize weak
rings.
To look around in various directions press the arrow keys and
"(" ")", which look like counter-clockwise and clockwise arrows. To start
moving the observation point inside (and even outside) of the detector
press "'". It changes the meaning of the arrow keys and "(" ")" from "turn"
to "shift". To move faster press "." to increase motion step. To fine tune
viewing position press "," to decrease motion step. Moving around is most
realistic in perspective and stereo views. Use "<" to zoom and ">" to have
wide angle view in perspective projection.
Of course at any time you
can resize tscan's window. The detector drawing will rescale automatically.
Type "tscan -help" to get a (hopefully) current
list of options.
After most options X11 resource string is shown in
parenthesis. You can see list of resources with default values in file
Tscan. Boolean resources can have value True or False.
Command line
arguments override X resources. If conflicting command line arguments are
given, last one is used.
- -i <filename> (inputFile)
- Input file name. If not
given tscan will start with a blank window.
- -zbs | -zform | -text (dataFormat)
- Format of the data file.
"zbs" is onsite format (default).
"zform"
is offsite format. It can also read onsite format in this mode, but mostly
only tube hit information is preserved and track information is lost.
"text" is a simple text format. It should be compatible with old format
developed by Clark McGrew, called stxt or superform. It is in the repository
in atmpd/src/examples/sform. You can find there documentation and sample
files.
- -apbnk <n> (apbnk)
- Bank number used to get track information. It
is passed directly to APRSTBNK. Default is 0 i.e. "best" bank will be picked.
-1 picks highest numbered bank. See aprstbnk.F and reconstruction code for
more info. Meaningful only in "zbs" file format.
- -skopt <NN,...> (skopt)
- Options
passed to SKOPTN before opening file in ZBS format. Argument is series
of numbers separated by commas with no spaces. Default is "31,30". 30 reads
event header. 31 reads PMT hits from TQREAL bank. Use 17 to correct OD timing
shift. Use 26 and 25 to remove bad channels. See skoptn.F for description
of available options.
- -pretty | -fast (drawing)
- Chooses default settings
to either improve appearance or to improve performance. Default is "pretty".
Affects "pmt_size", "pmt_style", "grid", "show_all_tracks".
- -colors <n>
(colors)
- Number of colors in color scale. Default is 16. If some colors
cannot be allocated warning messages are printed and the missing colors
are set to foreground color, typically white. If this happens either reduce
number of colors or exit other color-hungry applications like netscape
for example.
- -shape <shape> (shapeView)
- -[no]equal_area (equalArea)
- "shape"
selects view shape (projection) and "equal_area" selects detailed version
of the projection. "equal_area" mode typically preserves areas. To better
understand how some of the projections work, try to use grid type "map"
or "eye".
"cylinder" (default) is a cylindrical projection with a
view little distorted in the middle horizontal strip, even at the very
right and left edges of the view, and very distorted in the top and bottom
horizontal strips. Horizontal axis is the "phi" angle in spherical coordinate
system. Vertical axis is "theta" angle in "noequal_area" mode (default),
and "cos(theta)" in equal_area mode.
"unrolled" is just basic unrolled
view showing ID and OD simultaneously, one of them as a small inset in
the corner of the main view.
"perspective" is a perspective view. It
looks very real 3D with little distortion. Straight lines remain straight
in this projection, they are not curved as in other projections. It does
not show a 360 degree view as other views. The view angle can be set by
option or keystrokes. Changing it gives effect of zooming.
"stereo"
is a stereographical view. Two perspective views are shown side by side.
The left one is to be viewed by right eye, and the right one by left eye.
This is called "free viewing" (free of special 3D glasses). You just have
to be able to cross your eyes. To make it easier don't sit too close or
too far from the monitor, depending on your picture size. Put your finger
between the picture and your eyes, close to your eyes. Look at the finger.
Put it at such distance that the background SK image blends into 3 images,
the middle one is the stereo image. It is blurred as long as you focus
on your finger. Now the most difficult part. Try to focus on the SK image
without uncrossing your eyes. It may take a few minutes to learn to do
it. If you are far-sighted it might help to remove your glasses. Make sure
your eyes are perfectly horizontal. It can help to reduce image size, but
then finite pixel size can damage the stereo effect. It is better to increase
your distance from the picture instead. You can adjust distance between
eyes with -eye_base argument or with keystrokes "{" and "}". Theoretically
70 cm eye base is ideal for viewing objects 20-40 m away, but larger base
is default because of finite resolution. You can make base negative to
assign right image to right eye left to left. This is useful if you look
at the images through a pair of identical magnifying lenses. Decreasing
the view angle (zooming) can help improve the reality of images, otherwise
stereo effect and wide angle perspective give conflicting impressions
of distance. For best stereo effect a special viewing equipment should
be used.
"circle": Spherical coordinate system is mapped into flat
polar coordinate system on the screen. The spherical "phi" is mapped into
polar "phi". Spherical "theta" is mapped into polar "r" in "noequal_area"
mode, and Si(theta) (sine integral) in "equal_area" mode. View is little
distorted in the center and very distorted at the edges.
"hemispheres"
is very similar to "circle" view. The only difference is that the backward
hemisphere of the spherical coordinate system is mapped into separate
polar system. This reduces distortion in the backward direction (useful
for looking for back to back rings), but gives us two discontinuous views.
"globe" uses similar projections as for mapping Earth or sky. Horizontal
axis is essentially function of "phi", and vertical axis is function of
"theta". However the available width for "phi" is reduced as we approach
poles on top and bottom of the view, in order to preserve area. In "equal_area"
mode vertical axis is "theta" and the available width is proportional
to sin(theta). This is sometimes called "sine projection". In "noequal_area"
mode "Molleweide projection" is used to give a smooth elliptical shape
to the outline. It also preserves area, despite the mode name.
- -value <value>
(valueView)
- Show charge (default), time, residuals or long residuals.
Residuals are times with time of flight subtracted assuming all light
coming from vertex point. Long residuals differ in that light is assumed
to come from a long track.
- -tube_style <style> (tubeStyle)
- PMTs are drawn
either as "outline"s or "filled" (default).
- -tube_size <size_style> (tubeSizes)
- Shapes and sizes of individual PMTs.
"point": PMTs are drawn as points.
"fixed": PMTs are drawn as circles of radius independent of PMT distance
from the view point.
"by_distance": PMTs are drawn with circles of
radius which reflects PMT distance from the view point. Close PMTs are
drawn larger.
"real" (default): PMTs are represented in 3D space as
flat squares. Then they are realistically projected into the flat screen
view using current projection. This is the slowest mode, because 4 3D points
have to be calculated per PMT, and only 1 point per PMT is calculated
in other modes.
- -tube_sizing <sizing_mode> (tubeSizing)
- Describes how PMT
size is determined, independently of distance. Also "linear" and "log"
modes change the charge color scale to be proportional to square root
and logarithm (respectively) of charge.
"square" (default): PMT linear
size (e.g. circle radius or square side) is proportional to charge. This
means that PMT area is proportional to square of charge.
"linear":
PMT linear size is proportional to square root of charge. This means that
PMT area is proportional to charge.
"log": PMT size is proportional
to logarithm of charge, with minimum size 1 PE. This mode attempts to cover
large dynamic range of the charge.
"max": PMT size is maximal, all
PMTs have the same size.
"time": PMT size is proportional to the difference
of time of the hit and a middle of the time scale. This is useful in specialized
likelihood data (usually in text file format).
- -[no]show_non_hit (showNonHit)
- Enables showing of unhit PMTs in dim gray color. Their size is set to
1 P.E. Disabled by default.
- -[no]swap (swap)
- Swap ID/OD. Main view is ID
by default.
- -scale_horizontal | -scale_vetical (scaleHorizontal)
- Controls
where color scale and histogram are drawn. Possibilities are: vertically
on the right (default) or horizontally at the bottom.
- -grid <type> (grid)
- Drawing grid on the detector walls. The grid is drawn in dim grey color
except the corners of the detector or spherical equator are drawn in brighter
grey color.
"detector" (default): grid is defined by detector walls.
It helps visualising position of the observer in the tank and positions
of the rings on the tank walls.
"map": spherical grid is defined relative
to observer, with poles on top and bottom. It helps understand how some
of the projections work.
"eye": spherical grid is defined relative
to observer, with poles in front and behind of the viewer. It can help
to aim to a part of the detector before moving towards it.
"none":
no grid.
- -grids <n> (grids)
- Number of grid lines. Default is 4.
- -arrow_mode
<mode> (arrowMode)
- Controls how the arrow keys perform. In "turn" mode
(default) they turn the viewer around, while keeping its position fixed.
In "shift" mode they move the viewer around while keeping its orientation
fixed.
- -moving <mode> (moving)
- Controls how the arrow keys perform. In "detector"
mode (default) they move the detector (and whole virtual world) around
the fixed viewer. In "view_point" they move the viewer in a fixed virtual
world, in effect reversing the meaning of the arrow keys.
- -angle_step <degrees>
(angleStep)
- Magnitude of angular rotation by arrow keys. Default is
15 degrees.
- -shift_step <cm> (shiftStep)
- Size of motion step by arrow keys.
Default is 200 cm.
- -persp_angle <degrees> (perspAngle)
- View opening angle
in perspective view. The angle is measured from edge to edge of the viewing
area. It is not a half-opening angle. Default is 100 degrees.
- -eye_base <cm>
(eyeBase)
- Set distance between eyes used in "stereo" view. Default is
200 cm. See description of stereo view for more information.
- -[no]allow_behind
(allowBehind)
- Controls whether PMTs can be seen from behind when view
point moves outside of the detector. Most useful in perspective and stereo
modes. Allowed by default.
- -[no]square (square)
- Controls whether aspect
ratio of the projection is kept fixed (default) but usually wasting some
window space, or aspect ratio is set so that the view fills all of the
window, but possibly distorting the view.
- -[no]all_tracks (allTracks)
- Controls whether all tracks are shown (default) or only the selected
current track is shown.
- -[no]color_tracks (colorTracks)
- Controls whether
tracks are drawn in color (default) or not. Track color is determined by
track type (e.g. track bank name). Colors are picked uniformly from the color
scale. In "all_tracks" mode the selected track is usually white, and the
other tracks are dim grey or color.
- -ignore_tracks <track_type_list> (ignoreTracks)
- Selects which track types to ignore. The argument is comma separated list
of track types (e.g. track bank name), without spaces. No tracks are ignored
by default.
- -only_tracks <track_type_list> (onlyTracks)
- Selects which track
types to accept, the rest is ignored. All tracks are accepted by default.
- -track_weight <min_track_weight> (trackWeight)
- For tracks which have a
weight, only plot them if it is greater than the given value. Default
is 0.0, so all tracks are shows, whether or not there is a stored weight.
This currently only works offsite fitters using put_tracks_data().
- -[no]track_line
(trackLine)
- Each track has a short (currently 200 cm) line drawn from
vertex. Useful primarily after view point is moved away from vertex. Disabled
by default.
- -[no]k2k_dir (k2kDir)
- For each vertex mark on the detector
wall its projection forward along K2K beam direction with mark "K", and
projection backward toward KEK with inverted "K". Disabled by default.
- -[no]auto_view_point
(autoViewPoint)
- If set then every time new event is viewed view point
is automatically set to "good" position (default). Otherwise view point
is kept unchanged between events, initially set to detector center. In
most projections "good" position is the vertex of the current track. In
perspective view it is controlled by option -persp_auto.
- -view_angle <mode_or_track_type>
(autoAngle)
- In "fixed" mode view angle is kept unchanged between events,
initially looking in the -X direction, with Z axis pointing up and Y axis
pointing to the right.
In "inertia" mode (defualt) view orientation
is calculated based on eigenvectors of inertia tensor, where charge is
used as a mass. The view direction is chosen in the eigenvector associated
with the largest inertia, and "up/down" direction is the smallest inertia.
The goal is for the main plane of the event to be oriented horizontally
with the viewer looking toward most of the charge. E.g. for two ring event
in cylinder view, viewer should be facing somewhere between the rings
with the rings on the left and on the right, where projection distortion
is small.
When track type is given then the view direction is chosen
in the direction of the first track of the given type, and second track
the type is positioned exactly to the right of the first one.
- -[no]persp_auto
(perspAuto)
- If set (default) then in perspective view every time new
event is displayed observer is is put in a position from which most of
the event is visible in this view. It is important because unlike other
projections not all of the detector is visible (unless observer is positioned
outside of the detector). Instead of being put in the event vertex viewer
is put in a corner of the detector away from most of the charge. View angle
is towards center of the detector at 45 degree angle with respect to
horizontal direction. This option works correctly only if -noauto_view_point
is not used and -view_angle is not set to "fixed".
- -ev_skip <n> (evSkip)
- Number of events to skip from the beginning of the file. Default is none.
- -subev_skip <n> (subevSkip)
- Number of subevents to skip for the first
event displayed. Default is none. This option is mostly used by keystroke
"w".
- -track_skip <n> (trackSkip)
- Number of track selected in the first
event displayed. Default is 0. This option is mostly used by keystroke "w".
- -view_point <coord> (viewPoint)
- Coordinates of the view point to be used
for the first event displayed. Default is none. This option is mostly used
by keystroke "w".
- -view_basis <coords> (viewBasis)
- Coordinates of the three
basis vectors of the view direction to be used for the first event displayed.
Default is none. This option is mostly used by keystroke "w".
- -scales <ranges>
(scales)
- Ranges of all the scales used for the first event displayed.
Default is none. This option is mostly used by keystroke "w".
- -tube_size_scale
<factor> (tubeSizeScale)
- PMT size scale is usually tied to initial charge
scale for the event (and can be re-tied to a possibly modified by the user
scale by keystroke "Z"). The smallest PMT size is always determined by
the scale, independently of the "factor" (usually it is the bottom of
the charge scale). However the largest PMT size is determined by the scale
divided by the "factor" (default is 1.5). If factor > 1 then PMTs reach
maximum size before top of the charge color scale is reached. If factor
< 1 then PMT size still contains charge information even after color scale
has been exhausted.
- -[no]t_center_zero (tCenterZero)
- Force the time scale
to be centered on zero (disabled by default). Useful in specialized likelihood
views.
- -skgeom <file> (skgeom)
- Name of geometry file used. Deault is superk2.geo.
If the filename does not start with / then $SKAM/lib/<file> is used. If the
file does not exist then onsite geometry is used.
- -pixmap_width <w> -pixmap_height
<h> (pixmapWidth pixmapHeight)
- Used for saving image to a file (keystroke
"O"). Before saving it an invisible virtual window, called pixmap, is created
and the event is redrawn in it. Then the pixmap is saved to file. The pixmap
can have a different width and height than the tscan window. The purpose
of it is to enable saving images with sizes larger than the physical size
of the screen. Pictures needed for a printed publication sometimes need
to be huge. Without using pixmap only a visible part of the window can
be saved, even parts covered by other windows are not saved.
- -margin <fraction>
(margin)
- Each projection leaves fraction of the available window space
free around it. Default is 0.04.
- -scale_fraction <f> (scaleFraction)
- Fraction
of window space taken by color scale. Default is 0.005.
- -histo_fraction <f>
(histoFraction)
- Fraction of window space taken by histogram. Default
is 0.05.
- -[no]cms (cms)
- One of two color spaces can be used for defining
color scale.
CMS mode uses Tek HVC (hue, value, chroma) color space
which is included in X11 CMS (Color Management System) library. It is
supposed to have equal color distance between colors which have equally
spaced distances of their color coordinates. It is relatively computationally
intensive. However the results seem to be disappointing. The colors seem
to be distributed non-uniformly, some are under-represented, and some are
over-represented.
HSV (hue, saturation, value) (default) on the other
hand is a very simple transformation to RGB. It seems to give better results.
- -equalize <n> (equalize)
- Number of iterations (default 16) in a simple
algorithm designed to equalize color distribution in Tek HVC scale. Results
are poor however. Meaningful only in "cms" color mode.
- -hsv_adjustment <power>
(hsvAdjustment)
- Adjustment of "HSV" color scale. Meaningful only in
"nocms" mode. Default is 1.5. Some screens, especially laptop LCD screens,
over-emphasize low and high RGB values, while under-emphasizing values in
between. The effect is that red, yellow, green, cyan, blue and magenta
colors are over-emphasized, while colors in between are under-emphasized.
This adjustment changes this balance. For power > 1 the six main colors
are diminished. For power < 1 the six main colors are enhanced. Try extremely
large or small (close to zero) values to see better what it does.
- -hue_start
<hue> (hueStart)
- -hue_stop <hue> (hueStop)
- Minimal and maximal value
of the hue on the color scale in degrees. Default is 300 for start and
0 for stop. Stop can be lower that start to use the hue in reverse direction.
Also the values can go outside of 0-360 degree range to facilitate hue
ranges that span over the zero boundary (hue is periodic). Also note that
same hue values give slightly different colors for HSV and Tek HVC color
spaces. For HSV 0 is red, 120 is green, 240 is blue.
- -[no]rv (reverseVideo)
- Reverses background and foreground colors (disabled by default). Also
reverses "grey" and "dim_grey" colors. It can be useful for printing - possibly
improving appearance and saving color agent (ink, toner...). It also slightly
adjusts color scale by decreasing brightness of the brightest colors (e.g.
yellow) in order to increase contrast with bright background.
- -[no]greyscale
(greyscale)
- Chooses greyscale color scale (disabled by default). Useful
for black and white printing, perhaps together with option -rv.
- -bg <color>
| -background <color> (background)
- Background color. Default is black. Please
note that some desktop environments set a "*background" resource, without
any application name in front of the star, (frequently found in .Xdefaults
file) which affects background color of all applications which look at
the "background" X11 resource. This is in general a bad idea. This will
override tscan default (command line option still will override this).
- -fg <color> | -foreground <color> (foreground)
- Foreground color. Default is
white.
- -grey <color> (grey)
- Bright grey color. Default is grey50. This color
is used to draw corner edges of the detector grid and equator of the spherical
grids.
- -dim_grey <color> (dimGrey)
- Dim grey color. Default is grey30. This
color is used to draw most of the grid, unselected tracks in non color
track mode and unhit PMTs.
- -bw <n> | -borderwidth <n> (borderWidth)
- Width of
window border (an X11 thing, mostly unused) in pixels. Default is 4.
- -fn
<font> | -font <font> (font)
- Font name. Default is 8x13. Currently unused.
- -display
<display> (display)
- X11 display name to show tscan window on. A DISPLAY
environment variable is used by default.
- -geometry <geometry_string> (geometry)
- A usual X11 geometry (WWWxHHH+XXX+YYY). Default is 800x600.
- -title <title>
(title)
- Title of tscan window. It is often displayed by the window manager
above the window in its title bar. Default is "Trivial Scanner".
- -icon_name
<name> (iconName)
- Name of the icon. It is often displayed by the window
manager on the window's icon. Default is "T-Scan".
- -name <name> (name)
- Name
used to get resources from X11.
- -? | -help (help)
- Print a basic help.
- -help2
(help2)
- Print other options.
- -debug <level> (debug)
- Set debug level
used by skdebug() and tdebug(). Default is 25. The higher it is the more
information is printed in the xterm window. Levels above 40 enable more
debug printouts from onsite code.
- -[no]fake (fake)
- Use a fake event to
display. Disabled by default. Works only in zform file format. Used for debugging.
- -xrm <resource_string>
- Provide X11 resources. Not really useful because all
resources have corresponding command line arguments.
- -[no]dist_corr (distCorr)
- Distance correction to improve inertia tensor calculation. Disabled by
default. Experimental.
Press "h" in tscan window to get
help on keystrokes.
If there is some setting you want to change but
there is no keystroke for it however there is a command line option, then
you can use the following trick. Press "w" to save current detector state
into tscan-01.sh shell script. Exit tscan. Edit the script to change the desired
option. Run the script ("./tscan-01.sh" or "sh tscan-01.sh") and you will be
brought exactly to the state you left tscan, but with the change in effect.
Instead of editing the script you can call it with desired arguments in
the command line following the script name. The given arguments will override
any arguments in the script. If you do it frequently, maybe a keystroke
command should be added.
Make sure that tscan window has the keyboard
focus (not the xterm window) when pressing the keys described below.
Keystrokes are case-sensitive.
- q "Q"
- Quit. No confirmation question
is asked.
- h "?"
- Help. Displays short keystroke summary. If it has more lines
than window height, use xterm scroll-bar to see more of it.
- H
- Lists more
keystrokes.
- r
- Redraw. Clears the window and redraws it. Useful if there
are some unwanted graphical elements remaining.
- R
- Read file. Enter file
name in the xterm window at the prompt. Enter "0" to avoid reading a new
file (e.g. if you pressed R by mistake).
- j
- Jump to event. In the xterm window
enter run, subrun, event separated by spaces. Use "0" (zero) to ignore
the nuber, e.g. "9876 0 12345" will jump to run 9876 event 12345 no matter
what subrun it is in. Entering three zeros will avoid any jump at all.
- n
- Next event. One line information about the event is displayed in the text
window. First "event_count.subevent_count(total_subevents)" is shown. event_count
is sequential number of the event in the data-file. First event in the file
has number 1. subevent_count is 0 for the main event and 1 and more for
first and next subevents in the event. total_subevents is 0 if event has
no subevents, otherwise it shows how many subevents are in the event. This
is followed by "run.subrun.event date time" which is obvious.
- p
- Previous
event.
- N
- Next subevent, or if there are no more, next event. Number of
sub-events is displayed in the text window for every event.
- d
- Dump event
data. Event data summary, track information, color scale information,
etc. are printed in the xterm window. Count shows event.subevent, where events
are counting from the beginning of the current file starting with 1. Subevent
is 0 for the main event and increased by one for every next subevent
within this event. Next run.event.subevent is shown. trig shows trigger bits
hexadecimally. Time and date of the event is shown, followed by 48 bit
clock in microseconds followed by time difference from the previously
shown event, based on the 48 bit clock. If debug level is greater than
30 additional information about tracks is displayed, including projected
entry and exit points and coordinates of projections on nearest top/bottom/side
walls. Other information should be easy to understand.
- m
- Dump MC data. Works
only with ZBS file format.
- o
- OD/ID swap.
- O
- Dump current window into an
XPM (X pixmap) file. Only a visible part of the window can be saved, parts
covered by other windows are not saved. File name is event-NNNN.xpm, where
NNNN is sequential number starting from 0001. Existing files are overwritten
without asking. You can later convert the file into other formats. Here
are sample conversions to GIF and PostScript:
xpmtoppm event-0001.xpm | ppmtogif > event-0001.gif
xpmtoppm event-0001.xpm | pnmtops > event-0001.ps
Insert `pnmdepth 255' before `pnmtops' if you are dumping from a higher
than 8bpp display. You can also use other programs like xv or gimp for
the conversion.
- s
- Style of PMT (outline/filled) and non-hit PMTs shown/not-shown.
See options -tube_style and -show_non_hit.
- S
- Size of PMT (point/fixed/by_distance/real).
See option -tube_size.
- z
- siZing of PMTs (square/linear/log/max/time). Affects
charge scale too. See option -tube_sizing.
- Z
- siZes of PMTs are set according
to current charge color scale. Also see option -tube_size_scale for a related
information.
- t
- Type of value displayed: time/charge/residuals/long residuals.
See option -value.
- a
- Appearance. Chooses projection: cylinder/unrolled/perspective/circle/hemospheres/globe.
See option -shape.
- A
- Area - equal or not. Sub-Appearance. See option -equal_area.
- f
- Fixed/Flexible aspect ratio. See option -square.
- F
- Apply time of flight
(residual cut). The low and high cut value correspond to current low and
high ends of residual scale. Adjust it by adjusting the scale. You need
to press "F" again for the adjustment to take effect. Bug: the cut is not
saved to file by pressing "w".
- g
- Grid (detector/map/eye/none). See option
-grid.
- D
- Drawing pretty/fast. See options -pretty and -fast.
- c
- Cerenkov cone,
next. Selects next track. Detailed track information is displayed in the
xterm window. It includes track number, name and number of track type,
track number within the track type, vertex and time, direction, momentum,
Cerenkov cone opening angle, distance from the nearest wall, track length,
charge, weight, particle name, MCvisible flag, primary/child/info class.
If some information is not available for a particular track it is not
displayed. Note that Cerenkov cones are always drawn at maximum Cerenkov
angle, cone collapsing is not taken into account for low momentum tracks.
However if track Cerenkov angle is available, the cone is drawn at the
given angle. If track length is available then second cone is drawn at
the track stopping point. If length is not available then projected exit
point is found and second cone is drawn there. It is often not visible
(being only a single point), but is can be visible when the projected
exit point hits the wall at an oblique angle. Projected exit point is marked
by diamond, projected entry point is marked by a "+" mark. Projections
of the track on the top, bottom and side walls are marked by "x" marks.
- C
- Cerenkov cone, previous.
- b
- Bunch of cones, next. Displays all tracks
of the same type.
- B
- Bunch of cones, previous.
- T
- Track mode. Cycles through
modes of displaying tracks: all/one, color/grey. See options -all_tracks
and -color_tracks.
- V
- View to Vertex. Moves observer to vertex of currently
selected track.
- v
- Cycles through color modes (Video): light/dark background,
greyscale/full color. See options -rv and -greyscale.
- w
- Write current state
to a shell script file. When running the script you will be put in exactly
same event in same location and orientation, with same scale ranges and
same other parameters as when you wrote the state. Filename is used tscan-NN.sh,
where NN is sequential number starting with 01. Existing files are overwritten
without asking. You can edit the script to modify some settings. To run
the script type "./tscan-01.sh" or "sh tscan-01.sh". Bug: time of flight cut
(see key "F") is not saved.
- left "right" "up" "down" "(" ")"
- Arrow keys.
They move (rotate or shift) the view. You can imagine "(" being counter-clockwise
arrow and ")" a clock-wise arrow. Behavior of the arrow keys is modified
by other keystrokes and options. Use "," and "." to adjust motion step. Use
"'" to start moving (shifting the observer position) in the detector instead
of just turning around.
- ' (single quote)
- Switch arrow key mode: shift/rotate
the view. See option -arrow_mode.
- "" (double quote)
- Reverse meaning of arrow
keys (moving detector/view_point). See option -moving.
- < ">"
- Adjust perspective
view angle. See option -persp_angle.
- { "}"
- Adjust distance between eyes
used in stereo view. See option -eye_base.
- , "." (comma and period)
- Adjust
motion and turning step.
- - "=" (minus and equal)
- Shift color scale up/down.
"=" is usually "+" without shift. Most useful in time and residual views
when it moves the timing window around. For example shifting the timing
window while watching helps spot entering tracks. Also helps finding muon
decay.
Current range of the color scale is displayed in the text window.
- _ "+" (underscore and plus)
- Contract/expand color scale. "_" is usually
"-" with shift. Expanding charge scale helps examine hot spots, and expanding
time or residual scale helps put original track and muon decay electron
ring in range of one color scale. Contracting the scale helps examine details.
Histogram bins and color scale elements
are the same at the moment. Histogram accumulates number of hits per bin
in charge mode. In other modes it accumulates hits weighted by charge with
minimum weight of 1 PE. The first and the last bins are for overflow values
i.e. values out of range. Therefore minimum number of bins is 3. Also minimum
and maximum values of the scale, as reported in the text window correspond
to the upper edge of the lowest bin and lowest edge of the highest bin.
The histogram is automatically scaled to accommodate highest bin, but
the overflow bins do not participate in the scaling, so their contents
may be much higher than actually shown.
X11 resources:
/usr/lib/X11/app-defaults/Tscan
$EXPERIMENT_ROOT/lib/app-defaults/Tscan
$XAPPLRESDIR/Tscan
$HOME/.Xdefaults
DISPLAY - X11 display
TSCAN_RESOURCE_FILE - tscan X11 resource file
XENVIRONMENT - general X11 resource file
SKAM - SK directory, it contains geometry file in offsite format
Brett Viren wrote some of the improvements.
This program
could not work without many Super-Kamiokande libraries written by many
people.
Tomasz Barszczak, http://www.ps.uci.edu/~tomba/
zfscan, wgscan, yasukes, apdraw, ...
http://www.ps.uci.edu/~tomba/sk/tscan/
Add point-and-click-and-menu user interface.
The to-do list is MUCH longer but not included here.
There are probably many bugs and annoyances.
$Id: tscan.man,v 1.13 2000/02/10 00:42:17 tomba Exp $
Table of Contents