Документ взят из кэша поисковой машины. Адрес оригинального документа : http://curl.sai.msu.ru/mass/download/doc/massug_eso.pdf Дата изменения: Sun Jan 18 20:37:52 2004 Дата индексирования: Mon Oct 1 20:14:47 2012 Кодировка: Поисковые слова: comet tail

MASS Software Version 2.04 User Guide
V.Kornilov, N.Shatsky, O. Voziakova Decemb er 30, 2003


Contents
1 MASS software op eration overview 1.1 Main features of measurement pro cess with MASS instrument . . 1.2 The basic op erations . . . . . . . . . . . . . . . . . . . . . . . . . 1.2.1 Scintillation indices measurement (or, historically, normal 1.2.2 Background measurement . . . . . . . . . . . . . . . . . . 1.2.3 Flux estimation . . . . . . . . . . . . . . . . . . . . . . . . 1.2.4 Star centering . . . . . . . . . . . . . . . . . . . . . . . . . 1.2.5 Tests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2.6 Detector counting measurement . . . . . . . . . . . . . . . 1.2.7 Detector statistic measurement . . . . . . . . . . . . . . . 1.2.8 Initialization . . . . . . . . . . . . . . . . . . . . . . . . . 1.2.9 Device parking . . . . . . . . . . . . . . . . . . . . . . . . 1.2.10 Op erations with scenaria . . . . . . . . . . . . . . . . . . 1.2.11 Device direct control . . . . . . . . . . . . . . . . . . . . . 1.2.12 Configuration p ossibilities . . . . . . . . . . . . . . . . . . 2 Installation, tuning and startup 2.1 Installation of the MASS software Turbina 2.2 Editing the configuration file . . . . . . . 2.2.1 Preferences section . . . . . . . . . 2.2.2 General section . . . . . . . . . . . 2.2.3 Op erations section . . . . . . . . . 2.2.4 Display section . . . . . . . . . . . 2.3 Lo cal start up . . . . . . . . . . . . . . . . 2.4 Remote and automatic running . . . . . . 2.4.1 X-windows starting for Turbina . . 2.4.2 Automatic start-up . . . . . . . . . 2.4.3 Remote start-up . . . . . . . . . . 2.5 Working under the Sup ervisor control . . 3 Main Turbina program window and menu 3.1 Main window . . . . . . . . . . . . . . . . 3.2 The Structure of the Main Menu Tree . . 3.3 File menu item . . . . . . . . . . . . . . . 3.4 Measurements menu item . . . . . . . . . 3.5 Tests menu item . . . . . . . . . . . . . . 3.6 To ols menu item . . . . . . . . . . . . . . 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 5 6 6 6 6 7 7 7 8 8 8 8 8 9 10 10 13 14 15 16 19 21 22 22 23 24 24 27 27 28 30 31 32 33

.... .... mo de) .... .... .... .... .... .... .... .... .... .... .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

tree ... ... ... ... ... ...


3.7 3.8 3.9 3.10

Control menu item . . . Config menu item . . . . Help menu item . . . . . Results Window content

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

33 34 36 36 39 39 39 39 40 40 43 43 45 46 46 47

4 Measurements and results 4.1 Measurements with MASS . . . . . . . . . . . . . . 4.1.1 The observational pro cedure . . . . . . . . 4.1.2 Writing a new scenario . . . . . . . . . . . . 4.2 Output data in MASS Software . . . . . . . . . . . 4.2.1 Mass-file structure . . . . . . . . . . . . . . 4.2.2 Statistic moments file . . . . . . . . . . . . 4.2.3 Relation of prefixes to the MASS op eration 4.2.4 Count-file handling and data re-calculation

.... .... .... .... .... .... mo des ....

5 Version 2.04 features with resp ect to 2.03 version 5.1 Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.2 Further mo difications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2


Bibliography
[1] Kornilov V., The optimization of MASS device for synchronous measurement with Paranal DIMM. A Prop osal to Europ ean Southern Observatory (ESO). Decemb er 11, 2002 [2] Kornilov V., Shatsky N., Shugarov A., Voziakova O. Optimized MASS device for synchronous measurements with Paranal DIMM. Electronics and Device control. Novemb er 2003. [3] Kornilov V., Potanin S., Shatsky N., Shugarov A., Voziakova O. Optimized MASS device for synchronous measurements with Paranal DIMM. Optical and mechanical design. Alignment. Decemb er 2003. [4] Kornilov V., Tokovinin A., Voziakova O., Zaitsev A., Shatsky N., Potanin S., Sarazin M. MASS: a monitor of the vertical turbulence distribution. Pro c. SPIE, V. 4839, p. 837-845, 2003 [5] A.Tokovinin, V.Kornilov, N.Shatsky, O.Voziakova, Restoration of turbulence profile from scintil lation indices, MNRAS 2003, V. 343, P. 891

3


Introduction
This do cument presents the information on the use of the MASS Software. It is created for the control of the op erations with the LITE Version of the Multi-Ap erture Scintillation Sensor device designed at Sternb erg Astronomical Institute, according with a Prop osal to ESO [1]. The pro ject was implemented in frame of the ESO contract No. 69255/ODG/02/9124/GWI The do cument consists of several Chapters first of which presents an overview of what can b e done with the program and what are the general ideas of implementation of its functionality in form of its modes. Next chapter is more practical ­ it describ es how to install and prepare the software for a particular use. Chapter 3 tells ab out the comp osition of the program interface and gives more details on how the device works in its numerous mo des and which settings affect its p erformance. Chapter 4 describ es in brief the usual observational sequence (details are given already in previous chapters) and explains the data output in details. Finally, the last chapter 5 gives a helpful list of changes intro duces in the version 2.04 of the program Turbina which resulted from the first exp erience of automated way of use of the device. The drawbacks which still p ersist are mentioned as well. Compared to the previous versions of the current do cument, more details and practical advises are given, which allow to call it a real User Guide for the first time.

4


Chapter 1

MASS software operation overview
1.1 Main features of measurement pro cess with MASS instrument

The software for control of MASS op erations and data acquisition and reduction provides b oth reliable scintillation indices and atmospheric turbulence profile measurement and an ease of control and handling. The software supp orts all op erational mo des needed for making measurements, including testing, calibration and auxiliary measurements. In order to measure correctly scintillation indices (SI), series of separate star flux measurements with integration time less than scale time of scintillation (a few milliseconds) must b e obtained. This is done by photometric mo dules of the device which output is then transmitted to the MASS-machine where data flow is pro cessed. One can see ([4] and [5]) that there are a few physical parameters, which define the values of SI calculated on the base of statistical moments of the incoming data. In each channel such parameters are: background value, non-Poisson and non-linearity. The first one dep ends on sky condition, the last two are detector characteristics. Reduction of calculated SI and integral characteristics of the atmospheric turbulence to standard condition requires a star sp ectral energy distribution and its airmass. This information as well as instrument geometry are needed for turbulence profile restoration. During measurement, the star light flux variation dep ends not only on scintillation but on other factors: atmospheric transparency changes, tracking errors, wind pushes. To eliminate the influence of these factors, the incoming data must b e filtered from side of low frequencies. Such a filtering may b e implemented by calculation of the statistical moments around a sliding average flux value. In practice, the measurement data are obtained and reduced by separate segments of ab out 1 s duration each (so called base time). To obtain a reliable output values with appropriate accuracy, the additional averaging of the computed SI and other values is used. The full time, needed to obtain separate measurement value ( e.g. atmospheric turbulence profile, or background level, and so on) , is an accumulation time at a minute scale. In order to provide stable star image p osition in the instrument field of view, a sp ecial centering control is needed if CCD camera is not available. Finally, to ensure the correct p erformance of the MASS electronics and data pro cessing, a numb er of tests must b e provided by the software.

5


1.2

The basic op erations

To supply a full scop e of the needed data for measurements and subsequent reduction, MASS software (the program Turbina) includes a set of op erational mo des. Some of them represent measurement mo des themselves, other -- preparation mo des. Below follows a short description of implemented op erational mo des. Recall that all measurement mo des are using three different integration times for their temp oral organization: Exposition ­ the micro-exp osure duration in milliseconds during which one individual count is integrated in the photometric mo dules for each channel (elementary exp osure); BaseTime ­ the duration of the single blo ck of counts in seconds by which the individual statistical moments (and, for some mo de, scintillation indices) are pro duced; AccumTime ­ the duration of the mo de working in seconds; during this time N = AccumT ime B aseT ime individual sets of statistical moments are accumulated and then averaged to pro duce the single output result. The results of each mo de are displayed on the screen and saved in the output file. Note that all fluxes in the program refer to 1 ms integration time (i.e. scaled to this value if the actual exposition is different).

1.2.1

Scintillation indices measurement (or, historically, normal mo de)

This is a ma jor (scientific) mo de of measurements. During AccumTime the measurements are done by blo cks of the duration BaseTime. For every blo ck, statistical moments and then scintillation indices are computed. For SI, the last-obtained background values are taken, or, if no Background mo de was started b efore, the values from configuration file are adopted. From these instantaneous scintillation indices, the resp ective (basetime-related) atmospheric turbulence integral moments are computed (p owers 0, 1, 5/3 and 2 of altitude). For the whole AccumTime measurement, the average values of the scintillation indices and the estimates of their errors are computed and saved. Turbulence integral moments are similarly averaged and the atmospheric integral characteristics (free seeing, isoplanatic angle, effective turbulence altitude etc) are derived and corrected for non-zenith star p osition. Then the turbulence profile is restored from average SI using two metho ds (see [5]).

1.2.2

Background measurement

For correct calculation of the scintillation indices, the sky background level (non-scintillating) must b e known. The star must b e removed from the field ap erture b efore starting the mo de. The sky background is estimated by measuring the flux during the AccumTime. Subsequent scintillation indices calculations use these background values. If they are wrong by some reason (bad or outdated measurements) -- check situation and rep eat the background measurement.

1.2.3

Flux estimation

In some cases (star identification, p ointing checking etc), the brightness of a star (or any other light source) is needed. This auxiliary mo de allows to get such an estimation. Its results do not play any role in interpretation of results of subsequently run mo des. 6


The duration of measurement is determined by the parameter FluxEstimationTime which has a sense of accumulation time for this mo de. Data accumulation go es in the same way as in scintillation measurements. Meanwhile, data reduction is restricted to calculation of the average value and its error over the complete data set.

1.2.4

Star centering

Control of the star p osition within the field ap erture is p erformed by means of scanning (with help of a triangle knife moving across ap erture). See [2] and [3]. Scan represents the sequence of flux measurements obtained in a following way: knife is one-step shifted by stepp er motor, flux is measured, knife is shifted again and further on. For this mo de solely, the exp osure is given in a configuration file separately from other mo des. Star p osition is determined from the knife p ositions when the flux crosses the level of 1/2 of the maximal flux (when knife is out of the ap erture). The referencing of the knife p osition to the center of the ap erture is made by separate calibration scanning of a uniformly illuminated field of view (starless twilight sky). The p ositions for 1/2 flux level obtained during calibration must b e written in configuration manually.

1.2.5

Tests

There are three tests implemented in the program ­ Detector test, Exchange test and Statistic test. They allow to check the state of b oth hardware and software. Exchange test Idea of this mo de is to check the state of communication with device. Using settings for normal mo de measurements (exp osition, base time etc.) the photometric mo dules transmit the predefined test data, to b e checked by the program. First, each mo dules is tested separately (one after other). Then, all mo dules are tested simultaneously (work like in real measurement conditions). Detectors test Check the PMT sensitivity. The control LED is activated and, after a small pause, the flux measurements are done. The control light is then switched off. The measured fluxes and detector non-Poisson parameters are compared with those written in configuration file. Statistic test This test mo dels the pro cess of measurement of scintillation with help of blinking control LED. Instrument works like in the real SI measurements. The derived indices are compared with those calculated from the known LED flux variation. The LED is blinking synchronously with measurements with a p erio d of 4 micro exp osures: 1) middle level 2) max level 3) middle level 4) min level. Masking of resp ective micro exp osures allows to derive these levels explicitly and to predict the value of scintillation index.

1.2.6

Detector counting measurement

This complex auxiliary pro cedure provides measurement of the PMTs count rate as a function of HV and pulse discrimination threshold for a sp ecified grid control light levels. The mo de consists of three emb edded lo ops. The outer lo op is over the light fluxes, the intermediate lo op is over the HV levels, and the innermost lo op is over the discrimination level. The dark counting,

7


if needed, should b e sp ecified explicitly (with the light level 0). For every p oint, the average flux value, its error and a non-Poisson co efficient are computed. Duration of the mo de dep ends on pro duct of numb er of p oints in the grids over HV, discrimination and light levels. The detector counting measurement is intended to define optimal work condition for detector PMTs. As a final result, a series of dep endences of the count rate and non-Poisson parameter on HV value may b e plotted [3].

