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. | |
| void | Copy (TAttFill &attfill) const |
| void | Copy (TAttLine &attline) const |
| void | Copy (TAttMarker &attmarker) const |
| Int_t | DistancetoLine (Int_t px, Int_t py, Double_t xp1, Double_t yp1, Double_t xp2, Double_t yp2) |
| const char * | GetDrawOption () const |
| virtual Color_t | GetFillColor () const |
| Return the fill area color. | |
| virtual Style_t | GetFillStyle () const |
| Return the fill area style. | |
| 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 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. | |
| 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. | |
| virtual Bool_t | IsTransparent () const |
| Bool_t | IsVertical () const |
| Bool_t | IsViolinScaled () const |
| Returns true if violin plot should be scaled. | |
| virtual void | Modify () |
| virtual void | Modify () |
| virtual void | Modify () |
| virtual void | ModifyOn (TVirtualPad &pad) |
| virtual void | ModifyOn (TVirtualPad &pad) |
| virtual void | ModifyOn (TVirtualPad &pad) |
| virtual void | Paint (Option_t *option="") |
| Paint one candle with its current attributes. | |
| int | ParseOption (char *optin) |
| Parsing of the option-string. | |
| virtual void | ResetAttFill (Option_t *option="") |
| virtual void | ResetAttLine (Option_t *option="") |
| virtual void | ResetAttMarker (Option_t *toption="") |
| virtual void | SaveFillAttributes (std::ostream &out, const char *name, Int_t coldef=1, Int_t stydef=1001) |
| virtual void | SaveLineAttributes (std::ostream &out, const char *name, Int_t coldef=1, Int_t stydef=1, Int_t widdef=1) |
| virtual void | SaveMarkerAttributes (std::ostream &out, const char *name, Int_t coldef=1, Int_t stydef=1, Int_t sizdef=1) |
| void | SetAxisPosition (const Double_t candlePos) |
| void | SetCandleWidth (const Double_t width) |
| virtual void | SetFillAttributes () |
| virtual void | SetFillColor (Color_t fcolor) |
| Set the fill area color. | |
| void | SetFillColor (TColorNumber) |
| virtual void | SetFillColorAlpha (Color_t fcolor, Float_t falpha) |
| virtual void | SetFillStyle (Style_t fstyle) |
| Set the fill area style. | |
| void | SetHistogram (TH1D *proj) |
| void | SetHistoWidth (const Double_t width) |
| virtual void | SetLineAttributes () |
| virtual void | SetLineColor (Color_t lcolor) |
| Set the line color. | |
| void | SetLineColor (TColorNumber lcolor) |
| virtual void | SetLineColorAlpha (Color_t lcolor, Float_t lalpha) |
| virtual void | SetLineStyle (Style_t lstyle) |
| Set the line style. | |
| virtual void | SetLineWidth (Width_t lwidth) |
| Set the line width. | |
| void | SetLog (int x, int y, int z) |
| virtual void | SetMarkerAttributes () |
| virtual void | SetMarkerColor (Color_t mcolor=1) |
| Set the marker color. | |
| void | SetMarkerColor (TColorNumber lcolor) |
| virtual void | SetMarkerColorAlpha (Color_t mcolor, Float_t malpha) |
| virtual void | SetMarkerSize (Size_t msize=1) |
| Set the marker size. | |
| virtual void | SetMarkerStyle (Style_t mstyle=1) |
| Set the marker style. | |
| 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) |
Static Public Member Functions | |
| 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) |
| static Style_t | GetMarkerStyleBase (Style_t style) |
| 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. | |
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, .. | |
| Color_t | fFillColor |
| Fill area color. | |
| Style_t | fFillStyle |
| Fill area style. | |
| 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 | |
| Color_t | fLineColor |
| Line color. | |
| Style_t | fLineStyle |
| Line style. | |
| Width_t | fLineWidth |
| Line width. | |
| int | fLogX |
| make the candle appear logx-like | |
| int | fLogY |
| make the candle appear logy-like | |
| int | fLogZ |
| make the candle appear logz-like | |
| Color_t | fMarkerColor |
| Marker color. | |
| Size_t | fMarkerSize |
| Marker size. | |
| Style_t | fMarkerStyle |
| Marker style. | |
| 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. | |
#include <TCandle.h>
| enum TCandle::CandleOption : long |
| TCandle::TCandle | ( | ) |
TCandle default constructor.
Definition at line 37 of file TCandle.cxx.
| TCandle::TCandle | ( | const char * | opt | ) |
TCandle constructor passing a draw-option.
Definition at line 69 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 108 of file TCandle.cxx.
TCandle TH1 data constructor.
Definition at line 141 of file TCandle.cxx.
| TCandle::TCandle | ( | const TCandle & | candle | ) |
|
override |
TCandle default destructor.
Definition at line 174 of file TCandle.cxx.
|
protected |
Calculates all values needed by the candle definition depending on the candle options.
Definition at line 378 of file TCandle.cxx.
|
static |
|
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 934 of file TCandle.cxx.
|
inherited |
|
inherited |
|
inherited |
|
inlinestatic |
|
inherited |
|
inlinevirtualinherited |
Return the fill area color.
Reimplemented in TGraphMultiErrors, TGWin32, TGWin32VirtualXProxy, and TGX11.
Definition at line 32 of file TAttFill.h.
|
inlinevirtualinherited |
Return the fill area style.
Reimplemented in TGraphMultiErrors, TGWin32, TGWin32VirtualXProxy, and TGX11.
Definition at line 33 of file TAttFill.h.
|
inlinevirtualinherited |
Return the line color.
Reimplemented in TGraphMultiErrors, and TGWin32VirtualXProxy.
Definition at line 36 of file TAttLine.h.
|
inlinevirtualinherited |
Return the line style.
Reimplemented in TGraphMultiErrors, TGWin32, TGWin32VirtualXProxy, and TGX11.
Definition at line 37 of file TAttLine.h.
|
inlinevirtualinherited |
Return the line width.
Reimplemented in TGraphMultiErrors, TGWin32, TGWin32VirtualXProxy, and TGX11.
Definition at line 38 of file TAttLine.h.
|
inlinevirtualinherited |
Return the marker color.
Reimplemented in TGWin32VirtualXProxy.
Definition at line 33 of file TAttMarker.h.
|
inlinevirtualinherited |
Return the marker size.
Reimplemented in TGWin32VirtualXProxy.
Definition at line 35 of file TAttMarker.h.
|
inlinevirtualinherited |
Return the marker style.
Reimplemented in TGWin32VirtualXProxy.
Definition at line 34 of file TAttMarker.h.
|
inlineoverridevirtual |
| Bool_t TCandle::IsCandleScaled | ( | ) | const |
Returns true if candle plot should be scaled.
Definition at line 182 of file TCandle.cxx.
| bool TCandle::IsOption | ( | CandleOption | opt | ) | const |
Return true is this option is activated in fOption.
Definition at line 847 of file TCandle.cxx.
|
inlinevirtualinherited |
Reimplemented in TGWin32VirtualXProxy.
Definition at line 49 of file TAttFill.h.
| Bool_t TCandle::IsViolinScaled | ( | ) | const |
Returns true if violin plot should be scaled.
Definition at line 190 of file TCandle.cxx.
|
virtualinherited |
|
virtualinherited |
|
virtualinherited |
|
virtualinherited |
|
virtualinherited |
|
virtualinherited |
|
virtual |
Paint one candle with its current attributes.
Definition at line 665 of file TCandle.cxx.
Paint a box for candle.
Definition at line 863 of file TCandle.cxx.
|
protected |
Paint a line for candle.
Definition at line 893 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 243 of file TCandle.cxx.
|
virtualinherited |
Reimplemented in TGWin32VirtualXProxy.
|
virtualinherited |
Reimplemented in TGWin32VirtualXProxy.
|
virtualinherited |
Reimplemented in TGWin32VirtualXProxy.
|
virtualinherited |
|
virtualinherited |
|
virtualinherited |
|
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 215 of file TCandle.cxx.
|
inline |
|
virtualinherited |
Reimplemented in TGWin32VirtualXProxy.
|
inlinevirtualinherited |
Set the fill area color.
Reimplemented in TGQuartz, TGraphMultiErrors, TGWin32, TGWin32VirtualXProxy, TGX11, TPDF, TPostScript, TSpider, TSVG, TTeXDump, and TVirtualX.
Definition at line 40 of file TAttFill.h.
|
inherited |
Reimplemented in TGraphMultiErrors.
|
inlinevirtualinherited |
Set the fill area style.
Reimplemented in TGQuartz, TGraphMultiErrors, TGWin32, TGWin32VirtualXProxy, TGX11, TPad, TSpider, and TVirtualX.
Definition at line 42 of file TAttFill.h.
|
inline |
|
virtualinherited |
Reimplemented in TGWin32VirtualXProxy.
|
inlinevirtualinherited |
Set the line color.
Reimplemented in ROOT::Experimental::REveLine, ROOT::Experimental::REveStraightLineSet, ROOT::Experimental::REveTrackList, TEveLine, TEveStraightLineSet, TEveTrackList, TGeoVolume, TGeoVolumeMulti, TGQuartz, TGraphMultiErrors, TGWin32, TGWin32VirtualXProxy, TGX11, TParallelCoordRange, TPDF, TPostScript, TSpider, TSVG, TTeXDump, and TVirtualX.
Definition at line 44 of file TAttLine.h.
|
inherited |
Reimplemented in TGraphMultiErrors.
|
inlinevirtualinherited |
Set the line style.
Reimplemented in ROOT::Experimental::REveLine, ROOT::Experimental::REveTrackList, TEveLine, TEveTrackList, TGeoVolume, TGeoVolumeMulti, TGQuartz, TGraphMultiErrors, TGWin32, TGWin32VirtualXProxy, TGX11, TPDF, TPostScript, TSpider, TSVG, TTeXDump, and TVirtualX.
Definition at line 46 of file TAttLine.h.
|
inlinevirtualinherited |
Set the line width.
Reimplemented in ROOT::Experimental::REveLine, ROOT::Experimental::REveTrackList, TEveLine, TEveTrackList, TGeoVolume, TGeoVolumeMulti, TGQuartz, TGraphMultiErrors, TGWin32, TGWin32VirtualXProxy, TGX11, TPaletteAxis, TParallelCoordRange, TPDF, TPostScript, TSpider, TSVG, TTeXDump, and TVirtualX.
Definition at line 47 of file TAttLine.h.
|
virtualinherited |
Reimplemented in TGWin32VirtualXProxy.
|
inlinevirtualinherited |
Set the marker color.
Reimplemented in ROOT::Experimental::REveLine, ROOT::Experimental::REvePointSet, ROOT::Experimental::REvePointSetArray, ROOT::Experimental::REveTrackList, TEveLine, TEvePointSet, TEvePointSetArray, TEveTrackList, TGQuartz, TGWin32, TGWin32VirtualXProxy, TGX11, TPDF, TPostScript, TSVG, TTeXDump, and TVirtualX.
Definition at line 41 of file TAttMarker.h.
|
inherited |
|
inlinevirtualinherited |
Set the marker size.
Note that the marker styles number 1 6 and 7 (the dots), cannot be scaled. They are meant to be very fast to draw and are always drawn with the same number of pixels; therefore this method does not apply on them.
Reimplemented in ROOT::Experimental::REvePointSet, ROOT::Experimental::REvePointSetArray, ROOT::Experimental::REveTrackList, TEvePointSet, TEvePointSetArray, TEveTrackList, TGQuartz, TGWin32, TGWin32VirtualXProxy, TGX11, TTeXDump, and TVirtualX.
Definition at line 48 of file TAttMarker.h.
|
inlinevirtualinherited |
Set the marker style.
Reimplemented in ROOT::Experimental::REvePointSet, ROOT::Experimental::REvePointSetArray, ROOT::Experimental::REveTrackList, TEvePointSet, TEvePointSetArray, TEveTrackList, TGQuartz, TGWin32, TGWin32VirtualXProxy, TGX11, and TVirtualX.
Definition at line 43 of file TAttMarker.h.
|
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 224 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 234 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 203 of file TCandle.cxx.
|
overridevirtual |
Stream an object of class TCandle.
Reimplemented from TAttLine.
Definition at line 917 of file TCandle.cxx.
|
inline |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protectedinherited |
Fill area color.
Definition at line 24 of file TAttFill.h.
|
protectedinherited |
Fill area style.
Definition at line 25 of file TAttFill.h.
|
protected |
|
protected |
|
protected |
|
protected |
|
protectedinherited |
Line color.
Definition at line 24 of file TAttLine.h.
|
protectedinherited |
Line style.
Definition at line 25 of file TAttLine.h.
|
protectedinherited |
Line width.
Definition at line 26 of file TAttLine.h.
|
protected |
|
protected |
|
protected |
|
protectedinherited |
Marker color.
Definition at line 24 of file TAttMarker.h.
|
protectedinherited |
Marker size.
Definition at line 26 of file TAttMarker.h.
|
protectedinherited |
Marker style.
Definition at line 25 of file TAttMarker.h.
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |