Selection

It frequently happens that analysis needs to focus on a subset of events. For example, permanent records need to be stored in RAA so that they can be propagated to the output file. However it is likely that analysis will want to ignore them. Again, analysis may require the selection events according to some criteria and to the exclusion of everything else. It is the purpose of the summary STATUS word to mark records for rejection and selection. Currently 8 bits are defined in raa_com_subp.inc. Four of these are global with the remaining four belonging to individual sub processors. The four gloabl bits are as follows:-

DISCARD

summary is to be permanently discarded.

PERM

summary comes from a permanent record.

SELECT

summary is currently selected.

ORPHAN

summary comes from an orphan event.

RAA has two masks that operate on the STATUS word:-

VETO

ignore the record if any bit in VETO is also set in STATUS.

ACCEPT

accept the event if every bit in ACCEPT is also set in STATUS.

The routines RAA_GET_MASKS and RAA_SET_MASKS get and set these masks. The masks are respected by the utility RAA_GET_SUMM. If the code to print all summaries:-

      call raa_summ_get( KRAA_FIRST, l_summ )
      do while ( l_summ .ne. 0 )
        call raa_sum_print( iqprnt, l_summ )
        call raa_summ( KRAA_NEXT, l_summ )
      enddo

is preceded by:-

      call raa_set_masks( 2**KRAA_SELECT, 2**KRAA_PERM )

then the loop would only print records that had their SELECT bit and were not permanent records.