Jpp  19.0.0
the software that should make you happy
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
Public Member Functions | Protected Attributes | Private Attributes | List of all members
JCOMPAREHISTOGRAMS::JTestSignificance Class Reference

Significance test. More...

#include <JTestSignificance.hh>

Inheritance diagram for JCOMPAREHISTOGRAMS::JTestSignificance:
JCOMPAREHISTOGRAMS::JTest_t std::vector< JTestResult >

Public Member Functions

 JTestSignificance ()
 Default constructor. More...
 
void test (const TObject *o1, const TObject *o2) override
 Applies Significance test for two ROOT TH1 histograms. More...
 
std::istream & read (std::istream &in) override
 Read test parameters from input. More...
 
virtual std::ostream & write (std::ostream &out, const char delimiter= ' ', const bool onlyFailures=false) const
 Write test result to output. More...
 
virtual void save (TFile *f, const std::string &path, const bool onlyFailures=false) const
 Writes the test result to root file. More...
 
const std::string & getTestName () const
 Get test name. More...
 
const std::string & getResultType () const
 Get result type. More...
 

Protected Attributes

const std::string testName
 test name More...
 
const std::string resultType
 test result type More...
 

Private Attributes

double threshold
 threshold p-value to decide if test is passed. More...
 
double K
 normalization factor between histograms. More...
 

Detailed Description

Significance test.

Compares two histograms $ H_a $ and $ H_b $ by calculating the average bin significance

\[ S = \frac{1}{N} \cdot \sum_{i=0}^{N} \frac{|a_i - K \cdot b_i|}{\sqrt{\sigma ^2(a_i) + K^2 \cdot \sigma ^2(b_i)}} \]

where:

A threshold value for $ S $ is used to tag the test as passed or failed.

Definition at line 42 of file JTestSignificance.hh.

Constructor & Destructor Documentation

JCOMPAREHISTOGRAMS::JTestSignificance::JTestSignificance ( )
inline

Default constructor.

Definition at line 50 of file JTestSignificance.hh.

50  :
51  JTest_t("Significance", "Significance")
52  {}
JCOMPAREHISTOGRAMS::JTest_t::JTest_t
JTest_t(const std::string &testName, const std::string &resultType)
Constructor.
Definition: JTest_t.hh:51

Member Function Documentation

void JCOMPAREHISTOGRAMS::JTestSignificance::test ( const TObject *  o1,
const TObject *  o2 
)
inlineoverridevirtual

Applies Significance test for two ROOT TH1 histograms.

Parameters
o1First histogram
o2Second histogram

Implements JCOMPAREHISTOGRAMS::JTest_t.

Definition at line 61 of file JTestSignificance.hh.

62  {
63  using namespace std;
64  using namespace JPP;
65 
66  const TH1* h1 = dynamic_cast<const TH1*>(o1);
67  const TH1* h2 = dynamic_cast<const TH1*>(o2);
68 
69  if (h1 == NULL || h2 == NULL) {
70  THROW(JValueOutOfRange, "JTestSignificance::test(): Could not cast given TObjects to TH1.");
71  }
72 
73  if(h1->GetNbinsX() != h2->GetNbinsX() ||
74  h1->GetNbinsY() != h2->GetNbinsY() ||
75  h1->GetNbinsZ() != h2->GetNbinsZ()) {
76  THROW(JValueOutOfRange, "JTestSignificance::test(): Histograms with different bining. The objects: " <<
77  h1->GetName() << " and " << h2->GetName() << " can not be compared." << endl);
78  }
79 
80  if (K < 0) {
81  K = h2->GetEntries() / h1->GetEntries();
82  }
83 
84  TH1* h3 = (TH1*) h1->Clone(h1->GetName() == h2->GetName() ?
85  MAKE_CSTRING(h1->GetName() << "_" << testName) :
86  MAKE_CSTRING(h1->GetName() << "_VS_" << h2->GetName() << "_" << testName));
87 
88  h3->Add(h2,-1*K);
89 
90  double S = 0;
91 
92  for (int i=1 ; i <= h1->GetNbinsX() ; ++i){
93  for (int j=1 ; j <= h1->GetNbinsY() ; ++j){
94  for (int k=1 ; k <= h1->GetNbinsZ() ; ++k){
95 
96  const double a = h1->GetBinContent(i,j,k);
97  const double b = h2->GetBinContent(i,j,k);
98 
99  if (a!=0 || b!=0) {
100  S += fabs((a - K*b)/sqrt(a + K*K*b));
101  }
102  }
103  }
104  }
105 
106  S /= (h1->GetNbinsX()*h1->GetNbinsY()*h1->GetNbinsZ());
107 
108  const bool passed = (S > threshold);
109 
110  const JResultTitle title(testName, resultType, passed, S);
111 
112  h3->SetTitle(title.getTitle().c_str());
113 
114  const int Ndims = h3->GetDimension();
115 
116  if (Ndims == 1) {
117  h3->GetYaxis()->SetTitle(resultType.c_str());
118  } else if (Ndims == 2) {
119  h3->GetZaxis()->SetTitle(resultType.c_str());
120  }
121 
122  const JTestResult r(testName,
123  JRootObjectID(MAKE_STRING(h1->GetDirectory()->GetPath() << h1->GetName())),
124  JRootObjectID(MAKE_STRING(h2->GetDirectory()->GetPath() << h1->GetName())),
125  resultType, S, threshold, h3, passed);
126 
127  this->push_back(r);
128  }
k
then fatal No hydrophone data file $HYDROPHONE_TXT fi sort gr k
Definition: hydrophone-phi:fit.sh:35
JCOMPAREHISTOGRAMS::JResultTitle
Class dedicated to standardize the title of the graphical objects produced by the JTest_t() derived c...
Definition: JResultTitle.hh:25
THROW
#define THROW(JException_t, A)
Marco for throwing exception with std::ostream compatible message.
Definition: JException.hh:712
MAKE_CSTRING
#define MAKE_CSTRING(A)
Make C-string.
Definition: JPrint.hh:136
JTOOLS::r
data_type r[M+1]
Definition: JPolint.hh:868
JCOMPAREHISTOGRAMS::JTestSignificance::K
double K
normalization factor between histograms.
Definition: JTestSignificance.hh:153
MAKE_STRING
#define MAKE_STRING(A)
Make string.
Definition: JPrint.hh:127
a
then JCalibrateToT a
Definition: JTuneHV.sh:107
JCOMPAREHISTOGRAMS::JTest_t::resultType
const std::string resultType
test result type
Definition: JTest_t.hh:181
JCOMPAREHISTOGRAMS::JTest_t::testName
const std::string testName
test name
Definition: JTest_t.hh:180
JCOMPAREHISTOGRAMS::JTestSignificance::threshold
double threshold
threshold p-value to decide if test is passed.
Definition: JTestSignificance.hh:152
JCOMPAREHISTOGRAMS::JTestResult
Structure containing the result of the test.
Definition: JTestResult.hh:28
JTOOLS::j
int j
Definition: JPolint.hh:792
std::istream& JCOMPAREHISTOGRAMS::JTestSignificance::read ( std::istream &  in)
inlineoverridevirtual

Read test parameters from input.

Parameters
ininput stream
Returns
input stream

Implements JCOMPAREHISTOGRAMS::JTest_t.

Definition at line 137 of file JTestSignificance.hh.

138  {
139  using namespace JPP;
140 
141  in >> threshold >> K;
142 
143  if (threshold < 0.0) {
144  THROW(JValueOutOfRange, "JTestSignificance::read(): Invalid threshold value " << threshold);
145  }
146 
147  return in;
148  }
THROW
#define THROW(JException_t, A)
Marco for throwing exception with std::ostream compatible message.
Definition: JException.hh:712
JCOMPAREHISTOGRAMS::JTestSignificance::K
double K
normalization factor between histograms.
Definition: JTestSignificance.hh:153
JCOMPAREHISTOGRAMS::JTestSignificance::threshold
double threshold
threshold p-value to decide if test is passed.
Definition: JTestSignificance.hh:152
in
then fatal The output file must have the wildcard in the e g root fi eval JPrintDetector a $DETECTOR O IDENTIFIER eval JPrintDetector a $DETECTOR O SUMMARY JAcoustics sh $DETECTOR_ID source JAcousticsToolkit sh CHECK_EXIT_CODE typeset A EMITTERS get_tripods $WORKDIR tripod txt EMITTERS get_transmitters $WORKDIR transmitter txt EMITTERS for EMITTER in
Definition: JCanberra.sh:48
virtual std::ostream& JCOMPAREHISTOGRAMS::JTest_t::write ( std::ostream &  out,
const char  delimiter = ' ',
const bool  onlyFailures = false 
) const
inlinevirtualinherited

Write test result to output.

Parameters
outoutput stream
delimiterfield delimiter
onlyFailuresif true, write only failures.
Returns
output stream

Definition at line 84 of file JTest_t.hh.

87  {
88  using namespace std;
89  using namespace JPP;
90 
91  for (vector<JTestResult>::const_iterator r = this->begin() ; r != this->end() ; ++r) {
92 
93  if (onlyFailures && r->passed) { continue; }
94 
95  print(out, *r, delimiter, true);
96  }
97 
98  return out;
99  }
JCOMPAREHISTOGRAMS::print
std::ostream & print(std::ostream &out, const JTestSummary &summary, const char delimiter= ' ', const bool useColors=true)
Print test summary.
Definition: JTestSummary.hh:255
JTOOLS::r
data_type r[M+1]
Definition: JPolint.hh:868
virtual void JCOMPAREHISTOGRAMS::JTest_t::save ( TFile *  f,
const std::string &  path,
const bool  onlyFailures = false 
) const
inlinevirtualinherited

Writes the test result to root file.

Parameters
fA ROOT file
pathPath in root file.
onlyFailuresIf true, write only failures.

Definition at line 108 of file JTest_t.hh.

111  {
112  using namespace std;
113  using namespace JPP;
114 
115  if (f->GetDirectory(path.c_str())==0) {
116  f->mkdir(path.c_str());
117  }
118 
119  f->cd(path.c_str());
120 
121  for (vector<JTestResult>::const_iterator r = this->begin() ; r != this->end() ; ++r) {
122 
123  if (onlyFailures && r->passed) { continue; }
124 
125  r->obj->Write();
126  }
127  }
JTOOLS::r
data_type r[M+1]
Definition: JPolint.hh:868
path
$WORKDIR driver txt done cat $WORKDIR driver txt<< EOFprocess ${DATAFILTER}$FILTER_HOST csh-c '(setenv ROOTSYS $ROOTSYS &&source $JPP_DIR/setenv.csh $JPP_DIR &&(JDataFilter-H\$SERVER\$-M\$LOGGER\$-d $DEBUG-u ${DATAFILTER}-P $PORT</dev/null > &/dev/null &))';process ${DATAWRITER}$WRITER_HOST csh-c '(setenv ROOTSYS $ROOTSYS &&source $JPP_DIR/setenv.csh $JPP_DIR &&(JDataWriter-H\$SERVER\$-M\$LOGGER\$-d $DEBUG-u ${DATAWRITER}</dev/null > &/dev/null &))';print enterevent ev_init{RC_CMD}event ev_reset{RC_CMD}event ev_init{RC_CMD}event ev_configure{RC_DFLTR%<$WORKDIR/ev_configure_datafilter.txt > RC_DQSIM<$WORKDIR/ev_configure_dqsimulator.txt > RC_DWRT path
Definition: software/JDataFilter/JDataFilter.sh:199
f
then JHobbit a $DETECTOR f
Definition: software/JCalibrate/JHobbit.sh:42
const std::string& JCOMPAREHISTOGRAMS::JTest_t::getTestName ( ) const
inlineinherited

Get test name.

Returns
test name

Definition at line 135 of file JTest_t.hh.

136  {
137  return testName;
138  }
JCOMPAREHISTOGRAMS::JTest_t::testName
const std::string testName
test name
Definition: JTest_t.hh:180
const std::string& JCOMPAREHISTOGRAMS::JTest_t::getResultType ( ) const
inlineinherited

Get result type.

Returns
result type

Definition at line 146 of file JTest_t.hh.

147  {
148  return resultType;
149  }
JCOMPAREHISTOGRAMS::JTest_t::resultType
const std::string resultType
test result type
Definition: JTest_t.hh:181

Member Data Documentation

double JCOMPAREHISTOGRAMS::JTestSignificance::threshold
private

threshold p-value to decide if test is passed.

Definition at line 152 of file JTestSignificance.hh.

double JCOMPAREHISTOGRAMS::JTestSignificance::K
private

normalization factor between histograms.

Definition at line 153 of file JTestSignificance.hh.

const std::string JCOMPAREHISTOGRAMS::JTest_t::testName
protectedinherited

test name

Definition at line 180 of file JTest_t.hh.

const std::string JCOMPAREHISTOGRAMS::JTest_t::resultType
protectedinherited

test result type

Definition at line 181 of file JTest_t.hh.

The documentation for this class was generated from the following file:
Generated by   doxygen 1.8.5