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 |
| Copy this fill attributes to a new TAttFill. | |
| void | Copy (TAttLine &attline) const |
| Copy this line attributes to a new TAttLine. | |
| void | Copy (TAttMarker &attmarker) const |
| Copy this marker attributes to a new TAttMarker. | |
| 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. | |
| 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 () |
| Change current fill area attributes if necessary. | |
| virtual void | Modify () |
| Change current line attributes if necessary. | |
| virtual void | Modify () |
| Change current marker attributes if necessary. | |
| virtual void | ModifyOn (TVirtualPad &pad) |
| Change current fill area attributes on speicifed pad. | |
| virtual void | ModifyOn (TVirtualPad &pad) |
| Change current line attributes on specified pad. | |
| virtual void | ModifyOn (TVirtualPad &pad) |
| Change current marker attributes if necessary on specified 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="") |
| Reset this fill attributes to default values. | |
| virtual void | ResetAttLine (Option_t *option="") |
| Reset this line attributes to default values. | |
| virtual void | ResetAttMarker (Option_t *toption="") |
| Reset this marker attributes to the 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 | 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 | 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. | |
| void | SetAxisPosition (const Double_t candlePos) |
| void | SetCandleWidth (const Double_t width) |
| virtual void | SetFillAttributes () |
| Invoke the DialogCanvas Fill attributes. | |
| virtual void | SetFillColor (Color_t fcolor) |
| Set the fill area color. | |
| void | SetFillColor (TColorNumber) |
| Set a fill 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 | SetHistogram (TH1D *proj) |
| void | SetHistoWidth (const Double_t width) |
| virtual void | SetLineAttributes () |
| Invoke the DialogCanvas Line attributes. | |
| virtual void | SetLineColor (Color_t lcolor) |
| Set the line color. | |
| void | SetLineColor (TColorNumber lcolor) |
| 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 | SetLog (int x, int y, int z) |
| virtual void | SetMarkerAttributes () |
| Invoke the DialogCanvas Marker attributes. | |
| virtual void | SetMarkerColor (Color_t mcolor=1) |
| Set the marker color. | |
| void | SetMarkerColor (TColorNumber lcolor) |
| 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. | |
| 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) |
| 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. | |
| 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.
Definition at line 141 of file TCandle.cxx.
|
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.
| 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 |
Copy this fill attributes to a new TAttFill.
Definition at line 203 of file TAttFill.cxx.
|
inherited |
Copy this line attributes to a new TAttLine.
Definition at line 176 of file TAttLine.cxx.
|
inherited |
Copy this marker attributes to a new TAttMarker.
Definition at line 243 of file TAttMarker.cxx.
|
inherited |
Compute distance from point px,py to a line.
Compute the closest distance of approach from point px,py to this line. The distance is computed in pixels units.
Algorithm:
Definition at line 210 of file TAttLine.cxx.
Return the fill area color.
Reimplemented in TGraphMultiErrors, TGWin32, TGWin32VirtualXProxy, and TGX11.
Definition at line 32 of file TAttFill.h.
Return the fill area style.
Reimplemented in TGraphMultiErrors, TGWin32, TGWin32VirtualXProxy, and TGX11.
Definition at line 33 of file TAttFill.h.
Return the line color.
Reimplemented in TGraphMultiErrors, and TGWin32VirtualXProxy.
Definition at line 36 of file TAttLine.h.
Return the line style.
Reimplemented in TGraphMultiErrors, TGWin32, TGWin32VirtualXProxy, and TGX11.
Definition at line 37 of file TAttLine.h.
Return the line width.
Reimplemented in TGraphMultiErrors, TGWin32, TGWin32VirtualXProxy, and TGX11.
Definition at line 38 of file TAttLine.h.
Return the marker color.
Reimplemented in TGWin32VirtualXProxy.
Definition at line 33 of file TAttMarker.h.
Internal helper function that returns the line width of the given marker style (0 = filled marker)
Definition at line 305 of file TAttMarker.cxx.
Return the marker size.
Reimplemented in TGWin32VirtualXProxy.
Definition at line 35 of file TAttMarker.h.
Return the marker style.
Reimplemented in TGWin32VirtualXProxy.
Definition at line 34 of file TAttMarker.h.
Internal helper function that returns the corresponding marker style with line width 1 for the given style.
Definition at line 254 of file TAttMarker.cxx.
|
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 |
Change current fill area attributes if necessary.
Definition at line 212 of file TAttFill.cxx.
|
virtualinherited |
Change current line attributes if necessary.
Definition at line 246 of file TAttLine.cxx.
|
virtualinherited |
Change current marker attributes if necessary.
Definition at line 322 of file TAttMarker.cxx.
|
virtualinherited |
Change current fill area attributes on speicifed pad.
Definition at line 221 of file TAttFill.cxx.
|
virtualinherited |
Change current line attributes on specified pad.
Definition at line 255 of file TAttLine.cxx.
|
virtualinherited |
Change current marker attributes if necessary on specified pad.
Definition at line 331 of file TAttMarker.cxx.
|
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 |
Reset this fill attributes to default values.
Reimplemented in TGWin32VirtualXProxy.
Definition at line 231 of file TAttFill.cxx.
|
virtualinherited |
Reset this line attributes to default values.
Reimplemented in TGWin32VirtualXProxy.
Definition at line 279 of file TAttLine.cxx.
|
virtualinherited |
Reset this marker attributes to the default values.
Reimplemented in TGWin32VirtualXProxy.
Definition at line 342 of file TAttMarker.cxx.
|
virtualinherited |
Save fill attributes as C++ statement(s) on output stream out.
Definition at line 240 of file TAttFill.cxx.
|
virtualinherited |
Save line attributes as C++ statement(s) on output stream out.
Definition at line 289 of file TAttLine.cxx.
|
virtualinherited |
Save line attributes as C++ statement(s) on output stream out.
Definition at line 352 of file TAttMarker.cxx.
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.
|
virtualinherited |
Invoke the DialogCanvas Fill attributes.
Reimplemented in TGWin32VirtualXProxy.
Definition at line 251 of file TAttFill.cxx.
Set the fill area color.
Reimplemented in TVirtualX, TGQuartz, TGWin32, TGWin32VirtualXProxy, TGX11, TPDF, TPostScript, TSVG, TTeXDump, TSpider, and TGraphMultiErrors.
Definition at line 40 of file TAttFill.h.
|
inherited |
Set a fill color.
Definition at line 270 of file TAttFill.cxx.
Set a transparent fill color.
| fcolor | defines the fill color |
| falpha | defines the percentage of opacity from 0. (fully transparent) to 1. (fully opaque). |
Reimplemented in TGraphMultiErrors.
Definition at line 262 of file TAttFill.cxx.
Set the fill area style.
Reimplemented in TGraphMultiErrors, TPad, TSpider, TVirtualX, TGQuartz, TGWin32, TGWin32VirtualXProxy, and TGX11.
Definition at line 42 of file TAttFill.h.
|
virtualinherited |
Invoke the DialogCanvas Line attributes.
Reimplemented in TGWin32VirtualXProxy.
Definition at line 306 of file TAttLine.cxx.
Set the line color.
Reimplemented in TEveTrackList, ROOT::Experimental::REveTrackList, TVirtualX, TGQuartz, TGWin32, TGWin32VirtualXProxy, TGX11, TPDF, TPostScript, TSVG, TTeXDump, TEveLine, TEveStraightLineSet, ROOT::Experimental::REveLine, ROOT::Experimental::REveStraightLineSet, TParallelCoordRange, TSpider, TGraphMultiErrors, TGeoVolume, and TGeoVolumeMulti.
Definition at line 44 of file TAttLine.h.
|
inherited |
Definition at line 322 of file TAttLine.cxx.
Set a transparent line color.
| lcolor | defines the line color |
| lalpha | defines the percentage of opacity from 0. (fully transparent) to 1. (fully opaque). |
Reimplemented in TGraphMultiErrors.
Definition at line 317 of file TAttLine.cxx.
Set the line style.
Reimplemented in TVirtualX, TGQuartz, TGWin32, TGWin32VirtualXProxy, TGX11, TPDF, TPostScript, TSVG, TTeXDump, TGraphMultiErrors, TGeoVolume, TGeoVolumeMulti, TEveLine, ROOT::Experimental::REveLine, TEveTrackList, ROOT::Experimental::REveTrackList, and TSpider.
Definition at line 46 of file TAttLine.h.
Set the line width.
Reimplemented in TPDF, TPostScript, TSVG, TTeXDump, TGraphMultiErrors, TGeoVolume, TGeoVolumeMulti, TEveLine, ROOT::Experimental::REveLine, TEveTrackList, ROOT::Experimental::REveTrackList, TParallelCoordRange, TSpider, TVirtualX, TGQuartz, TGWin32, TGWin32VirtualXProxy, TGX11, and TPaletteAxis.
Definition at line 47 of file TAttLine.h.
|
virtualinherited |
Invoke the DialogCanvas Marker attributes.
Reimplemented in TGWin32VirtualXProxy.
Definition at line 365 of file TAttMarker.cxx.
Set the marker color.
Reimplemented in TEveTrackList, ROOT::Experimental::REveTrackList, TVirtualX, TGQuartz, TGWin32, TGWin32VirtualXProxy, TGX11, TPDF, TPostScript, TSVG, TTeXDump, TEveLine, TEvePointSet, ROOT::Experimental::REveLine, ROOT::Experimental::REvePointSet, TEvePointSetArray, and ROOT::Experimental::REvePointSetArray.
Definition at line 41 of file TAttMarker.h.
|
inherited |
Definition at line 381 of file TAttMarker.cxx.
Set a transparent marker color.
| mcolor | defines the marker color |
| malpha | defines the percentage of opacity from 0. (fully transparent) to 1. (fully opaque). |
Definition at line 376 of file TAttMarker.cxx.
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 TVirtualX, TGQuartz, TGWin32, TGWin32VirtualXProxy, TGX11, TTeXDump, TEvePointSet, TEvePointSetArray, ROOT::Experimental::REvePointSet, ROOT::Experimental::REvePointSetArray, TEveTrackList, and ROOT::Experimental::REveTrackList.
Definition at line 48 of file TAttMarker.h.
Set the marker style.
Reimplemented in TVirtualX, TGQuartz, TGWin32, TGWin32VirtualXProxy, TGX11, TEvePointSet, TEvePointSetArray, ROOT::Experimental::REvePointSet, ROOT::Experimental::REvePointSetArray, TEveTrackList, and ROOT::Experimental::REveTrackList.
Definition at line 43 of file TAttMarker.h.
|
inline |
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 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 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 |