Logo ROOT  
Reference Guide
 
Loading...
Searching...
No Matches
TCandle Class Reference

The candle plot painter class.

Instances of this class are generated by the histograms painting classes (THistPainter and THStack) when an candle plot (box plot) is drawn. TCandle is the "painter class" of the box plots. Therefore it is never used directly to draw a candle.

Definition at line 26 of file TCandle.h.

Public Types

enum  CandleOption : long {
  kNoOption = 0 , kBox = 1 , kMedianLine = 10 , kMedianNotched = 20 ,
  kMedianCircle = 30 , kMeanLine = 100 , kMeanCircle = 300 , kWhiskerAll = 1000 ,
  kWhisker15 = 2000 , kAnchor = 10000 , kPointsOutliers = 100000 , kPointsAll = 200000 ,
  kPointsAllScat = 300000 , kHistoLeft = 1000000 , kHistoRight = 2000000 , kHistoViolin = 3000000 ,
  kHistoZeroIndicator = 10000000 , kHorizontal = 100000000
}
 

Public Member Functions

 TCandle ()
 TCandle default constructor.
 
 TCandle (const char *opt)
 TCandle constructor passing a draw-option.
 
 TCandle (const Double_t candlePos, const Double_t candleWidth, Long64_t n, Double_t *points)
 TCandle constructor for raw-data candles.
 
 TCandle (const Double_t candlePos, const Double_t candleWidth, TH1D *proj)
 TCandle TH1 data constructor.
 
 TCandle (const TCandle &candle)
 
virtual ~TCandle ()
 TCandle default destructor.
 
void ConvertToPadCoords (Double_t minAxis, Double_t maxAxis, Double_t axisMinCoord, Double_t axisMaxCoord)
 The coordinates in the TParallelCoordVar-class are in Pad-Coordinates, so we need to convert them.
 
const char * GetDrawOption ()
 
Double_t GetMean () const
 
Double_t GetMedian () const
 
long GetOption ()
 
Double_t GetQ1 () const
 
Double_t GetQ2 () const
 
Double_t GetQ3 () const
 
Bool_t IsCandleScaled ()
 
Bool_t IsHorizontal ()
 
bool IsOption (CandleOption opt)
 Return true is this option is activated in fOption.
 
Bool_t IsVertical ()
 
Bool_t IsViolinScaled ()
 
virtual void Paint (Option_t *option="")
 Paint one candle with its current attributes.
 
int ParseOption (char *optin)
 Parsing of the option-string.
 
void SetAxisPosition (const Double_t candlePos)
 
void SetCandleWidth (const Double_t width)
 
void SetHistogram (TH1D *proj)
 
void SetHistoWidth (const Double_t width)
 
void SetLog (int x, int y, int z)
 
virtual void SetMean (Double_t mean)
 
virtual void SetMedian (Double_t median)
 
void SetOption (CandleOption opt)
 
virtual void SetQ1 (Double_t q1)
 
virtual void SetQ2 (Double_t q2)
 
virtual void SetQ3 (Double_t q3)
 
- Public Member Functions inherited from TAttLine
 TAttLine ()
 AttLine default constructor.
 
 TAttLine (Color_t lcolor, Style_t lstyle, Width_t lwidth)
 AttLine normal constructor.
 
virtual ~TAttLine ()
 AttLine destructor.
 
void Copy (TAttLine &attline) const
 Copy this line attributes to a new TAttLine.
 
Int_t DistancetoLine (Int_t px, Int_t py, Double_t xp1, Double_t yp1, Double_t xp2, Double_t yp2)
 Compute distance from point px,py to a line.
 
virtual Color_t GetLineColor () const
 Return the line color.
 
virtual Style_t GetLineStyle () const
 Return the line style.
 
virtual Width_t GetLineWidth () const
 Return the line width.
 
virtual void Modify ()
 Change current line attributes if necessary.
 
virtual void ResetAttLine (Option_t *option="")
 Reset this line attributes to default values.
 
virtual void SaveLineAttributes (std::ostream &out, const char *name, Int_t coldef=1, Int_t stydef=1, Int_t widdef=1)
 Save line attributes as C++ statement(s) on output stream out.
 
virtual void SetLineAttributes ()
 Invoke the DialogCanvas Line attributes.
 
virtual void SetLineColor (Color_t lcolor)
 Set the line color.
 
virtual void SetLineColorAlpha (Color_t lcolor, Float_t lalpha)
 Set a transparent line color.
 
virtual void SetLineStyle (Style_t lstyle)
 Set the line style.
 
virtual void SetLineWidth (Width_t lwidth)
 Set the line width.
 
- Public Member Functions inherited from TAttFill
 TAttFill ()
 AttFill default constructor.
 
 TAttFill (Color_t fcolor, Style_t fstyle)
 AttFill normal constructor.
 
virtual ~TAttFill ()
 AttFill destructor.
 
void Copy (TAttFill &attfill) const
 Copy this fill attributes to a new TAttFill.
 
virtual Color_t GetFillColor () const
 Return the fill area color.
 
virtual Style_t GetFillStyle () const
 Return the fill area style.
 
virtual Bool_t IsTransparent () const
 
virtual void Modify ()
 Change current fill area attributes if necessary.
 
virtual void ResetAttFill (Option_t *option="")
 Reset this fill attributes to default values.
 
virtual void SaveFillAttributes (std::ostream &out, const char *name, Int_t coldef=1, Int_t stydef=1001)
 Save fill attributes as C++ statement(s) on output stream out.
 
virtual void SetFillAttributes ()
 Invoke the DialogCanvas Fill attributes.
 
virtual void SetFillColor (Color_t fcolor)
 Set the fill area color.
 
virtual void SetFillColorAlpha (Color_t fcolor, Float_t falpha)
 Set a transparent fill color.
 
virtual void SetFillStyle (Style_t fstyle)
 Set the fill area style.
 
- Public Member Functions inherited from TAttMarker
 TAttMarker ()
 TAttMarker default constructor.
 
 TAttMarker (Color_t color, Style_t style, Size_t msize)
 TAttMarker normal constructor.
 
virtual ~TAttMarker ()
 TAttMarker destructor.
 
void Copy (TAttMarker &attmarker) const
 Copy this marker attributes to a new TAttMarker.
 
virtual Color_t GetMarkerColor () const
 Return the marker color.
 
virtual Size_t GetMarkerSize () const
 Return the marker size.
 
virtual Style_t GetMarkerStyle () const
 Return the marker style.
 
virtual void Modify ()
 Change current marker attributes if necessary.
 
virtual void ResetAttMarker (Option_t *toption="")
 Reset this marker attributes to the default values.
 
virtual void SaveMarkerAttributes (std::ostream &out, const char *name, Int_t coldef=1, Int_t stydef=1, Int_t sizdef=1)
 Save line attributes as C++ statement(s) on output stream out.
 
virtual void SetMarkerAttributes ()
 Invoke the DialogCanvas Marker attributes.
 
virtual void SetMarkerColor (Color_t mcolor=1)
 Set the marker color.
 
virtual void SetMarkerColorAlpha (Color_t mcolor, Float_t malpha)
 Set a transparent marker color.
 
virtual void SetMarkerSize (Size_t msize=1)
 Set the marker size.
 
virtual void SetMarkerStyle (Style_t mstyle=1)
 Set the marker style.
 

Static Public Member Functions

static void SetBoxRange (const Double_t bRange)
 Static function to set fBoxRange, by setting whisker-range, one can force the box of the candle-chart to cover that given fraction of the distribution.
 
static void SetScaledCandle (const Bool_t cScale=true)
 Static function to set scaling between candles-withs.
 
static void SetScaledViolin (const Bool_t vScale=true)
 Static function to set scaling between violin-withs.
 
static void SetWhiskerRange (const Double_t wRange)
 Static function to set fWhiskerRange, by setting whisker-range, one can force the whiskers to cover the fraction of the distribution.
 
- Static Public Member Functions inherited from TAttMarker
static Width_t GetMarkerLineWidth (Style_t style)
 Internal helper function that returns the line width of the given marker style (0 = filled marker)
 
static Style_t GetMarkerStyleBase (Style_t style)
 Internal helper function that returns the corresponding marker style with line width 1 for the given style.
 

Protected Member Functions

void Calculate ()
 Calculates all values needed by the candle definition depending on the candle options.
 
int GetCandleOption (const int pos)
 
void PaintBox (Int_t nPoints, Double_t *x, Double_t *y, Bool_t swapXY)
 Paint a box for candle.
 
void PaintLine (Double_t x1, Double_t y1, Double_t x2, Double_t y2, Bool_t swapXY)
 Paint a line for candle.
 

Protected Attributes

Double_t fAxisMax
 The Maximum which is visible by the axis (used by zero indicator)
 
Double_t fAxisMin
 The Minimum which is visible by the axis (used by zero indicator)
 
Double_t fBoxDown
 Position of the lower box end.
 
Double_t fBoxUp
 Position of the upper box end.
 
Double_t fCandleWidth
 The candle width.
 
Double_tfDatapoints
 position of all Datapoints within this candle
 
bool fDismiss
 True if the candle cannot be painted.
 
Double_t fDrawPointsX [kNMAXPOINTS]
 x-coord for every outlier, ..
 
Double_t fDrawPointsY [kNMAXPOINTS]
 y-coord for every outlier, ..
 
Double_t fHistoPointsX [kNMAXPOINTS]
 x-coord for the polyline of the histo
 
Double_t fHistoPointsY [kNMAXPOINTS]
 y-coord for the polyline of the histo
 
Double_t fHistoWidth
 The histo width (the height of the max bin)
 
bool fIsCalculated
 
bool fIsRaw
 0: for TH1 projection, 1: using raw data
 
int fLogX
 make the candle appear logx-like
 
int fLogY
 make the candle appear logy-like
 
int fLogZ
 make the candle appear logz-like
 
Double_t fMean
 Position of the mean.
 
Double_t fMedian
 Position of the median.
 
Double_t fMedianErr
 The size of the notch.
 
Long64_t fNDatapoints
 Number of Datapoints within this candle.
 
Long64_t fNDrawPoints
 max number of outliers or other point to be shown
 
int fNHistoPoints
 
CandleOption fOption
 Setting the style of the candle.
 
char fOptionStr [128]
 String to draw the candle.
 
Double_t fPosCandleAxis
 x-pos for a vertical candle
 
TH1DfProj
 
Double_t fWhiskerDown
 Position of the lower whisker end.
 
Double_t fWhiskerUp
 Position of the upper whisker end.
 
- Protected Attributes inherited from TAttLine
Color_t fLineColor
 Line color.
 
Style_t fLineStyle
 Line style.
 
Width_t fLineWidth
 Line width.
 
- Protected Attributes inherited from TAttFill
Color_t fFillColor
 Fill area color.
 
Style_t fFillStyle
 Fill area style.
 
- Protected Attributes inherited from TAttMarker
Color_t fMarkerColor
 Marker color.
 
Size_t fMarkerSize
 Marker size.
 
Style_t fMarkerStyle
 Marker style.
 

Static Protected Attributes

static Double_t fBoxRange = 0.5
 The fraction which is covered by the box (0 < x < 1), default 0.5.
 
static Bool_t fScaledCandle = false
 shall the box-width be scaled to each other by the integral of a box?
 
static Bool_t fScaledViolin = true
 shall the violin or histos be scaled to each other by the maximum height?
 
static Double_t fWhiskerRange = 1.0
 The fraction which is covered by the whiskers (0 < x < 1), default 1.
 

#include <TCandle.h>

Inheritance diagram for TCandle:
[legend]

Member Enumeration Documentation

◆ CandleOption

Enumerator
kNoOption 
kBox 
kMedianLine 
kMedianNotched 
kMedianCircle 
kMeanLine 
kMeanCircle 
kWhiskerAll 
kWhisker15 
kAnchor 
kPointsOutliers 
kPointsAll 
kPointsAllScat 
kHistoLeft 
kHistoRight 
kHistoViolin 
kHistoZeroIndicator 
kHorizontal 

If this bit is not set it is vertical.

Definition at line 29 of file TCandle.h.

Constructor & Destructor Documentation

◆ TCandle() [1/5]

TCandle::TCandle ( )

TCandle default constructor.

Definition at line 42 of file TCandle.cxx.

◆ TCandle() [2/5]

TCandle::TCandle ( const char *  opt)

TCandle constructor passing a draw-option.

Definition at line 74 of file TCandle.cxx.

◆ TCandle() [3/5]

TCandle::TCandle ( const Double_t  candlePos,
const Double_t  candleWidth,
Long64_t  n,
Double_t points 
)

TCandle constructor for raw-data candles.

Definition at line 114 of file TCandle.cxx.

◆ TCandle() [4/5]

TCandle::TCandle ( const Double_t  candlePos,
const Double_t  candleWidth,
TH1D proj 
)

TCandle TH1 data constructor.

Definition at line 148 of file TCandle.cxx.

◆ TCandle() [5/5]

TCandle::TCandle ( const TCandle candle)

◆ ~TCandle()

TCandle::~TCandle ( )
virtual

TCandle default destructor.

Definition at line 182 of file TCandle.cxx.

Member Function Documentation

◆ Calculate()

void TCandle::Calculate ( )
protected

Calculates all values needed by the candle definition depending on the candle options.

Definition at line 380 of file TCandle.cxx.

◆ ConvertToPadCoords()

void TCandle::ConvertToPadCoords ( Double_t  minAxis,
Double_t  maxAxis,
Double_t  axisMinCoord,
Double_t  axisMaxCoord 
)

The coordinates in the TParallelCoordVar-class are in Pad-Coordinates, so we need to convert them.

Definition at line 928 of file TCandle.cxx.

◆ GetCandleOption()

int TCandle::GetCandleOption ( const int  pos)
inlineprotected

Definition at line 98 of file TCandle.h.

◆ GetDrawOption()

const char * TCandle::GetDrawOption ( )
inline

Definition at line 140 of file TCandle.h.

◆ GetMean()

Double_t TCandle::GetMean ( ) const
inline

Definition at line 112 of file TCandle.h.

◆ GetMedian()

Double_t TCandle::GetMedian ( ) const
inline

Definition at line 113 of file TCandle.h.

◆ GetOption()

long TCandle::GetOption ( )
inline

Definition at line 141 of file TCandle.h.

◆ GetQ1()

Double_t TCandle::GetQ1 ( ) const
inline

Definition at line 114 of file TCandle.h.

◆ GetQ2()

Double_t TCandle::GetQ2 ( ) const
inline

Definition at line 115 of file TCandle.h.

◆ GetQ3()

Double_t TCandle::GetQ3 ( ) const
inline

Definition at line 116 of file TCandle.h.

◆ IsCandleScaled()

Bool_t TCandle::IsCandleScaled ( )

Definition at line 186 of file TCandle.cxx.

◆ IsHorizontal()

Bool_t TCandle::IsHorizontal ( )
inline

Definition at line 117 of file TCandle.h.

◆ IsOption()

bool TCandle::IsOption ( CandleOption  opt)

Return true is this option is activated in fOption.

Definition at line 845 of file TCandle.cxx.

◆ IsVertical()

Bool_t TCandle::IsVertical ( )
inline

Definition at line 118 of file TCandle.h.

◆ IsViolinScaled()

Bool_t TCandle::IsViolinScaled ( )

Definition at line 191 of file TCandle.cxx.

◆ Paint()

void TCandle::Paint ( Option_t option = "")
virtual

Paint one candle with its current attributes.

Definition at line 670 of file TCandle.cxx.

◆ PaintBox()

void TCandle::PaintBox ( Int_t  nPoints,
Double_t x,
Double_t y,
Bool_t  swapXY 
)
protected

Paint a box for candle.

Definition at line 861 of file TCandle.cxx.

◆ PaintLine()

void TCandle::PaintLine ( Double_t  x1,
Double_t  y1,
Double_t  x2,
Double_t  y2,
Bool_t  swapXY 
)
protected

Paint a line for candle.

Definition at line 889 of file TCandle.cxx.

◆ ParseOption()

int TCandle::ParseOption ( char *  opt)

Parsing of the option-string.

The option-string will be empty at the end (by-reference).

Definition at line 245 of file TCandle.cxx.

◆ SetAxisPosition()

void TCandle::SetAxisPosition ( const Double_t  candlePos)
inline

Definition at line 124 of file TCandle.h.

◆ SetBoxRange()

void TCandle::SetBoxRange ( const Double_t  bRange)
static

Static function to set fBoxRange, by setting whisker-range, one can force the box of the candle-chart to cover that given fraction of the distribution.

Set bRange between 0 and 1. Default is 0.5 TCandle::SetBoxRange(0.68) will set all candle-charts to cover 68% of the distribution by the box

Definition at line 218 of file TCandle.cxx.

◆ SetCandleWidth()

void TCandle::SetCandleWidth ( const Double_t  width)
inline

Definition at line 126 of file TCandle.h.

◆ SetHistogram()

void TCandle::SetHistogram ( TH1D proj)
inline

Definition at line 128 of file TCandle.h.

◆ SetHistoWidth()

void TCandle::SetHistoWidth ( const Double_t  width)
inline

Definition at line 127 of file TCandle.h.

◆ SetLog()

void TCandle::SetLog ( int  x,
int  y,
int  z 
)
inline

Definition at line 123 of file TCandle.h.

◆ SetMean()

virtual void TCandle::SetMean ( Double_t  mean)
inlinevirtual

Definition at line 133 of file TCandle.h.

◆ SetMedian()

virtual void TCandle::SetMedian ( Double_t  median)
inlinevirtual

Definition at line 134 of file TCandle.h.

◆ SetOption()

void TCandle::SetOption ( CandleOption  opt)
inline

Definition at line 122 of file TCandle.h.

◆ SetQ1()

virtual void TCandle::SetQ1 ( Double_t  q1)
inlinevirtual

Definition at line 135 of file TCandle.h.

◆ SetQ2()

virtual void TCandle::SetQ2 ( Double_t  q2)
inlinevirtual

Definition at line 136 of file TCandle.h.

◆ SetQ3()

virtual void TCandle::SetQ3 ( Double_t  q3)
inlinevirtual

Definition at line 137 of file TCandle.h.

◆ SetScaledCandle()

void TCandle::SetScaledCandle ( const Bool_t  cScale = true)
static

Static function to set scaling between candles-withs.

A candle containing 100 entries with be two times wider than a candle containing 50 entries

Definition at line 228 of file TCandle.cxx.

◆ SetScaledViolin()

void TCandle::SetScaledViolin ( const Bool_t  vScale = true)
static

Static function to set scaling between violin-withs.

A violin or histo chart with a maximum bin content to 100 will be two times as high as a violin with a maximum bin content of 50

Definition at line 237 of file TCandle.cxx.

◆ SetWhiskerRange()

void TCandle::SetWhiskerRange ( const Double_t  wRange)
static

Static function to set fWhiskerRange, by setting whisker-range, one can force the whiskers to cover the fraction of the distribution.

Set wRange between 0 and 1. Default is 1 TCandle::SetWhiskerRange(0.95) will set all candle-charts to cover 95% of the distribution with the whiskers. Can only be used with the standard-whisker definition

Definition at line 204 of file TCandle.cxx.

Member Data Documentation

◆ fAxisMax

Double_t TCandle::fAxisMax
protected

The Maximum which is visible by the axis (used by zero indicator)

Definition at line 88 of file TCandle.h.

◆ fAxisMin

Double_t TCandle::fAxisMin
protected

The Minimum which is visible by the axis (used by zero indicator)

Definition at line 87 of file TCandle.h.

◆ fBoxDown

Double_t TCandle::fBoxDown
protected

Position of the lower box end.

Definition at line 66 of file TCandle.h.

◆ fBoxRange

Double_t TCandle::fBoxRange = 0.5
staticprotected

The fraction which is covered by the box (0 < x < 1), default 0.5.

Definition at line 91 of file TCandle.h.

◆ fBoxUp

Double_t TCandle::fBoxUp
protected

Position of the upper box end.

Definition at line 65 of file TCandle.h.

◆ fCandleWidth

Double_t TCandle::fCandleWidth
protected

The candle width.

Definition at line 59 of file TCandle.h.

◆ fDatapoints

Double_t* TCandle::fDatapoints
protected

position of all Datapoints within this candle

