HDF_Bfit: Optimal baseline fit.
===============================

.. _hdf_bfit:

Optimal fitting using the general template based on pulse event records, 
applied to empty (no pulses) noise records.

useage::

           HDF_Bfit [-h] [-ch CHANNEL] [-f FREQUENCY [FREQUENCY ...]] [-n NRECS]
                    [-sum] [--pdf] [--debug] [--threshold THRESHOLD] [--bsec BSEC]
                    [--bpo] [--absolute] [-ect] [--noise] [--brange BRANGE BRANGE]
                    [-nf NOISEFILE] [-np] [-fc FREQCUTOFF] [-pl PRLEN] [-rot]
                    [-ph PHASE]
                    dir

     Process baseline HDF5 records for optimal fitting

     positional arguments:
        dir                   Directory or file of x-ray data HDF5 file(s)

     optional arguments:
        -h, --help            show this help message and exit
        -ch CHANNEL, --channel CHANNEL
                              Channel number to use. Default is first available
                              channel.
        -f FREQUENCY [FREQUENCY ...], --frequency FREQUENCY [FREQUENCY ...]
                              Frequency numbers (pixels) to use. Default is first
                              available frequency. 'all' for all frequencies
        -n NRECS, --nrecs NRECS
                              Number of records to display. When single is not
                              selected, average of records is shown. Default is all
                              records
        -sum, --summary       Print summary of results to file
        --pdf                 Only pdf output
        --debug               show some debug info + plots on screen
        --threshold THRESHOLD, -t THRESHOLD
                              Amplitude threshold for event detection (default 2000)
        --bsec BSEC           Section (start+end) of record to use for background
                              (default 0.05)
        --bpo                 select only pretrigger section for baseline value
        --absolute            Use sqrt(I^2+Q^2) for pulse record
        -ect, --ectfilter     Perform filtering to exclude electric crosstalk
                              positive pulses
        --noise               Let the script ask for seperate noise file
        --brange BRANGE BRANGE
                              Range of baseline values to select. Default: no
                              selection
        -nf NOISEFILE, --noisefile NOISEFILE
                              Define seperate noise file(name)
        -np, --nopulseposition
                              do not select pulses based on pulse position
        -fc FREQCUTOFF, --freqcutoff FREQCUTOFF
                              Maximum frequency cutoff for optimal filtering
        -pl PRLEN, --prlen PRLEN
                              Length (power of 2) of record to process for optimal
                              filtering (default entire record)
        -rot, --rotate        Rotate events for minimum Q-signal (based on 100
                              events phase average)
        -ph PHASE, --phase PHASE
                              Rotate events with given fixed phase (degrees)

     Execution can be distributed over multiple CPU's, using 'mpiexec'


:download:`[source download] </../../scripts/HDF_Bfit>`