Name

Synopsis

Description

·
• Operate the dtb.
·
• Operate the mar345 scanner.
·
• Display the scanner and dtb status.
·
• Transform spiral images into Cartesian images.
·
• Display and analyze images.

Options

--admin

Starts program in administrator mode.
Default: start in non-administrator mode.

-c, --colors COLORS

No. of colors to use for image display.
Default: -c 64

-dtb, -base HOSTNAME PORT-NO

Hostname (or IP-address) and socket port number to use for the dtb.
Default: -dtb 192.0.2.3 4451

-mar, -scan HOSTNAME PORT-NO

Hostname (or IP-address) and socket port number to use for the mar345 detector.
Default: -mar 192.0.2.1 4441

--host HOSTNAME

Hostname (or IP-address) to use for the the dtb.
Default: --host 192.0.2.3

-p, --port PORT-NO

Socket port number to use for the dtb.
Default: -p 192.0.2.1 4451

-d, --default SCANMODE

Default scanmode to use for the mar345 detector. At program startup, the scanner will be set to the requested scanmode.
Default: current scanmode

--debug NUMBER

Sets an undocumented flag for debugging purposes.
Default: --debug 0

-g, --geometry WIDTHxHEIGHT[+X+Y]

Width and height and location of the main window at program startup.
Default: taken from configuration file.

-h, --help

Prints usage summary

-i, --init NUMBER

Hexcode for commands to be executed at program startup. The command can be any combination of: 0x01 (synchronize controller times with computer time), 0x02 (get firmware version), 0x04 (close shutter), 0x08 (adjust ADC offsets), 0x10 (turn on high voltage) and 0x20 (lock image plate).
Default: taken from configuration file.

-n, --nodisp

Don't pop up the image display window at program startup.
Default: pop up image display window.

--noicon

Don't create colorful program icons. This may save some colors on 8-bit color screens. Obsolete on 24-bit color screens.
Default: create icons.

--no345

Start program without opening connection to the mar345 detector.
Default: taken from configuration file.

--nodtb

Start program without opening connection to the dtb.
Default: taken from configuration file.

--print STRING

Print additional status block information. STRING can be: TASK (print all changes in task status), DIO (print all changes in digital I/O bits), ADC (print all ADC value readings), ERROR (print all error numbers in status block) or CAN <ID> (print all bits for CAN-motor with identifier <ID><). Multiple --print options are allowed.
Default: no additional prints.

-v, --verbose

Increases verbosity level. May be given several times.

Environment

MARHOME:

Root directory for mar software distribution.

MARTABLEDIR:

Location of scanner specific calibration and and dtb specific configuration files.

MAR_SCANNER_NO

Three-digit serial number of scanner.

MAR_DTB_NO

Three-digit serial number of dtb. In most cases, this value should be identical to MAR_SCANNER_NO

MARLOGDIR

Directory where log files will go.

MARHELPDIR

Directory containing documentation (html and man pages).

Input Files

$MARTABLEDIR/mar2300.$MAR_SCANNER_NO:

Scanner specific calibration table used for transformation of the images collected with 0.15 mm pixelsize.

$MARTABLEDIR/mar3450.$MAR_SCANNER_NO:

Scanner specific calibration table used for transformation of the images collected with 0.10 mm pixelsize.

$MARTABLEDIR/config.$MAR_SCANNER_NO:

Scanner and dtb specific configuration file (ASCII).

$MARHELPDIR/index.htm:

HTML documentation.

$MARLOGDIR/dtb.dat (optional):

Contains parameters from latest program session.

$MARLOGDIR/mar345dtb.csh (optional):

Shell script for running external commands. This file must be executable. The number of arguments is variable.

Output Files

$MARLOGDIR/last.log:

Contains the version number of the latest log file.

$MARLOGDIR/log/mar.log.NO:

Latest log file. NO ranges from 1 to 99 and is increased with each call of the program. If NO > 99, NO = 1.

$MARLOGDIR/lp/mar.lp.NO:

Optional output, if keyword USE STATS is given in the configuration file. The NO ranges from 1 to 99 and is increased with each call of the program. If NO > 99, NO = 1.

$MARLOGDIR/spy/mar.spy.NO:

Optional output containing native messages of the mar345 controller.

$MARLOGDIR/spy/dtb.spy.NO:

Optional output containing native messages of the dtb controller.

$MARSTATUSFILE

Optional output of a status file updated in regular interval, containing the most relevant status information. To enable output, use keyword STATUS <interval> in the configuration file. The interval is in milliseconds. If the environment variable MARSTATUSFILE is not defined, the default file name will be $MARLOGDIR/dtb.status.

$MARLOGDIR/beam/dtb.time.NO:

Binary file containing a history of the ionization chamber readings. The NO ranges from 1 to 99 and is increased with each call of the program. If NO > 99, NO = 1.

$MARLOGDIR/beam/dtb.scan.NO:

ASCII file containing ionization chamber readings as function of a motor movement of the dtb ("scan"). The NO ranges from 1 to 99 and is increased with each scan. If NO > 99, NO = 1.

$MARLOGDIR/beam/dtb.profile.NO:

Binary file containing the result of a beam profile determination. The NO ranges from 1 to 99 and is increased with each profile run. If NO > 99, NO = 1.

Note: The program will automatically set links $MARLOGDIR/mar.log and optionally $MARLOGDIR/mar.lp and $MARLOGDIR/mar.spy to the latest files in use.

See Also

Author

Germany

Copyright

Address

Table of Contents

• Name
• Synopsis
• Description
• Options
• Environment
• Input Files
• Output Files
• See Also
• Author
• Copyright
• Address