Table of Contents

Name

bsf - benchmark stats on all floating point values in a (binary) structured file

Synopsis

bsf [parameter=value]

Description

bsf computes some numbers for all the floating point values in a structured file, which can then be used against previously obtained number in an effort to assert proper regression.

The output will mean, rms, min, max and number of points.

This program can be used by users who want to provide some regression in their NEMO scripts. See EXAMPLES below.

Parameters

The following parameters are recognized in any order if the keyword is also given:
in=
input file name [???]
test=test-string
If given, this is the resulting string that should have been obtained. Default: none
fmt=C-fmtP
C-Format string for the 4 floating point values output. [%g]
eps=
In some next version this accuracy parameter can control if the regression numbers need to agree within some fraction. Default: not used and not implemented.
label=label-string
By default the input file name is reported, but with label= you can override this. Particularly useful when unix pipes are used.

Examples

Here are some examples of the stats of the masses and phase space coordinates of a plummer sphere with 10 particles and seed=123. The last example is to show that the output of %g (the default) and %f do differ.
    mkplummer - 10 seed=123 | bsf -
    0.0140845 0.896875 -4.6523 4.80925 71
    
    mkplummer - 10 seed=123 | csf - - convert=d2f | bsf -
    0.0140845 0.896875 -4.6523 4.80925 71
    mkplummer - 10 seed=123 | csf - - convert=d2f | bsf - %f "0.0140845 0.896875
-4.6523 4.80925 71"
    0.014085 0.896875 -4.652300 4.809249 71 FAIL
    0.0140845 0.896875 -4.6523 4.80925 71 expected
When you run these with seed=0, you will see the first and last number do not change, because mkplummer by default value centers the snapshot (zerocm=t).!q

See Also

tsf(1NEMO) , filestruct(3NEMO)

Files

NEMO/src/kernel/io

Author

Peter Teuben

Update History


24-Nov-2019    V0.1 Created    PJT
10-dec-2019    V1.0 finalized with label=    PJT


Table of Contents