Definition at line 70 of file TCandle.h.

◆ fDismiss

bool TCandle::fDismiss
protected

True if the candle cannot be painted.

Definition at line 56 of file TCandle.h.

◆ fDrawPointsX

Double_t TCandle::fDrawPointsX[kNMAXPOINTS]
protected

x-coord for every outlier, ..

Definition at line 73 of file TCandle.h.

◆ fDrawPointsY

Double_t TCandle::fDrawPointsY[kNMAXPOINTS]
protected

y-coord for every outlier, ..

Definition at line 74 of file TCandle.h.

◆ fHistoPointsX

Double_t TCandle::fHistoPointsX[kNMAXPOINTS]
protected

x-coord for the polyline of the histo

Definition at line 77 of file TCandle.h.

◆ fHistoPointsY

Double_t TCandle::fHistoPointsY[kNMAXPOINTS]
protected

y-coord for the polyline of the histo

Definition at line 78 of file TCandle.h.

◆ fHistoWidth

Double_t TCandle::fHistoWidth
protected

The histo width (the height of the max bin)

Definition at line 60 of file TCandle.h.

◆ fIsCalculated

bool TCandle::fIsCalculated
protected

Definition at line 54 of file TCandle.h.

◆ fIsRaw

bool TCandle::fIsRaw
protected

0: for TH1 projection, 1: using raw data

Definition at line 53 of file TCandle.h.

◆ fLogX

int TCandle::fLogX
protected

make the candle appear logx-like

Definition at line 83 of file TCandle.h.

◆ fLogY

int TCandle::fLogY
protected

make the candle appear logy-like

Definition at line 84 of file TCandle.h.

◆ fLogZ

int TCandle::fLogZ
protected

make the candle appear logz-like

Definition at line 85 of file TCandle.h.

◆ fMean

Double_t TCandle::fMean
protected

Position of the mean.

Definition at line 62 of file TCandle.h.

◆ fMedian

Double_t TCandle::fMedian
protected

Position of the median.

Definition at line 63 of file TCandle.h.

◆ fMedianErr

Double_t TCandle::fMedianErr
protected

The size of the notch.

Definition at line 64 of file TCandle.h.

◆ fNDatapoints

Long64_t TCandle::fNDatapoints
protected

Number of Datapoints within this candle.

Definition at line 71 of file TCandle.h.

◆ fNDrawPoints

Long64_t TCandle::fNDrawPoints
protected

max number of outliers or other point to be shown

Definition at line 75 of file TCandle.h.

◆ fNHistoPoints

int TCandle::fNHistoPoints
protected

Definition at line 79 of file TCandle.h.

◆ fOption

CandleOption TCandle::fOption
protected

Setting the style of the candle.

Definition at line 81 of file TCandle.h.

◆ fOptionStr

char TCandle::fOptionStr[128]
protected

String to draw the candle.

Definition at line 82 of file TCandle.h.

◆ fPosCandleAxis

Double_t TCandle::fPosCandleAxis
protected

x-pos for a vertical candle

Definition at line 58 of file TCandle.h.

◆ fProj

TH1D* TCandle::fProj
protected

Definition at line 55 of file TCandle.h.

◆ fScaledCandle

Bool_t TCandle::fScaledCandle = false
staticprotected

shall the box-width be scaled to each other by the integral of a box?

Definition at line 93 of file TCandle.h.

◆ fScaledViolin

Bool_t TCandle::fScaledViolin = true
staticprotected

shall the violin or histos be scaled to each other by the maximum height?

Definition at line 94 of file TCandle.h.

◆ fWhiskerDown

Double_t TCandle::fWhiskerDown
protected

Position of the lower whisker end.

Definition at line 68 of file TCandle.h.

◆ fWhiskerRange

Double_t TCandle::fWhiskerRange = 1.0
staticprotected

The fraction which is covered by the whiskers (0 < x < 1), default 1.

Definition at line 90 of file TCandle.h.

◆ fWhiskerUp

Double_t TCandle::fWhiskerUp
protected

Position of the upper whisker end.

Definition at line 67 of file TCandle.h.

Libraries for TCandle:

The documentation for this class was generated from the following files: