Table of Contents

Name

TScan - A trivial scanner (event display)

Synopsis


tscan <options> 
  
Minimum useful syntax:
tscan -i <event_file_name> 
  

Description

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/

Tips

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.

Options and Resources

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.

Keystrokes

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 and Color Scale

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.

Files


X11 resources: 
   /usr/lib/X11/app-defaults/Tscan 
   $EXPERIMENT_ROOT/lib/app-defaults/Tscan 
   $XAPPLRESDIR/Tscan 
   $HOME/.Xdefaults 
  

Environment Variables


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 
  

Credits

Brett Viren wrote some of the improvements. This program could not work without many Super-Kamiokande libraries written by many people.

Author

Tomasz Barszczak, http://www.ps.uci.edu/~tomba/

See Also

zfscan, wgscan, yasukes, apdraw, ...
http://www.ps.uci.edu/~tomba/sk/tscan/

to Do


Add point-and-click-and-menu user interface. 
 The to-do list is MUCH longer but not included here. 
  

Bugs


There are probably many bugs and annoyances. 
  

$Id: tscan.man,v 1.13 2000/02/10 00:42:17 tomba Exp $ 
  


Table of Contents