man8/DMANjudge_v2

Table of Contents

Name

DMANjudge_v2 - dosimetry judgement client

Synopsis

DMANjudge_v2 <argument list>

Description

The DMAN system judgement client.

This program works with DMANserv_v2(8) when judgement is enabled to decide when an item has been sufficently measured.

Each time DMANserv_v2(8) completes a measurement a message is sent to DMANjudge asking it to render a judgement.

DMANjudge analyzes the measurements for the item and notifies DMANserv_v2(8) telling it whether the item has passed, failed, or is not ready to be judged.

The criteria used to judge an individual item (minimum number of measurements, and the judge limit) are supplied as part of the runlist information.

The judgement method, which ratio and which field within the ratio to use for judgement are supplied as part of DMANserv_v2(8) ’s configuration information and may be changed from DMANmngr_v2(1) .

DMANserv_v2(8) will continue to perform measurements of an item until the number of measurements specified is completed or until DMANjudge decides that the item has passed judgement.

See below for a description of each of the available judgement methods.

Arguments

Argument processing is done using Unix long argument syntax.

The values of all of the parameters listed here (whether or not they were supplied on the command line) are printed on stderr when the program starts.

--dman_host <hn>

the host where DMANserv_v2 is running

The DMAN_HOST environment variable is used if present.

--diag_msg

If this argument is supplied then DMANjudge will output diagnostic messages about the judgement process.

The diagnostic messages are written to stderr.

When this argument is used the program is usually started on the command line so the user can watch the diagnostic messages go by.

If diagnostic messages are enabled then SIGINT may be used to exit the program, otherwise SIGINT is ignored.

--nmin_recent <arg>

Set the behavior of the nmin_recent judgement method.

<arg> presently only accepts "continue" as a valid argument.

See the "N minimum recent judgement method" section below.

--help

Print the internal help information and exit.

Judgement method general information

The descriptions below refer to several parameters. The parameters are: Jn, Jvalue, Jlimit, Jstatus, and Nj.

The Jn, and Jlimit parameters are supplied by the runlist.

Jvalue, Jstatus and Nj are values calculated by DMANjudge and returned to DMANserv_v2(8) .

Jn is the minimum number of results required by the judgement. The exact behavior of this parameter depends on the selected judgement method.

Jlimit is the minimum value the judgement parameter must achieve for the item to pass judgement.

Jvalue is the value calculated by DMANjudge. This value is returned to DMANserv_v2(8) when judgement is rendered.

Nj is the number of measurements actually used by DMANjudge when performing it’s calculation. This value is returned to DMANserv_v2(8) when judgement is rendered.

Jstatus is the judgement status. It has three possible values:

nop no judgement has been rendered.
pass the judgement passed.
fail the judgement failed.

One of these values is returned to DMANserv_v2(8) when judgement is rendered.

DMANjudge sets the Jexclude flags in the results records when judging. These values are returned to DMANserv_v2(8) when judgement is rendered.

If a result has been excluded it is also excluded from judgement.

N best judgement method

This method caculates a mean for all results, then excludes the results with the greatest amount of scatter until only Jn results are left.

The statistics are recalculated and judgement rendered.

N recent judgement method

This method excludes all results except the Jn most recent results.

The statistics are calculated and judgement rendered.

N minimum best judgement method

This method calculates the statistics on all measurements and compares the result to Jlimit.

If the result is greater than Jlimit the measurement with the greatest scatter is excluded and results are recalculated.

If the result is worse than the previous result the process stops and judgement is rendered.

If the result is better than (or the same as) the previous result the process is continued until there are at most Jn results left unexcluded.

N minimum recent judgement method

This method starts by calculating the statistics for the Jn most recent measurements and compares the result to Jlimit.

If the result is greater than Jlimit the next oldest measurement is added and results are recalculated.

If the result is worse than the previous result the process stops and judgement is rendered.

If the result is better than (or the same as) the previous result the process is continued until all measurements are included.

If the "--nmin_recent" argument is used with the value "continue" then judgement will continue to add measurements until all are included or the result is below Jlimit.

Examples


#
# typical AccelNET DMANjudge startup
#
# this line is usually in the dosimetry script after
# DMANserv_v2 has been started.
#
DMANjudge_v2 2>/log/dosimetry.log/DMANjudge &

#
# startup DMANjudge from the command line to be able to
# watch the diagnostic messages.
#
DMANjudge_v2 --diag_msg

Notes

The "--nmin_recent" argument is an example of how one can add new behaviors to existing judgement methods without going through all of the work to add this stuff to the configuration.

This is especially worthwhile when trying things out where there is doubt over whether or not the change will become a permanent addition.

If it does become permanent then one can consider later what to do about the configuration stuff.

Manual Page Revision

$Id: DMANjudge_v2.8,v 2.1 2007/07/30 18:23:54 kitchen Exp $

Table of Contents