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.
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) | |
~TCandle () override | |
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 () const |
Double_t | GetMean () const |
Double_t | GetMedian () const |
long | GetOption () const |
Double_t | GetQ1 () const |
Double_t | GetQ2 () const |
Double_t | GetQ3 () const |
TClass * | IsA () const override |
Bool_t | IsCandleScaled () const |
Returns true if candle plot should be scaled. | |
Bool_t | IsHorizontal () const |
bool | IsOption (CandleOption opt) const |
Return true is this option is activated in fOption. | |
Bool_t | IsVertical () const |
Bool_t | IsViolinScaled () const |
Returns true if violin plot should be scaled. | |
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) |
void | Streamer (TBuffer &) override |
Stream an object of class TCandle. | |
void | StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b) |
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. | |
void | StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b) |
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. | |
void | StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b) |
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. | |
void | StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b) |
Static Public Member Functions | |
static TClass * | Class () |
static const char * | Class_Name () |
static constexpr Version_t | Class_Version () |
static const char * | DeclFileName () |
static void | SetBoxRange (const Double_t bRange) |
Static function to set BoxRange, by setting box-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 WhiskerRange, by setting whisker-range, one can force the whiskers to cover the fraction of the distribution. | |
Static Public Member Functions inherited from TAttLine | |
static TClass * | Class () |
static const char * | Class_Name () |
static constexpr Version_t | Class_Version () |
static const char * | DeclFileName () |
Static Public Member Functions inherited from TAttFill | |
static TClass * | Class () |
static const char * | Class_Name () |
static constexpr Version_t | Class_Version () |
static const char * | DeclFileName () |
Static Public Member Functions inherited from TAttMarker | |
static TClass * | Class () |
static const char * | Class_Name () |
static constexpr Version_t | Class_Version () |
static const char * | DeclFileName () |
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) const |
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_t * | fDatapoints {nullptr} |
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. | |
TString | fOptionStr |
String to draw the candle. | |
Double_t | fPosCandleAxis |
x-pos for a vertical candle | |
TH1D * | fProj {nullptr} |
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. | |
#include <TCandle.h>
enum TCandle::CandleOption : long |
TCandle::TCandle | ( | ) |
TCandle default constructor.
Definition at line 38 of file TCandle.cxx.
TCandle::TCandle | ( | const char * | opt | ) |
TCandle constructor passing a draw-option.
Definition at line 70 of file TCandle.cxx.
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 109 of file TCandle.cxx.
Definition at line 142 of file TCandle.cxx.
TCandle::TCandle | ( | const TCandle & | candle | ) |
|
override |
TCandle default destructor.
Definition at line 175 of file TCandle.cxx.
|
protected |
Calculates all values needed by the candle definition depending on the candle options.
Definition at line 379 of file TCandle.cxx.
|
static |
|
inlinestaticconstexpr |
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 930 of file TCandle.cxx.
|
inlinestatic |
|
inlineoverridevirtual |
Bool_t TCandle::IsCandleScaled | ( | ) | const |
Returns true if candle plot should be scaled.
Definition at line 183 of file TCandle.cxx.
bool TCandle::IsOption | ( | CandleOption | opt | ) | const |
Return true is this option is activated in fOption.
Definition at line 843 of file TCandle.cxx.
Bool_t TCandle::IsViolinScaled | ( | ) | const |
Returns true if violin plot should be scaled.
Definition at line 191 of file TCandle.cxx.
|
virtual |
Paint one candle with its current attributes.
Definition at line 666 of file TCandle.cxx.
Paint a box for candle.
Definition at line 859 of file TCandle.cxx.
|
protected |
Paint a line for candle.
Definition at line 889 of file TCandle.cxx.
int TCandle::ParseOption | ( | char * | opt | ) |
Parsing of the option-string.
The option-string will be empty at the end (by-reference).
Definition at line 244 of file TCandle.cxx.
|
inline |
|
static |
Static function to set BoxRange, by setting box-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 216 of file TCandle.cxx.
|
inline |
|
inline |
|
inlinevirtual |
|
inlinevirtual |
|
inline |
|
static |
Static function to set scaling between candles-withs.
A candle containing 100 entries will be two times wider than a candle containing 50 entries
Definition at line 225 of file TCandle.cxx.
|
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 235 of file TCandle.cxx.
|
static |
Static function to set WhiskerRange, 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.
|
overridevirtual |
Stream an object of class TCandle.
Reimplemented from TAttLine.
Definition at line 913 of file TCandle.cxx.
|
inline |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |