XMM-Newton Science Analysis System


selectlib (selectlib-4.77) [xmmsas_20230412_1735-21.0.0]

In-operator

The in-operator is available in three distinct forms

1. arith IN intervals
   This tests whether the value to which the arithmetic expression arith evaluates lies within at least one among a list of intervals with numeric boundaries. The interval list is either a single interval or a comma separated list of interval specifications. The following table provides an overview of the available intervals types (x stands for the value of arith above):

   interval specification	alternative expression	meaning
   : or (:] or [:) or (:)	true	$-\infty<x<+\infty$
   val or [val]	val == x	$x=val$
   val: or [val:] or [val:)	val <= x	$val<=x<+\infty$
   (val:] or (val:)	val < x	$val<x<+\infty$
   :val or [:val] or (:val]	val >= x	$-\infty<x<=val$
   [:val) or (:val)	val > x	$-\infty<x<val$
   lo:hi or [lo:hi]	lo <= x && hi >= x	$lo<=x<=hi$
   (lo:hi]	lo < x && hi >= x	$lo<x<=hi$
   [lo:hi)	lo <= x && hi > x	$lo<=x<hi$
   (lo:hi)	lo < x && hi > x	$lo<x<hi$

   An example of a valid value-in-interval expression which yields true is:
   3.1415 in :-10,[1:3),3.1,[3.14:3.19),[4:]
   

2. arith in gti(gtitable)
   This is equivalent to the expression
   gti(gtitable, arith)
   

3. (arith1, arith2) in filter(...)
   where filter is either region or mask or any of the region selection functions. The form is equivalent to
   filter(..., arith1, arith2)
   
   for instance
   (RAWX, RAWY) in circle(100, 120, 10) == circle(100, 120, 10, RAWX, RAWY)
   
   always evaluates to true.
4. vector in filter(...)
   where filter is a three dimensional region selection function and vector is a vector for the inclusion test.