esrf

Beamline Instrument Software Support
SPEC Macro documentation: [ Macro Index | BCU Home ]

marcollect.mac
See other macros in category: Detection
Description:
    Data collection macro with MAR Scanner and spindle/shutter synchronisation (VCT6).
Documentation:
    DESCRIPTION
    The MAR345 scanner provides a X-ray detection area from 180 to 345 mm with two possible pixel sizes 100 and 150 micro-meter. This scanner is using a unique image-plate that is erased after each exposure-read-out cycle. This is why the mar is used as detector and not as a offline scanner. Read-out cycles range from 108 to 34 (!!!) seconds, depending on pixel size and scanned plate diameter. This is about 3 times faster than other scanners and actually comes close to the performance of CCD-detectors.
    a TACO device server named MarScan345ds is running on the MAR computer and controls the scanner.

    OVERVIEW

    These user macros allow full control of the scanner for doing single scan, enabling spec scan with the mar like pseudo-counter or starting a data collection with spindle/shutter synchronisation.
    marsetup
    setup the mar scanner
    marcollect
    Perform a data collection


    DEPENDENCIES
    The file(s) marcollect.mac, ccd.mac and oscil.mac have to be read in

Macros:
    marsetup
    Usage: marsetup [ccd device number]
    Has to be called first with ccd-device-number as defined into the spec configuration.

    marnewfile
    Usage: marnewfile
    Set new file parameters.

    marimagepar
    Usage: marimagepar
    Set image parameters, detector distance and wavelength

    marcollect
    Usage: marcollect ["filename prefix"] ["frames number"] ["passes number"] ["oscillation range"] ["oscillation overlap"] ["exposure time"] ["starting position"] ["image directory"] ["erase first"]
    Performs the data collection. will acquire [frames number] images into the ["image directory"] directory with the file names ["filename prefix"]_$$ (where $$ is from [starting frame number] to [starting frame number]+[frames number]. The first position will be [starting position], the angle oscillation for each frame is [oscillation range] and there will be [passes number] passes for each frame in [exposure time] seconds.

Internal Macros:
    mar_imagepar
    Usage: mar_imagepar()


    mar_filepar
    Usage: mar_filepar()
    internal function that really set the new file parameters. return -1 if the esrf_io failed

    mar_getfilename
    Usage: mar_getfilename()
    internal function that reset the current filename setting return -1 if the esrf_io failed

    marshow
    Usage: marshow


    mar_getvals
    Usage: mar_getvals


    mar_head
    Usage: mar_head


    mar_loop_frames
    Usage: mar_loop_frames()


    mar_dataloop
    Usage: mar_dataloop


Filename: marcollect.mac
Author: L.Claustre / V.Rey, 1997-2005 $Revision: 1.2 $
Last mod.: 12/08/2008 15:25 by rey