Home

Tv User-Manual Andreas Fitzler1 Institute for Nuclear Physics

1. 6 tv gt window view full y S nS window view smeteh DD tv gt window view full y E window view smeteh remeras tv gt window view full y S E window view siech awe O OOO To be continued 85 tv gt window view full y iS window view HY O tv gt window view full y E gt wadon vex Y Ftv spectrum update ally dP tv gt window view full y tv gt window view shift 70 0 0 0 tv gt keyalias List all hotkeys in text window tv gt fit param backgr free tv gt fit param expo free tv gt fit param fact free tv gt fit background create tv gt fit param backgr hold tv gt fit param expo hold tv gt fit param fact hold tv gt window show fit function marker po AAN i Tel rerea o Ea tv gt window show fit decomposition tv gt calibration position read cal for all spectra loaded tv gt fit region create active tv gt fit status short a tv gt window show fit function marker G tv gt fit read bin position cursor tv gt window show fit function marker i EE tv gt cut read cut position cursor I G n tv gt cut read head position cursor I G G tv gt cut marker gate enter cursor Defines a gate marker tv gt fit parameter position hold Prevent peak position from being fitted i fitted tv gt fit integration create active Integrate active spectrum and MEH portas o tv gt window setup keyboard focus cursor Set keyboard to graphic window iU wen eud wn No t
2. Execute system command Execute command file Comment Carriage Return Escape Give a listing of available commands String contents will not be evaluated Parenthesize Insert value of argument n S ENVIRONMENT Insert content of environment variable ENVIRONMENT unix command The result of the unix command will be inserted at the place of this expression E g look at the alias for help ESC Toggle between edit and cursormode Ctrl C Leave Tv Es ella filename evaluation like bin ls see spectrum get ya Table 3 2 Summary of the command line interpreter s special characters them you must not do that if you want to use them again For example to define an alias to switch the y scale to logarithmic enter tv gt alias lin window setup function y logarithmic window setup function y normalization on window setup function y normalization off lt no arguments gt Pay attention to enclose the second and third argument in double quotes if you use definitions consisting of more than one word The third argument is appended to the usage message printed by lin alias without arguments prints all aliases known to the current menu unalias lin deletes the alias lin You may use commandline arguments or environment variables in the second argument following the same convention as in common shells like the bash To program an alias to switch the y scale according to a given commandline argument e
3. If no filename is defined the filename according to the wildcard setting will be used tv gt window plot create xfig filename Creates a plot in xfig format protocol 3 2 tv gt window plot format 6 9 7 tv gt window plot format cm format lt x gt lt y gt Defines the plot size in cm tv gt window plot format px format lt x gt lt y gt Defines the plot size in pixels tv gt window plot format pts inch lt x gt lt y gt Defines the resolution for the plot in points per inch tv gt window plot format fontscale factor lt factor gt Defines the scale factor for fonts Window raise tv gt window raise lt window name gt Raises window lt window name gt 6 9 8 Window redisplay tv gt window redisplay Refreshes the active window 76 CHAPTER 6 COMMAND SUMMARY 6 9 9 Window scaling tv gt tv gt tv gt window scaling function y tv gt window scaling function y linear This command prepares linear y scales tv gt window scaling function y logarithmic This command prepares logarithmic y scales tv gt window scaling function y normalization on off This command switches to prepared y scales tv gt window scaling function y squared This command prepares quadratic y scales window scaling modification y tv gt window scaling modification y no modification Cancels all y scale modifications tv gt window scaling modification y efficiency tv gt window scal
4. tv gt cut rm cut lt filename gt Remove cut lt filename gt from the attached cut directory tv gt cut rm fit lt filename gt Remove fit lt filename gt from the attached cut directory tv gt cut rm spectrum lt filename gt Remove spectrum lt filename gt from the attached cut directory 6 3 11 Cut status tv gt cut status Prints status information about all cuts and their attachments 6 3 12 Cut scale tv gt cut scale i o calibrated default uncalibrated Adjusts the scale for writing or reading of markers tv gt cut scale marker calibrated default uncalibrated Adjusts the scale for marker gueries 6 3 13 Cut use marker tv gt cut use marker lt index gt The markers from cut lt index gt will be used for the active cut 6 3 14 Cut write tv gt cut write cut Writes the active cutmarkers and cutspectrum tv gt cut write head Writes the active cutmarkers 6 3 15 Cut weight tv gt cut weight gatewidth The gatewidths are used for the weight calculation tv gt cut weight fit The background volumes are used for the weight calculation 62 CHAPTER 6 COMMAND SUMMARY 6 4 Fit 6 4 1 Fit activate tv gt fit activate index lt index gt next previous status Activates spectrum in buffer lt index gt the next or previous buffer or prints status information about loaded buffers and active fits and cuts 6 4 2 Fit background create tv gt fit background create Creates a background f
5. tv gt fit function background definition exponential BG 0 Bn gt a 20 FAC cap a zo EXP Bn background coefficient parameter Xo offset for numerical optimization during the fit FAC factor of exponential term EXP scaling of exponential term D 3 Measure functions tv gt fit measure definition dy chi sguare Minimization of x weighted by data errors Maximization of a gauss distri bution apse Lega i f fit function X channel Y spectrum value of channel X dY error of Y tv gt fit measure definition y chi square Minimization of x weighted by data Maximization of a gauss distribution dat X Y chi f y geg dus Ge f fit function X channel Y spectrum value of channel X tv gt fit measure definition poisson Maximization of a poisson distribution dat Xx P f Tico A APA f fit function X channel Y spectrum value of channel X 106APPENDIX D THE FIT BACKGROUND AND MEASURE FUNCTIONS The really maximized and printed measure is the function G f n P f C numdata Yr X 08 i 0 Groes Ini Appendix E License Agreement The authors J Theuerkauf S Esser S Krink M Luig N Nicolay O Stuch H Wolters at thc Institute for Nuclear Physics Cologne herc inafter referred to as IKP grant to the user a non transferable and non exclusive license to copy and use Tv under the following terms and condi
6. lt index gt tv gt spectrum delete lt index gt copy copies buffer lt source index gt to buffers lt destination index gt create creates an empty spectrum with name lt name gt and resolution lt resolution gt in buffer lt index gt delete removes spectra from buffers lt index gt You can perform the delete operation with hotkey x 4 5 Using the mouse The usage of the mouse is described in section 3 5 on page 19 4 6 Plot and labels Labels are used to mark points in a spectrum e g a peak They have no effect to any operations in Tv Labels consist of an info string and a position on one axis of a spectrum The info string is normally generated automatically by Tv and contains the energy calibrated or not Labels allow the user to define an own info string The position may be on the x axis labels and vertical markers or on the y axis horizontal markers The position of the info string on the other axis is calculated by Tv You can set labels for peaks fits and cuts as well as user markers whereat you can define any combination of the calibrated and uncalibrated position and the info string to be printed You define a label with the command which takes a position as argument by default tv gt label user enter cursor value offset The combination of data to be printed at the label can be defined with the following command where pairs of arguments function like switches For example calibrate
7. status vSpace status hSpace status allowResize position label VSpace hSpace allowResize aned gray75 white white white white white gray75 white white oo ORF FH True APPENDIX B XRESOURCES wn YTT False Xtv monochrome GowVsWidget cursorForeground Xtv monochrome GowVsWidget cursorBackground Xtv gray GowVsWidget cursorForeground Xtv gray GowVsWidget cursorBackground Xtv colored GowVsWidget cursorForeground Xtv colored GowVsWidget cursorBackground 100 pirate solid 0 0 0 0 0 0 02 0 15 Xtv GowVsWidget height Xtv GowVsWidget cursor Xtv GowVsWidget cursorLinestyle Xtv GowVsWidget cursorLinewidth Xtv GowVsWidget xClipMin Xtv GowVsWidget xClipMax Xtv GowVsWidget yClipMin Xtv GowVsWidget yClipMax 1 1 1 mouse leaving window cancels pending expand 1 1 center x y xy 1 14 full xlylxy 14 scalereset xl y xy 8 shift lt x percent gt lt y percent gt 14 stretch lt log2 xfac gt lt log2 yfac gt execute string lt commandstring gt 1 1 cancel keyrequest bottom 0 03 0 03 white black white black yellow black viewport modifications by mouse buttons do not affect the actual input text Shift lt Btn gt is normally used by the window manager expand expand x expand xy expand y cancel expand execute keyseguence cancel keyseguence B 2 RESOURCES 95 Xtv GowFrameWidget Translations override n Xt
8. 64 1 Bitvactivate cos aka A 62 6 4 2 Fit background create o 62 64 3 Fib bg function nsi p04 a a ee a 62 6 4 4 Fit region create e o 62 6 4 5 Fitintegration reate o 62 6 4 6 Fit delete I a 62 G A Pit function oo gu A a ta 62 56 6 5 6 6 6 7 6 8 CHAPTER 6 COMMAND SUMMARY 64 3 Pit list kek tet cok tot a ek od Ae hated tye ADs 62 6 4 9 Bitcmarker oy eens SG eee Maye oe Pe Re eS 63 6 4 10 Fit measure I eee eens 63 6 4 11 Pit ope 24 64 Bae ea A BAR aue ee ae ee i 63 6 4 12 Fit parameter I ee eee 63 G 4 13 Fit p aklist st a ee aR Res SA ne Ps 64 G 4 14 Fitpremt os roe eee A ee Dace Se 64 6 4 15 Fit psearch 2 2 es 64 64 16 Fit read se GL ce eek hoe Gee ha ee Ho OMS le 0 A 65 6 4 17 Fit recover backup e o 65 GAS Fit TESTER Ne RUN See ek 66 6 4 19 Fit result Hfile FF ug 66 64 20 Fitistatis i maa a hades deat Hd ae i eS 66 6 4 21 Pites ale s 2G 2 4 3 4 Bd dn ded hee Sed dd FR dyd Shee HAS 67 6 4 22 Pit SOTELO YY Nee Ree wad ee a EN 67 6 4 23 Fit use fitdata 0 0 0 a 67 G 4 24 Pit write sv x ee a A WY Re ee Se Fi E N 67 Label rd a aS a ORE A SE we ap ya 67 G5 habel cut Agee Soe ean e Se Fe 67 65 27 Label ka ee eee e Re B 68 6 5 3 Label peaklist 68 6 5 4 Label user uo pss as e a a a 68 Normalization ini eee A 8 69 6 6 1 Normalization
9. 77 Appendix A 79 Appendix B 87 Appendix C 97 Appendix D 99 Arithmetic operations 34 Background 100 functions 100 Basic usage 13 Introduction 13 Buffer 30 operations 30 Calibration 32 53 efficiency 53 lefttail 54 position 54 righttail 54 set 54 startchannel 54 unit 54 width 54 cd 75 Colorindex 31 Command 19 abbreviation 18 default 17 files 18 19 hotkeys 5 20 output 5 syntax 5 Command summary 53 introduction 53 command file 75 Commandfiles 19 Commandline arguments 13 Commands 17 Configuration 22 files 22 109 Controls mouse 31 crosshair cursor 17 Cut 47 54 activate 54 attach 54 create 55 creating 47 directory 55 environment 21 46 55 load 47 list 55 loading from disk 49 marker 55 matrix 56 read 56 remove 56 saving to disk 49 scale 57 status 57 use marker 57 weight 57 write 57 Decomposition 38 Default command 17 edit lock 75 exit 77 File formats 97 Filenames 6 Fit 35 57 activate 57 background create 57 bg function 57 delete 58 function 58 functions 99 integration create 58 list 58 loading 42 marker 58 110 measure 99 open 59 parameter 41 59 peaklist 60 Position free 41 hold 41 set 41 print 60 psearch 60 read 61 recover backup 61 region create 57 restore 61 result file 61 saving 42 scale 62 status 62 store 62 use fitdata 62 write 62 Fit
10. delete enter Performs an operation according to table 6 2 on cuts tv gt cut marker gate delete enter list read restore store write Performs an operation according to table 6 2 on gates 6 3 8 Cut matrix tv gt cut matrix attach projection lt spectrum gt Attaches spectrum in buffer lt spectrum gt to the active matrix as its projec tion tv gt cut matrix close lt index gt Close matrix in buffer lt index gt tv gt cut matrix format lt format gt Queries the format of the matrix to load see section C 2 tv gt cut matrix open lt index gt lt filename gt Open matrix for buffer lt index gt tv gt cut matrix status Show a list of all loaded matrices 6 3 9 Cut read tv gt cut read cut cursor entry position first last next previous Performs the read operation for the cut according to table 6 3 tv gt cut read head cursor entry position first last next previous Performs the read operation for the head according to table 6 3 6 3 CUT 61 cursor Reads the cut at the cursorposition entry Queries for a directoryname to read data from position cursor value Reads the cut or head it queries for first Reads the first cut in the cudirectory last Reads the last cut in the cutdirectory next Reads the next cut in the cutdirectory previous Reads the previous cut in the cutdirectory Table 6 3 Commands allowed to the cut read command 6 3 10 Cut rm
11. list read write Performs an operation on the lefttail s calibration 6 2 3 Calibration position tv gt calibration position copy delete enter list read write Performs an operation on the position s calibration 6 2 4 Calibration righttail tv gt calibration righttail copy delete enter list read write Performs an operation on the righttail s calibration 6 2 5 Calibration set tv gt calibration set copy delete list read write Performs the operations on the complete set of calibrated parameters 6 2 6 Calibration startchannel tv gt calibration startchannel copy delete enter Sets startchannel for calibration 6 3 CUT 59 6 2 7 Calibration unit tv gt calibration unit copy delete enter lt unit gt Sets unit of x scale e g keV 6 2 8 Calibration width tv gt calibration width copy delete enter list read write Performs an operation on the width s calibration 6 3 Cut 6 3 1 Cut activate tv gt cut activate lt index gt Activates cut lt index gt for following cut commands 6 3 2 Cut attach tv gt cut attach directory lt index gt Attach directory lt index gt to the active cut tv gt cut attach matrix lt index gt Attach matrix lt index gt to the active cut tv gt cut attach spectrum lt index gt Attach spectrum lt index gt to the active cut 6 3 3 Cut create tv gt cut create cut Create head and spectrum tv gt cut crea
12. lt char value gt lt char value gt Prints a list of ascii codes in five formats The values printed are decimal hex adecimal octal a symbolic name and the key to be pressed The circumflex stands for the control key 6 10 MISCELLANOUS 81 tv gt keytable create lt title gt Creates an empty keytable tv gt keytable delete lt title gt Deletes the keytable named lt title gt tv gt keytable list Prints the active hotkey table tv gt keytable read tv gt keytable read merge lt filename gt lt title gt Merges the keytable read from lt filename gt to the keytable lt title gt or the active keytable if no title is specified tv gt keytable read replace lt filename gt lt title gt Replaces the keytable specified by lt title gt or the active one if no title is specified with the one read from lt filename gt tv gt keytable status Prints a list of existing keytables and the files they are saved in tv gt keytable write lt filename gt Writes active keytable to lt filename gt 6 10 11 precision tv gt precision lt digits gt Sets the precision of marker output format i e the number of digits after the comma It must be an integer value 6 10 12 protocol tv gt protocol command close open lt filename gt All commands entered are recorded to the protocol file lt filename gt tv gt protocol session close open lt filename gt All commands entered as well as all
13. n lt Btn2Down gt insert selection PRIMARY CUT_BUFFERO n lt Btn3Down gt extend end PRIMARY CUT_BUFFERO Xtv Spectrum lineSpace 1 1 IXtv spectrum foreground0 white IXtv spectrum background0 black IXtv spectrum linewidthO 0 IXtv fit function foreground0 white IXtv bg function foreground0 white Xtv monochrome spectrum Foreground white IXtv monochrome spectrum Linewidth 1 Xtv monochrome spectrum linewidthO 0 Xtv monochrome spectrum linewidthT 0 IXtv monochrome spectrum linestyleO0 solid IXtv monochrome spectrum linestylel longdashed IXtv monochrome spectrum linestyle2 disconnected IXtv monochrome spectrum linestyle3 dotdashed Xtv monochrome spectrum linestyle4 dotted IXtv monochrome spectrum linestyleb shortdashed IXtv monochrome spectrum linestyle6 odddashed Xtv monochrome spectrum linestyle7 solid Xtv gray spectrum Foreground white IXtv gray spectrum Linewidth 1 IXtv gray spectrum linewidth0 O IXtv gray spectrum linewidth7 O IXtv gray spectrum linestyle0 solid IXtv gray spectrum linestylei longdashed IXtv gray spectrum linestyle2 disconnected IXtv gray spectrum linestyle3 dotdashed IXtv gray spectrum linestyle4 dotted IXtv gray spectrum linestyle5 shortdashed IXtv gray spectrum linestyle6 odddashed B 2 RESOURCES 97 IXtv gray spectrum linestyle7 solid Xtv colored spectrum foreground0 yellow Xtv colored spectrum backgroundoO red Xtv colored fit function foreground0 gold Xtv colo
14. tv gt tv gt 6 9 12 Window status tv gt window status Prints a list of graphic windows 6 9 13 Window view tv gt window view center tv gt window view center both lt x value gt lt y gt Centers displayed spectra in the current window section around the en ergy or channel lt x value gt and the counts lt y gt tv gt window view center x lt x value gt Centers displayed spectra in the current window section around the en ergy or channel lt x value gt tv gt window view center y lt y gt Centers displayed spectra in the current window section around the counts lt y gt tv gt window view expand Expands region between markers set with window mark vertical enter or the window view full commands tv gt window view full 6 10 MISCELLANOUS 79 tv gt window view full both Prepares window to display spectra in full x and y size tv gt window view full x Prepares window to display spectra in full x size tv gt window view full y Prepares window to display spectra in full y size tv gt window view position lt width gt lt position gt Centers displayed spectra in window around the energy or channel lt position gt The number of displayed channels is given by lt width gt tv gt window view shift lt x percent gt lt y percent gt Shifts window section by lt x percent gt along the x axis and lt y percent gt along the y axis tv gt window view stretch lt log gt x f
15. write 66 Remote control 23 Setup 45 Special characters 18 Spectra analysis 25 1 O 27 introduction 25 loading 27 saving 27 Spectra analysis 25 Spectrum 7 66 activate 66 add 66 analysator 67 Calibrating 9 copy 67 create 67 delete 67 enter 67 Fitting 8 format 27 28 67 get 27 67 111 Loading 7 8 ls file 67 maximum 68 minimum 68 multiply 68 norm 68 offset 68 Plot 10 read 27 69 resolution 69 status 69 subtract 69 update 69 write 27 69 Syntax 5 introduction 5 viewport markers 16 which 77 Wildcard 20 concept 21 delete 22 enter 22 status 21 user defined 22 wildcard 77 Window 25 69 bufferlist 15 configuration 26 create 69 delete 70 graphics 14 hide 70 list 70 marker 70 plot 70 raise 71 redisplay 71 scaling 71 setup 71 show 72 status 73 text 15 tvkeys 15 types 25 view 74 Windows 13 tv 13 tv Root 13 Xresources 87 Application preferences 87 sample 87
16. 0 000000008 73 6 8 19 Spectrum subtract 0 200085 74 6 8 20 Spectrum update ug 74 6 8 21 Spectrum write ee 74 69 Window eia Daen A OE a Taw 74 6 9 1 Window create I ug 74 6 9 2 Window delete 00085 74 6 93 Window hide I GG y 74 6 94 Windowlist I eee 75 6 9 5 Window marker 00005 75 6 9 6 Window plot I 0 000002 ae 75 6 9 7 WindowTIase I 75 6 9 8 Window redisplay ug 75 6 9 9 Window scaling o 76 6 9 10 Window setup I eee 76 6 9 11 Window show I ug 77 6 9 12 Window status Fu ug 78 6 9 13 Window view ug 78 6 10 Miscellanous lt lt 79 GO alias ce oe Bere ous Y y we GY ok SOA y YAR 79 6 10 2 ReadMe I GG GG o 79 GO A A at ye Ge few YSG RE dis O 79 6 10 4 command file Fu 79 6 10 5 edit lock GG ee es 80 G 1056 graphic e e ek Y A ata ee oe ORG a da a 80 6 10 7 input mode 0 0000 eee eee 80 6 10 8 keyalias I GG ee 80 6 10 9 keyunalias I e 80 6 10 10keytable I GG 80 6 10 11 precision GG I I I I y 81 ETOT protocols i aeb ot todd ee Pate ae Sek oe 81 61013 Which ia did WT A dydd Pee be A dydy y 81 6 104 wildcard g ecese Di eet hate RAD eed kee 81 UY OT Uan so ai Y ich eth NR de Le Be 82 6 11 Default aliases lt lt 82 GAUL ath A eas Sethe NSS ah se
17. 0 And finally move the cursor to the bottom pane and enter tv gt window setup frame width 9 9 0 3 Then you can plot your paned window with inscriptions at the y axes as usually 4 7 Marker Several Tv commands e g fit or recalibration do not work on the whole spectrum but on regions only Such regions can be defined using markers There are hotkeys for all kind of markers which are listed in table 4 5 on page 35 Markers are set in a window and remain there even if the spectrum displayed is exchanged by another So you can operate with one set of markers on many spectra 4 8 Calibration Tv offers commands to calibrate various parameters as there are position width efficiency lefttail and righttail You can set startchannel to define the energy associated with channel 0 and define the unit of the x scale by setting unit For example to calibrate the position and width of peaks in a spectrum in buffer 0 in keV where the energy for channel 0 is 17 keV you set the startchannel to 17 the unit to keV and perform the calibrations as shown below tv gt calibration startchannel enter 17 tv gt calibration unit enter keV 4 8 CALIBRATION 35 Hotkey b tv gt fit mark bg region enter cursor Set background region marker at cursor position lle tv gt cut mark cut enter cursor Set cut marker at cursor position eje tv gt cut marker gate enter cursor Defines a gate marker hb tv gt window mark horizontal enter c
18. 1 p 16 is the main graphic window By default all spectra loaded are displayed in this window Status window Graphic pane Scale Frame Grip Cross hair s0 c0 0 d0 n0 15 4146 EA 4000 5000 co56b68 127 esla ll rrrrrrr E T morr T Trrrrrrrrr T 2000 3000 4000 5000 6000 7000 8000 Figure 3 1 Graphic display window immediately after startup with a Co spectrum loaded The graphic window is composed of two subwindows The status window displays the window name as well as the buffernumbers of the active spectrum cut directory and matrix In parentheses the buffernumber for the spectrum where the cut is saved is printed as well as the buffernumber of the projection attached to the active matrix In the case that a spectrum is loaded the x and y position are displayed otherwise questionmarks are printed at the place of the coordinates In windows with more then one pane see section 4 2 1 p 28 the name of the currently active pane is displayed The lower subwindow or subwindows called graphic pane s display the spec tra and show their according names which are printed in the upper right corner In this window you can perform operations with the mouse as described in section 3 5 on page 19 The graphic pane is surrounded by scales at all sides which show 3 3 THE WINDOWS 17 the counts at the left and right side y scale as well as the x position in channels at the top and energy see sect
19. 32 4 2 Options to the ls file operations to define which files will be operated 32 4 3 Hotkeys for ls file operations II 33 4 4 Colorindices for labels ee eee 34 4 5 Hotkey definitions for all markers known by Tv 35 4 6 Hotkey definitions for fit markers and commands known by Tv 42 4 7 Fit parameters and their meaning 43 4 8 Hotkeys to hold free and set parameters a aaa 45 4 9 Hotkeys for saving and loading of fits and integrations 46 5 1 Tv s default attachments I ug 48 5 2 Files that must exist for the cut environment command 49 5 3 Default buffers for the cut environment command 49 5 4 Hotkeys for saving and loading of cutmarkers and cutspectra 92 5 5 Sample batchfile8 FF I 2 020200 53 5 6 Hotkeys for cmp2spc I I I Yy 53 5 7 Hotkey for cmp2mat I I Yu 53 5 8 Hotkey forcemp2cut I I yg 4 6 1 Commands allowed to the calibration menu 58 6 2 Commands allowed to the cut marker menu 60 6 3 Commands allowed to the cut read command 61 6 4 Commands allowed to the fit marker menu 63 6 5 Commands allowed to the fit parameter command 64 6 6 Commands in the fit read menus o 65 6 7 Arguments for the result file format command 66 6 8 Possible arguments for the parameter command 67 6 9 Po
20. 720 160 22 wdt 2 298 33 cor 0 vol 8818 149 From this one can see that the positions are not held and the widths are corre lated the width of peak1 is set equal to the width of peak0 Now lets set the energy of peak0 to its known value of 717 3 keV and hold this position while the second peak will be fitted Use the following commands to set and hold the position tv gt fit parameter position0 717 3 tv gt fit parameter position hold The hotkeys to do this are P p o0 and P p h o The short status of this fit looks as follows which shows that position of peak0 is held spectrum 15 3_3_11 3_3_11 pry keV 0 pos 717 3 0 hol wdt 2 298 33 vol 7829 144 1 pos 720 251 22 wdt 2 298 33 cor 0 vol 8818 149 In the above example the widths of the peaks are correlated To set correlations the command equal is used and the according command is Thank you Constantin Chitu Ayak 4 13 SAVING AND LOADING FITS 45 tv gt fit parameter widthl equal width0 To set all widths free for fitting the following command is used tv gt fit parameter width free or the hotkey respectivelly All hotkeys to hold free and set parameters are given in table 4 8 P p h o tv gt fit para position0 hold Hold position of peak 0 This hotkey is available for peaks 1 to 4 either P p f o tv gt fit para position0 free The position of peak 0 is set free for fitting This hotkey is avail able for peaks 1 to 4 either tv gt
21. Calibration Plot Recalibration marker Matrix Projection spectrum Calibration for projection spectrum Table 3 6 Default wildcard definitions 3 13 CONFIGURATION FILES 25 example where the left wildcard expression will be evaluated and given as input to the right expression If you are in the directory matriz1 220Th and enter tv gt cut env 220Th test the modified wildcard for matrices mtx t r mtx will result in a matrix filename matriz1 220Th 220Th test 220Th mtz You can define own wildcards or alter existing settings For example to set the modified matrix wildcard from the example above enter tv gt wildcard enter mtx t r mtx The second argument should contain the leading asterisk Be sure to encapsu late the second argument in double quotes Also you can change existing wildcards with the wildcard enter command To delete a wildcard use the command tv gt wildcard delete lt wildcard gt 3 12 2 Example for user defined wildcards For example you can use wildcards for the input and output of multiple spectra To write a group of calibrated spectra you can define the wildcard calspc tv gt wildcard enter calspc r cal_spc and write the spectra with the command tv gt spectrum write calspc all For example if you have the spectra prge0 0121 and prgel 0121 loaded this com mand saves the files prge0 cal_spc and prgel cal_spc The input and output of spectra can also be p
22. Marker 69 6 6 2 Normalization off ug 69 6 6 3 Normalization scale 69 6 6 4 Normalization status 69 6 6 5 Normalization A A RAS 70 Recalibration ee ee die a Se 70 6 7 1 Recalibration append 70 6 7 2 Recalibration create 00008 70 6 7 3 Recalibration delete aaa 70 6 7 4 Recalibration marker 70 6 7 5 Recalibration list ug 70 6 7 6 Recalibration read ug 71 6 7 7 Recalibration type GG ug 71 6 7 8 Recalibration write 0 008 71 SDpectruill un OW WR y GR ee ee DW WYW a A 71 6 8 1 Spectrum activate 000084 71 6 8 2 Sp ctrumi add 2 Je GI AS oe Pe E S 71 6 8 3 Spectrum analysator 71 6 8 4 Spectrum copy 2 0 I GG I I ug 71 6 8 5 Spectrum create FI ug 71 6 8 6 Spectrum delete 000085 71 68 7 Spectrum enter eho ff eh yR Ryd ti Ew 72 6 8 8 Spectrum format o 72 6 8 9 Spectrum get ee 72 6 8 10 Spectrum ls file 72 6 8 11 Spectrum maximum a 73 6 8 12 Spectrum minimum 73 6 1 INTRODUCTION 57 6 8 13 Spectrum multiply oaa 73 6 8 14 Spectrum norm y 73 6 8 15 Spectrum offset 0 0 0 2000008 73 6 8 16 Spectrum read ee 73 6 8 17 Spectrum resolution e 73 6 8 18 Spectrum status 2 0 0 0
23. Pee 82 GAMEZ Tint yy tee he oe ae A ed BOP Bebe 82 6 11 3 log gob Roe Ge Bassey a gave aoc Gina Weert ete OYOI tihes 82 6 1 Introduction This chapter lists all commands in alphabetic order and gives a short description for each of them Underlined words are default commands and only their arguments must be entered Arguments to the value command can be energies calibrated or channels uncalibrated The current interpretation of the entered value is printed 58 CHAPTER 6 COMMAND SUMMARY and you can overwrite it by entering the appropriate word cal or uncal after the value Commands in Tv are mostly object oriented i e you have to put the object you want to work with to the beginning of the command 6 2 Calibration Table 6 1 shows the commands allowed to the calibration menu and their according arguments In the subsections the commands allowed to the calibration commands are listed lt source index gt lt index gt active all shown visible lt index gt active all shown visible lt channelg gt lt energyg gt lt channel gt lt energy gt lt index gt lt filename gt lt filename gt Table 6 1 Commands allowed to the calibration menu 6 2 1 Calibration efficiency tv gt calibration efficiency copy delete list read write Performs an operation on the efficiency s calibration 6 2 2 Calibration lefttail tv gt calibration lefttail copy delete enter
24. as buffer number or alternatively a text value which is taken as filename of a spectrum The argument all makes Tv to add all spectra but the one in the destination buffer If the destination buffer was empty before the spectrum will get the name of the first spectrum added subtract works analogous to add but subtracts spectra 38 CHAPTER 4 SPECTRA ANALYSIS multiply multiplies the spectra given by the last argument with the factor lt fact gt The second argument takes an integer argument as default value maximum takes the maximum for each channel of all spectra defined by the last argument and puts this value in the spectrum specified by the second argument The last argument takes integer values as default which give the buffer numbers for comparison minimum works analogous to maximum but takes the minimum of each chan nel 4 12 Fit and integration The interesting results of the quantitative analysis of spectra are position volume and shape of the observed peaks The analysis must comprise a proper description of the background Since the background has a more global structure whereas the peaks in a gamma spectrum are local structures the former can be approximated by a polynom usually of second degree On the contrary particle spectra have very broad peaks Therefore it is necessary to use a more physical description of the background which is provided by an exponential term besides the polynom This background function may
25. be useful in the upper part of a Ge detector s spectrum too since the exponential term reproduces approximately the detector s efficiency Tv offers three methods for the analysis of spectra as there arc integration peaksearch and fit whereat two different functions to fit the peaks and two different functions to approximate the background can be used The methods are explained in the following sections while the definitions are given in appendix D on page 103 4 12 1 Integration The main advantage of integration in comparison with fitting is that no hypothesis on the shape of the peak is necessary Tv calculates volume center of mass width corrected by a factor 2 V2 ln 2 to obtain the FWHM and skewness asymmetry TV takes into account existing background fits and calculates background corrected values too If background regions are defined but not fitted Tv determines the mean background and uses this for the background correction The results of the integration increasingly depend from volume to skewness on a good description of the background Integration is appropriate for y spectra with not well determined peak shapes You can only analyze well separated peaks by integration Otherwise it is neces sary to make assumptions about the line shape and to use a fit for decomposition of overlapping peaks Furthermore it needs a lot of effort to integrate a large number of peaks To perform an integration you have to define a fit re
26. characters on your keyboard combinations of keys have been introduced to increase the number of abbreviable commands You must press each character in such a combination For example to plot a spectrum in xfig format you have to press the keys and one after the other which is written in the manual like The default hotkeys are printed in appendix A on page 83 5 6 CHAPTER 1 SYNTAX IN THIS MANUAL 1 4 Program output Terminal output from Tv is printed in typewriter font like in the following way spectrum co56b68 127 8k le4 1 read to 0 1 5 Filenames Filenames are printed in italics like site turc Chapter 2 Introduction Contents 2 1 Introduction ug 7 2 2 Input mod s rotonda da A ae da EUR 7 DD SP SCHUM e So Shee ee e ae Y a hee Rea oat Gah sa See SE tw ee an 8 2 3 1 Loading a single spectrum 2 3 2 Moving through the spectrum 2 33 Fitting aspectrum Y 2 3 4 Calibrating a spectrum a 10 2348 Plot a ae ah ae SA YG A Ad io r Md y 10 2 4 Analyzing a yy matriX lt lt 10 2 41 Opening a matrix 0 0 10 2 4 2 Cutting in a Matrix Fu 12 2 1 Introduction This chapter is intended for the novice user to get an overview of the main topics of Tv and to describe its basic operations It is started from the commandline with gt tv amp but since Tv writes its output so standard out you better enter gt tv gt dev null
27. cut attach spectrum 3 tv gt cut attach directory 4 Now change to a suitable directory and open the matrix as well as the directory and load the projection tv gt cd matrixl tv gt cut directory open 4 220Th 220Th cutdir tv gt cut matrix open 220Th 220Th mtx tv gt spectrum read 220Th 220Th pry 2 5 3 FAST SETUP 49 Examples for the comparison of matrices where attachments for several matrices are made are given in chapter 5 6 5 3 Fast setup Since the files needed for matrix analysis are always of the same structure Tv offers a method to make the setup much easier It is called cut environment and uses the wildcards described in section 3 12 2 on page 25 1 e the files must have standard filenames to be loaded with the environment command 5 3 1 Definition of environment The cut environment defines a file structure that simplifies the analysis of ma trices i e you only have to specify the pathname to access the matrix load its projection and open the cut directory For example to load the environment from the directory matriz1 220Th it must contain the files listed in table 5 2 on page 49 220Th mtz The matrix file 220Th pr xy The projection files Table 5 2 Files that must exist for the cut environment command 5 3 2 Load the environment If all files exist that are mentioned in the previous section you can load the envi ronment that you want to work with by pressing the hotkey and entering the pathn
28. e if you delete the spectrum you have fitted the fit will still be there So you may load or activate another spectrum while keeping the markers and use the same fit on it To obtain best fit results you have to define fit and background regions as well as peak markers To define the fit region i e the region of the spectrum 40 CHAPTER 4 SPECTRA ANALYSIS containing the peak s to be fitted press for the left border and press again for the right border of the fit region Now mark all peaks to be fitted inside the fit region by pressing p over each peak Then you can perform the fit by pressing or with the command tv gt fit region create Optionally you can further improve the fit by defining an arbitrary number of background egions using the hotkey D for the left and once for the right border of each background region Press B to fit spectral background inside the background regions and afterwards to fit peak s The background fitted to the background regions will be used for the fit inside the fit region Note though Tv supports only one fit region any number of background regions can be defined for the fit Figure 4 4 on page 40 shows spectra with fits In its upper pane no fit parameters have been changed and the fit does not suit very good as you can see If you want to save your fit results to a file it must be opened first To open the file enter the command tv gt fit result file open fit result demo and write
29. function y squared tv gt window scaling function y normalization on tv gt window scaling function y normalization off Appendix A The default hotkey table By default the file tukeys has the following contents Hotkey cursor mode quit Tv else Soei t gt dorada Refresh display srele t gt window redisplay Refresh display tv gt input mode edit Switch between edit and cursor mode tv gt window mark vertical enter cursor Set vertical markers to define x tv gt window view stretch 1 cursor 0 tv gt window view stretch 2 cursor 0 tv gt window view full y Zoom out show 12 5 of 4 tv gt window view full y i window view stretch 4 omoro gt eS window view smeteh DD tv gt window view stretch 5 cursor 0 oue wn cs tv gt window view stretch 6 cursor 0 tv gt window view full y os window iw ate meros tv gt window view full y E e maoe enea tv gt window view stretch 9 cursor 0 Se El E gt Tabel user enter cursor A tv gt cut mark cut delete Delete all markers You will tv gt window hide mark cut still see markers which are tv gt fit mark fit delete part of the autonomous fit tv gt fit delete tv gt window hide mark fit tv gt label user delete all tv gt normalization mark delete To be continued 83 84 APPENDIX A THE DEFAULT HOTKEY TABLE Hotkey tv gt recalibration marker delete all UNED A tv gt cut mark cut de
30. has the attachments listed in table 5 1 on page 48 Matrix m0 is attached to all cuts Spectrum s lt n gt is attached to cut lt n gt Directory d0 is attached to all cuts Spectrum buffer 15 contains the projection for matrix 0 Table 5 1 Tv s default attachments 5 2 2 Changing the attachments All changes are for the active cut which is c0 by default You can select the active cut with the command tv gt cut activate lt index gt The attachments can be changed with tv gt cut attach matrix lt n gt spectrum lt n gt directory lt n gt The projection attached to a matrix can be changed with tv gt cut matrix attach projection lt s gt where lt s gt 1s the spectrum buffer containing the projection 5 2 3 Open a matrix Now we have defined the attachments between all necessary buffers They can be loaded with the according data in the following way To open a matrix enter its index and filename tv gt cut matrix open lt mtx idx gt lt filename gt Load the projection lt filename gt in buffer lt n gt with tv gt spectrum read lt filename gt lt n gt Define the pathname of the cut directory with tv gt cut directory open lt dir idx gt lt pathname gt 5 2 4 Example setup As an example cut 0 is activated and the according attachments are made to ma trix 1 projection 2 spectrum 3 and directory 4 tv gt cut activate 0 tv gt cut attach matrix 1 tv gt cut matrix attach projection 2 tv gt
31. lt i gt linestyle lt i gt linewidth lt i gt unix plot resources unixFontname lt i gt unixFontsize lt i gt unixColor lt i gt unixLinestyle lt i gt xfig resources xfigFont lt i gt xfigFontsize lt i gt xfigColor lt i gt xfigLinestyle lt i gt xfigLinewidth lt i gt xfigFillstyle lt i gt APPENDIX B XRESOURCES NumGCs Font Foreground Background Linestyle Linewidth UnixFontname UnixFontsize UnixColor UnixLinestyle XfigFont XfigFontsize XfigColor XfigLinestyle XfigLinewidth XfigFillstyle lt name gt lt color gt lt color gt lt linestyle gt int lt name gt int lt int gt lt int gt lt int gt lt linestyle gt int int int lt linestyle gt int int Appendix C File formats C 1 Definition of mfile Mfile is a library developed by Stefan Esser as diploma thesis for the IKP for system independent reading and writing of n dimensional spectra n lt 4 It provides a compressed spectra file format called lc line compressed The compression algo rithm codes the differences of succesive channels in 4 bits C 2 File formats Table C 1 lists all file formats from the mfile h header file Element format Compression format line compressed 2 byte low endian VAX DEC mips Intel 4 byte low endian VAX DEC mips Intel 2 byte high endian HP Motorola 4 byte high endian HP Motorola low endian 4 byte IEEE float low endian 8 byte IEEE flo
32. necessary files you can start analysing your matrix with the command tv gt cut env lt path gt which performs the opening and loading of your data automatically The filename for matrices mtx is composed of the full absolute directory name If a slash matrix basename t and the suffix mtx For the meaning of the wildcard characters see table 3 5 on page 24 The wild card characters mus be preceded by an exclamation mark The wildcards which are defined by default are listed in table 3 6 on page 24 You can print a list of all wildcards with the command tv gt wildcard status You can combine any entries of table 3 5 by using the pipe character This character works like the pipe character in unix shells as shown in the following 24 CHAPTER 3 BASIC USAGE Widera Example full filename filename tail matrix1 220Th 220Th tig0 220Th tig0 absolute path f t matrix1 220Th basename without last ext 220Th extension mtx Table 3 5 Wildcard characters Wildcard cutdir cutspcgat cutspcbg cutspccl cutspccr fit cal plt prospc procal If lt cutdir If It cut cal If lt gate If lt cut If lt gt If It bg If Tt cl If lt c th t fit Ir cal Ir fig Ir rcl 1 Mt mtx If lt pry If lt pry cal Cut directory Cut calibration Cut gate marker Cut spectrum Cut spectrum gate marker Cut spectrum background gate marker Fit marker
33. output from Tv are recorded to the protocol file lt filename gt tv gt protocol standard output close open All commands entered as well as all output from Tv are printed to standard output 6 10 13 which tv gt which config file command file which without arguments prints the search path for configuration and command files If a filename is given as argument which prints the full path of the file used by Tv 6 10 14 wildcard tv gt wildcard delete lt wildcard gt Deletes lt wildcard gt from list tv gt wildcard enter lt wildcard gt lt expression gt Adds a new wildcard to the list or replaces an existing one 82 CHAPTER 6 COMMAND SUMMARY tv gt wildcard status Prints a list of defined wildcards See section 3 12 2 on page 25 for further explanations 6 10 15 exit 6 11 Default aliases 6 11 1 quit tv gt quit Performs the command tv gt exit 6 11 2 lin tv gt lin Changes the y scale to linear units by performing tv gt window scaling function y linear tv gt window scaling function y normalization on tv gt window scaling function y normalization off 6 11 3 log tv gt log Changes the y scale to logarithmic units by performing tv gt window scaling function y logarithmic tv gt window scaling function y normalization on tv gt window scaling function y normalization off tv gt ysqr Changes the y scale to squared units by performing tv gt window scaling
34. save the results of a peak fit to a file peak integration Format to save the results of a peak integration to a file peak search Format to save the results of a peaksearch to a file Table 6 7 Arguments for the result file format command tv gt fit result file format default lt arg gt Sets the format for lt arg gt to the default tv gt fit result file format enter lt arg gt Queries the format for lt arg gt tv gt fit result file format read lt arg gt lt filename gt Reads the format for lt arg gt from file lt filename gt tv gt fit result file format status Prints the format for all parameters tv gt fit result file format write lt arg gt lt filename gt Saves the format for lt arg gt to the file lt filename gt tv gt fit result file open lt filename gt Open lt filename gt to write fit results printed with fit print or fit peak list print 6 4 20 Fit status tv gt fit status full Prints detailed status informations about the current fit tv gt fit status short Prints short status informations about the current fit 6 5 LABEL 67 6 4 21 Fit scale tv gt fit scale input calibrated default uncalibrated Defines how read values are interpreted tv gt fit scale marker calibrated default uncalibrated Defines how marker values are interpreted tv gt fit scale output calibrated default uncalibrated Defines the scale for writing markers 6 4 22 F
35. the last argument to file lt filename gt 6 8 Spectrum 6 8 1 Spectrum activate tv gt spectrum activate lt index gt next previous status Activates the spectrum defined by the last argument 6 8 2 Spectrum add tv gt spectrum add lt index gt lt filename gt lt format gt lt index gt active all shown visible Adds buffers defined by the last argument to buffer lt index gt This command has one text default or one integer default 6 8 3 Spectrum analysator tv gt spectrum analysator lt hostname gt Read data from host lt hostname gt which is bibo by default 6 8 4 Spectrum copy tv gt spectrum copy lt source gt lt destination gt Copies spectrum from buffer lt source gt to buffers lt destination gt 6 8 5 Spectrum create tv gt spectrum create lt name gt lt resolution gt lt index gt Creates an empty spectrum lt name gt with resolution lt resolution gt in buffer lt index gt 6 8 6 Spectrum delete tv gt spectrum delete lt index gt Prints a list of spectra and asks for a list of buffers to delete 72 CHAPTER 6 COMMAND SUMMARY 6 8 7 Spectrum enter tv gt spectrum enter lt index gt lt channel gt lt value gt Set channel lt channel gt of spectrum in buffer lt index gt to value lt value gt 6 8 8 Spectrum format tv gt spectrum format input lt format gt Set input format of spectra to lt format gt tv gt spectrum format outp
36. times roman Xtv UnixLinestyle solid Xtv UnixColor 0 0 0 Default values for all window frames Xtv XFrame 2 Xtv YFrame 3 Xtv ticLong 0 6 Xtv ticMedium 0 4 Xtv ticShort 0 2 Xtv ticSpace 0 75 Xtv ticLabel 3 0 Xtv ticTic 0 3 Xtv VLabel labelDistance 2 0 Xtv VLabel labelLine 1 0 Xtv VLabel topSpectrum True Xtv VLabel channelRadius 2 Xtv VLabel libraryRadius 1 0 Default values for cursors Xtv GowFrameWidget cursor gumby Xtv Paned gripCursor sb_v_double_arrow B 2 RESOURCES Xtv GowCutWidget gripCursor Xtv GowCutWidget adjustCursor Ispecial named widgets 93 dot bottom_left_corner Xtv fit geometry 780x570 0 0 Xtv cut geometry 300x300 0 0 Xtv pro geometry 100x100 0 0 Xtv xpane geometry 300x300 0 0 IXtv pane i compressMode firstfound Xtv fit height 200 Xtv residuum height 100 Xtv residuum skipAdjust True Xtv CrossFraction 0 01 Xtv bin list vBarPosition bottom Xtv bin list upperFraction 0 00 Xtv bin list lowerFraction 0 99 Xtv fit region vBarPosition top Xtv fit region upperFraction 0 02 Xtv fit region lowerFraction 0 02 Xtv bg region vBarPosition bottom Xtv bg region upperFraction 0 02 Xtv bg region lowerFraction 0 02 Xtv peaklist label topSpectrum true Xtv peaklist label upperFraction 0 01 Xtv peaklist label lowerFraction 0 01 Xtv fit label topSpectrum false Xtv fit label upperFraction 0 01 Xtv fit label lowerFraction 0 01 Xtv peak label topSpec
37. to cursor Table 4 5 Hotkey definitions for all markers known by Tv 36 CHAPTER 4 SPECTRA ANALYSIS tv gt calibration position enter 1204 1197 1579 1563 tv gt calibration width enter 1213 4 26 1258 4 63 Tv prints the parameters for the position calibration with the command tv gt calibration position list 0 and for the width calibration with the command tv gt calibration width list 0 You can list the results for the complete set of calibrations at once with the com mand tv gt calibration set list 0 You can save the energy calibration to a file with standard filename according to the wildcard definition cal or another file you have to enter with the command tv gt calibration position write and load from file cal or any other file by pressing hotkey or by entering the full command tv gt calibration position read You can copy the calibration to spectra in other buffers with tv gt cali position copy lt src ind gt lt ind gt acti all show visi All calibrations entered or read are copied to all buffers automatically For the syntax of all calibration commands see section 6 2 on page 58 4 9 Recalibration Due to electrical effects during the data aquisition peaks may be shifted in some spectra which means that peaks that should be at the same position are not Shifting spectra to have their according peaks in the same channels is provided by Tv with the recalibration commands Basically this is a linear calibra
38. tv gt window show fit decomposition Display the decomposition of the fit tv gt window show fit function marker Display the fit function and markers window show labellist tv gt window show labellist cut Display the labellist for the active cut tv gt window show labellist peaklist Display the labellist for all peaks in the active peaklist tv gt window show labellist user Display all labels from the user labellist window show marker tv gt window show marker cut Display markers for the active cut tv gt window show marker fit Display markers for the active fit CHAPTER 6 COMMAND SUMMARY tv gt window show marker normalization Display normalization markers tv gt window show marker recalibration Display recalibration markers tv gt window show marker psearch Display peaksearch markers window show peaklist window show spectrum tv gt window show spectrum index lt index gt Show spectrum in buffer lt index gt tv gt window show spectrum next Show next spectrum tv gt window show spectrum previous Show previous spectrum tv gt window show spectrum lt index gt Show additional spectrum tv gt window show spectrum lt index gt Hide spectrum tv gt window show spectrum names Show one spectrum start with spectrum in lowest buffer window show status Prints the number of active spectrum and cut as well as a list of all spectra shown in the active window 78 tv gt
39. widget lt cut gt cut GowFrameWidget widget lt simple gt sheet GowVsWidget widget standard GowVsWidget lt cut gt projection GowFrameWidget widget lt cut gt projection sheet GowVsWidget widget standard GowVsWidget lt paned gt lt color gt standard status pane lt index gt TopLevelShell widget Paned widget GowFrameWidget widget pane lt index gt sheet GowVsWidget widget standard GowVsWidget standard status paned status Box widget focus Label widget activ Label widget full Label widget position Label widget standard GowVsWidget lt name gt GowVsWidget widget bin list VMark object cut gate VMark object cut bg gate VMark object cut label VLabel object decomposition Decomposition object fit function Fitfunction object fit region VMark object bg function Fitfunction object bg region VMark object fit label VLabel object peak label VLabel object user label VLabel object position label VLabel object horizontal marker HMark object vertical marker VMark object recalibration marker VMark object gate marker VMark object bg gate marker VMark object fit bg marker VMark object fit region marker VMark object fit bin marker VMark object integration marker VMark object peak search marker VMark object normalization marker VMark object normalization bg
40. 2 gt amp 1 amp Two windows appear on your screen which are a text window named tv for echoing commands and the displaying of results and status information and a graphic window named tv root for displaying the spectra you are working with Both window types are described in detail in section 3 3 on page 16 and displayed in figure 3 2 on page 18 and figure 3 1 on page 16 2 2 Input modes Tv supports two major modes for entering commands called edit mode and cursor mode By default Tv starts in edit mode where input is focussed to the text window which means that all keys you type are printed in the text window and will be evaluated after pressing cR As long as the cursor is placed over the text window you are in edit mode In cursor mode mode entered keys are used as hotkeys see section 3 4 2 p 18 when the cursor is placed over the graphic window the cursorform is pirate amp then 7 8 CHAPTER 2 INTRODUCTION To switch between edit and cursor mode place the cursor over the graphic window and press Esc Most operations in this introduction are performed in cursor mode 2 3 Spectrum 2 3 1 Loading a single spectrum In order to examine a single y spectrum switch to the cursor mode and press to load a spectrum You will be gueried the name of the spectrum file Enter its name and press CR The spectrum will be displayed in the tv root window see figure 2 1 15 c00 do mocs FFA y Chn T 480 _ ub Md
41. 3 Saving and loading fits 4 1 Introduction The main topic of Tv is to display and analyze spectra With respect to that matter in this chapter it will be explained how to load one or more spectra and perform all necessary operations to analyze the data as there are the choosing of the best window type calibration recalibration normalization arithmetic operations integration and fit as well as peaksearch and finally the plotting of spectra 27 28 CHAPTER 4 SPECTRA ANALYSIS 4 2 Graphic window 4 2 1 Graphic window types Tv offers several types of windows suitable for special purposes First there is the basic window type simple which consists of just one pane You can use it to display an arbitrary number of spectra There is one special window of window type simple the plot window Since the default frame width for the left and right side is not large enough to see the scale s inscriptions on your plot you can enlarge them see section 4 6 p 34 or create a new window named plot which is suitable for the plotting of spectra tv gt window create simple plot Besides the simple window there are three different paned windows the xy x and y paned They are composed of one or more panes which are arranged one above the other All panes share a common status line These window types provide a y scale per pane and a total of two x scales In an xy paned window the x scales are independent as well as the y sc
42. 6 6 2 Normalization off tv gt normalization off Turns off normalization so that spectrum norm has no effect on any spec trum 6 6 3 Normalization scale tv gt normalization scale calibrated default uncalibrated Defines whether values are interpreted as energy or channel for normalization markers 6 6 4 Normalization status tv gt normalization status Prints status information how spectra will be normalized 70 CHAPTER 6 COMMAND SUMMARY 6 6 5 Normalization type tv gt normalization type factor lt factor gt lt index gt active all shown visible tv gt normalization type maximum lt index gt active all shown visible Normalize spectra defined by the last argument with reference to the spectrum with maximum channel tv gt normalization type reference lt reference gt lt index gt active all shown visible Normalize spectra defined by the last argument with reference to the spectrum in buffer lt reference gt tv gt normalization type unity lt index gt active all shown visible Normalize spectra defined by the last argument with reference to the spectrum with maximum integral 6 7 Recalibration 6 7 1 Recalibration append tv gt recalibration append lt filename gt lt index gt Append recalibration data of buffers lt index gt to file lt filename gt 6 7 2 Recalibration create tv gt recalibration create lt reference gt lt
43. 9 R b c tv gt fit read bin position cursor Reads the fit at the cursorposi eee tion i n b r tv gt fit read bin first Reads the first fit from the fitfile rfbfn tv gt fit read bin next Reads the next fit from the fitfile R b p tv gt fit read bin position cursor Reads the fit at the cursorposi tion Rf e tv gt fit read fit first Reads the first fit from the fitfile patria Rt next Reads the next fit from the fl lend the fitfile N the fitfile fitfile Table 4 9 Hotkeys for saving and loading of fits and integrations To write the results from a fit or integration as asciitext to a protocolfile the file must be opened first with one of the commands tv gt fit result file open lt resultfile gt tv gt fit result file append open lt resultfile gt The results are saved with the command tv gt fit print After writing all results the file can be closed with the command tv gt fit result file close or it will be closed automatically at leaving Tv Chapter 5 Matrix analysis Contents Bl Hitroductionb sig ia ee ties e eee Oe Re 47 DR SRAM A A A d r dw RY 47 Bel Attachments lt a a wed DA 48 5 2 2 Changing the attachments 48 5 2 3 Open a matrix I ee ee 48 5 2 4 Example setup I 48 Bid Fast setos lark eee od ee Re a a ag 49 5 3 1 Definition of environment 49 5 3 2 Load the environment 49 5 4 Creat
44. E p 107 sign it and send the original and one copy to the authors at the address found in the agreement No fee is charged for licensing Tv All registered users will be informed about new releases of Tv Chapter 1 Syntax in this manual 1 1 Introduction To increase the legibility of this manual various font styles are used In this chapter the meaning of these typographic conventions is explained 1 2 Commands Tv commands are printed in a boldfaced sans serife font and formatted in the following manner menu gt command lt argument1 gt lt argument2 gt lt argument3 gt menu gt command lt argument4 gt lt argument5 gt menu gt is the prompt indicating that Tv is accepting input in the current menu The command can be entered complete or in short form as explained later see section 3 7 p 20 Arguments enclosed in brackets are optional Three dots after the argument name indicate that a list of arguments of this type may follow From arguments enclosed in braces exactly one must be used The vertical line in the example above means that you can specify argument4 or argument5 exclusive tor 1 3 Command Shortcuts Hotkeys Frequently used commands can be executed with one or more keystrokes in cursor mode see section 3 4 2 p 18 These hotkeys are shown in the manual in a box like For example the hotkey which displays the full spectrum is Since there is only a limited number of
45. FF FF uu 0000 4 A 6 Plot and label amp 3 ee a Se y ba Bie AG yR IE d i A Markers ea sy Sy oes wear E ANDI Ge at ae O Se 4 8 iGalibration 4 4 A as SRS ee 4 9 Recalibratiorh o 4 45 40 da ee ce et ES ded ew 4 10 Normalizati n 5 22 22k eR ee ee AE ES RR RS 4 11 Arithmetic Operations 4 12 Fitandintegration FI I GG Y Y y 4 13 Saving and loading fits Matrix analysis 5 1 Introduction A kg os os Gy wea Ed Go RL 5 3 Fast setup 5 4 Creating cuts 5 5 Saving and loading cuts 5 6 Comparing matrices Command summary 6 1 Introduction 6 2 Calibration AAA A A A AA ds Bn 6 5 Label eL 22 y ad ae ek 6 6 Normalization 6 7 Recalibration 6 8 Spectrum 6 9 Window 6 10 Miscellanous 6 11 Default aliases The default hotkey table Xresources B 1 Application preferences B 2 Resources File formats C 1 Definition of mfile C 2 File formats The fit background and measure functions D 1 Fit functions D 2 The background functions D 3 Measure functions License Agreement CONTENTS List of Figures 21 2 2 2 3 2 4 2 5 3 1 3 2 4 1 4 2 4 3 4 4 4 5 5 1 5 2 5 3 Graphic display window with a Co spectrum loaded Graphic display window with a Th projection spectrum loaded and a nt attached gu 2 vee ia ee Sk ae ee ete ee LES a Sample plot from Tv plotted in xfig format and exported to ps Cut gate in the projection of a Th spectrum The cut in its special
46. IKP at the option of the user TV is licensed with no warranty of any kind The IKP will not be responsible for the correction of any bugs or other deficiencies In no event shall the IKP be liable for any damages of any kind including special indirect or conse guential damages arising out of or in connection with the use or performance of Tv This license for Tv shall be effective from the date hereof and shall remain in force until the user discontinues use of Tv In the case the user neglects or fails to perform or observe any obligations under this agreement this agree ment and the license granted hereunder shall be immediately terminated and the user shall certify to the IKP in writing that all copies of Tv in whatever form in its possession or under its control have been destroyed Reguests TV is provided by the IKP in a spirit of friendship and cooperation The IKP asks that people enjoying the use of Tv cooperate in return to help further develop and distribute Tv Specifically the IKP would like to know which machines Tv gets used on A brief notice form is appended to this agreement which the user is reguested to send by email or otherwise Please send in further notifications at reasonable intervals if you increase the number and type of machines on which Tv is loaded You may send these notices to another user which is cooperating with the IKP for this purpose Index 16 Abbreviation 18 Alias 74 Aliases 18 default
47. STEP dz SH E arctan HE SH step height of i th peak parameter SW step width of i th peak parameter tv gt fit function peak definition additive tail erf step F x BG a Weetknumber PEAK x BG x background function see section D 2 on page 105 peak function of ith peak PEAKi z none 1 TAIL z Pi GAUSS P STEP a Pi P position of i th peak parameter Vi volume of i th peak parameter NORM 2 Pi TL FTR gauss function of i th peak GAUSS de expl zr S c of gaussian part of i th peak parameter additional tail factor of i th peak TL El TAIL dx o FACFACtER 20 TL left tail of i th peak parameter TR right tail of i th peak parameter EL exponent of left tail 2 16 ER exponent of right tail 2 16 for simplification of integral n 1 n 3 5 7 n 1 2 n 2 4 6 dx lt 0 FACFAC n step function of i th peak STEP dx 3 SH 1er f 5 Ea SH step height of i th peak parameter SW step width of i th peak parameter erf erf x Je exp t dt D 2 THE BACKGROUND FUNCTIONS 105 D 2 The background functions You can take a look at the definitions of the background functions with the com mand tv gt fit function background definition polynom BG 2 Enzo Bn 2 20 Bn background coefficient parameter xg offset for numerical optimization during fit
48. Tv User Manual Andreas Fitzler Institute for Nuclear Physics University of Cologne July 13 2000 1e mail fitz ikp uni koeln de Contents 1 Syntax in this manual T I ntroduction 24 sai 9 Sear ee ee a SS TH dar EW RR 1 2 Commands 204 Lo ek ee Be EEE LS 1 3 Command Shortcuts Hotkeys o l4 Program outputs lt 4 von ee PR eee y a Se tb a a y 125 Filenames 001144 o See rr Gh 2 Introduction 2A Introduction HS BS Cote AU e te Ip ke kets eee ekg 22 Input modes 2 5 PEC Lo a A a 2 4 Analyzing ary mA e css RR A RR RR Eg 3 Basic usage Sol Tatro ductions de alee ee Se ey NOD OY GY O Eo 9 2 Starting LV 3 4 dani ee a Pee hh eM EES eS Sele es 3 9 OS ca yaks coe RA eee ee Ate dar ar A 9 Tnputimodes ss susie Oe SS a EN ND GWD eo MOUSE 2 38 o niet ede Y YDD I I A Edr dr tb 3 6 Commands and Menus 3 1 Abbreviations sese WW O A ASA TI YI YG YM 3 8 Special characters 2 2 I ee 379 AASE Ar ee Se ce SoS Bee ets ee ee we a AT A 3 10 Command files 2 0 SF GG GG o oL Hotkeys o u o RAA drdd ee FIS III Y YD wn dd 3 12 Wildcards 25 5 5 WR GA fof dele BAA Byd FD RID A O DO SS 3 13 Configuration filles FF e 3 14 Remote control I GG ee 4 Spectra analysis 4 1 Introduction 4 2 Graphic window GG GI IG I I ee eee 4 3 Loading and saving of spectra I O oo o 4 4 Buffer operations GG GG GG I yL 4 5 Using the mouse F
49. a precision of 1 10 of a channel and the peak is added to a list The peaksearch is performed by the command tv gt fit psearch create which prints the number of peaks found You will get a list of all peaks found with their positions widths and volumes with the command tv gt fit psearch list If you do not want to search for peaks in the whole spectrum you can set markers to limit the range To set a marker enter tv gt fit psearch marker enter cursor value offset If you found a pair of good markers that you want to keep in mind while looking for a better pair you can store and restore them with tv gt fit psearch marker store tv gt fit psearch marker restore Saving peaklists The results of a peaksearch can be saved either as binary with tv gt fit psearch write to the file lt spectrumname gt fit or as asciitext using one of the following commands tv gt fit print tv gt fit psearch print tv gt fit peaklist print to a file open with one of the following commands tv gt fit result file open psearch demo tv gt fit result file append open psearch demo The asciifile will be closed by using the command or at exiting Tv Loading peaklists Peaklists can be loaded from binaryfiles only by using the command tv gt fit psearch read By use of the command tv gt fit psearch open besides the peaklist eventually saved fits are loaded too 4 12 3 Fitting A fit consists of markers and parameters and is autonomous i
50. a 4 4 8 280000 220Th tig0 pry 280000 250000 250000 200000 200000 160000 160000 Figure 2 1 Graphic display window with a Co spectrum loaded Tv uses the program library mfile for spectrum I O Spectra written in mfile format are preceded by a header with information about the spectrum format If you want to read spectra not written in mfile format the mfile routines try to guess the format If this fails you have to explicitely specify the spectrum format for example to read a spectrum with 8192 channels that was written in low endian format with 4 bytes you enter tv gt s co56b68 127 8k le4 1 In the example above s stands for spectrum See section 3 7 on page 20 for a description of abbreviating commands A detailed desription of spectra formats 1s given in appendix C 2 on page 101 2 3 2 Moving through the spectrum You can determine the x and y position of the cursor from the status window in the graphic window To zoom a part of the spectrum set two markers by pressing Ga for each over the desired position and press e to expand You also can use keys 1 to 9 to zoom in and 0 or HE to e to zoom out with the cursor defining the center To move the viewport to the left or right press or gt which automatically adjusts the y scale according to the peaks displayed To move the viewport without adjusting the y scale use or CD Alternatively you can press i to Jump to a certain position y
51. a RY o7 462 779 LaS S 462 779 H S gt Y Ss Y Ce rv S ov A S oS mH ry RY ON J S v RY Jl S N rv ahs Do pel S es a S PS S ll s Ur S N N F RY S S PS S RS N Y S PS S E E z 3 ie o o S o x A gt gt Y 9 er ys ye Figure 2 3 Sample plot from Tv plotted in xfig format and exported to ps 220Th NAAA 2010 2074 pri Table 2 1 Example for a collection of necessary files to examine a yy matrix You need either the projection to the x axis or y axis 12 CHAPTER 2 INTRODUCTION 2 4 2 Cutting in a matrix A yy matrix is a twodimensional object which contents are coincident data from an experiment To examine coincident data you can cut out a slice of the matrix which gives you a cut spectrum To actually create a cut spectrum see chapter 5 p 47 you must define a cut gate using the hotkey e Similar to the definition of the fit region you define the left and right border of the cut gate by pressing once for each border Further gates defined with are automatically interpreted as background gates If you want additional cut gates use the hotkey to define them Pressing performs the cut and the cut spectrum will be displayed in the window You can delete your cut and background gates by pressing Jo A gate will then be marked in your projection as shown in figure 2 4 on page 12 500 500 520 540 650 Gin
52. a a a i eg te 22 3 12 Wildcard sie nu ae ue eter te iros SMe yes wont oe dd Sp fey se 23 3 12 1 Wildcard concept GL 23 3 12 2 Example for user defined wildcards 25 3 13 Configuration files lt lt 25 3 14 Remote control lt F 26 3 1 Introduction This chapter describes the user port of Tv It introduces Tv s basic usage from the commandline arguments windows and input modes via the usage of the mouse and the command and menu concept to the defining of hotkeys writing of command files and sending commands from outer space 3 2 Starting Tv You can start Tv with a number of command line options which are described in the following section The usage is tv help shm src rc v s lt ns gt ee lt string gt Where 15 16 CHAPTER 3 BASIC USAGE help prints a list of allowed command line options shm Tv performs operations on spectra from shared memory src the evaluation of the systemwide setupfile site turc is omitted rc the evaluation of the personal setupfile turc is omitted v information about the version is printed s lt ns gt sets the number of spectrabuffer from the default value of 16 to lt ns gt e lt string gt interprets the string and executes the commands 3 3 The windows Two windows appear at your display when you start the program Their titles are tv and tv root 3 3 1 The graphics window tv root see figure 3
53. a shell and loads all matching files As example we load spectra prge0 0121 prge5 0121 tv gt spectrum prge 012345 Tv distributes them to buffers 0 to 5 automatically if these are free tv gt spectrum prge0 0121 8k 1c 2 read to 0 tv gt spectrum prge1 0121 8k 1c 2 read to 1 Tv has read the spectrum files to buffers 0 to 5 using the format 8k lc 2 The second more general way to load multiple spectra is the ls file mechanism see section 4 3 2 p 31 which loads or performs other operations on spectra listed in a special file the ls file The third alternative is the loading of multiple spectra using wildcards see section 3 12 2 p 25 4 3 2 ls file mechanism In order to perform an operation on a group of spectra that you want to load write their names in a so called ls file You can generate an ls file from within Tv for example for the spectra from the last section with the command tv gt Is prge 012345 gt spc file That is where it got its name from The syntax for the ls file command is tv gt s Is lt operation gt lt option gt All operations listed in table 4 1 on page 32 are possible 32 CHAPTER 4 SPECTRA ANALYSIS add Add several spectra to a specified buffer commandget Load spectra and execute command file for each spectrum loaded get Load several spectra subtract Subtract several spectra from a specified buffer Table 4 1 Allowed operations for the ls file comma
54. ac gt lt cursor x value gt lt log gt y fac gt lt cursor y value gt Stretches window section by lt log2 x fac gt in x direction where the center is given by lt x value gt or cursor position and by lt log gt y fac gt in y direction where the center is given by lt y value gt or the cursor position tv gt window view reset tv gt window view reset both tv gt window view reset x tv gt window view reset y 6 10 Miscellanous 6 10 1 alias tv gt alias lt command gt lt alias gt lt arg list gt Execute lt alias gt if lt command gt is entered lt arg list gt is printed if a question mark is entered as argument to lt command gt If no argument is given to alias all alias definitions are printed 6 10 2 ReadMe tv gt ReadMe Prints a copyright information and a list of allowed command line arguments 6 10 3 cd tv gt cd lt pathname gt Changes the current working directory to lt pathname gt If no pathname is en tered you are queried for input and the current working directory s pathname is used as default 6 10 4 command file tv gt command file close Closes a command ile tv gt command file open lt filename gt Opens the command file speccified by lt filename gt 80 CHAPTER 6 COMMAND SUMMARY tv gt command file resume Resumes the graphic and executes the commands from an open command file tv gt command file suspend Suspends the graphic and executes the
55. activate 1 cut activate 0 cut write cut cut activate 1 cut write cut a edit LAF kR Table 5 8 Hotkey for cmp2cut Chapter 6 Command summary Contents 6 1 Introduction ug 57 6 2 Calibration erro ee da ed Re AY WY ee a 58 6 2 1 Calibration efficiency 58 6 2 2 Calibration lefttail 58 6 2 3 Calibration position 58 6 2 4 Calibration righttail ug 58 6 25 Calibration set ai arta we ee Ay DR 58 6 2 6 Calibration startchannel 58 6 2 7 Calibration unit FF ug 59 6 2 8 Calibration width 59 ES CUE rn TN A Gok ae A NR 59 6 3 1 Gut gt actryabec e e ca RY RW O 59 63 2 Cutvattach 4 20 48 a eA y ADY yD ek 59 6 33 Cut creab amp ebe hk les eden ter ede ets sl cer Fy ee 59 G 3 4 Cut directory cs ye h an Se ew ese Se es 59 6 3 5 Cut environment I 59 6367 Quel 313 4 02 3 neg y GY ee Ake 60 631 Cutvmarker o yon ea Eg ego ee eS 60 6 328 Cut matik Le es Se sgin tds ae amp RW CF ea ee 60 6 39 Cut read gen Y Gt y BG Ep lee ee Sl as 60 6 30 Cut TMs a e Aah hes RY an dati a 61 63 Cut status O fh hates ar My A ee ek 61 G 3 12 Cut scale op yf eh ae Soe ee ae Fo ee FR ee a 61 6 3 13 Cut use marker 00000004 61 6 3 4 Cut write 5 23S A Gye ee AD ny 61 6 35 Gut weight iii dd dy o ly td AG 61 6 47 BMG ogres aise sete rr HN Y TYN 62
56. aklist parameter lt arg gt Selects which information is printed at a peaklist label lt arg gt is a list of entries from table 6 8 on page 67 tv gt label peaklist status Lists which values are printed at peak labels tv gt label peaklist write lt filename gt Writes the current list of peak labels to lt filename gt 6 5 4 Label user tv gt label user activate lt title gt Activate user list lt title gt tv gt label user create lt titel gt calibrated uncalibrated Creates labellist lt title gt tv gt label user delete all cursor list lt title gt Delete labels from active list or entire list tv gt label user enter cursor value offset lt coloridx gt string Enter a new label at cursor position or by value The value is interpreted as energy or channel depending on how the list was created see label user create and label user scale The color of the marker can be selected with the argument lt coloridx gt see 4 4 An arbitrary string can be printed as marker when given as the final argument and selected with label user parameter string tv gt label user parameter lt arg gt Selects which information is printed at a user label lt arg gt is a list of entries from table 6 8 on page 67 tv gt label user read tv gt label user read merge lt filename gt lt title gt Reads a labellist from lt filename gt and merges it to lt title gt or the active labellist if no title is specifi
57. ales The scale at the top of the window belongs to the uppermost spectrum shown and the one at the bottom to the lowest So with more than two panes you have spectra without x scale In x or y paned windows the x scales are coupled to all spectra shown So if you set x view markers with in one pane and expand with e the viewport in all panes will be changed In a y paned window see figure 4 2 p 31 all y scales are coupled too tv gt window create paned xpaned ypaned lt name gt lt number gt Paned windows are good means for the comparison of many spectra For example you can create an x paned window for the comparison of four distances of a lifetime experiment with the command tv gt window create xpaned lifetime 4 The remaining window types are composed of two graphic subwindows The fit window is an x paned window in which lower pane the residuum of the fit is shown The cut window has a small subwindow in its upper right corner where the position of the cut marker in the projection is shown see figure 2 5 p 13 tv gt window create fit cut lt name gt Figure 4 1 on page 28 shows an example for the fit window that was created with the command tv gt window create fit fit example In the lower pane the residuum is displayed 1540 1548 Li 56b68 127 Hideg pes Sed 1490 1540 1548 Figure 4 1 A fit of two peaks in a Co spectrum in the special fit window In the lower pan
58. ame or with the command tv gt cut environment matrix1 220Th Tv loads the environment to the buffers that are by default set to the values listed in table 5 3 Using the commands from chapter 5 2 one can define more than one environment and perform cuts in several matrices simultaneously Cut Matrix Projection Spectrum Table 5 3 Default buffers for the cut environment command The single commands executed by the cut environment command are tv gt cut matrix open matrix1 220Th 220Th mtx tv gt spectrum read matrix1 220Th 220Th pry tv gt cut directory open matrix1 220Th 220Th cutdir 5 4 Creating cuts To create a cut you have to define a set of gates You can do this in several ways e g with the hotkey c or the according command tv gt cut marker cut enter cursor 50 CHAPTER 5 MATRIX ANALYSIS The first two markers define the positive gate whereas the following marker pairs define background gates Another way is to enter the markers by their channel or energy You can switch between channel and energy with the commands tv gt cut scale marker default tv gt cut scale marker calibrated tv gt cut scale marker uncalibrated and the marker is set with the command tv gt cut marker cut enter value Since you can set only one positive gate by using the hotkey Tv offers a possi bility to set further gates with the hotkey or the according command tv gt cut marker gate enter cursor Another way to define backgroun
59. and we load the spectrum ge0 0121 after the above operation Tv places it to the next free buffer tv gt spectrum home fitz spec 0121 prge0 0121 tv gt spectrum prge0 0121 8k 1c 2 read to 4 This loads the 8k spectrum which is saved in mfile format see appendix C p 101 with linecompress mode 2 to buffer 4 To force Tv to use a certain format you have to specify it either while loading a spectrum with get or read or by setting the default format with the format command Choosing the wrong format tv gt spectrum prge0 0121 16k lc 2 will result in an error fatal cannot read spectrum prge0 0121 16k 1c 2 vsSpectra could not set mfile format fatal illegal input spectrum Here is an example for the format command tv gt spectrum format input 16k lc 2 The maximum number of buffers is set to 16 by default and may be specified in the command line see section 3 2 p 15 when Tv is started 1 The mfile library was programmed by S Esser as diploma thesis for the IKP and is a tool for the saving and loading of compressed spectra The compression factor is about 1 5 4 3 LOADING AND SAVING OF SPECTRA I O 31 8000 prge0 0121 prge0 0121 prge0 0121 Lo prge0 0121 Figure 4 2 Ypaned window with the a spectrum loaded to all four panes 4 3 1 I O with multiple spectra To load multiple spectra with the get command you may use filename patterns Tv expands the patterns like
60. arameter background hold and the exponential term is activated by setting the parameter FAC to nonzero with 42 CHAPTER 4 SPECTRA ANALYSIS Hotkey tv gt fit mark bg region enter cursor Set background region marker nen AS tv gt fit mark peak enter cursor Set a peak marker at cursor po A eee eed r tv gt fit mark region enter cursor Set fit region marker at cursor b tv gt fit mark bg region delete cursor Delete background marker clos emul ee reese Tame mr SS cursor to cursor A tv gt cut mark cut delete Delete all markers You will tv gt window hide mark cut still see markers which are tv gt fit mark fit delete part of the autonomous fit tv gt fit delete tv gt window hide mark fit tv gt label user delete all tv gt normalization mark delete tv gt recalibration marker delete all tv gt fit mark fit delete Delete the current fit and tv gt fit delete all its markers tv gt fit delete activ tv gt window hide mark fit tv gt fit mark fit delete Creates a quick fit tv gt fit delete tv gt fit mark peak enter cursor tv gt fit mark region enter offset 10 offset 20 tv gt window view full y tv gt fit region create tv gt fit status short tv gt window show fit function marker P tv gt fit mark peak delete 0 uncalib 8192 un Delete all peak markers dam de tv gt fit parameter peak hold Prevent peak position from being Peele eee ee IRA eae fitted P b h tv gt fit param backg
61. at high endian 4 byte IEEE float high endian 8 byte IEEE float signed LE2 signed HE2 matrix file VAX F format 4 byte float VAX G format 8 byte float PC Mate spectra format ASCII spectra Integer or Double trixi save_matrix format triagonal LE2 triagonal LE4 triagonal HE2 triagonal HE4 Table C 1 File formats from the mfile header file The order of bytes in a data word is described by its endianess With high big endian byte order the bytes are numbered consecutively from left to right in a word 101 102 APPENDIX C FILE FORMATS With little endian byte order the byte numbering is reversed as you go from right to left The format of a spectrum is given in the following manner lt levels gt lt lines gt lt columns gt lt element format gt lt version gt like for example 1k 2k 4k he4 which characterizes a cube with 1024 levels 2048 lines and 4096 columns with 4 byte elements total size 35 GB coded in high endian format Allowed abbreviations in the sizes of levels lines and columns are k kilo m mega Appendix D The fit background and measure functions Contents D 1 Fit functions G G 103 D 2 The background functions lt lt 105 D 3 Measure functions 105 D 1 Fit functions There are two alternative parametrizations for the peaks Both have proven to yield comparable results The latter reduces the correlation betwee
62. ault values are 0 2 0 4 and 0 6 chars for the tic lengths and 0 75 chars for the distance 6 9 WINDOW 77 tv gt tv gt tv gt window setup frame widths lt left gt lt right gt lt bottom gt lt top gt Defines the widths of the left right bottom and top frame Default values are 3 3 2 and 2 chars in the order of arguments window setup histogram compression tv gt window setup histogram compression each Compresses a group of channels by taking the average of all these chan nels tv gt window setup histogram compression first found Compresses a group of channels by taking only the first of these channels tv gt window setup histogram compression min max Compresses a group of channels by taking only the channel with the minimum or maximum number of counts depending on the sign window setup keyboard focus title lt subwindow gt cursor none Selects the window where the input entered in the text window will be eval uated It can be a lt subwindow gt the window where the cursor is positioned or none 6 9 11 tv gt tv gt tv gt tv gt Window show window show cut tv gt window show cut spectrum lt index gt Display the spectrum attached to the active cut tv gt window show cut projection Display the projection attached to the active cut tv gt window show cut gate marker Display the gate markers for the activ cut window show fit tv gt window show fit bin list
63. commands from an opened command file 6 10 5 edit lock tv gt edit lock Some commands need alphanumericalinput which is not possible in cursor mode edit lock escapes from cursor mode until the next RETURN 6 10 6 graphic tv gt graphic resume tv gt graphic resume forced tv gt graphic suspend You may switch off the graphical output to accelerate automated operations e g the time shifting of projections suspend and resume have to be used in pairs i e if you have suspended the graphic n times you have to resume it n times The suspend counter can be resetted with resume forced 6 10 7 input mode tv gt input mode cursor Switches the input mode to cursor mode see section 3 4 2 p 18 tv gt input mode edit Switches the input mode to edit mode see section 3 4 1 p 18 6 10 8 keyalias tv gt keyalias lt keysequence gt lt alias gt Without arguments the entire table of hotkeys see chapter A p 83 is shown If a keysequence is given as argument only the alias for this hotkey is shown and if an alias is given besides the keysequence it will be added to the hotkey table if not existent or redefined in the other case 6 10 9 keyunalias tv gt keyunalias lt keysequence gt The lt keysequence gt is deleted from the hotkey table 6 10 10 keytable tv gt keytable activate lt title gt Deactivates the currently used keytable and activates the keytable named lt title gt tv gt keytable ascii
64. complete command will put you in another menu For example if you only enter tv gt window Tv will be in the menu window afterwards This is indicated by changing the command prompt tv gt to the name of the menu window All commands are interpreted relative to the menu you are in i e they are ap pended to the menu name For example window spectrum get co56b68 127 will result in the error 20 CHAPTER 3 BASIC USAGE fatal illegal input window spectrum get co56b68 12T since spectrum is not an available command to the window menu Tv accepts absolute commands from any menu if preceded by tv gt You will be in the same menu after the evaluation of your command To load the spectrum from the example above enter window tv gt spectrum get co56b68 127 To see a list of all arguments available to a command for example the window command enter tv gt window Some menus have default commands which do not need to be entered These are underlined in the manual For example the default command to the spectrum menu is get To load a spectrum you can enter tv gt spectrum get co56b68 127 tv gt spectrum co56b68 127 or go to the spectrum menu tv gt spectrum and enter the spectrum s name spectrum co56b68 127 To leave a menu and go to the menu one level higher enter cR 3 7 Abbreviations Every command can be abbreviated Note that if the abbreviation is ambiguous Tv takes the first matching alias or if not existant the fir
65. d gates is the command tv gt cut marker bg gate enter value To perform the cut press the hotkey or enter the command tv gt cut create cut The background gates are weighted against the positive gates The more back ground you mark the better it is because it reduces the statistical error The background is weighted by gatewidth by default and can be weighted by volume too The commands to switch the weight are tv gt cut weight gatewidth tv gt cut weight fit It is evident how important it is to choose correct background gates as is shown in figures 5 1 on page 50 5 2 on page 51 and 5 3 on page 51 550 600 650 209 cite a B50 ata 220Th tig0 pry 672_ cut AIR LEAU EUR MUN A a 1000 1500 2000 2500 3000 3500 4000 Figure 5 1 Cut without background gates If you want to use the cut markers from another cut in the active cut you can do this with the command tv gt cut use marker lt index gt which copies the gates from cut lt index gt to the active cut If you have found a good set of gates but want to look for an even better one you can store the current gates and background gates with the store commands tv gt cut marker gate store tv gt cut marker bg gate store 5 4 CREATING CUTS cut good bg 1 si c1 1 dO n0 15 550 600 850 700 j eso 900 220Th tig0 pru Figure 5 2 Cut with good background gates cut bad bg 1 s
66. d switches the printing of the calibrated position on while nocalibrated turns it off tv gt label cut fit peak user libr cali noca unca noun stri nost You can manage several labellists at once The commands for creating a new labellist and activating an existent one are 34 CHAPTER 4 SPECTRA ANALYSIS tv gt label user create lt title gt tv gt label user activate lt title gt You can use labels to mark peaks in plotted spectra To mark a peak with an arbitrary string the following command is used tv gt label user enter lt position gt lt colorindex gt lt string gt The colors are given in table 4 4 Colornde Color Colorindex Color yellow r fo magenta 8 MediumOrchid firebrick a red EE seashell4 me fo cyn 13 fyo Table 4 4 Colorindices for labels white 10 11 LightSlateBlue 13 Sometimes markers are disturbing in printouts Therefore they can be switched off and turned on with the following commands tv gt window hide labellist user tv gt window show labellist user Since you want to plot paned windows sometimes and the simple window named plot has one frame only you can change the frame widths of the window panes For example create a paned window with three frames move the cursor to the upper frame and enter tv gt window setup frame width 9 9 3 0 Then move the cursor to the center pane and enter tv gt window setup frame width 9 9 0
67. d menus tv gt fit read bin position first last next previous index Reads a fit from file lt specname gt fit according table 6 6 tv gt fit read fit first last next previous Reads a fit from file lt specname gt fit according table 6 6 tv gt fit read integration first last next previous Reads an integration from file lt specname gt fit according table 6 6 tv gt fit read record first last next previous index Reads an entry from file lt specname gt fit according table 6 6 6 4 17 Fit recover backup tv gt fit recover backup lt index gt all shown active Recovers fit for the buffers defined by the additional argument The default value is the active buffer 66 CHAPTER 6 COMMAND SUMMARY 6 4 18 Fit restore tv gt fit restore Restores fit from memory see f t restore 6 4 19 Fit result file tv gt fit result file tv gt fit result file append open lt filename gt Open protocol file lt filename gt to append fit results printed with fit print tv gt fit result file close Close protocol file tv gt fit result file format Function bg polynom Format to save the background polynom to a file bg exponential Format to save the exponential part of the background to a file fit Format to save the results from a fit to a file integration Format to save the results of an integration to a file mark Format to save markers to a file peak fit Format to
68. e the residuum is displayed 4 3 LOADING AND SAVING OF SPECTRA I O 29 To delete the graphic window named fit example use the command tv gt window delete fit example 4 2 2 Configuration of graphic windows When more than one graphic window is existent it is not definite where commands entered in the text window are evaluated A focus to the window must be set where commands concerning the window should be evaluated These are for example com mands to plot a window change the y scaling or change its habits e g frame width or tic length All commands to configure the graphic window are listed in section 6 9 on page 74 of chapter 6 By default to set the focus to a window you have to move the mouse into the window You can set the keyboard focus to a certain window named lifetime with the following command assuming it exists tv gt window setup keyboard focus title lifetime and switch back to default behaviour by pressing hotkey or with the command tv gt window setup keyboard focus cursor There are three values for the short medium and long tic lengths in this order and another one for the distance between the axis label and the tic The command to change these values which are given in the unit character size is tv gt window setup frame length 0 2 0 4 0 6 0 75 Another group of commands configures the y scale of the windows For example to set the y scale to logarithmic scale you have to enter the commands t
69. ed tv gt label user read replace lt filename gt lt title gt Read a labellist from lt filename gt and replaces lt title gt or the active labellist if no title is specified tv gt label user scale lt title gt calibrated uncalibrated Defines how values are interpreted for user labellists 6 6 NORMALIZATION 69 tv gt label user status active existing Lists which values are printed at user labels tv gt label user write lt filename gt lt title gt Writes labellist lt title gt to lt filename gt 6 6 Normalization The normalization as it is performed with the command see section 6 8 14 on page 73 tv gt spectrum norm lt index gt active all shown visible 6 6 1 Normalization marker tv gt normalization marker delete Deletes set of normalization markers tv gt normalization marker enter cursor value offset The first two markers define the normalization area pairs of following markers define normalization background areas tv gt normalization marker list Lists all defined normalization markers tv gt normalization marker read lt filename gt Reads set of normalization markers from file tv gt normalization marker restore Restores previously saved set of normalization markers from memory tv gt normalization marker store Stores set of normalization markers to memory tv gt normalization marker write lt filename gt Saves set of normalization markers to file
70. en in the following list Chapter 1 Describes the typographic conventions used to emphasize certain parts of the text as there are for example commands and filenames Chapter 2 Gives an introduction to the main topics of Tv with examples to each item The basic commands are explained in their most simple form and you will be able to use the program to do simple evaluation after reading this chapter Chapter 3 Describes the basic usage of Tv starting from commandline arguments windows and input modes via the usage of the mouse and the command and menu concept to the defining of hotkeys writing of command files and sending commands from outer space Chapter 4 Shows how to load one or more spectra and perform all necessary operations to analyze the data as there are choosing of the best window type calibration recalibration normalization arithmetic operations integration and fit as well as peaksearch Chapter 5 Explains all necessary operations to work with matrices cuts projec tions spectra and buffers 4 LIST OF TABLES Chapter 6 Shows a detailed list of all Tv commands This chapter is addressed to advanced users who want to know all the mysteries and secrets It lists all commands in alphabetical order and gives a short description for each of them Copying Before copying the program Tv you must obtain an appropriate license from the authors To get a license fill in the attached License Agreement for Tv sec appendix
71. er lt index gt 6 8 SPECTRUM 73 6 8 11 Spectrum maximum tv gt spectrum maximum lt index gt lt index gt active all shown visible Sorts spectrum with maximum peak height from spectra defined by the last argument to the spectrum in buffer lt index gt 6 8 12 Spectrum minimum tv gt spectrum minimum lt index gt lt index gt active all shown visible Sorts spectrum with minimum peak height from spectra defined by the last argument to the spectrum in buffer lt index gt 6 8 13 Spectrum multiply tv gt spectrum multiply lt factor gt lt index gt active all shown visible Multiply spectra defined by the last argument with the factor lt factor gt 6 8 14 Spectrum norm tv gt spectrum norm lt index gt active all shown visible Normalizes the spectra defined by the argument see also 6 6 All normalized spectra are marked in the spectrum status with the character 6 8 15 Spectrum offset tv gt spectrum offset lt offset gt lt index gt active all shown visi ble Adds offset lt offset gt to spectra defined by the last argument 6 8 16 Spectrum read tv gt spectrum read lt filename gt lt index gt active all shown visible Reads a single spectrum lt filename gt to buffers defined by the last argument 6 8 17 Spectrum resolution tv gt spectrum resolution lt index gt lt resolution gt Changes resolution of s
72. erformed using the ls file mechanism described in section 4 3 2 on page 31 To delete the just defined wildcard calspc use the command tv gt wildcard delete calspc 3 13 Configuration files Tv allows you to configure its behaviour in a wide range by using aliases see section 3 9 p 20 changing the window appearence see appendix B p 91 i e colours and cursorforms and defining the hotkeys for the cursor mode see section 3 11 p 22 For all these purposes you can use configuration files which are evaluated by Tv automatically at startup or which you have to start from automatically evaluated files or by hand If the environment variable TVPATH is not set Tv looks for configuration files in the following order Only one tvrc is evaluated 1 ikp local lib to site tvrc 2 ikp local lib tu turc 3 lt current working directory gt tvrc If TV PATH is set only the directories defined in this variable are scanned First for site turc and afterwards for tvrc Set TVPATH in your bashrc with export TVPATH TVPATH ikp local lib tv 26 CHAPTER 3 BASIC USAGE 3 14 Remote control Since Tv does not support any control structures like loops or branchings an extension was programmed to send commands to Tv from any script language The program that fulfills this is called Srv stands for send tv For example i 1 while test i 85 do stv tv gt s i spc i expr i 1 done started fro
73. ew expand Expand viewport to the x range between markers set with tv gt window view full both Expand visible part to tv gt edit Gueries a spectrum name tv gt edit Gueries a position by energy tv gt window view full y and displays 100 channels with tv gt window view position 100 the given position in center tv gt edit Gueries a buffer number tv gt spectrum delete and deletes the according spec trum BF oi Fu tv gt spectrum delete all Deletes all spectra and reads tv gt spectrum ls file get according to the ls file rules sec 6 8 10 p 72 tv gt spectrum delete all Deletes all spectra and reads tv gt spectrum ls file get according to the ls file rules sec 6 8 10 p 72 tv gt edit Asks for spectra to be loaded tv gt spectrum ls file get and reads according to the ls file rules see 6 8 10 p 72 tv gt edit Queries an ls file name tv gt window show peaklist window show labellist peaklist tv gt fit open active tv gt window show fit bin list Display bin markers Eu LA E El tv gt window show fit decomposition Display decomposition of the tv gt fit open active fit for the active spectrum tv gt window show fit function marker Display fit function and marker To be continued Zz El ap 88 APPENDIX A THE DEFAULT HOTKEY TABLE Hotkey m n tv gt window show spectrum next Display next spectrum in bufferlist tv gt window show s
74. f your spectrum and their corresponding energies calibration To calibrate a spectrum you need to identify two peaks in the spectrum or a calibration from a calibration spectrum The energies of these positions can be determined from a calibration spectrum If you know two channels and their corresponding energies you can define the calibration with the command tv gt calibration position enter lt chn gt lt energy gt lt chn gt lt energy gt If you have a calibration in a file you can load it To load a calibration you can either use the hotkey to load the default calibration file cal or you switch to the text mode and enter the full command tv gt calibration position read lt calfile gt You can abbreviate this command with tv gt cpr lt calfile gt 2 3 5 Plot Plotting with Tv may not lead to sufficient results at the first attempt Probably you will miss the inscription at the y axis The reason is that the frame width for left and right frames is set to 3 by default see section 3 3 p 16 There are two ways to get sufficient plots The first way is to create a window with the name plot which has frame widths of 9 for the left and right border To create the window enter the command tv gt window create simple plot Another way is to change the frame widths of your window You can do this with the command tv gt window setup frame width lt I gt lt r gt lt b gt lt t gt The most convenient format to plot your
75. figure is the xfig format because you can process and convert plot files with the program xfig The plot is performed by pressing P x Alternatively you can use the unix format by pressing P u In both cases you will be gueried a filename at the filename prompt forces the standard filename for plots to be taken this is composed from the spectrum name and a suffix defined by the wildcard see section 3 12 p 23 for plots which is fig by default A sample plot exported to ps via xfig is shown in figure 2 3 on page 11 2 4 Analyzing a yy matrix 2 4 1 Opening a matrix To analyze a yy matrix you need a matrix written in mfile format The default extension of the matrix filename is mtx Furthermore you need the projection on the x or y axis with the default extensions prx or pry All three files must be located in a directory with the same basename as the matrix e g sec table 2 1 on page 11 To open the matrix for analysis use the hotkey and you will be gueried the name of the directory containing the matrix 1 To convert a matrix to an appropriate format use the program matconv 2 The projection can be created using the program matproj 2 4 ANALYZING A yy MATRIX 11 gt xs N o S AAA ASAS 220Th tig0 pry S 490 64 S 490 64 Y ES N
76. fit para position0 none Peak 0 is removed from the peak list This hotkey is available for peaks 1 to 4 either tv gt edit tv gt fit para position The position of peak 0 is set to the queried value This hotkey is available for peaks 1 to 4 either tv gt fit param backgr hold The background parameters tv gt fit param exponent hold will not be fitted tv gt fit param factor hold tv gt fit param backgr free The backfround parameters tv gt fit param exponent free will be fitted tv gt fit param factor free we tv gt fit parameter width equal The widths of all peaks will be correlated tv gt fit parameter position hold The peak position will not be fit ted tv gt fit parameter width hold The peak width will not be fitted tv gt fit parameter width equal The widths of all peaks will be correlated tv gt fit parameter width free The widths of all peaks will be fitted Table 4 8 Hotkeys to hold free and set parameters El 3 efa E 4 13 Saving and loading fits The results from fits and integrations can be saved to a file As with the peaksearch one can decide to save the data as binary or asciitext Again data can be loaded from binaryfiles only To save data to the binaryfile lt spectrumname gt fit the following command tv gt fit write will be used or the hotkey s f To read data from this file the following commands can be used tv gt fit read bin position first last next pre
77. fset 10 offset 20 tv gt window view full y tv gt fit region create tv gt fit status short tv gt window show fit function marker Eepe Sit read bin position cursor Reads At at cursor position Tejo ld evs ft read bm fle Readsfst At from flo Tejo la tS trad bm next Readene fit from fitfile TR b p t gt ft read bin position cursor Reads ft at cursor position IR cfc tv gt cut read cut cursor Reads cut spectrum and a set of cut markers at the cursor posi tion Pee the first set of cut markers Er the next set of cut markers PRY wo We read We fate Read the fest Bi from file dat read fit mexty Read the next fit from le IR bh c tv gt cut read head cursor Reads the set of cut markers at cursor position and performs the cut BSE and performs the cut R h n Reads the next set of cut markers and performs the cut To be continued 87 Hotkey ae fitfile ifn tv gt fit read integration next fitfile sor position a E3 retain ces and enter the recalibration tv gt recalibration create and creates the recalibration BWL wm OSS A s e tv gt cut write cut Writes a cut to file ea Ex Tn Y YHA ci AA a tv gt edit Queries a buffer number and EZ spectrum activates sat acting spectrum b tv gt fit mark bg region enter cursor Set background region marker A A lle tv gt cut mark cut enter cursor Set cut marker at cursor position tv gt window vi
78. gion by pressing the hotkey once for the left and once for the right border of this region You can also define background regions by using the hotkey e and create the background fit with or the command tv gt fit background create The integration is created and a short status printed by pressing hotkey 1 If you Just want to create the integration use the command tv gt fit integration create and print the results of integration with tv gt fit status full short where full status gives detailed information about the background and all pa rameters of the peak 4 12 FIT AND INTEGRATION 39 4 12 2 Peaksearch To obtain a list of all peaks in a spectrum Tv offers a peaksearch function The fit function used is a simple gaussian with constant background Before performing the peaksearch it is necessary to apply a width calibration to determine the width of the gaussian To get the two widhts you need for width calibration you can use the guickfit and to perform the width calibration use tv gt calibration width lt chnlo gt lt widtho gt lt chnl gt lt width gt The amplitudes of the gaussian and background are fitted and the probability inte gral is compared with a given limit which is 99 99 by default You can determine the current probability limit and set a new value with the command tv gt fit psearch probability lt limit gt If the probability integral exceeds the limit the peak position is determined to
79. her homes or organizations shall be clearly and conspicuously indicated in all such copies Under no other circumstances than provided in this paragraph shall a modified copy of Tv be represented as Tv The user will ensure that all their copies of Tv whether modified or not carry as the first information item the following copyright notice e Copyright J Theuerkauf S Esser S Krink M Luig N Nico lay O Stuch H Wolters at the Institute for Nuclear Physics 107 108 10 APPENDIX E LICENSE AGREEMENT Cologne 1993 All rights reserved Copying of this file is authorized to users who have executed the true and proper License Agreement for Tv and License Agreement for mfile with the Institute for Nuclear Physics Cologne In particular the authors prohibit to use any part of the code or algorithms of this software in other programs without an additionally negotiated license Title to and ownership of Tv and its copies shall at all times remain with the IKP and those admitted by the IKP as contributors to the development of Tv The user will return to the IKP for further distribution modifications to TV modifications being understood to mean changes which increase the speed reliability and existing functionality of the software delivered to the users The user may make for his own ownership and use enhancements to Tv which add new functionality and applications which employ Tv Such modules may be returned to the
80. i c1 1 d0 m0 15 672_ cut 550 600 850 700 5 890 900 t 220Th tig0 pru 672_ cut 1000 1500 2000 2500 3000 3500 4000 Figure 5 3 Cut with bad background gates ol 52 CHAPTER 5 MATRIX ANALYSIS and resume them with the according restore commands To perform a new cut you have to delete the gates from the previous cut first Again you have to separately do it for the gates and background gates If you want to delete both you can use the hotkey Ic 5 5 Saving and loading cuts Cuts can be saved to and loaded from disk Cuts are saved in the cutdirectory where a subdirectory is created for each cut The name of the subdirectory is given by the energy or channel where the cut is performed and an attached underscore and index By means of the index more than one cut can be performed at one position A cut performed at channel 1105 of the 22T A matrix will be saved with the command tv gt cut write cut or the according hotkey in the cutdirectory 220Th 220Th cutdir 1105_0 The markers are written to file 1105_0 gate and the cutspectrum is saved in file 1105_0 cut To load cuts different commands are given One can choose to only load markers or to load markers and spectrum at once In the first case the loaded markers are used to perform a cut The commands to load markers only or markers and spectrum together at the position defined by the cursor are tv gt tv gt cut read head curso
81. index gt active all shown visible Shifts spectra defined by the last argument with respect to spectrum in buffer lt reference gt All shifted spectra are marked with the character lt in the spectrum status 6 7 3 Recalibration delete tv gt recalibration delete lt index gt active all shown visible Deletes recalibrations for the spectra defined by the argument 6 7 4 Recalibration marker tv gt recalibration marker delete all range cursor value offset Delete recalibration region marker tv gt recalibration marker enter cursor value offset list read lt filename gt restore store write lt filename gt Handle recalibration region marker 6 7 5 Recalibration list tv gt recalibration list lt index gt active all shown visible Lists recalibrations for spectra in buffers defined by the argument 6 8 SPECTRUM 71 6 7 6 Recalibration read tv gt recalibration read lt filename gt lt index gt active all shown visible Reads recalibrations from file lt filename gt to spectra defined by the last ar gument 6 7 7 Recalibration type tv gt recalibration type center of mass sguared distance pair poly nom Defines which method is used to recalibrate spectra 6 7 8 Recalibration write tv gt recalibration write lt filename gt lt index gt active all shown visible Writes recalibrations for spectra defined by
82. ing cuts o ee 49 5 5 Saving and loading Cuts o 52 5 6 Comparing Matrices lt lt 52 DO NEMPZSPOS dots ei A a A AA e 33 562 lt CMP2MAby i cA a e a Bote A ds Ee 33 06 37 CMpPZEUb da A A de A de Bd ed 34 5 1 Introduction The analysis of coincident data is important since most gamma spectroscopy experiments yield such data This chapter explains all necessary operations to open the matrix attach the according cuts projections spectra and buffers Furthermore it is shown how to cut in a single matrix or in several matrices simultaneous 5 2 Setup To create a cut you need a matrix its x and y projection a set of markers and a buffer for the cut spectrum Tv can manage an arbitrary number of matrices projections cuts and spectra By default Tv offers 16 buffers see section 3 2 p 15 for storing matrices cuts spectra and directories Their names are composed of the first character of the buffer type and the buffer number e g c0 cl5 for the cut buffers 47 48 CHAPTER 5 MATRIX ANALYSIS 5 2 1 Attachments Tv needs relations between matrix spectrum cut and directory buffers which are called attachments For example if you create a cut the associated gates will be applied to the attached matrix and the cut spectrum will be written to the attached spectrum buffer If you save the cut the cut spectrum will be written into the attached directory By default Tv
83. ing modification y multiplied Multiplies the contents of each channel with the channel number window scaling scale x calibrated default uncalibrated Defines whether entered values are interpreted as energies or channels 6 9 10 tv gt tv gt Window setup window setup cursor tv gt window setup cursor cross hair Sets graphic cursor to cross hair tv gt window setup cursor vertical Changes nothing tv gt window setup cursor subwindow tv gt window setup cursor subwindow cross hair Sets graphic cursor to cross hair tv gt window setup cursor subwindow doppler lt factor gt Changes cursor to a grid with a number of elements of 1 and offset depending on cursor position The default value for lt factor gt is 0 tv gt window setup cursor subwindow grid lt number gt lt offset gt Changes cursor to a grid with lt number gt of lines to the right and to the left of the vertical cursor line The distance between the lines is lt offset gt scale units The default values for lt number gt and lt offset gt are 0 window setup frame tv gt window setup frame distances lt tic gt lt label gt Defines the minimum distances between tics and labels Default values are 0 3 characters chars for tics and 3 chars for labels tv gt window setup frame lengths lt short gt lt medium gt lt long gt lt dist gt Defines the short medium and long tic lengths and the distance between tic and axis label Def
84. ion 4 8 p 34 at the bottom x scale if an energy calibration is loaded The scales are positioned in the frame The grip is used to move the line between the status window and the top frame You can switch the y scale between linear logarithmic and squared scale with the aliases tv gt lin tv gt log tv gt qua You can change the viewport this is the visible part of the spectra in many ways with the hotkeys listed in table 3 1 on page 17 Key tv gt window mark vertical enter cursor Set vertical markers to define x Hia tv gt window view full y Zoom out 9 tv gt window view stretch 1 to 9 cursor 0 see appendix A on page 83 tv gt window view full y Move the viewport to the left tv gt window view full y Move the viewport to the right tv gt window view full y Zoom out fees window view canoe op AIID 1 tv gt window view full y Zoom in a tv gt window view stretch 1 to 9 cursor 0 see appendix on page 83 x tv gt window view full y Move the cursor to the left gt tv gt window view full y Move the cursor to the right tv gt window view expand Expand viewport to the x range between markers set with Spacebar tv gt window view full both Expand visible part to 5 eS windon view expands fle x tv gt window view full x Expand viewport to full size in MM eden y tv gt window view full y Expand viewport to full size in LM TN AN tv gt window view full y Center the spectra around Mm tv gt window vie
85. ion and press r again for the right border of the fit region Now mark all peaks to be fitted inside the fit region by pressing p over each peak Then you can perform the fit by pressing E Optionally you can further improve the fit by defining an arbitrary number of background regions using the hotkey e once for left border and once for right border of each background region Press to fit spectral background in side the background regions and to fit peak s The background fitted to the background regions will be used for the fit inside the fit region Note though Tv supports only one fit region any number of background regions can be defined for the fit Figure 2 2 shows a spectrum with fit Peak region marker Peakmarker Background region marker 25e4 4 20574 Figure 2 2 Graphic display window with a Th projection spectrum loaded and a fit attached You can see the fit region surrounding the peaks which have peak markers on them as well as two background regions with the fitted background function Moreover the fit function is displayed To remove either a guickfit or a normal fit use the hotkey EIE This will remove the region markers from the graphic window and delete the fit You have to do this before you can fit another peak 10 CHAPTER 2 INTRODUCTION 2 3 4 Calibrating a spectrum To identify peaks with transition energies from a decay you need a relation between the channels o
86. it see section D 2 6 4 3 Fit bg function tv gt fit bg function definition Prints the definition of the background function see section D 2 6 4 4 Fit region create tv gt fit region create Creates a fit for the region defined by region markers 6 4 5 Fit integration create tv gt fit integration create Integrates the region defined by region markers 6 4 6 Fit delete tv gt fit delete Deletes the fit and all its markers 6 4 7 Fit function tv gt fit function background definition Prints the definition of the background function tv gt fit function peak tv gt fit function peak activate continuous additive Queries the fit function to use see D tv gt fit function peak definition continuous additive Prints the definition of the fit function tv gt fit function peak exponent tl tr Gueries the exponent for the left or right tail term of the fit function 6 4 8 Fit list tv gt fit list Lists all fits and prints some information about them 6 4 FIT 63 delete Delete marker enter cursor value offset Set new marker list List all markers read lt filename gt Read list of markers from file restore Restore markers from memory number lt multiple single gt store Store markers to memory write lt filename gt Save list of markers to file Table 6 4 Commands allowed to the fit marker menu 6 4 9 Fit marker tv gt fit marker bin delete enter list
87. it store tv gt fit store Stores the current fit to memory see fit restore 6 4 23 Fit use fitdata tv gt fit use fitdata lt index gt active The markers from buffer lt index gt will be used for the active buffer 6 4 24 Fit write tv gt fit write Saves the fit with all its parameters und markers to the file lt specname gt fit 6 5 Label library calibrated Calibrated energy is printed nocalibrated Calibrated energy is not printed uncalibrated Uncalibrated energy is printed nouncalibrated Uncalibrated energy is not printed string The info string is printed nostring The info string is not printed Table 6 8 Possible arguments for the parameter command 6 5 1 Label cut tv gt label cut parameter lt arg gt Selects which information is printed at a cut label lt arg gt is a list of entries from table 6 8 on page 67 tv gt label cut status Lists which values are printed at cut labels tv gt label cut write lt filename gt Writes the current list of cut labels to lt filename gt 68 CHAPTER 6 COMMAND SUMMARY 6 5 2 Label fit tv gt label fit parameter lt arg gt Selects which information is printed at a fit label lt arg gt is a list of entries from table 6 8 on page 67 tv gt label fit status Lists which values are printed at fit labels tv gt label fit write lt filename gt Writes the current list of fit labels to lt filename gt 6 5 3 Label peaklist tv gt label pe
88. itted to enter it The difference between read and get is that read loads one spectrum into one or more buffers you have to specify manually whereas get loads them to the next free buffers automatically selected by Tv write saves the spectra to the defined files It operates on all only the shown or the active spectra or on spectra defined by the index list format sets the format for the input or output of spectra input is the default value to this command For a list of allowed formats see appendix C on page 101 Tv performs I O operations using the mfile library If you want to read spectra not written in mfile format it may be necessary to specify the spectrum format explicitely For example you want to load the spectrum prge0 0121 to buffers 0 to 3 and display them for comparison in a y paned window see section 4 2 1 p 28 You create the window with the command tv gt window create ypaned ypwindow 4 and Tv prints which spectrum and cut is active in each pane yp window O spectrum 0 active yp window O cut 0 active yp window 1 spectrum 1 active If the window exists load the spectrum with the command tv gt spectrum read home fitz spec 0121 prge0 0121 0 1 2 3 and Tv prints to which buffer the spectrum is loaded and copies it to the other buffers tv gt spectrum prge0 0121 8k 1c 2 read to 0 tv gt spectrum 0 copied to 1 This results in the window shown in figure 4 2 on page 31 As an example for the get comm
89. lete Delete cut markers tv gt window hide mark cut tv gt window hide fit decomposition Hides the decomposition of a fit tv gt fit mark fit delete Delete the current fit and tv gt fit delete all its markers tv gt fit delete activ tv gt window hide mark fit tv gt fit mark peak delete 0 uncalib 8192 un Delete all peak markers calib p tv gt fit mark peak delete cursor Delete peak marker closest to cursor Je tv gt fit mark bg region delete all Delete all background markers PEA eee est to the cursor eed cursor Ea closest to cursor lll tv gt label user delete cursor Delete user label n tv gt normalization mark delete Delete the normalization mark ers Be tv gt fit mark region delete cursor Delete fit region marker closest to cursor R tv gt recalibration marker delete cursor Delete recalibration marker clos est to cursor w n tv gt window scaling function y normalization tv gt window view full y Move the viewport to the left Ha tv gt window view full y Move the viewport to the right o tv gt window view full y Zoom out show 50 of channels a5 window view UU A tv gt window view full y Zoom in show 200 of channels iS window view O n tv gt window view full y Zoom in show 400 of channels E E window view O n O Aora tv gt window view full y fees window viov sesia Seamer tv gt window view full y LM DI tv gt window view full y LM DD
90. local lib tv tvkeys which contains the hotkey definitions for the cursor mode The contents of this file is shown in appendix A on page 83 3 12 Wildcards Tv supports a wildcard mechanism for filenames which have special meaning for certain commands and datatypes 3 12 1 Wildcard concept If you want for example to analyse a matrix you need the matrix itself its projec tion and a directory where the results will be saved Using wildcards you need not to enter all three pathnames but only one basename Therefore the three compo nents have to follow a certain naming convention defined by the according wildcard A matrix filename must have the extension mtx by default and furthermore it must be saved in a directory that has the same name as the basename of the matrix If you want to load the matrix 220Th mtz it must be in the directory 220Th The default wildcard for matrices is mtx f t mtx which is resolved in table 3 4 on page 23 for the matrix matrix1 220Th 220Th mtx matrix1 220Th 220Th 220Th mtx Table 3 4 Resolved wildcards for the matrix matriz1 220Th 220h miz Besides the matrix you need the projection to the y axis which must obey the wildcard prospe and is according to the default values for the example above matriz1 220Th 220Th pry The directory must obey the wildcard cutdir see table 3 6 p 24 and will be made by Tv if not existing Its pathname is matriz1 220Th 220Th cutdir If you have the
91. lt value gt Set factor or scaling of the exponential term of the background function see section D 2 p 105 Default values are 0 for each of them free Set parameter to be fitted hold Hold this parameters value lt expression gt Set position to the result from lt expression gt none When fitting position the peak will be removed from peaklist the fit of the tail will be suppressed spaced lt parameter gt lt index gt calibrated equal lt parameter gt lt index gt Take value from parameter from buffer lt index gt Table 6 5 Commands allowed to the fit parameter command tv gt fit parameter sh calibrated free hold equal none Defines how to fit step height tv gt fit parameter sw calibrated free hold equal none Define how to fit step width tv gt fit parameter tl calibrated free hold equal none Defines how to fit left tail tv gt fit parameter tr calibrated free hold equal none Defines how to fit right tail tv gt fit parameter volume free hold Defines how to fit volume tv gt fit parameter width calibrated free hold equal Defines how to fit width 6 4 13 Fit peaklist tv gt fit peaklist list Lists peaklist in fit file tv gt fit peaklist print Prints peaklist to protocol file tv gt fit peaklist read Reads peaklist from fit file 6 4 14 Fit print tv gt fit print Writes fit results to protocol file sec fit re
92. m a shell loads 7 spectra STV sends commands only to Tv s which are owned by the user running STV and waits for Tv to finish the command before returning Only the last one started Tv receives the commands or you must ex plicitely define a portnumber This is printed immediately after startup of Tv and saved in the file tu port If you want to send commands to Tv with portnumber 10000 you enter for example i 1 while test i 85 do stv tv gt s i spc 10000 i expr i 1 done Tv shell commands like rm rf sent by STV are ignored Chapter 4 Spectra analysis Contents 4 1 Introduction lt lt 4 2 Graphic window lt lt 4 2 1 Graphic window types 4 2 2 Configuration of graphic windows 4 3 Loading and saving of spectra I O 4 3 1 I O with multiple spectra 2 0 4 3 2 s file mechanism 4 4 Buffer operations 4 5 Usingthemouse lt lt 4 6 Plot and labels lt AT Marker iow se a e 4 8 Calibration lt lt lt lt 4 9 Recalibration lt lt lt 4 10 Normalization lt lt lt lt 4 11 Arithmetic operations 4 12 Fit and integration lt 4 12 1 Integration o 4 12 2 Peaksearch 4 123 Fitting es 46 9 4 Gee be RBG Se Des 4 12 4 Decomposition 4 12 5 Holding parameters constant 4 1
93. marker VMark object range marker VMark object B 2 RESOURCES 99 peaklist label VLabel object peaklist function Peaklistfunction object spectrum Spectrum object GowCutWidget heightRatio HeightRatio float widthToHeight WidthToHeight float GowFrameWidget bottomFrame XFrame int topFrame XFrame int leftFrame YFrame int rightFrame YFrame int ticLabel TicLabel float ticTic TicTic float ticLong TicLong float ticMedium TicMedium float ticShort TicShort float ticSpace TicSpace float GowVsWidget cursorLinestyle CursorLinestyle lt linestyle gt cursorLinewidth CursorLinewidth int xClipMin Clip float xClipMax Clip float yClipMin Clip float yClipMax Clip float VLabel labelLine LabelLine float labelDistance LabelDistance float topSpectrum TopSpectrum boolean channelRadius ChannelRadius int libraryRadius LibraryRadius float Mark crossFraction CrossFraction float upperFraction UpperFraction float lowerFraction LowerFraction float VMark vBarPosition VBarPosition bottom top none Residuum normalized Normalized boolean Spectrum compressMode CompressMode firstfound minmax lineSpace LineSpace float Values of lt color x x gt monochrome gray or colored Values of lt linestyle gt solid longdashed disconnected dotdashed dotted shortdashed 100 odddashed lt Graphic context resources numGCs Xii resources font lt i gt foreground lt i gt background
94. me events are shifted to lower energies and a step in the background will occur You can fit height as well as width of these steps To allow Tv to fit the height of a step you enter tv gt fit parameter sh free The lower pane of figure 4 4 on page 40 shows the difference in the background form The step is fitted as arctan but you can also consider an erf function see section D 1 p 103 You can do this with the command tv gt fit function peak activate additive tail erf step A list of all fit parameter commands is printed in section 6 4 12 on page 63 Table 4 6 on page 42 shows all hotkeys related to the fit commands 4 12 4 Decomposition A spectrum does not only consist of well separated peaks but they often appear as multiplets a line in a spectrum composed of a group of related lines For the decomposition of multiplets a fit must be used Therefore a description of the observed line shapes is necessary Otherwise it is impossible to find the correct number of overlapping lines and to obtain a good description of the spectrum As an example what can happen if you fit a multiplet in the wrong way figure 4 5 on page 43 shows in its upper pane a quickfit As you can see it can not decompose the two peaks In the middle pane a normal fit has been performed with two peakmarkers set and in the lower pane the decomposition is shown You can show or hide the decomposition with the commands tv gt window show fit decomposition tv gt wi
95. n is created The following hotkeys are defined see table 5 6 p 53 Hotkey window scaling function y normalization on window show spectrum 0 1 window show spectrum 5 window show spectrum names window setup histogram compression each cut activate 1 cut read cut position cursor cut activate 0 Table 5 6 Hotkeys for cmp2spc 5 6 2 cmp2mat cmp2mat makes attachments for cuts 0 and 1 Matrices directories and pro jections 0 and 1 are attached as well as spectra 4 and 5 The simple windows projections which shows spectra 0 and 1 and comparison which shows spectra 4 and 5 are created One hotkey is defined see table 5 7 p 53 which creates the cuts for both matrices Hotkey cut activate 0 cut create cut cut activate 1 cut create cut Table 5 7 Hotkey for cmp2mat Finally cmp2mat opens the environments for the two matrices given as command line arguments For example tv gt Gcmp2mat 220Th tig0 220Th tig1 54 CHAPTER 5 MATRIX ANALYSIS The scripts cmp3mat and cmp4mat perform the same operations but for more matrices They take more arguments too 5 6 3 cmp2cut cmp2cut makes attachments for cuts 0 and 1 Matrices and directories 0 as well as projection 5 and spectra 0 and 1 are attached Cut windows CUTO for spectrum 0 and CUTI for spectrum 1 are created The projection is shown in tv root Some hotkeys are defined as shown in table 5 8 on page 54 Hotkey Function cut activate 0 cut
96. n step and tails since the erf step approximates the asymptotic value guite fast in comparison with the arctan Furthermore the step width of the erf can be fixed to 1 0 in units of sigma which reduces the number of parameters by one Finally the latter func tion is analytically integrable whereas the integration of the former has to be done numerical In both functions the volume but not the amplitude of the peaks is fitted The volume is the parameter of interest normally and in this way 1t is not necessary to integrate the resulting function and to estimate the errors of the obtained volume tv gt fit function peak definition continuous exp tail arctan step F x BG a YPE p HAK z BG x background function see section D 2 on page 105 peak function of i th peak PEAKi z gon GAUSM 2 Pi STEP a P P position of i th peak parameter Vi volume of i th peak parameter NORM numeric INTEGRAL GAUSM modified gauss function of i th peak exp dz Li de lt SL GAUSMi dx exp 5 2 SL lt de lt SR exp Shs de 32 SR lt dx 103 104APPENDIX D THE FIT BACKGROUND AND MEASURE FUNCTIONS dx x P S c of gaussian part of i th peak parameter SL TL SEF SR TR SP TL left tail of i th peak parameter TR right tail of i th peak parameter EL exponent of o weight of TL 0 2 ER exponent of c weight of TR 0 2 step function of i th peak
97. n the amplitudes i e it does not matter how large the fitted region is Besides the y minimization Tv can do the maximization of the poisson distri bution see section D 3 p 105 The results determined by this method are correct as long as the spectra have only be incremented or added For normalized or sub tracted spectra the variance of the data following the poisson distribution is not defined and therefore this method is not usable for those spectra For data dis tributed according to the gaussian distribution these operations are possible As a conclusion from the above one can say that none of the measure functions deter mines correct results if for example gates with low statistics have been subtracted In order to switch between the measure functions use the command tv gt fit measure activate dy 7 y x poisson 4 12 5 Holding parameters constant Sometimes it is useful to do not fit parameters but keep them constant or in corre lation with other parameters One example is if the energy of one peak in a doublet is known and the other should be fitted or to set the width of several peaks equal To do this all steps have to be gone as with the fitting of separated peaks I e set the fit region background and peakmarkers and perform the fit The short status of the fit tv gt fit status short for two peaks looks as follows spectrum 15 3_3_11 3_3_11 pry kev 0 pos 716 937 25 wdt 2 298 33 vol 7829 144 1 pos
98. nd Note that if there is a position calibration for all spectra involved in the ls file operation it will be applied before the operations add and subtract If you want the uncalibrated spectra to be added or subtracted you have to unload the calibration for at least one spectrum To access the spectra listed in the ls file all operations mentioned above have the options listed in table 4 2 on page 32 Open an ls file Take the next spectrum in the list Take all following spectra up to the end of file Take the previous spectrum in the list Take all previous spectra line index Take spectrum at line index Table 4 2 Options to the ls file operations to define which files will be operated To use the ls file in Tv it must be opened first with tv gt spectrum Is file open spc file To list the contents of an ls file you can use tv gt spectrum ls file list lt filename gt lt index gt The pointer is set to the next file if a file is listed If another ls file is open than the one given by lt filename gt the old one will be closed and the new one opened but if no ls file is opened an error occurs The list command without arguments shows the index of the next file To set the pointer in the ls file to position lt number gt enter tv gt spectrum Is file position lt number gt In order to load all spectra from the current file position to the end of the ls file use the c
99. nd is not yet completed Tv requests further input 3 4 2 Cursor mode This mode is indicated by a pirate cursor amp in the tv root window It allows you to shortcut commands by using hotkeys which are displayed in the tvkeys 3 5 MOUSE 19 window when pressed Keys you press in graphic pane of tv root are looked up in the hotkey table see section 3 11 p 22 and the bound commands are executed as soon as the hotkey combination is definite As an example the following commands are bound to key f tv gt window view full both tv gt window view expand and when you press it in the graphic pane the viewport is expanded to full size If you press question mark in this mode a list of all hotkeys is printed in the text window 3 5 Mouse The mouse is used for two purposes First you can change the viewport of the spectrum To do so you can set viewport markers with mouse clicks Second you can use it for cut and paste text as well as positioning the cursor in the text window While the cursor is placed in the graphic pane cross hair cursor the left mouse button 1 sets a marker and the other buttons perform certain actions each The middle button 2 expands the region between the marker and the border in which the cursor is positioned and the right button 3 expands the region between the marker set with 1 and the current cursor position You may set a vertical marker single click 1 a horizontal ma
100. ndow hide fit decomposition or the hotkeys or u a TV uses a modified gaussian with left tail and right tail and an underlying step Parameters of the gaussian are position volume and width as well as left and right tail and finally width and height of the step see section D 1 p 103 These seven parameters are associated with each peak fitted To reduce the number of parameters it is possible to use calibrations for single parameters or to correlate them e g to egual widths Step and tail parameters sometimes can be neglected The background parameters can be simultaneously fitted with the peaks or can be fixed in advance by a fit in separate background regions To select the peak function or background function to be used or whether parameters are to be fitted or not use the following commands for all fit function and fit parameter commands see section 6 4 7 on page 62 and section 6 4 12 on page 63 To activate a certain peak function by default continuous exp tail arctan step is active enter tv gt fit function peak activate cont additive tail erf step You can generally set parameters to a value and hold this value i e disallow Tv to fit the parameter or set the parameter free and allow Tv to fit it If you do not want Tv to fit a parameter after you set it you should set it to hold The degree of the background polynom default value is 2 is set with tv gt fit parameter background degree lt degree gt tv gt fit p
101. nent background Scaling of exponential term see section D 2 p 105 factor background Factor of exponential term see section D 2 p 105 position Position sh Height of step sw Width of step tl Left tail tr Right tail volume Volume width Width Table 4 7 Fit parameters and their meaning It is important to choose the optimal procedure to optimize the parameters The correct fit function gives the expectation value for the contents of each channel fitted Since the measured values follow a probability distribution their probability 44 CHAPTER 4 SPECTRA ANALYSIS with respect to the expected function is known for each channel For a certain set of parameters a total probability can be calculated as product of these channel probabilities The optimal set of parameters is assumed to be most likely It is determined by searching the maximum of this product in dependence of the free parameters maximum likelihood By default it is assumed that the channel contents follow a gaussian distribu tion In this case maximum likelihood is equivalent to the commonly used x minimization see section D 3 p 105 Unfortunately this is not applicable if the expectation values for the contents of single channels are in the order of one In this case the values are described by a poisson distribution Obviously the fit function misestimates the contents of the spectrum This does not depend on the integral of the fitted data but only o
102. nter tv gt alias yscale window setup function y 1 window setup function y normalization on window setup function y normalization off lt linear logarithmic squared gt where 1 denotes the first argument passed to the yscale command The paren theses in 1 must be entered alias and unalias are builtin commands of the command line interpreter and there fore available in every menu and not listed by E Aliases defined by default in Tv s root menu are help quit lin and log and their definitions listed by the alias command are tv gt alias aliases in menu help xon hostname which lemacs f info Tv gt dev null 2 gt dev null amp lin wi sc fu li wi sc fu no on wi sc fu no off log wi sc fu lo wi sc fu no on wi sc fu no off quit exit 3 10 Command files Frequently used commands definitions or setups can be stored in so called com mand files To execute them enter their names preceded by the special character 22 Be sure to be in a menu suitable for your command file This is usually the root CHAPTER 3 BASIC USAGE menu A command file must always end with a newline If you do not use abbreviations shorter than 4 characters your command files are guaranteed to work with every version of Tv Some useful command files to compare matrices cuts and spectra are in the directory ikp local lib tu These are listed in table 3 3 on page 22 As an example
103. ommand tv gt spectrum ls file get You may close the ls file with tv gt spectrum Is file close As an example we load the spectra from the last section Imagine that no ls file is opened so we have to open the file spc file first with the command tv gt spectrum Is file open spc file Now you can load the spectra with the command tv gt spectrum ls file get Of course not more spectra can be loaded then buffers are available For the syntax of all ls file commands see section 6 8 10 on page 72 A list of hotkeys for ls file operations is shown in table 4 3 on page 33 4 4 BUFFER OPERATIONS 33 Function 1 tv gt spectrum delete all Deletes all spectra and reads tv gt spectrum ls file get according to the ls file rules see section 6 8 10 1j tv gt spectrum delete all Deletes all spectra and reads tv gt spectrum ls file get according to the ls file rules see section 6 8 10 ife tv gt edit Asks for spectra to be loaded tv gt spectrum ls file get and reads according to the ls file rules see section 6 8 10 ifo tv gt edit Queries an ls file name tv gt spectrum ls file open and opens it Table 4 3 Hotkeys for 1s file operations 4 4 Buffer operations Tv provides three commands to copy create and delete spectra in memory as there are tv gt spectrum copy lt source index gt lt destination index gt tv gt spectrum create lt name gt lt resolution gt
104. ont misc bold r 13 80 Xtv allowResize True Xtv Linewidth 0 Xtv monochrome Foreground white Xtv monochrome Background black Xtv gray Foreground white Xtv gray Background black Xtv colored Foreground yellow Xtv colored Background black tv geometry 650x300 0 0 Xtv geometry 500x500 0 0 Xtv NumGCs 16 Xtv comparison geometry 500x500 0 0 Xtv comparison colored spectrum foreground0 yellow Xtv comparison colored spectrum foregroundl magenta Xtv projections geometry 500x500 0 0 Xtv projections colored spectrum foreground4 yellow Xtv projections colored spectrum foreground5 magenta Xtv cut XFrame 1 91 92 Xtv cut YFrame DE APPENDIX B XRESOURCES Default values for plot window Xtv plot geometry Xtv plot XFrame Xtv plot YFrame Xtv plot Font Xtv GowFrameWidget Font Xtv unix geometry Xtv unix XFrame Xtv unix YFrame Xtv unix Font Xtv unix LineSpace 500x500 0 0 3 9 fixed fixed 900x900 0 0 6 6 fixed 1 3 Xtv unix VLabel labelDistance 1 0 Xtv unix labelLine Xtv unix ticLabel Xtv unix ticTic Xtv unix ticLong Xtv unix ticMedium Xtv unix ticShort Xtv unix ticSpace Xtv unix spectrum linestyle4 1 2 0 6 0 3 1 2 shortdashed Xtv unix spectrum unixLinestyle4 shortdashed Xtv xfig geometry 500x500 0 0 Xtv xfig XFrame 3 Xtv xfig YFrame 9 Xtv xfig Font fixed Xtv XfigFontsize 20 Xtv UnixFontsize 20 Xtv UnixFontname
105. ou will be gueried This position is the energy for calibrated spectra which is egual to the channels for uncalibrated spectra The full spectrum is displayed by pressing E The mouse can be used to zoom the spectra and move through them too as is explained in section 3 5 on page 19 2 3 SPECTRUM 9 2 3 3 Fitting a spectrum The easiest way to determine or f t sec 4 12 p 38 the position width and volume of a peak is to use the quickfit feature of Tv Place the cursor over the peak to be fitted and press o The result of this operation is shown in figure 2 2 on page 9 and the short status output is printed below fit of spectrum 0 co56b68 127 spectrum 0 co56b68 127 Chn 0 pos 1501 0690 66 wdt 2 883 14 vol 63636 324 The last line of the result output shows fitted position width and volume of the peak In parentheses the errors of fitted values are given The quickfit guesses position and fit region of the peak which leads to trouble if you have to fit merged peaks They are usually fitted as one peak by the quickfit Furthermore it does not consider background regions which leads to a misestimation of the subtracted background As a consequence of the last paragraph you have to define fit and background regions as well as peak markers to obtain best fit results You have to define the fit region i e the region of the spectrum containing the peak s to be fitted Press to define the left border of the fit reg
106. pectrum in buffer lt index gt to lt resolution gt 6 8 18 Spectrum status tv gt spectrum status Prints status information about all loaded spectra The last coloumn informs about which operations have been performed on the spectra The meaning of the special characters used there are listed in table 6 10 74 CHAPTER 6 COMMAND SUMMARY Meaning Spectrum has been normalized or multiplied Spectrum has been recalibrated Spectrum has been added subtracted or the offset operation has been performed Spectrum has been used for maximization Table 6 10 Meaning of the special characters used in spectrum status output 6 8 19 Spectrum subtract tv gt spectrum subtract lt index gt lt filename gt lt format gt lt index gt active all shown visible Subtracts buffers defined by the last argument from buffer lt index gt This command has one text default or one integer default 6 8 20 Spectrum update tv gt spectrum update lt index gt all shown active Reloads all queried spectra from harddisk without asking 6 8 21 Spectrum write tv gt spectrum write lt filename gt lt index gt active all shown visible Writes buffers defined by the last argument to the single spectrum lt filename gt 6 9 Window 6 9 1 Window create See section 4 2 1 on page 28 for a desription of window types which are created with this command tv gt window create simple lt window name g
107. pectrum norm To identify normalized spectra an asterisk will be applied to the spectrum status see section 6 8 18 p 73 An example of recalibrated and normalized spectra can be seen in figure 4 3 on page 37 where the region of the right peak was marked before normalization si c1 1 dO n0 15 276 9 4843 245 250 255 260 205 270 25 200 25 20 ai 300 ss iM prge3 0121 prge5 0121 prge3 0121 prge5 0121 Figure 4 3 An example for recalibrated and normalized spectra In the lower pane the original data is shown A complete list of all normalization commands can be found in section 6 6 on page 69 4 11 Arithmetic operations Tv provides five commands to perform arithmetic operation on spectra as there are tv gt s add lt idx gt lt fname gt lt fmt gt lt idx gt acti all show visi tv gt s subt lt idx gt lt fname gt lt fmt gt lt idx gt acti all show visi tv gt s mult lt fact gt lt idx gt acti all show visi tv gt s maxi lt idx gt lt idx gt acti all show visi tv gt s mini lt idx gt lt idx gt acti all show visi add summarizes the contents of all spectra specified by the second argument to the buffer defined by the first argument lt idx gt As second argument it accepts an integer value by default which is interpreted
108. pectrum previous Display previous spectrum tv gt edit Queries a list of buffer tv gt window show spectrum index numbers and displays the accord ing spectra tv gt edit Queries a list of buffer tv gt window show spectrum index numbers and displays the accord ing spectra tv gt normalization mark enter cursor Set normalization marker at cur sor position gt tv gt fit mark peak enter cursor Set a peak marker at cursor po tv gt fit mark region enter cursor Set fit region marker at cursor tv gt fit status full Print all status information tv gt window hide peaklist window hide labellist peaklist fb tv gt window hide fit bin list Do not display bin markers lc tv gt window hide cut gate marker Do not display cut gate markers a tv gt window hide fit decomposition Do not display the decomposi tv gt window hide fit function marker Do not display fit function and Em u m c tv gt window hide marker cut Do not display cut markers tv gt window hide marker fit Do not display fit region mark ers u m n tv gt window hide marker normalization Do not display normalization markers tv gt window hide marker recalibration Do not display recalibration markers tv gt window hide marker psearch Do not display peaksearch re gion markers w e tv gt fit parameter width equal The widths of all peaks will be correlated llw f tv gt fit parameter width free Allow width to be fitted
109. r tv gt tv gt cut read cut cursor All hotkeys for saving and loading of markers and spectra are given in table 5 4 a cutmarkers at cursorposition the first set of cutmarkers efn tv gt cut read cut next Reads the next cutspectrum and AP E At RR tv gt cut read head cursor Reads the set of cutmarkers at the cursorposition and performs the cut and performs the cut A tv gt cut read head next Reads the next set of cutmarkers ed ere tet tv gt cut write cut Writes the cutspectrum and the set of cutmarkers to disk Table 5 4 Hotkeys for saving and loading of cutmarkers and cutspectra 5 6 Comparing matrices Tv offers some scripts listed in table 5 5 on page 53 to compare spectra matrices or cuts Each of these is described in the following subsections For example to compare two spectra enter tv gt Ocmp2spc 5 6 COMPARING MATRICES 53 The path of these files is by default ikp local lib tv and on some systems usr local lib tv To find the location of the file for example use the command tv gt which cmp2spc cmp2cut Compare two cuts cmp2mat Compare two matrices cmp2spc Compare two spectra cmp3mat Compare three matrices cmp4mat Compare four matrices Table 5 5 Sample batchfiles 5 6 1 cmp2spc cmp2spc makes attachments for cuts 0 and 1 Matrix and directory 0 as well as the projection 5 and spectra 0 and 1 are attached A simple window named normalized spectra compariso
110. r hold Prevent background parameters tv gt fit param exponent hold from being fitted tv gt fit param factor hold P b f tv gt fit param backgr free Allow background parameters tv gt fit param exponent free to be fitted tv gt fit param factor free TF Je a fit parameter width equal Fee b gt fit parameter width oqual 223 w f tv gt fit parameter width free Allow width to be fitted Table 4 6 Hotkey definitions for fit markers and commands known by Tv 4 12 FIT AND INTEGRATION 43 pee 388 220Th tig0 pry 91 238 91 238 pas 305 220Th tig0 pry 91 238 91 238 Figure 4 5 Graphic display window with a 2 Th spectrum loaded and a fit attached Upper A quickfit has been performed The peaks are not decomposited Middle A normal fit is performed with two peaks marked Lower The fit function and its decomposition is shown tv gt fit parameter factor background number lt number gt tv gt fit parameter factor background hold The scaling of the exponential term is set with tv gt fit parameter exponent background number lt number gt tv gt fit parameter exponent background hold All parameters which can be influenced by the fit parameter command are listed in table 4 7 on page 43 Parameter Meaning background Degree of background function expo
111. read restore store write Performs an operation on bin markers tv gt fit marker bg region delete enter list read restore store write Performs an operation on background markers tv gt fit marker fit delete Deletes all markers for the active fit tv gt fit marker peak delete enter Performs an operation on peak markers tv gt fit marker region delete enter list read restore number store write Performs an operation on fit region markers 6 4 10 Fit measure tv gt fit measure activate dy x y x poisson Activates the selected measure function see section D 3 p 105 tv gt fit measure definition dy 7 y x poisson Prints the definition for the measure function see section D 3 p 105 6 4 11 Fit open tv gt fit open Opens the file lt specfile gt fit and reads all fits and intergrations 6 4 12 Fit parameter tv gt fit parameter background degree free hold Defines how to fit background see table 6 5 p 64 tv gt fit parameter exponent background number free hold Defines how to fit exponent background exponent tv gt fit parameter factor background number free hold Defines how to fit background factor tv gt fit parameter position free hold none spaced Defines how to fit position 64 CHAPTER 6 COMMAND SUMMARY degree lt degree gt Set degree of background polynom see section D 2 p 105 Default value is 2 number
112. red bg function foreground0 green Xtv colored foreground0 yellow Xtv colored foregroundl magenta Xtv colored foreground2 red Xtv colored foreground3 blue Xtv colored foreground4 white Xtv colored foregroundb wheat Xtv colored foreground6 cyan Xtv colored foreground7 pink B 2 2 X widget hierachy lt application gt Xtv application lt color gt Paned widget standard status lt application gt root lt application gt root sheet standard GowVsWidget spectralist view spectralist n io status keysequence view text lt simple gt lt color gt standard status lt simple gt lt simple gt sheet standard GowVsWidget lt fit gt lt color gt standard status lt fit gt fit lt simple gt sheet standard GowVsWidget lt fit gt residuum lt fit gt residuum sheet residuum lt cut gt lt color gt GowFrameWidget widget GowVsWidget widget Viewport widget List widget Paned widget Box widget Label widget Viewport widget Text Widget TopLevelShell widget Paned widget GowFrameWidget widget GowVsWidget widget kk TopLevelShell widget Paned widget GowFrameWidget widget GowVsWidget widget kk GowFrameWidget widget GowVsWidget widget Residuum object TopLevelShell widget Paned widget 98 APPENDIX B XRESOURCES standard status cut GowCutWidget
113. rker double click 1 or a corner marker triple click 1 A corner marker is a combination of a vertical and a horizontal marker and defines a corner of a rectangle Leaving the tv root window deletes all viewport markers set With the cursor on the scales gumby cursor f the left mouse button shifts the displayed spectra to the left and the right button to the right In combination with the keys 1 shifts the viewport to the left 2 centers the viewport at cursor position and 3 shifts the viewport to the right The configuration of the mouse buttons can be defined in your Xresources file see appendix B p 91 which will overwrite the default settings The x and y position of the cursor is displayed in the status bar of the window the cursor is in see 3 1 p 16 If a calibration is loaded the x position is displayed both calibrated and uncalibrated in parenthesis 3 6 Commands and Menus Tv s commands are organized in a menu structure This leads to a kind of object orientation because all commands that are allowed to an object are in its menu To see all available commands for the current menu enter CR In the root menu which is indicated by the prompt tv gt the available commands are separated in three groups There are aliases main command group and miscellaneous Commands can be combinations of subcommands for example tv gt window setup function y normalization off Leaving out at least one argument of the
114. rs for text widget 1 athena viewport widget is not able to trace the position of insertion point 1 Xtv io allowHoriz False Xtv io useBottom True Xtv io allowVert False Xtv io useRight False Xtv io forceBars True IR athena text widget forces visibility of insertion point on keyboard events but the position of the last line is sometimes below window 1 Xtv io text scrollVertical always Xtv io text scrollHorizontal never Xtv io text resize never Xtv io text displayCaret True 96 Xtv io text wrap word Xtv monochrome io text background Xtv monochrome io text foreground Xtv gray io text background Xtv gray io text foreground Xtv colored io text background Xtv colored io text foreground APPENDIX B XRESOURCES white black white black wheat DarkGreen Xtv io text Translations override n Ctrl lt Key gt G cancel keyseguence cancel keyreguest n lt Key gt Escape execute string tv gt input mode cursor n n lt Key gt Return execute command edit unlock n lt Key gt Linefeed execute command n lt Key gt KP_Enter execute command n Ctrl lt Key gt J execute command n Ctrl lt Key gt M execute command n Ctrl lt Key gt 0 execute command Ctrl lt Key gt C end of file newline insert char execute command n lt BtniDown gt select start n lt BtniMotion gt _ extend adjust n lt Btn1Up gt extend end PRIMARY CUT_BUFFERO
115. ssible arguments for the Is filecommands 72 6 10 Meaning of the special characters used in spectrum status output 74 C 1 File formats from the mfile header file 101 LIST OF TABLES Preface Introduction Tv is a spectra and matrix analysis program which runs under the operating system UNIX and has been successfully tested under SUNOS 5 5 1 Ultrix 4 3A HP UX 9 01 and Linux This manual documents the use and simple customization of the program Its intention is to teach the beginner all basic functions of the program and as a reference manual for the advanced user This documentation describes the program as it and not the physical background Only now and then fundamental vocabulary from the analyzing of nuclear physics data is explained and a little theory of the form of spectra is given This manual is available both as postscript file and as hypertext The URL of the hypertext form is http ikp uni koeln de fitz Tv_user manual Tv_user manual html You can get a postscript version of the manual from this site too Organisation of the book Chapters 1 to 3 are recommended to be read by beginners at starting their work with Tv Chapters 4 and 5 are intended as introduction to the beginner and as reference guide to the more sophisticated user respectively Chapter 6 is a reference guide to all commands of Tv in alphabetical order A more detailed description of the contents of the chapters is giv
116. st matching command The order of the builtin commands is in most cases alphabetical but not necessarily The order of the aliases is given by the order of their definition To see the order of commands and aliases in a given menu type E For example if you plot a spectrum and therefore want to change the frame width to get inscriptions at the y scale you can set them to 9 9 3 and 3 for the left right top and bottom frame with the command tv gt window setup frame width 9 9 3 3 Your minimum set of characters to abbreviate this command is tv gt wsefw9 93 3 By the way these are the default frame width values for the plot window which you can create with tv gt wc s plot 3 8 Special characters To define aliases keyaliases or write commandfiles you need a set of control char acters These are used to replace keys like or Esc which cannot be inserted in files Tv s control characters are listed in table 3 2 on page 21 3 9 Aliases You may configure your own menu structure or simply create redefine or rename certain commands by using the alias mechanism An alias is a named string known to a menu When parsing the command line Tv checks each word whether there is an alias defined and substitutes the according definition in the command line Aliases are defined in the menu you are in You can not define aliases in menus other than the current menu Since you destroy built in commands if you redefine 3 10 COMMAND FILES 21
117. sult f le 6 4 15 Fit psearch tv gt fit psearch list List all peaks found by the last peaksearch 6 4 FIT 65 tv gt fit psearch create Create a peaksearch for the entire spectrum if no markers are set tv gt fit psearch marker delete enter cursor value offset list read lt filename gt restore store write lt filename gt Handle markers for the peaksearch tv gt fit psearch open Opens the file lt specname gt fit and reads the list of peaks and fits saved in it tv gt fit psearch print lt index gt Prints the number of peaks found by the last peaksearch for the spectrum 1n buffer lt index gt tv gt fit psearch probability lt limit gt Determine or set the probability limit for the peaksearch tv gt fit psearch read lt index gt all shown active tv gt fit psearch scale calibrated default uncalibrated Determine or set if the peaksearch is performed at the calibrated or uncali brated scale tv gt fit psearch status Prints the number of peaks found by the last peaksearch for all buffers tv gt fit psearch write Writes results from the last peaksearch to the file lt specname gt fit 6 4 16 Fit read Function position cursor value offset Reads the fit at position first Reads the first fit last Reads the last fit next Reads the next fit previous Reads the previous fit index Reads the fit number lt index gt Table 6 6 Commands in the fit rea
118. t tv gt window create cut lt window name gt tv gt window create fit lt window name gt tv gt window create paned lt window name gt lt panes gt tv gt window create xpaned lt window name gt lt panes gt tv gt window create ypaned lt window name gt lt panes gt 6 9 2 Window delete tv gt window delete lt window name gt Deletes window lt window name gt 6 9 3 Window hide Hides the object in active window which is given by the additional arguments tv gt window hide cut gate marker tv gt window hide fit bin list decomposition function marker 6 9 WINDOW T5 tv gt window hide marker cut fit normalization recalibration psearch tv gt window hide labellist cut peaklist user tv gt window hide peaklist tv gt window hide spectrum names 6 9 4 Window list tv gt window list Prints a list of graphic windows 6 9 5 Window marker tv gt window marker horizontal delete enter cursor value list read lt filename gt restore store write lt filename gt Handles horizontal markers in active window tv gt window marker vertical delete enter cursor value list read lt filename gt restore store write lt filename gt Handles vertical markers in active window 6 9 6 Window plot tv gt window plot create tv gt window plot create unix plot filename Creates a plot in unix plot format and writes the output to lt filename gt
119. te head Create head i e do the gate weight calculation tv gt cut create spectrum Creates a cut spectrum and copies it to the buffer attached to the active cut The cut head must be created first 6 3 4 Cut directory tv gt cut directory close lt index gt Closes cut directory tv gt cut directory format lt format gt Defines format to save spectra see section C 2 p 101 tv gt cut directory open lt index gt lt filename gt Opens directory lt filename gt for cut lt index gt tv gt cut directory status Prints attachments between directories and buffers 6 3 5 Cut environment tv gt cut environment lt pathname gt Opens cut environment see section 5 3 p 49 60 CHAPTER 6 COMMAND SUMMARY 6 3 6 Cut list tv gt cut list all Lists all cuts in the attached cut directory tv gt cut list range cursor value offset Set markers to define a range for which you want to list the cuts 6 3 7 Cut marker delete Delete marker enter cursor value offset Set new marker list List all markers read lt filename gt Read list of markers from file restore Restore markers from memory store Store markers to memory write lt filename gt Save list of markers to file Table 6 2 Commands allowed to the cut marker menu tv gt cut marker bg gate delete enter list read restore store write Performs an operation according to table 6 2 on background gates tv gt cut marker cut
120. the contents of cmp2mat will be shown here in an abbreviated form To understand the meaning of the commands take page 55 cmp2cut Compare two cuts cmp2mat Compare two matrices cmp2spc Compare two spectra cmp3mat Compare three matrices cmp4mat Compare four matrices Table 3 3 Sample command files wind dele projections wind dele comparison cut cut cut cut cut cut cut cut wind wind wind wind wind wind wind keya cut cut cut cut acti atta matr atta acti atta matr atta 0 matr atta spec 1 matr atta spec crea simp setu show keyb spec crea simp setu show setu cut acti O acti envi acti envi keyb spec keyb O 1 1 2 0 O 4 1 1 5 dire O dire 1 projections projections O 1 comparison comparison 4 5 none cut crea cut cut acti 1 cut crea cut 3 11 Hotkeys You can define hotkeys which work in cursor mode as explained before see section 3 4 2 p 18 by using the keyalias command For example to bind the commands tv gt edit tv gt spectrum get to the key s you have to enter tv gt keyalias g tv gt edit tv gt spectrum get a look at chapter 6 on 3 12 WILDCARDS 23 You can print a complete list of hotkeys with the command tv gt keyalias To destroy the just defined keyalias for key use the command tv gt keyunalias At startup Tv reads the file ikp
121. ting 37 graphic 75 gumby cursor 17 Hotkeys 16 20 I O 27 input mode 75 Integration 35 loading 42 saving 42 Introduction 7 Introduction 7 keyalias 76 keytable 76 keyunalias 76 Label 63 cut 63 fit 63 peaklist 63 user 63 label colorindex 31 Labels 31 license agreement 103 lin 77 log 78 ls file mechanism 29 Marker 32 Matrix 10 45 INDEX Analyzing 10 attachment example 46 attachments 45 change 46 cmp2cut 51 cmp2mat 50 cmp2spc 50 comparing 50 Cutting 11 environment 46 fast setup 46 introduction 45 Opening 10 opening 46 setup 45 Measure 101 functions 101 Menus 17 Miscellanous alias 74 cd 75 command file 75 edit lock 75 exit 77 graphic 75 input mode 75 keyalias 76 keytable 76 keyunalias 76 precision 76 protocol 77 ReadMe 75 which 77 wildcard 77 Miscellanous commands 74 Modes 16 cursor 16 edit 16 Mouse 16 usage 31 Multiplets 38 Normalization 34 64 marker 64 off 65 scale 65 status 65 type 65 Operations arithmetic 34 Peaklist INDEX loading 37 saving 36 Peaksearch 36 loading 37 saving 36 Plot 10 introduction 10 labels 31 window 18 Position free 41 hold 41 set 41 precision 76 Program start 13 protocol 77 Ouestionmark 16 quit 77 ReadMe 75 Recalibration 32 65 append 65 create 65 delete 66 list 66 marker 66 read 66 type 66
122. tion For example load two spectra prge 35 0121 which are shifted In order to per form the recalibration you have to define at least one recalibration region The region is defined by pressing the hotkey once for the left border and once again for the right side To perform the recalibration enter tv gt recalibration create in the text window Tv will query you for further parameters as there are the reference spectrum and a list of spectra to be recalibrated By default the type of recalibration is set to sguared distance You can change this for example to center of mass with the command tv gt recalibration type center of mass Redisplay the window to see the results by pressing hotkey or with the com mand tv gt window redisplay You can print a list of recalibration parameters with the command tv gt recalibration list A list of all recalibration commands is printed in section 6 7 on page 70 4 10 Normalization For the comparison of spectra normalization is often useful to bring their peaks to comparable heights To perform a normalization for a specific peak you have to set markers with the hotkey o one at the right side of the peak and one at the left border which define the normalization region You can set normalization background markers by using the command 4 11 ARITHMETIC OPERATIONS 37 tv gt normalization marker enter cursor value offset Spectra are normalized in Tv by using the command tv gt s
123. tions and for the period of time identified in Paragraph 9 1 This license agreement grants to the user the right to use Tv within their own home or organization The user may make copies of Tv for use within their own home or organization but may not further distribute Tv except as provided in paragraph 4 The license agreement is only effective in connection with the subsequent listed license agreements License Agreement for mfile with the Institute for Nuclear Physics Cologne If the use of Tv is connected to any form of publication the authors of Tv must be cited correctly J Theuerkauf S Esser S Krink M Luig N Nicolay O Stuch H Wolters Program Tv Institute for Nuclear Physics Cologne The IKP intends that Tv be widely distributed and used but in a manner which preserves the quality and integrity of Tv The user may send a copy of Tv to another home or organization only after either receiving permission from the IKP or after seeing written evidence that the other home or orga nization has signed this agreement and sent a hard copy of it to the IKP If the user has made modifications to Tv and wants to distribute that modi fied copy the user will first obtain permission from the IKP by written or electronic communication Any user which has received such a modified copy can pass it on as received but must receive further permission for further modifications All modifications to copies of Tv passed on to ot
124. trum false Xtv peak label upperFraction 0 01 Xtv peak label lowerFraction 0 01 Xtv fit bg marker vBarPosition bottom Xtv fit bg marker upperFraction 0 03 Xtv fit bg marker lowerFraction 0 03 Xtv fit region marker vBarPosition top Xtv fit region marker upperFraction 0 02 Xtv fit region marker lowerFraction 0 02 Xtv fit bin marker vBarPosition bottom Xtv fit bin marker upperFraction 0 00 Xtv fit bin marker lowerFraction 0 99 Xtv vertical marker vBarPosition none Xtv vertical marker upperFraction 0 02 Xtv vertical marker lowerFraction 0 02 Xtv gate marker vBarPosition top Xtv gate marker upperFraction 0 03 Xtv gate marker lowerFraction 0 03 Xtv bg gate marker vBarPosition bottom Xtv bg gate marker upperFraction 0 03 Xtv bg gate marker lowerFraction 0 03 Xtv cut gate vBarPosition top Xtv cut gate upperFraction 0 03 Xtv cut gate lowerFraction 0 03 94 Xtv cut bg gate Xtv cut bg gate Xtv cut bg gate vBarPosition upperFraction lowerFraction Xtv gray BorderColor Xtv gray grip foreground Xtv gray grip background Xtv monochrome BorderColor Xtv monochrome grip foreground Xtv monochrome grip background Xtv colored BorderColor Xtv colored grip foreground Xtv colored grip background Xtv borderWidth Xtv io Xtv io Xtv io Xtv io Xtv io Xtv io Xtv paned status Xtv paned status Xtv paned status Xtv paned status children of P grip widt grip height h gripIndent
125. ursor Set a horizontal marker o tv gt normalization mark enter cursor Set normalization marker at cur O PP p tv gt fit mark peak enter cursor Set a peak marker at cursor po AAA tv gt fit mark region enter cursor Set fit region marker at cursor A A R r tv gt recalibration marker enter cursor Set a recalibration marker at cur pe O H b tv gt fit mark bg region delete cursor Delete background marker clos wne n oo cursor c b tv gt cut mark bg gate delete cursor closest to cursor n Delete the normalization mark ers p tv gt fit mark peak delete cursor Delete peak marker closest to A eamat o a e r tv gt fit mark region delete cursor Delete fit region marker closest A tv gt cut mark cut delete Delete all markers You will tv gt window hide mark cut still see markers which are tv gt fit mark fit delete part of the autonomous fit tv gt fit delete tv gt window hide mark fit tv gt label user delete all tv gt normalization mark delete tv gt recalibration marker delete all tv gt cut mark cut delete Delete cut markers tv gt window hide mark cut G tv gt fit mark fit delete Delete the current fit and tv gt fit delete all its markers tv gt fit delete activ tv gt window hide mark fit P tv gt fit mark peak delete 0 uncalib 8192 un Delete all peak markers calib PUN tv gt recalibration marker delete cursor Delete recalibration marker clos est
126. ut lt format gt Set output format of spectra to lt format gt 6 8 9 Spectrum get tv gt spectrum get lt filename gt Reads spectra from file s lt filename gt to the next free buffer s 6 8 10 Spectrum ls file To address a file in an ls file the following commands are possible ls filename Name of ls file to process Use next spectrum in list H Use all spectra from here to the end of the ls file Use previous spectrum Use all previous spectra to the beginning of the ls file lineandex Use spectrum at position line index Table 6 9 Possible arguments for the ls file commands tv gt spectrum Is file add lt index gt lt arg gt Add the spectra according to lt arg gt to buffer lt index gt tv gt spectrum ls file close Close currently open ls file tv gt spectrum Is file commandget lt commandfile gt lt arg gt Perform commands from lt commandfile gt to the spectra defined by lt arg gt tv gt spectrum ls file get lt arg gt Load the spectra addressed with lt arg gt tv gt spectrum Is file list Show current pointer position in ls file tv gt spectrum ls file open lt Is filename gt Open the ls file lt ls filename gt for operation tv gt spectrum ls file position lt index gt Position the pointer in the opened Is file to lt index gt tv gt spectrum Is file subtract lt index gt lt arg gt Subtract spectra addressed by lt arg gt from spectrum in buff
127. v GowVsWidget Translations I lt BtniDown gt 1 I lt Btn3Down gt 1 I lt BtniDown gt i I lt BtniDown gt 2 I lt BtniDown gt 3 I lt BtniDown gt 4 ICtrl lt BtniDown gt i ICtrl lt BtniDown gt 2 ICtrl lt BtniDown gt 3 ICtrl lt BtniDown gt 4 I lt Btn2Down gt I lt Btn3Down gt ICtrl lt Btn3Down gt lt Leave gt Shift Ctrl lt BtniDown gt Shift Ctrl lt Btn2Down gt Shift Ctrl lt Btn3Down gt full y shift 70 0 0 0 n full y shift 70 0 0 0 override n expand x n expand y n expand xy n cancel expand n full y n full xy n full x n scalereset xy n expand to limit n expand n cancel expand scalereset xy n cancel expand n full y shift 70 0 0 0 n full y center x n full y shift 70 0 0 0 n Ctrl lt Key gt G cancel keyseguence cancel keyreguest cancel expand XnM lt Key gt Escape execute string tv gt input mode edit n n lt Key gt execute keyseguence Xtv spectralist Translations replace Xtv spectralist internalHeight 0 Xtv spectralist internalWidth 0 Xtv spectralist view allowVert False Xtv spectralist view allowResize True Xtv spectralist view skipAdjust False IXtv io skipAdjust True IXtv io view height 100 IXtv io allowResize True Xtv io borderWidth 1 Xtv io text search scrollVertical False Xtv io text search scrollHorizontal False Xtv io text search resize True 1 two optional scrollba
128. v gt edit Opens a cut window named tv gt window create cut Cut Cut and gueries an tv gt cut environment environment to load tv gt window show spectrum next Display next spectrum in buffer list tv gt window redisplay tv gt window show spectrum previous Display previous spectrum in buffer list tv gt window redisplay i P b n tv gt fit param backgr hold The background parameters To be continued 86 APPENDIX A THE DEFAULT HOTKEY TABLE tv gt fit param exponent hold will not be fitted AA e tv gt fit param backgr free The background parameters tv gt fit param exponent free will be fitted tv gt fit param factor free tv gt fit para position0 hold Hold position of peak 0 This hotkey is available for peaks 1 to 4 either tv gt fit para position0 free The position of peak 0 is set free for fitting This hotkey is avail able for peaks 1 to 4 either tv gt fit para position0 none Peak 0 is removed from the peak list This hotkey is available for peaks 1 to 4 either tv gt edit tv gt fit para position The position of peak 0 is set to the queried value This hotkey is available for peaks 1 to 4 either i gt ft parameter width quay OOOO tv gt edit Plots a unix plot figure to tv gt edit Plots a xfig v2 1 figure to tv gt window plot create xfig tv gt fit mark fit delete Creates a quick fit tv gt fit delete tv gt fit mark peak enter cursor tv gt fit mark region enter of
129. v gt window scaling function y logarithmic tv gt window scaling function y normalization on tv gt window scaling function y normalization off These three commands are defined as alias log by default You can switch off the graphic display to omit graphical output and thereby accelerate the execution of command files To do this enter tv gt graphic suspend and to turn it on again enter tv gt graphic resume 4 3 Loading and saving of spectra I O Tv supports several functions for spectrum input and output as there are tv gt s read lt fname fmt gt lt ind gt all shown active tv gt s get lt fname fmt gt tv gt s write lt fname fmt gt lt wc gt lt ind gt all shown active tv gt sformat input output lt fmt gt lt fname gt is the name of the spectrum file lt fmt gt is the format of the spectrum file see below lt ind gt are the buffernumbers for the spectrum lt we gt is a wildcard defined according to section 3 12 2 on page 25 The commands to the spectrum menu are described now read loads the spectrum to the first defined buffer and copies it to the other buffers specified Tv displays the same buffer always in the same color If you want to see a special spectrum in a certain color you can ensure this by using the read command 30 CHAPTER 4 SPECTRA ANALYSIS get reads spectra too and is the default command to the spectrum menu mean ing it can be om
130. vious index tv gt fit read fit first last next previous tv gt fit read integration first last next previous 46 CHAPTER 4 SPECTRA ANALYSIS tv gt fit read record first last next previous The first command scans the file lt spectrumname gt fit for saved fits and loads them A fit can be loaded for a certain position given by the cursorposition or a channelnumber To load the first set of information one will usually use the option first hotkey RIED The options first and last load all entries from the file energetically sorted If one wants to load a certain fit and knows the position in the file one can use the option index and give the according number as an argument Besides the markers and parameters for the selected fit the positions for all saved fits and integrations are read and displayed in the graphic window by their bin markers at the upper frame Using these bins further fits can be loaded easily with the following command tv gt fit read bin position cursor For this operation the hotkey can be used either The command tv gt fit read fit is intended to load fits only but it doesn t offer the easy way with the bins The third command does the same with integrations To load fits and integrations the latter command ca be used With this command the entries are read from the file in the order they were saved All hotkeys for saving and loading fits and integrations are given in table 4
131. w lwli tv gt window scaling function y linear tv gt Switch y axis to linear scaling window scaling function y normalization on tv gt window scaling function y normalization off wj tv gt window scaling function y logarithmic Switch y axis to logarithmic tv gt window scaling function y normalization scaling on tv gt window scaling function y normaliza tion off w n tv gt window scaling function y normalization on To be continued 89 Hotkey tv gt window scaling function y squared tv gt Switch y axis to quadratic scal window scaling function y normalization on 1 tv gt window scaling function y normalization off x tv gt window view full x Expand viewport to full size in tv gt window view expand x direction y tv gt window view full y Expand viewport to full size in tv gt window view full y Center the spectra around 90 APPENDIX A THE DEFAULT HOTKEY TABLE Appendix B Xresources B 1 Application preferences By the use of Xresources application preferences e g colors for Tv can be set guickly and easily For a detailed description of handling Xresources read the X 1 manpage The configuration is read from the files 1 app defaults Xtv 2 Xdefaults 3 Xresources After changing one of these files you have to reread 1t to let the changes come to effect B 2 Resources B 2 1 Sample Xtv file Xtv xrdb class CLASS Xtv xrdb planes PLANES Xtv F
132. w center x cursor position defined by cursor Table 3 1 Hotkeys to change the viewport of the graphic pane Some of these operations can be executed as described in section 3 5 on page 19 3 3 2 The text window tv figure 3 2 p 18 is a text window and composed of three subwindows The bufferlist window shows the buffernumbers and the names of the accord ing spectra 18 CHAPTER 3 BASIC USAGE Scrollbar Tvkeys window Bufferlist window Grip P co56b68 127 O OtNSN I A tpkeus For customization of tv create the startup file turc in a directory of your TVPRTH Aliases for some vs commands are summarized in vs turc To activate then enter tv gt BGus tvurc or add this command to your turc closing command input file ikp local lib tv site turc after line 12 tu gt alias aliases in menu help X xon hostname which lemacs f info Tv gt dev null 2 gt dev null2 quit exit tu gt which search path for configuration and command files ikp local lib tv tv gt s co56b68 127 spectrum co56b68 127 8k le4 1 read to 0 ty gt tu gt input mode cursor Mead tu gt window view full both tv gt window view expand NP x Figure 3 2 Text display immediately after startup The bufferlist window shows a Co spectrum loaded to buffer 0 The tvkeys window echoes the keys you have entered in cursor mode see section 3 4 p 18 All commands
133. window In the upper right corner the projec tion is displayed GG GI GG GG GG G9 Y Y Y YY Graphic display window immediately after startup with a Co spec trum loaded is se ee e g ds A ddd dwU Ry AO A I Text display immediately after startup The bufferlist window shows a Co spectrum loaded to buffer D o o A fit of two peaks in a Co spectrum in the special fit window Ypaned window with the a spectrum loaded to all four panes An example for recalibrated and normalized spectra In the lower pane the original data is shown I Graphic display window with a 224Ra spectrum loaded and a fit at Graphic display window with a Th spectrum loaded and a fit at tachedie eg 2 4 2h 2 wee A DD ed y ud a Cut without background gates ee Cut with good background gates 2 2 ee Cut with bad background gates o 111 12 LIST OF FIGURES List of Tables 2 1 Example for a collection of necessary files to examine a y y matrix 11 3 1 Hotkeys to change the viewport of the graphic pane 17 3 2 Summary of the command line interpreter s special characters 21 3 3 Sample command files 2 2 2 I ug 22 3 4 Resolved wildcards for the matrix matrix1 220Th 220h mtx 23 3 5 Wildcard characters I GG I Y Yg 24 3 6 Default wildcard definitions I e 24 4 1 Allowed operations for the ls filecommand
134. ym Ui A A a 671_ cut 220Th tig0 pry Figure 2 4 Cut gate in the projection of a Th spectrum The peak at channel 671 is marked to find its coincident transitions The spectrum at the bottom is the cut spectrum for channel 671 which has less statistic Besides you can see that channel 671 is autocoincident With a view to greater clarity it is recommended to create the so called cut window It displays the projection and cut in one window You can create it with the command tv gt window create cut testcut Compare figure 2 4 on page 12 and figure 2 5 on page 13 to see the advantages of the cut window 2 4 ANALYZING A yy MATRIX 13 Figure 2 5 The cut in its special window In the upper right corner the projection is displayed 14 CHAPTER 2 INTRODUCTION Chapter 3 Basic usage Contents 3 1 Introduction wais a ae ri A Ae a 15 3 2 Starting DV acid ante YA ed a ee by a AW WA 15 3 3 The windows ug 16 3 3 1 The graphics window o ug 16 3 3 2 Thetext window ug 17 3 4 Input modes Hu 18 341 Edit mode I Gy 18 3 4 2 Cursor mode I ee eee 18 3 5 MOUSE i a ii A y NF 19 3 6 Commands and Menus sasssa ss 00 eee ee eae 19 3 7 Abbreviations s sss eee ee es 20 3 8 Special characters 20 3 9 ALIASES A ee ele Qk a ee Re eS a 20 3 10 Command files lt o 21 oll Hotkeys s ss Se Re say ce S
135. you enter in text mode in any Tv window are echoed in the text window They will be evaluated after pressing and the results are displayed in the text or graphic windows The text window is full screen editable i e you can move the cursor with the cursor keys or the mouse to any previous executed command and execute it again or edit it and execute the new command If you want to perform commands that have been executed many commands before you can use the scrollbar to accelerate your search and place the cursor with a mouseclick at the position wanted Alternatively you can search previous executed commands by a search context Therefore use or Strg s You can also cut an paste text blocks with the mouse 3 4 Input modes There are two input modes between which you can toggle with the input mode command in the text window or by pressing in the graphics window 3 4 1 Edit mode This mode is indicated by a text cursor I in the tv root window All keys you enter in this mode in any of Tv s windows are echoed in the text window When you enter CR Tv will try to execute the entire line You can enter question mark at any time to receive a list of possible commands Furthermore it is sufficient to enter just the first few letters of a com mand see section 3 7 p 20 and press cR Tv will try to complete the command and execute it In general it is sufficient to enter just the first letter of the command If the comma
136. your results with tv gt fit print After finishing your work you must close the file with the command tv gt fit result file close You can store your fit markers to memory and restore them with the commands tv gt fit store tv gt fit restore If you want to set new markers to perform another fit you have to delete the old markers first Best you can do this by pressing JE You can recover fit markers that have been deleted accidentally with the command tv gt fit recover backup 4310 4920 4330 4940 4950 1 1 1 1 Ladd 4960 An L 4980 4990 5000 5010 L 1 Lissu 1 N 1 960 98 pold_add 2 960 98 4000 961 32 961 32 961 37 961 37 0 Lant Lo 4910 4920 4930 4940 4950 4960 4970 4980 4990 5000 5010 Figure 4 4 Graphic display window with a Ra spectrum loaded and a fit attached Upper The fit parameters are set to their default values Middle Left tail parameter is set free Lower Left tail and step height parameters are set free 4 12 FIT AND INTEGRATION 41 In order to consider the left tail you must allow Tv to fit it The command to do that is tv gt fit parameter tl free The result for the fit with tail is shown in the middle pane of figure 4 4 on page 40 and the difference is evident You can furthermore consider the background form in various ways Since there can be a loss of energy in electronics during data aguisition so

Tv User-Manual Andreas Fitzler1 Institute for Nuclear Physics

Contents

Download Pdf Manuals

Related Search

Related Contents