1.2.7

Detector statistic measurement

This pro cedure provides measurement of the main statistical parameters of the detector ­ nonlinearity co efficient and non-Poisson parameter. The measurements are done when optimal HV and discrimination threshold were defined and set in the system. This mo de includes separate measurements for sp ecified set of the control light levels. The resulting dep endence of the current non-Poisson parameter on the flux level p ermits to compute non-linearity co efficient and non-Poisson parameter for each detector channel [3].

1.2.8

Initialization

Device initialization mo de is a preparation mo de which activates initial settings of the instrument electronic mo dules. Some program variables are initialized, to o. Also, the initialization may involve a numb er of mo des sp ecified in the initial scenario script (see 1.2.10). The initialization is an obligatory first step b efore any other measurement mo des after the program start-up.

1.2.9

Device parking

This mo de shuts down the device in a safe waiting state with a well defined status. As a rule, high voltage turns off. The mo de is called automatically b efore the normal exit from the program. To continue the measurements with a program after parking, it is obligatory to do the Initialization.

1.2.10

Op erations with scenaria

Scenario is a simple mechanism which provides an execution of a sequence of op eration mo des. The desired sequence is defined by the scenario script which is an expression involving the symb ols denoting the mo des (or commands) and op erations with them: grouping the sub expressions (parentheses (...) ), grouping the mo des (addition sign +) and rep etition of mo des or sub expressions (multiplication sign * ). Normally, the scenario script is comp osed and written in the configuration file to simplify (automate) routine well tested measurements during long time p erio d. Redefinition of the scenario script up on work is p ossible as well. Before scenario launching the software always checks the scenario content and estimates its execution duration.

1.2.11

Device direct control

Device direct control itself is not a separate op erational mo de. It provides a p ossibility of manual control of the device auxiliary functions: turn on/off high voltage, field ap erture illumination, control light etc. Mainly, these are needed during device installation, preparation tasks, alignments and etc. The settings done under such a control are valid until parking the device. 8


1.2.12

Configuration p ossibilities

An interactive GUI provides p ossibilities to change program configurations during Turbina program execution. Similarly to the direct device control options, changed configuration parameters are active during current session if they are not saved. Once saved, new values are written into the main configuration file and b ecome active up on the next program run as well.

9


Chapter 2

Installation, tuning and startup
2.1 Installation of the MASS software Turbina

The MASS device is op erated by the program turbina written in C++ language for the real-time communication with the system hardware. Both desktop or laptop PC computer running under Linux OS can b e used. So far as MASS device is designed to b e connect to the PC via parallel p ort and sp ecial RS485/LPT converter [2], computer must have LPT p ort working in EPP mo de. The MASS software itself do esn't require a large disk free space (1 Gb is enough) or p owerful PC hardware, and in general, requirement to PC follows the one for mo dern Linux distribution with XWindows graphic shell. Installation pro cedure is roughly following: 1. Install the Linux distributive. The software was tested with SuSE 7.2, 8.2, Slackware 8.0 and RedHat 8.0 Linux distributions. The following comp onents are obligatory to install: ­ ­ ­ ­ ­ ­ XWindows with any window manager (KDE or whatso ever) gcc/g++ compilers ncurses text dialogs package Qt graphic libraries versions 2 and/or 3, development package sources of the installed Linux kernel xmgrace and xfig utilities for output data analysis

Normally, using the standard installation option, the first three comp onents are installed by default, but others, esp ecially, the development libraries and include files of Qt are not. Note, that this MASS software do es not demand Real-Time Linux installation contrary its early version. 2. Login as ro ot 3. Insert the compact disk with Turbina distributive and make the following actions: # mount /dev/cdrom /cdrom # cd /cdrom # ./unpack

10


The last command starts the script which just takes the archives from the CD and unpacks them in the right places of the file system. The comp onents of the Turbina program are put in following places: /usr/share/turbina/ ­ working directory: input and output data (star list, sp ectra, weight functions etc.), configuration files, etc. /usr/src/rs485-X.X.X ­ the sources of the RS-485 interface driver /usr/share/doc/turbina/ ­ MASS and Turbina do cumentation /usr/src/turbina/ ­ source files of Turbina to make executable /usr/share/supervisor/ ­ Sup ervisor manager program package They must b e compiled and built which is describ ed in following steps of installation. 4. Compile of the RS-485 driver. Go to the sources directory, make a link to current kernel sources directory, to the current (provided) version of the RS-485 driver sources. Then enter the driver directory, configure, compile and install the driver and make the device for the RS-485 interface: # # # # # # # cd /usr/src ln -s [kernel-source-code-directory] linux ln -s rs485-3.X.2 rs485 cd rs485 make make modules_install make create_dev

