EventFilter takes a data source that contains events classified by SoftwareTrigger and applies a criterion to the classification to determine whether or not each event is forwarded to a sink.
Optionally, a rejected events sink can be defined. If defined, that sink will receive all physics events that were not forwarded to the accepted sink. Both sinks will get all non Physics events.
Acceptance is defined using a mask and a value. The following boolean expression must be true if an even is to be forwarded to the accepted events sink: (classification & mask) == value.
--source=URIProvides the URI of the data source. This can be a file or tcp URI. If a tcp URI it may refer to a remote ringbuffer.
--accepted-sink=URI
Provides the URI of the data sink into which
accepted events are placed. See
DESCRIPTION above to see
which events are accepted. See also the
--mask and
--value options below.
The URI can be either a file or a tcp URI. If a tcp URI, the host must resolve to localhost as NSCLDAQ only supports local producers to ring buffers.
--rejected=-sink=URI
Provides an optional sink for rejected events.
If this option is not used, rejected events silently
disappear. The URI parameter can be defined as it is
for the --accepted-sink as either
a file or a local ring buffer.
--mask=intProvides the integer mask used in determining if events are accepted. See DESCRIPTION for how this mask is used.
--value=intProvides the integer comparison value used in determining if events are accepted. See DESCRIPTION for how this mask is used.