Logical DQFs

Logical DQFs return either 1.0 (true) or 0.0 (false). In those cases where logical values are required on input the C convention is followed i.e. 0. is taken as false and all other values as true.

Figure 6.3: Logical Derived Quantity Functions

Table 6.3 lists all available Logical DQFs. Some additional details are given in the following notes:-

1. IN_LIST returns 1.0 if the value $P_1$ is contained in a list pointed to by $P_2$, or 0.0 otherwise. If just these two parameters are given then $P_2$ should be a link to a user titles bank, for example:-

       '  pmt_sel    in_list    PMT+$KPMT_PIN, USER.1;     '
   

   where no offset to the titles bank should be given. You are free to invent any new titles bank to contain a list. You just need to create a titles file containing the bank (including database header) and load it in with the titles command. The length of the list is inferred from the bank size. The value $P_1$ and the values in the list should be of the same type (integer/float).

   The usage with three parameters is more general. The second parameter now points to the first word in the list (which need not be in a titles bank), and the third gives the list length (in floating point). For example:-

       '  ev_sel     in_list    EV+$KEV_GTR_ID, USER.2+1, 10.0; '
   

2. DMM gives access to DAMN and DARN data masks. $P_1$ is always the mask number and uses the following convention:-

     mask number = 0       => DAMN mask 0
     mask number = i > 0   => DARN mask i
     mask number = j < 0   => DAMN mask -j
   

   One two or three parameters can be used:-
   • DMM $P_1$

     Return 1.0 if any bit in mask $P_1$ is on. For example:-

       'test     dmm   2; '
     

     Return 1.0 if any bit on the DARN bank 2 mask is set.

   • DMM $P_1$,$P_2$

     Return 1.0 if any of bits set in $P_2$ is set for the mask $P_1$. For example:-

       'test     dmm   0,7; '
     

     Return 1.0 if any of bits 0, 1 or 2 of the DAMN bank 0 is set.

   • DMM $P_1$,$P_2$,$P_3$

     Perform the operation defined by $P_3$ on mask $P_1$ using the bits selected in $P_2$

       operation   = action*100 + value
     
       action =  0 OR  test of selected bits against value
              =  1 AND test of selected bits against value
              =  2 SET selected bits to value
     
       value  =  0 0 (false)
              =  1 1 (true)
              =  2   (undefined)
              = 10 not 0 (not allowed for SET)
              = 11 not 1 ( "    "      "   " )
              = 12 not 2 ( "    "      "   " )
     
     Examples:-
     
       'test     dmm   0,12,111; '
     
     Return 1. if bits 2 and 3 of DAMN bank 0
     are both not 1 (either 0 or undefined).
     
       'test     dmm   3,5,201; '
     
     Set bits 0 and 2 of DARN 3 mask to 1.
     Return 1.
     

     When DMM is used to set bits it always returns 1.