;+

; Project     : SOLAR-B - EIS

;

; Name        : EIS_event_control__DEFINE

;

; Purpose     : Generates structure EIS_event_control.

;

; Explanation : When IDL encounters structure 'STRname', if structure not already defined

;               it looks for routine strname__define and compiles and calls routine to define

;               structure. NB under unix it looks for lower case flename.

;

;               This routine defines the structure :

;

;                 EIS_event_control. Tags are :

;                   response_identifier      : ULONG number uniquely identifying the study

;                                              to be run if an EIS event occurs.

;                                              0 if no response to an EIS flare event.

;                   raster_identifier        : ULONG specifies which raster in the event study the autonomous

;                                              repointing is applied to ( if required).

;                                              Last 16 bits must not be 0 or 0xFFFF.

;                   adjust_Y                 : UINT flag indicating whether repointing in the Y

;                                              direction by changing the window height and the

;                                              camera readout window is allowed (1) or not (0).

;                   adjust_X                 : UINT flag indicating whether repointing in the X

;                                              direction using the fine mirror is allowed (1) or not (0).

;                   X_threshold              : UINT threshold used for row sums.

;                   Y_threshold              : UINT threshold used for column sums.

;                   X_min_limit              : UINT number of consecutive samples above threshold

;                                              which are required for a flare trigger, range 1-7.

;                   Y_min_limit              : UINT number of consecutive samples above threshold

;                                              which are required for a flare trigger, range 1-7.

;

; Use         : <dummy = {EIS_event_control}>

;

; Inputs      : None.

;

; Opt. Inputs : None.

;

; Outputs     : Sets up structure definition.

;

; Opt. Outputs: None.

;

; Keywords    : None,

;

; Calls       : None.

;

; Common      : None.

;

; Restrictions: None.

;

; Side effects: None.

;

; Category    : EIS_CPT.

;

; Prev. Hist. : None.

;

; Written     : Martin Carter RAL 03/08/04

;

; Modified    : Version 0.1, 23/09/04, MKC

;                 Changed ystart and yheight tags to ULONG.

;               Version 0.2, 24/02/05, MKC

;                 Removed ystart and yheight tags.

;                 Moved parameters from EIS event response.

;               Version 0.3, 24/06/05, MKC

;                 Changed INT values to UINT.

;                 Added X_threshold, Y_threshold.

;               Version 0.4, 04/07/05, MKC

;                 Added number of rasters tag..

;               Version 0.5, 08/09/05, MKC

;                 Changed raster number/ number of rasters tag to raster identifier.

;               Version 0.6, 19/06/06, MKC

;                 Changed tag study identifier.

;               Version 0.7, 23/03/10, JAR

;                 Added tags.

;               Version 0.8, 05/05/11, JAR

;                 Modified JAR extra tags.

;

; Version     : 0.8, 05/05/11

;-

;**********************************************************



PRO eis_event_control__define



  dummy = {EIS_event_control, $

           response_identifier      : 0UL, $

           raster_identifier        : 0UL, $

           ; Start of extra tags introduced by JAR

           line_index               : 0U  , $

           no_hunt_data             : 0B  , $

           ra1_xcen                 : 0.D , $

           ra1_ycen                 : 0.D , $

           ra1_mip                  : 0L , $

           ra1_yip                  : 0L , $

           ra1_sc_x                 : 0.D  , $

           ra1_sc_y                 : 0.D  , $

           ra1_pointed              : 0B  , $

           ra2_use                  : 0B , $

           ra2_xcen                 : 0.D , $

           ra2_ycen                 : 0.D , $

           ra2_mip                  : 0L , $

           ra2_yip                  : 0L , $

           ra2_sc_x                 : 0.D  , $

           ra2_sc_y                 : 0.D  , $

           ; End of extra tags

           adjust_Y                 : 0U, $

           adjust_X                 : 0U, $

           X_threshold              : 0UL, $

           Y_threshold              : 0UL, $

           X_min_limit              : 0U, $

           Y_min_limit              : 0U }



END