Notes: ­ Do make menuconfig b efore make if your LPT p ort address and IRQ are different from 378H and IRQ7, resp ectively. ­ The installation command copies the driver lpt.o from the /modules sub directory to /lib/modules/[kernel-version]/misc. ­ The device-making instruction (last "make") actually do es mknod /dev/mcua0 c 28 0 and creates the devices /dev/mcua0 and /dev/mcua1; this is needed only if you install the driver for the first time in the system. 5. Install the RS-485 driver. Try to say # modprobe lpt or # insmod lpt The driver is installed instead of the parallel p ort driver. Thus, the driver is installed if parallel p ort is not o ccupied. Otherwise, unload all drivers that use it by the command rmmod [driver-name]. The command lsmod lists all loaded drivers. The name of lowlevel LPT driver is parport, but firstly unload the high-level drivers that use it (they are listed by lsmod in 4-th column of parport row), then unload parport.

11


If the kernel is compiled with the LPT driver already built in (not loaded as a mo dule), b o ot the computer with the option parport=0 in /etc/lilo.conf (in the section that contains the parameters of the chosen kernel, this is a case of loading the linux with LILO). These steps of "cleaning" the unnecessary drivers and installing the lpt should b e written in one of the system start-up script (normally somewhere in /etc/rc.d/, consult your system administer how to do this). Otherwise, the cleaning of LPT-drivers and insmod lpt must b e done each time the Linux is restarted. 6. Test the driver and communication. ­ Make sure that the LPT p ort is in the EPP mo de (check in BIOS settings). The LPT p ort address normally is: 378H IRQ7. ­ Connect the electronics to LPT p ort through the RS485/LPT converter. Power the electronics with +12V (green LED on). ­ Compile and start the low-level program for direct communication with the electronic mo dules of MASS: # cd /usr/rs485/test/ # make # ./lmox The screen message shows the version of the driver and < prompt if the communication is established. Write 10 a2. The answer should b e Data 2 bytes 0b 07. Then press Enter to exit. If either device mcua0 or driver lpt or PS485/LPT converter are not found or the electronics is not accessible, there will b e appropriate error message. 7. Compile the Turbina program. Go the the Turbina source directory, copy the Makefile which represents the use of your version of Qt (see whether it is /usr/lib/qt2 or qt3), and compile the program: # # # # cd /usr/src/turbina cp Makefile.qt2 Makefile make clean make

Thus, the compilation of Turbina is started. When finished, the turbina executable is created in the current directory. Try to start it: # ./turbina If starts, install the executable: # make install This way, the program may b e started as simply typing turbina from any directory. Potential problems: 12


­ Absence of symb olic link to the real Qt library in /usr/lib. The symb olic directory /usr/lib/qt2 must p oint to the actual Qt2 directory, like /usr/lib/qt2.1. The same for Qt3 library: the link /usr/lib/qt3 to p oint to the real Qt3 directory. ­ Sometimes the links to sp ecific library mo dules are required when compiling turbina. Put the required links: libqt-mt.so -> libqt-mt.so.3 -> [real file]. ­ Incomplete Qt libraries. In some Linux installations the Qt directories are not complete. In this case, use the Linux distribution and up date the system to install qt devel. ­ Error messages at linking saying that some Qt libraries are not found. In this case, make symb olic links to the missing libraries in /usr/lib. 8. Check the Sup ervisor program. The Sup ervisor is a Tcl script which do es not require compilation. Thus, if you need such a functionality, follow the instructions in the Sup ervisor User Guide do cument. 9. Check the PC clo ck, which must b e set to lo cal time, as usual, with a prop er value of the time-zone set. In this case, the Universal Time (UT) is computed prop erly for writing the output file records and ob ject visibility calculations (autonomous Turbina functioning and Sup ervisor).

2.2

Editing the configuration file

