esrf

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

METEOR.MAC
See other macros in category: Detection Ccd
Description:
    Macros to control non-standard cameras via the Matrox Meteor2 frame grabber.
Documentation:
    DESCRIPTION
    The meteor2 server supports the following cameras:
    • 8500A54
    • HR50
    • XC55


    DESCRIPTION
    The Meteor2 device server can be accessed via SPEC as a standart CCD camera. All standart functionality is implemented. Several extra features are available which are accessible via this set of macros as well as ccdmenu. The main features are:
    • Counters on calculated beam parameters (spot center, size, ...)
    • Manual and automatic image intensity calibration
    • Live mode for monitoring
    • Intensity threshold on image


    EXAMPLE
    meteorsetup device_name min_intensity max_intensity threshold
    It will set default calibration parameters for the active meteor2 CCD camera. You can add this setup into the SPEC setup.
    meteorshow
    Shows all readable parameters for the active meteor2 camera with their index and actual values. The actual meteor2 camera set-up is:
    [index] : description : value
    -----------------------------------------
    [0] : Exposure time : 0.000000
    [1] : Threshold : 0
    [9] : Live mode : 0
    [30] : Auto calibration mode : 0
    [2] : Calibrated max. Intensity : 0
    [3] : Full image size X : 0
    [4] : Full image size Y : 0
    [5] : ROI start X : 0
    [6] : ROI start Y : 0
    [7] : ROI end X : 0
    [8] : ROI end Y : 0
    [10] : Number of beam spots : 0
    [11] : Beam intensity : 0
    [29] : Normalized beam intensity : 0
    : (Beam intensity/Exposure time)
    [12] : Beam center X : 0.00
    [13] : Beam center Y : 0.00
    [14] : Beam size FWHM X : 0
    [15] : Beam size FWHM Y : 0
    [16] : Beam size full X : 0
    [17] : Beam size full Y : 0
    [18] : Max. pixel value : 0
    [19] : Max. pixel X : 0
    [20] : Max. pixel Y : 0
    [21] : Beam spot start X : 0
    [22] : Beam spot start Y : 0
    [23] : Beam spot end X : 0
    [24] : Beam spot end Y : 0
    [25] : Beam spot FWHM start X : 0
    [26] : Beam spot FWHM start Y : 0
    [27] : Beam spot FWHM end X : 0
    [28] : Beam spot FWHM end Y : 0
    meteor_counter_add inten "d05/meteor2/eh1" 11 1
    Configures the counter inten with the beam intensity value (index = 11)
    meteor_counter_add cenx "d05/meteor2/eh1" 12 1
    Configures the counter cenx with the beam center X value (index = 12)
    meteor_counter_add ceny "d05/meteor2/eh1" 13 1
    Configures the counter ceny with the beam center Y value (index = 13)
    meteoron
    Switches on the configured counters during ct and scans.
    meteoroff
    Switches off the configured counters during ct and scans.
    meteorcalibrate
    Start a calibration of the camera exposure time. Apply the min and max intensity set by meteorsetup macro.


Macros:
    meteorsetup
    Usage: meteorsetup <device-name> <minimum_intensity> <maximum_intensity> <threshold>
    Setup default parameters of the meteor camera.One can add this setup into the SPEC setup to save the default setting of the camera calibration.

    meteor_liveon
    Usage: meteor_liveon [ccd-unit]
    Start the camera live mode The "Take an image during ct/scan" feature of ccdmenu is disabled because it is incompatible with the live mode.

    meteor_liveoff
    Usage: meteor_liveoff [ccd-unit]
    Stop the camera live mode

    meteor_autocal_on
    Usage: meteor_autocal_on ()
    Switch on the intensity calibration for every image aquired. The camera calibrates the image intensity using the specified range before taking an image by changing the exposure time. see meteorsetup.

    meteor_autocal_off
    Usage: meteor_autocal_off ()
    Switch off the intensity calibration for every image aquired.

    meteoron
    Usage: meteoron [ccd unit]
    Switches on the configured counters during ct and scans.

    meteoroff
    Usage: meteoroff [ccd unit]
    Disables the configured counters during ct and scans.

    meteorshow
    Usage: meteorshow
    Shows all readable parameters for the camera with their index and actual values.

    meteor_counter_add
    Usage: meteor_counter_add [ counter_mnemonic ccd_ds value_index factor ]
    Adds the counter with the given mnemonic which reads the ccd_ds device value specified by the index. The index can be found by executing "meteorshow"!

    meteor_counter_remove
    Usage: meteor_counter_remove [ counter_mnemonic ]
    Removes the counter with the given mnemonic.

    meteorcalibrate
    Usage: meteorcalibrate
    start calibration of the Meteor2 CCD camera exposure time. Apply the min and max intensity set by meteorsetup macro.

    meteor_calibrate_intensity
    Usage: meteor_calibrate_intensity minimum_intensity maximum_intensity
    start calibration of the Meteor2 CCD camera exposure time then return the calibrated maximum intensity and the calibrated exposure time.

    meteor_pixelsize
    Usage: meteor_pixelsize <Y pixelsize> <Z pixelsize>
    store the pixel size in Y and Z into the database through the device server

Internal Macros:
    meteor_private_show
    Usage: meteor_private_show


    meteor_private_setup
    Usage: meteor_private_setup


    meteor_live_on
    Usage: meteor_live_on(u)


    meteor_live_off
    Usage: meteor_live_off(u)


    _meteor_on
    Usage: _meteor_on(u)


    _meteor_off
    Usage: _meteor_off(u)


    _meteor_signal_menu
    Usage: _meteor_signal_menu()


    _meteor_init_siglist
    Usage: _meteor_init_siglist()


    meteor_ct_add
    Usage: meteor_ct_add (counter_mnemonic ccd_ds signal_index signal_factor)
    Adds the counter with the given mnemonic which reads the ccd_unit camera value specified by the index. The index can be found executing "meteorshow"!

    meteor_ct_remove
    Usage: meteor_ct_remove (counter_mnemonic)
    Removes the counter with the given mnemonic.

    meteor_ct_read
    Usage: meteor_ct_read
    Reads all counters specified for the camera if the reading was eanabled by "meteoron"!

    _meteor_calibrate_intensity
    Usage: _meteor_calibrate_intensity (minimum_intensity, maximum_intensity)
    start calibration of the Meteor2 CCD camera exposure time.

    meteor_setthreshold
    Usage: meteor_setthreshold (threshold)
    set the threshold.

    meteor_getthreshold
    Usage: meteor_getthreshold(dev)
    Return the threshold.

    meteor_read_beam_center
    Usage: meteor_read_beam_center ()
    return Y and Z beam position + Y Fwhm and Z Fwhm

    meteor_read_intensity
    Usage: meteor_read_intensity(dev)


    meteor_is_running
    Usage: meteor_is_running(dev)


    meteor_is_ready
    Usage: meteor_is_ready(dev)


    meteor_getsignals
    Usage: meteor_getsignals(dev)


    meteor_initpar
    Usage: meteor_initpar(dev)
    Initialise the local parameters with the current camera setting.

Filename: meteor.mac
Author: BLISS (L.Claustre) / ESRF 2004
Last mod.: 12/08/2008 15:36 by rey