This module provides mechanism relative to stats calculation within a
PlotWidget
.
It also include the implementation of the statistics themselves.
-
class Stats(statslist=None)[source]
Class to define a set of statistic relative to a dataset
(image, curve…).
The goal of this class is to avoid multiple recalculation of some
basic operations such as filtering data area where the statistics has to
be apply.
Min and max are also stored because they can be used several time.
- Parameters
statslist (List) – List of the Stat
object to be computed.
-
calculate(item, plot, onlimits, roi, data_changed=False, roi_changed=False)[source]
Call all Stat
object registered and return the result of the
computation.
- Parameters
item – the item for which we want statistics
plot – plot containing the item
onlimits (bool) – True if we want to apply statistic only on
visible data.
roi (Union[None, _RegionOfInterestBase
]) – region of interest for statistic calculation. Incompatible
with the onlimits option.
data_changed (bool) – did the data changed since last calculation.
roi_changed (bool) – did the associated roi (if any) has changed
since last calculation.
- Return dict
dictionary with Stat
name as ket and result
of the calculation as value
-
add(stat)[source]
Add a Stat
to the set
- Parameters
stat (Stat) – stat to add to the set
-
class StatBase(name, compatibleKinds=('curve', 'image', 'scatter', 'histogram'), description=None)[source]
Base class for defining a statistic.
- Parameters
name (str) – the name of the statistic. Must be unique.
compatibleKinds (List[str]) – The kind of items (curve, scatter…) for which the statistic apply.
-
calculate(context)[source]
compute the statistic for the given StatsContext
- Parameters
context (_StatsContext) –
- Return dict
key is stat name, statistic computed is the dict value
-
getToolTip(kind)[source]
If necessary add a tooltip for a stat kind
- Parameters
kind (str) – the kind of item the statistic is compute for.
- Returns
tooltip or None if no tooltip
-
class Stat(name, fct, kinds=('curve', 'image', 'scatter', 'histogram'))[source]
Create a StatBase class based on a function pointer.
- Parameters
name (str) – name of the statistic. Used as id
fct – function which should have as unique mandatory parameter the
data. Should be able to adapt to all kinds defined as
compatible
kinds (tuple) – the compatible item kinds of the function (curve,
image…)
-
calculate(context)[source]
compute the statistic for the given StatsContext
- Parameters
context (_StatsContext) –
- Return dict
key is stat name, statistic computed is the dict value
-
class StatMin[source]
Compute the minimal value on data
-
calculate(context)[source]
compute the statistic for the given StatsContext
- Parameters
context (_StatsContext) –
- Return dict
key is stat name, statistic computed is the dict value
-
class StatMax[source]
Compute the maximal value on data
-
calculate(context)[source]
compute the statistic for the given StatsContext
- Parameters
context (_StatsContext) –
- Return dict
key is stat name, statistic computed is the dict value
-
class StatDelta[source]
Compute the delta between minimal and maximal on data
-
calculate(context)[source]
compute the statistic for the given StatsContext
- Parameters
context (_StatsContext) –
- Return dict
key is stat name, statistic computed is the dict value
-
class StatCoordMin[source]
Compute the coordinates of the first minimum value of the data
-
calculate(context)[source]
compute the statistic for the given StatsContext
- Parameters
context (_StatsContext) –
- Return dict
key is stat name, statistic computed is the dict value
-
getToolTip(kind)[source]
If necessary add a tooltip for a stat kind
- Parameters
kind (str) – the kind of item the statistic is compute for.
- Returns
tooltip or None if no tooltip
-
class StatCoordMax[source]
Compute the coordinates of the first maximum value of the data
-
calculate(context)[source]
compute the statistic for the given StatsContext
- Parameters
context (_StatsContext) –
- Return dict
key is stat name, statistic computed is the dict value
-
getToolTip(kind)[source]
If necessary add a tooltip for a stat kind
- Parameters
kind (str) – the kind of item the statistic is compute for.
- Returns
tooltip or None if no tooltip
-
class StatCOM[source]
Compute data center of mass
-
calculate(context)[source]
compute the statistic for the given StatsContext
- Parameters
context (_StatsContext) –
- Return dict
key is stat name, statistic computed is the dict value
-
getToolTip(kind)[source]
If necessary add a tooltip for a stat kind
- Parameters
kind (str) – the kind of item the statistic is compute for.
- Returns
tooltip or None if no tooltip