All parameters which control b oth the hardware and software characteristics of the program Turbina are stored in text configuration files turbina.cfg (main CFG, changeable from Turbina menu) and device.cfg ("engineer" settings only, inaccessible from the program). Both files have the same structure of hierarchical levels. Upp er level consists of Sections; each section may have any numb er of Subsections. Thus, there are up to two levels of enclosure (no "SubSubsections"). Lowest level of hierarchy is a list of parameters. Names of (sub)sections (given in quotes) and names of parameters are fixed and cannot b e changed. The values of parameters may b e of following typ es: ­ ­ ­ ­ numerical (integer or floating p oint) character (strings) set of values separated by commas or spaces (no matters) Logical: On/Off or Yes/No

The values of parameters are validated by the program on startup and the message is given in case when the non-allowed value is encountered or some field is absent or non-recognized. Character-typ e parameter values (except for the scenario mo de symb ols) are case-insensitive. Parameters cannot b e removed from the file, in this case they disapp ear also from the menu. Sections and parameters with unrecognized names are ignored. The line starting with `#' as a first non-blanc character is a comment string not interpreted by the program. The part of line after semicolon ';' is also a comment but displayed by the program as a short help in the dialog for the resp ective parameter mo dification. When the file is written by the program back to disk (after a mo dification via the menu tree), the latter comments are retained but comment lines started with `#' are not. Therefore, keep the original turbina.cfg file as a reference to prevent loss of some parameters string. 13


File device.cfg contains imp ortant device constants. Some lines (parameters) may b e mo dified during MASS installation and alignment pro cedure (see [3]). First of all, the Magnification parameter is very imp ortant for correct turbulence profile restoration and must b e written after MASS installation at the feeding telescop e and measurement of magnification (see [3]). It is also useful to have a FocalLength parameter close to true one, but it do es not affect at the output results. After careful studying of the the MASS detectors [3] with help of the program to ols: Detector count measurements and Detector statistic measurements (see Sect 3.6), a need for correction of some electronics parameters can arise. These are: ­ working high voltage HighVoltage in Auxiliary/Common subsection; ­ non-linearity parameters NonLinearityA/B of the detectors in the Bicounters/Bicounter 1 or 2/ subsections; ­ non-Poisson parameters NonPoissonA/B in the same sections; ­ discrimination thresholds DiscriminationA/B. Also, the mo dule identifications must b e changed after their re-programming. Never edit the Module/Command sections! Third configuration file is status.dat placed in the directory config/; it contains program service information only for its auto-validation of the turbina.cfg content. Below we describ e section-by-section the content and edition of the MASS main configuration file turbina.cfg. Note, that the structure of the configurating file corresp onds in general to the Turbina GUI menu tree (see Chapter 3).

2.2.1

Preferences section

Section "Preferences" SubSection "Text window settings" ; WindowGeometry auto ;left top width height in pxs FontSizeLarge 12 ;fontsize of text window FontSizeSmall 10 ;fontsize of data and message text EndSubSection SubSection "Graphic window settings"; WindowGeometry 640 -45 620 960 ;left top width height in pxs FontSize 10 ;fontsize of graphic window Background darkGreen ;background color for graph window AxesColor lightGray ;color of axes PointSize 1 ;size of point in pxs EndSubSection EndSection This section helps to adjust the app earance of the program windows. WindowGeometry allows to set the desirable dimensions of the program windows on the X-windows screen or set auto for default b ehavior. Large font in Text window settings manipulates the sizes of Menu item names, Small font is used for the output data numb ers and message text. Graphic window settings refer to the result plots. The color names in the configuration file are standard and include: black, white, darkgray, gray, lightgray, red, green, blue, cyan, magenta, yellow, darkred, darkgreen, darkblue, darkcyan, darkmagenta, darkyellow. 14


2.2.2

General section
; ; ;TURBINA version number ;date of introduction, DD.MM.YY ;who modifies the program ; ;version of this conf. file ;date of introduction DD.MM.YY ;who modifies this conf. file ; ;observatory or site name ;longitude of the site: h,m,s ;latitude of the site: d,m,s ;tmZome (Local-UT) ; ;list of stars for measurements ;set of energy distributions (SED) ;spectral response of detectors ;weightDir ;lutDir ; ;directory for temporal files ;directory for mass, cnt, stm files ;directory for logging files ; ;Turbina port number for SV usage

Section "General" SubSection "Program version" Version 2.04 Date 26.12.03 Modified O.Voziakova EndSubSectio