Class to manage histogram axis.

This class manages histogram axis. It is referenced by TH1 and TGraph. To make a graphical representation of an histogram axis, this class references the TGaxis class. TAxis supports axis with fixed or variable bin sizes. Labels may be associated to individual bins. See examples of various axis representations drawn by class TGaxis.

Definition at line 30 of file TAxis.h.

Public Types
enum	EStatusBits { kDecimals = BIT(7), kTickPlus = BIT(9), kTickMinus = BIT(10), kAxisRange = BIT(11), kCenterTitle = BIT(12), kCenterLabels = BIT(14), kRotateTitle = BIT(15), kPalette = BIT(16), kNoExponent = BIT(17), kLabelsHori = BIT(18), kLabelsVert = BIT(19), kLabelsDown = BIT(20), kLabelsUp = BIT(21), kIsInteger = BIT(22), kMoreLogLabels = BIT(23) }

Public Types inherited from TObject
enum	{ kIsOnHeap = 0x01000000, kNotDeleted = 0x02000000, kZombie = 0x04000000, kInconsistent = 0x08000000, kBitMask = 0x00ffffff }

enum	{ kSingleKey = BIT(0), kOverwrite = BIT(1), kWriteDelete = BIT(2) }

enum	EDeprecatedStatusBits { kObjInCanvas = BIT(3) }

enum	EStatusBits { kCanDelete = BIT(0), kMustCleanup = BIT(3), kIsReferenced = BIT(4), kHasUUID = BIT(5), kCannotPick = BIT(6), kNoContextMenu = BIT(8), kInvalidObject = BIT(13) }

Public Member Functions
	TAxis ()
	Default constructor. More...

	TAxis (Int_t nbins, Double_t xmin, Double_t xmax)
	Axis constructor for axis with fix bin size. More...

	TAxis (Int_t nbins, const Double_t *xbins)
	Axis constructor for variable bin size. More...

	TAxis (const TAxis &axis)
	Copy constructor. More...

virtual	~TAxis ()
	Destructor. More...

Bool_t	CanBeAlphanumeric ()

Bool_t	CanExtend () const

void	CenterLabels (Bool_t center=kTRUE)
	Center axis labels. More...

void	CenterTitle (Bool_t center=kTRUE)
	Center axis title. More...

void	ChangeLabel (Int_t labNum=0, Double_t labAngle=-1., Double_t labSize=-1., Int_t labAlign=-1, Int_t labColor=-1, Int_t labFont=-1, TString labText="")
	Define new text attributes for the label number "labNum". More...

const char *	ChooseTimeFormat (Double_t axislength=0)
	Choose a reasonable time format from the coordinates in the active pad and the number of divisions in this axis If orientation = "X", the horizontal axis of the pad will be used for ref. More...

virtual void	Copy (TObject &axis) const
	Copy axis structure to another axis. More...

virtual void	Delete (Option_t *="")
	Delete this object. More...

virtual Int_t	DistancetoPrimitive (Int_t px, Int_t py)
	Compute distance from point px,py to an axis. More...

virtual TObject *	DrawClone (Option_t *="") const
	Draw a clone of this object in the current selected pad for instance with: `gROOT->SetSelectedPad(gPad)`. More...

virtual void	ExecuteEvent (Int_t event, Int_t px, Int_t py)
	Execute action corresponding to one event. More...

virtual Int_t	FindBin (Double_t x)
	Find bin number corresponding to abscissa x. More...

virtual Int_t	FindBin (Double_t x) const

virtual Int_t	FindBin (const char *label)
	Find bin number with label. More...

virtual Int_t	FindFixBin (Double_t x) const
	Find bin number corresponding to abscissa x. More...

virtual Int_t	FindFixBin (const char *label) const
	Find bin number with label. More...

virtual Double_t	GetBinCenter (Int_t bin) const
	Return center of bin. More...

virtual Double_t	GetBinCenterLog (Int_t bin) const
	Return center of bin in log With a log-equidistant binning for a bin with low and up edges, the mean is : 0.5*(ln low + ln up) i.e. More...

const char *	GetBinLabel (Int_t bin) const
	Return label for bin. More...

virtual Double_t	GetBinLowEdge (Int_t bin) const
	Return low edge of bin. More...

virtual Double_t	GetBinUpEdge (Int_t bin) const
	Return up edge of bin. More...

virtual Double_t	GetBinWidth (Int_t bin) const
	Return bin width. More...

virtual void	GetCenter (Double_t *center) const
	Return an array with the center of all bins. More...

Bool_t	GetCenterLabels () const

Bool_t	GetCenterTitle () const

Bool_t	GetDecimals () const

Int_t	GetFirst () const
	Return first bin on the axis i.e. More...

THashList *	GetLabels () const

Int_t	GetLast () const
	Return last bin on the axis i.e. More...

virtual void	GetLowEdge (Double_t *edge) const
	Return an array with the lod edge of all bins. More...

TList *	GetModifiedLabels () const

Bool_t	GetMoreLogLabels () const

Int_t	GetNbins () const

Bool_t	GetNoExponent () const

virtual TObject *	GetParent () const

Bool_t	GetRotateTitle () const

virtual const char *	GetTicks () const
	Return the ticks option (see SetTicks) More...

virtual Bool_t	GetTimeDisplay () const

virtual const char *	GetTimeFormat () const

virtual const char *	GetTimeFormatOnly () const
	Return only the time format from the string fTimeFormat. More...

const char *	GetTitle () const
	Returns title of object. More...

const TArrayD *	GetXbins () const

Double_t	GetXmax () const

Double_t	GetXmin () const

virtual void	ImportAttributes (const TAxis *axis)
	Copy axis attributes to this. More...

Bool_t	IsAlphanumeric ()

Bool_t	IsVariableBinSize () const

virtual void	LabelsOption (Option_t *option="h")
	Set option(s) to draw axis with labels option can be: More...

TAxis &	operator= (const TAxis &)
	Assignment operator. More...

void	RotateTitle (Bool_t rotate=kTRUE)
	Rotate title by 180 degrees. More...

virtual void	SaveAttributes (std::ostream &out, const char name, const char subname)
	Save axis attributes as C++ statement(s) on output stream out. More...

virtual void	Set (Int_t nbins, Double_t xmin, Double_t xmax)
	Initialize axis with fix bins. More...

virtual void	Set (Int_t nbins, const Float_t *xbins)
	Initialize axis with variable bins. More...

virtual void	Set (Int_t nbins, const Double_t *xbins)
	Initialize axis with variable bins. More...

void	SetAlphanumeric (Bool_t alphanumeric=kTRUE)
	Set axis alphanumeric. More...

virtual void	SetBinLabel (Int_t bin, const char *label)
	Set label for bin. More...

void	SetCanExtend (Bool_t canExtend)

void	SetDecimals (Bool_t dot=kTRUE)
	Sets the decimals flag By default, blank characters are stripped, and then the label is correctly aligned. More...

virtual void	SetDefaults ()
	Set axis default values (from TStyle) More...

virtual void	SetDrawOption (Option_t *="")
	Set drawing option for object. More...

virtual void	SetLimits (Double_t xmin, Double_t xmax)

void	SetMoreLogLabels (Bool_t more=kTRUE)
	Set the kMoreLogLabels bit flag When this option is selected more labels are drawn when in log scale and there is a small number of decades (<3). More...

void	SetNoAlphanumeric (Bool_t noalpha=kTRUE)

void	SetNoExponent (Bool_t noExponent=kTRUE)
	Set the NoExponent flag By default, an exponent of the form 10^N is used when the label value are either all very small or very large. More...

virtual void	SetParent (TObject *obj)

virtual void	SetRange (Int_t first=0, Int_t last=0)
	Set the viewing range for the axis from bin first to last. More...

virtual void	SetRangeUser (Double_t ufirst, Double_t ulast)
	Set the viewing range for the axis from ufirst to ulast (in user coordinates). More...

virtual void	SetTicks (Option_t *option="+")
	Set ticks orientation. More...

virtual void	SetTimeDisplay (Int_t value)

virtual void	SetTimeFormat (const char *format="")
	Change the format used for time plotting. More...

virtual void	SetTimeOffset (Double_t toffset, Option_t *option="local")
	Change the time offset If option = "gmt", set display mode to GMT. More...

virtual void	UnZoom ()
	Reset first & last bin to the full range. More...

virtual void	ZoomOut (Double_t factor=0, Double_t offset=0)
	Zoom out by a factor of 'factor' (default =2) uses previous zoom factor by default Keep center defined by 'offset' fixed ie. More...

Public Member Functions inherited from TNamed
	TNamed ()

	TNamed (const char name, const char title)

	TNamed (const TString &name, const TString &title)

	TNamed (const TNamed &named)
	TNamed copy ctor. More...

virtual	~TNamed ()
	TNamed destructor. More...

virtual void	Clear (Option_t *option="")
	Set name and title to empty strings (""). More...

virtual TObject *	Clone (const char *newname="") const
	Make a clone of an object using the Streamer facility. More...

virtual Int_t	Compare (const TObject *obj) const
	Compare two TNamed objects. More...

virtual void	FillBuffer (char *&buffer)
	Encode TNamed into output buffer. More...

virtual const char *	GetName () const
	Returns name of object. More...

virtual ULong_t	Hash () const
	Return hash value for this object. More...

virtual Bool_t	IsSortable () const

virtual void	ls (Option_t *option="") const
	List TNamed name and title. More...

TNamed &	operator= (const TNamed &rhs)
	TNamed assignment operator. More...

virtual void	Print (Option_t *option="") const
	Print TNamed name and title. More...

virtual void	SetName (const char *name)
	Set the name of the TNamed. More...

virtual void	SetNameTitle (const char name, const char title)
	Set all the TNamed parameters (name and title). More...

virtual void	SetTitle (const char *title="")
	Set the title of the TNamed. More...

virtual Int_t	Sizeof () const
	Return size of the TNamed part of the TObject. More...

Public Member Functions inherited from TObject
	TObject ()
	TObject constructor. More...

	TObject (const TObject &object)
	TObject copy ctor. More...

virtual	~TObject ()
	TObject destructor. More...

void	AbstractMethod (const char *method) const
	Use this method to implement an "abstract" method that you don't want to leave purely abstract. More...

virtual void	AppendPad (Option_t *option="")
	Append graphics object to current pad. More...

virtual void	Browse (TBrowser *b)
	Browse object. May be overridden for another default action. More...

ULong_t	CheckedHash ()
	Checked and record whether for this class has a consistent Hash/RecursiveRemove setup (*) and then return the regular Hash value for this object. More...

virtual const char *	ClassName () const
	Returns name of class to which the object belongs. More...

virtual void	Draw (Option_t *option="")
	Default Draw method for all objects. More...

virtual void	DrawClass () const
	Draw class inheritance tree of the class to which this object belongs. More...

virtual void	Dump () const
	Dump contents of object on stdout. More...

virtual void	Error (const char method, const char msgfmt,...) const
	Issue error message. More...

virtual void	Execute (const char method, const char params, Int_t *error=0)
	Execute method on this object with the given parameter string, e.g. More...

virtual void	Execute (TMethod method, TObjArray params, Int_t *error=0)
	Execute method on this object with parameters stored in the TObjArray. More...

virtual void	Fatal (const char method, const char msgfmt,...) const
	Issue fatal error message. More...

virtual TObject *	FindObject (const char *name) const
	Must be redefined in derived classes. More...

virtual TObject *	FindObject (const TObject *obj) const
	Must be redefined in derived classes. More...

virtual Option_t *	GetDrawOption () const
	Get option used by the graphics system to draw this object. More...

virtual const char *	GetIconName () const
	Returns mime type name of object. More...

virtual char *	GetObjectInfo (Int_t px, Int_t py) const
	Returns string containing info about the object at position (px,py). More...

virtual Option_t *	GetOption () const

virtual UInt_t	GetUniqueID () const
	Return the unique object id. More...

virtual Bool_t	HandleTimer (TTimer *timer)
	Execute action in response of a timer timing out. More...

Bool_t	HasInconsistentHash () const
	Return true is the type of this object is known to have an inconsistent setup for Hash and RecursiveRemove (i.e. More...

virtual void	Info (const char method, const char msgfmt,...) const
	Issue info message. More...

virtual Bool_t	InheritsFrom (const char *classname) const
	Returns kTRUE if object inherits from class "classname". More...

virtual Bool_t	InheritsFrom (const TClass *cl) const
	Returns kTRUE if object inherits from TClass cl. More...

virtual void	Inspect () const
	Dump contents of this object in a graphics canvas. More...

void	InvertBit (UInt_t f)

virtual Bool_t	IsEqual (const TObject *obj) const
	Default equal comparison (objects are equal if they have the same address in memory). More...

virtual Bool_t	IsFolder () const
	Returns kTRUE in case object contains browsable objects (like containers or lists of other objects). More...

R__ALWAYS_INLINE Bool_t	IsOnHeap () const

R__ALWAYS_INLINE Bool_t	IsZombie () const

void	MayNotUse (const char *method) const
	Use this method to signal that a method (defined in a base class) may not be called in a derived class (in principle against good design since a child class should not provide less functionality than its parent, however, sometimes it is necessary). More...

virtual Bool_t	Notify ()
	This method must be overridden to handle object notification. More...

void	Obsolete (const char method, const char asOfVers, const char *removedFromVers) const
	Use this method to declare a method obsolete. More...

void	operator delete (void *ptr)
	Operator delete. More...

void	operator delete[] (void *ptr)
	Operator delete []. More...

void *	operator new (size_t sz)

void *	operator new (size_t sz, void *vp)

void *	operator new[] (size_t sz)

void *	operator new[] (size_t sz, void *vp)

TObject &	operator= (const TObject &rhs)
	TObject assignment operator. More...

virtual void	Paint (Option_t *option="")
	This method must be overridden if a class wants to paint itself. More...

virtual void	Pop ()
	Pop on object drawn in a pad to the top of the display list. More...

virtual Int_t	Read (const char *name)
	Read contents of object with specified name from the current directory. More...

virtual void	RecursiveRemove (TObject *obj)
	Recursively remove this object from a list. More...

void	ResetBit (UInt_t f)

virtual void	SaveAs (const char filename="", Option_t option="") const
	Save this object in the file specified by filename. More...

virtual void	SavePrimitive (std::ostream &out, Option_t *option="")
	Save a primitive as a C++ statement(s) on output stream "out". More...

void	SetBit (UInt_t f, Bool_t set)
	Set or unset the user status bits as specified in f. More...

void	SetBit (UInt_t f)

virtual void	SetUniqueID (UInt_t uid)
	Set the unique object id. More...

virtual void	SysError (const char method, const char msgfmt,...) const
	Issue system error message. More...

R__ALWAYS_INLINE Bool_t	TestBit (UInt_t f) const

Int_t	TestBits (UInt_t f) const

virtual void	UseCurrentStyle ()
	Set current style settings in this object This function is called when either TCanvas::UseCurrentStyle or TROOT::ForceStyle have been invoked. More...

virtual void	Warning (const char method, const char msgfmt,...) const
	Issue warning message. More...

virtual Int_t	Write (const char *name=0, Int_t option=0, Int_t bufsize=0)
	Write this object to the current directory. More...

virtual Int_t	Write (const char *name=0, Int_t option=0, Int_t bufsize=0) const
	Write this object to the current directory. More...

Public Member Functions inherited from TAttAxis
	TAttAxis ()

virtual	~TAttAxis ()
	Destructor. More...

void	Copy (TAttAxis &attaxis) const
	Copy of the object. More...

virtual Color_t	GetAxisColor () const

virtual Color_t	GetLabelColor () const

virtual Style_t	GetLabelFont () const

virtual Float_t	GetLabelOffset () const

virtual Float_t	GetLabelSize () const

virtual Int_t	GetNdivisions () const

virtual Float_t	GetTickLength () const

virtual Color_t	GetTitleColor () const

virtual Style_t	GetTitleFont () const

virtual Float_t	GetTitleOffset () const

virtual Float_t	GetTitleSize () const

virtual void	ResetAttAxis (Option_t *option="")
	Reset axis attributes. More...

virtual void	SetAxisColor (Color_t color=1, Float_t alpha=1.)
	Set color of the line axis and tick marks. More...

virtual void	SetLabelColor (Color_t color=1, Float_t alpha=1.)
	Set color of labels. More...

virtual void	SetLabelFont (Style_t font=62)
	Set labels' font. More...

virtual void	SetLabelOffset (Float_t offset=0.005)
	Set distance between the axis and the labels The distance is expressed in per cent of the pad width. More...

virtual void	SetLabelSize (Float_t size=0.04)
	Set size of axis labels The size is expressed in per cent of the pad width. More...

virtual void	SetMaxDigits (Int_t maxDigits=5)
	This function sets the maximum number of digits permitted for the axis labels above which the notation with 10^N is used. More...

virtual void	SetNdivisions (Int_t n=510, Bool_t optim=kTRUE)
	Set the number of divisions for this axis. More...

virtual void	SetNdivisions (Int_t n1, Int_t n2, Int_t n3, Bool_t optim=kTRUE)
	see function above More...

virtual void	SetTickLength (Float_t length=0.03)
	Set tick mark length The length is expressed in per cent of the pad width. More...

virtual void	SetTickSize (Float_t size=0.03)

virtual void	SetTitleColor (Color_t color=1)
	Set color of axis title. More...

virtual void	SetTitleFont (Style_t font=62)
	Set the title font. More...

virtual void	SetTitleOffset (Float_t offset=1)
	Set distance between the axis and the axis title Offset is a correction factor with respect to the "standard" value. More...

virtual void	SetTitleSize (Float_t size=0.04)
	Set size of axis title The size is expressed in per cent of the pad width. More...

Private Types
enum	{ kAlphanumeric = BIT(0), kCanExtend = BIT(1), kNotAlpha = BIT(2) }

Private Member Functions
Bool_t	HasBinWithoutLabel () const
	this helper function checks if there is a bin without a label if all bins have labels, the axis can / will become alphanumeric More...

Private Attributes
UShort_t	fBits2

Int_t	fFirst

THashList *	fLabels
	Object owning this axis. More...

Int_t	fLast

TList *	fModLabs

Int_t	fNbins

TObject *	fParent

Bool_t	fTimeDisplay

TString	fTimeFormat

TArrayD	fXbins

Double_t	fXmax

Double_t	fXmin

Additional Inherited Members
Static Public Member Functions inherited from TObject
static Long_t	GetDtorOnly ()
	Return destructor only flag. More...

static Bool_t	GetObjectStat ()
	Get status of object stat flag. More...

static void	SetDtorOnly (void *obj)
	Set destructor only flag. More...

static void	SetObjectStat (Bool_t stat)
	Turn on/off tracking of objects in the TObjectTable. More...

Protected Member Functions inherited from TObject
virtual void	DoError (int level, const char location, const char fmt, va_list va) const
	Interface to ErrorHandler (protected). More...

void	MakeZombie ()

Protected Attributes inherited from TNamed
TString	fName

TString	fTitle

Protected Attributes inherited from TAttAxis
Color_t	fAxisColor
	Color of the line axis. More...

Color_t	fLabelColor
	Color of labels. More...

Style_t	fLabelFont
	Font for labels. More...

Float_t	fLabelOffset
	Offset of labels. More...

Float_t	fLabelSize
	Size of labels. More...

Int_t	fNdivisions
	Number of divisions(10000n3 + 100n2 + n1) More...

Float_t	fTickLength
	Length of tick marks. More...

Color_t	fTitleColor
	Color of axis title. More...

Style_t	fTitleFont
	Font for axis title. More...

Float_t	fTitleOffset
	Offset of axis title. More...

Float_t	fTitleSize
	Size of axis title. More...

#include <TAxis.h>

Inheritance diagram for TAxis:

[legend]

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

private

Enumerator
kAlphanumeric
kCanExtend
kNotAlpha

Definition at line 47 of file TAxis.h.

◆ EStatusBits

enum TAxis::EStatusBits

Enumerator
kDecimals
kTickPlus
kTickMinus
kAxisRange
kCenterTitle
kCenterLabels
kRotateTitle
kPalette
kNoExponent
kLabelsHori
kLabelsVert
kLabelsDown
kLabelsUp
kIsInteger
kMoreLogLabels

Definition at line 57 of file TAxis.h.

Constructor & Destructor Documentation

◆ TAxis() [1/4]

TAxis::TAxis ( )

Default constructor.

Definition at line 47 of file TAxis.cxx.

◆ TAxis() [2/4]

TAxis::TAxis	(	Int_t	nbins,
		Double_t	xmin,
		Double_t	xmax
	)

Axis constructor for axis with fix bin size.

Definition at line 64 of file TAxis.cxx.

◆ TAxis() [3/4]

TAxis::TAxis	(	Int_t	nbins,
		const Double_t *	xbins
	)

Axis constructor for variable bin size.

Definition at line 75 of file TAxis.cxx.

◆ TAxis() [4/4]

TAxis::TAxis ( const TAxis & axis )

Copy constructor.

Definition at line 103 of file TAxis.cxx.

◆ ~TAxis()

TAxis::~TAxis ( )

virtual

Destructor.

Definition at line 86 of file TAxis.cxx.

Member Function Documentation

◆ CanBeAlphanumeric()

Bool_t TAxis::CanBeAlphanumeric ( )

inline

Definition at line 83 of file TAxis.h.

◆ CanExtend()

Bool_t TAxis::CanExtend ( ) const

inline

Definition at line 82 of file TAxis.h.

◆ CenterLabels()

void TAxis::CenterLabels ( Bool_t center = kTRUE )

inline

Center axis labels.

If center = kTRUE axis labels will be centered (hori axes only) on the bin center default is to center on the primary tick marks This option does not make sense if there are more bins than tick marks

Definition at line 175 of file TAxis.h.

◆ CenterTitle()

void TAxis::CenterTitle ( Bool_t center = kTRUE )

inline

Center axis title.

If center = kTRUE axis title will be centered default is right adjusted

Definition at line 184 of file TAxis.h.

◆ ChangeLabel()

void TAxis::ChangeLabel	(	Int_t	labNum = `0`,
		Double_t	labAngle = `-1.`,
		Double_t	labSize = `-1.`,
		Int_t	labAlign = `-1`,
		Int_t	labColor = `-1`,
		Int_t	labFont = `-1`,
		TString	labText = `""`
	)

Define new text attributes for the label number "labNum".

It allows to do a fine tuning of the labels. All the attributes can be changed, even the label text itself.

Parameters

[in]	labNum	Number of the label to be changed, negative numbers start from the end
[in]	labAngle	New angle value
[in]	labSize	New size (0 erase the label)
[in]	labAlign	New alignment value
[in]	labColor	New label color
[in]	labFont	New label font
[in]	labText	New label text

If an attribute should not be changed just give the value "-1".

If labnum=0 the list of modified labels is reset.

Definition at line 859 of file TAxis.cxx.

◆ ChooseTimeFormat()

const char * TAxis::ChooseTimeFormat ( Double_t axislength = 0 )

Choose a reasonable time format from the coordinates in the active pad and the number of divisions in this axis If orientation = "X", the horizontal axis of the pad will be used for ref.

If orientation = "Y", the vertical axis of the pad will be used for ref.

Definition at line 124 of file TAxis.cxx.

◆ Copy()

void TAxis::Copy ( TObject & axis ) const

virtual

Copy axis structure to another axis.

Reimplemented from TNamed.

Definition at line 208 of file TAxis.cxx.

◆ Delete()

virtual void TAxis::Delete ( Option_t * option = "" )

inlinevirtual

Delete this object.

Typically called as a command via the interpreter. Normally use "delete" operator when object has been allocated on the heap.

Reimplemented from TObject.

Definition at line 98 of file TAxis.h.

◆ DistancetoPrimitive()

Int_t TAxis::DistancetoPrimitive	(	Int_t	px,
		Int_t	py
	)

virtual

Compute distance from point px,py to an axis.

Reimplemented from TObject.

Definition at line 251 of file TAxis.cxx.

◆ DrawClone()

virtual TObject* TAxis::DrawClone ( Option_t * option = "" ) const

inlinevirtual

Draw a clone of this object in the current selected pad for instance with: gROOT->SetSelectedPad(gPad).

Reimplemented from TObject.

Definition at line 100 of file TAxis.h.

◆ ExecuteEvent()

void TAxis::ExecuteEvent	(	Int_t	event,
		Int_t	px,
		Int_t	py
	)

virtual

Execute action corresponding to one event.

This member function is called when an axis is clicked with the locator. The axis range is set between the position where the mouse is pressed and the position where it is released. If the mouse position is outside the current axis range when it is released the axis is unzoomed with the corresponding proportions. Note that the mouse does not need to be in the pad or even canvas when it is released.

Reimplemented from TObject.

Definition at line 267 of file TAxis.cxx.

◆ FindBin() [1/3]

Int_t TAxis::FindBin ( Double_t x )

virtual

Find bin number corresponding to abscissa x.

NOTE: this method does not work with alphanumeric bins !!!

If x is underflow or overflow, attempt to extend the axis if TAxis::kCanExtend is true. Otherwise, return 0 or fNbins+1.

Definition at line 279 of file TAxis.cxx.

◆ FindBin() [2/3]

virtual Int_t TAxis::FindBin ( Double_t x ) const

inlinevirtual

Definition at line 103 of file TAxis.h.

◆ FindBin() [3/3]

Int_t TAxis::FindBin ( const char * label )

virtual

Find bin number with label.

If the List of labels does not exist create it and make the axis alphanumeric If one wants just to add a single label- just call TAxis::SetBinLabel If label is not in the list of labels do the following depending on the bit TAxis::kCanExtend; of the axis.

if the bit is set add the new label and if the number of labels exceeds the number of bins, double the number of bins via TH1::LabelsInflate
if the bit is not set and the histogram has labels in each bin set the bit automatically and consider the histogram as alphanumeric if histogram has only some bins with labels then the histogram is not consider alphanumeric and return -1

-1 is returned only when the Axis has no parent histogram

Definition at line 324 of file TAxis.cxx.

◆ FindFixBin() [1/2]

Int_t TAxis::FindFixBin ( Double_t x ) const

virtual

Find bin number corresponding to abscissa x.

Identical to TAxis::FindBin except that if x is an underflow/overflow no attempt is made to extend the axis.

Definition at line 405 of file TAxis.cxx.

◆ FindFixBin() [2/2]

Int_t TAxis::FindFixBin ( const char * label ) const

virtual

Find bin number with label.

If the List of labels does not exist or the label doe not exist just return -1 . Do not attempt to modify the axis. This is different than FindBin

Definition at line 387 of file TAxis.cxx.

◆ GetBinCenter()

Double_t TAxis::GetBinCenter ( Int_t bin ) const

virtual

Return center of bin.

Definition at line 464 of file TAxis.cxx.

◆ GetBinCenterLog()

Double_t TAxis::GetBinCenterLog ( Int_t bin ) const

virtual

Return center of bin in log With a log-equidistant binning for a bin with low and up edges, the mean is : 0.5*(ln low + ln up) i.e.

sqrt(low*up) in logx (e.g. sqrt(10^0*10^2) = 10). Imagine a bin with low=1 and up=100 :

the center in lin is (100-1)/2=50.5
the center in log would be sqrt(1*100)=10 (!=log(50.5))

NB: if the low edge of the bin is negative, the function returns the bin center as computed by TAxis::GetBinCenter

Definition at line 487 of file TAxis.cxx.

◆ GetBinLabel()

const char * TAxis::GetBinLabel ( Int_t bin ) const

Return label for bin.

Definition at line 426 of file TAxis.cxx.

◆ GetBinLowEdge()

Double_t TAxis::GetBinLowEdge ( Int_t bin ) const

virtual

Return low edge of bin.

Definition at line 504 of file TAxis.cxx.

◆ GetBinUpEdge()

Double_t TAxis::GetBinUpEdge ( Int_t bin ) const

virtual

Return up edge of bin.

Definition at line 514 of file TAxis.cxx.

◆ GetBinWidth()

Double_t TAxis::GetBinWidth ( Int_t bin ) const

virtual

Return bin width.

Definition at line 526 of file TAxis.cxx.

◆ GetCenter()

void TAxis::GetCenter ( Double_t * center ) const

virtual

Return an array with the center of all bins.

Definition at line 539 of file TAxis.cxx.

◆ GetCenterLabels()

Bool_t TAxis::GetCenterLabels ( ) const

inline

Definition at line 114 of file TAxis.h.

◆ GetCenterTitle()

Bool_t TAxis::GetCenterTitle ( ) const

inline

Definition at line 115 of file TAxis.h.

◆ GetDecimals()

Bool_t TAxis::GetDecimals ( ) const

inline

Definition at line 116 of file TAxis.h.

◆ GetFirst()

Int_t TAxis::GetFirst ( ) const

Return first bin on the axis i.e.

1 if no range defined NOTE: in some cases a zero is returned (see TAxis::SetRange)

Definition at line 444 of file TAxis.cxx.

◆ GetLabels()

THashList* TAxis::GetLabels ( ) const

inline

Definition at line 117 of file TAxis.h.

◆ GetLast()

Int_t TAxis::GetLast ( ) const

Return last bin on the axis i.e.

fNbins if no range defined NOTE: in some cases a zero is returned (see TAxis::SetRange)

Definition at line 455 of file TAxis.cxx.

◆ GetLowEdge()

void TAxis::GetLowEdge ( Double_t * edge ) const

virtual

Return an array with the lod edge of all bins.

Definition at line 548 of file TAxis.cxx.

◆ GetModifiedLabels()

TList* TAxis::GetModifiedLabels ( ) const

inline

Definition at line 118 of file TAxis.h.

◆ GetMoreLogLabels()

Bool_t TAxis::GetMoreLogLabels ( ) const

inline

Definition at line 120 of file TAxis.h.

◆ GetNbins()

Int_t TAxis::GetNbins ( ) const

inline

Definition at line 121 of file TAxis.h.

◆ GetNoExponent()

Bool_t TAxis::GetNoExponent ( ) const

inline

Definition at line 122 of file TAxis.h.

◆ GetParent()

virtual TObject* TAxis::GetParent ( ) const

inlinevirtual

Definition at line 123 of file TAxis.h.

◆ GetRotateTitle()

Bool_t TAxis::GetRotateTitle ( ) const

inline

Definition at line 124 of file TAxis.h.

◆ GetTicks()

const char * TAxis::GetTicks ( ) const

virtual

Return the ticks option (see SetTicks)

Definition at line 572 of file TAxis.cxx.

◆ GetTimeDisplay()

virtual Bool_t TAxis::GetTimeDisplay ( ) const

inlinevirtual

Definition at line 126 of file TAxis.h.

◆ GetTimeFormat()

virtual const char* TAxis::GetTimeFormat ( ) const

inlinevirtual

Definition at line 127 of file TAxis.h.

◆ GetTimeFormatOnly()

const char * TAxis::GetTimeFormatOnly ( ) const

virtual

Return only the time format from the string fTimeFormat.

Definition at line 557 of file TAxis.cxx.

◆ GetTitle()

const char* TAxis::GetTitle ( ) const

inlinevirtual

Returns title of object.

This default method returns the class title (i.e. description). Classes that give objects a title should override this method.

Reimplemented from TNamed.

Definition at line 129 of file TAxis.h.

◆ GetXbins()

const TArrayD* TAxis::GetXbins ( ) const

inline

Definition at line 130 of file TAxis.h.

◆ GetXmax()

Double_t TAxis::GetXmax ( ) const

inline

Definition at line 134 of file TAxis.h.

◆ GetXmin()

Double_t TAxis::GetXmin ( ) const

inline

Definition at line 133 of file TAxis.h.

◆ HasBinWithoutLabel()

Bool_t TAxis::HasBinWithoutLabel ( ) const

private

this helper function checks if there is a bin without a label if all bins have labels, the axis can / will become alphanumeric

Definition at line 583 of file TAxis.cxx.

◆ ImportAttributes()

void TAxis::ImportAttributes ( const TAxis * axis )

virtual

Copy axis attributes to this.

Definition at line 617 of file TAxis.cxx.

◆ IsAlphanumeric()

Bool_t TAxis::IsAlphanumeric ( )

inline

Definition at line 84 of file TAxis.h.

◆ IsVariableBinSize()

Bool_t TAxis::IsVariableBinSize ( ) const

inline

Definition at line 136 of file TAxis.h.

◆ LabelsOption()

void TAxis::LabelsOption ( Option_t * option = "h" )

virtual

Set option(s) to draw axis with labels option can be:

"a" sort by alphabetic order
">" sort by decreasing values
"<" sort by increasing values
"h" draw labels horizontal
"v" draw labels vertical
"u" draw labels up (end of label right adjusted)
"d" draw labels down (start of label left adjusted)

Definition at line 599 of file TAxis.cxx.

◆ operator=()

TAxis & TAxis::operator= ( const TAxis & orig )

Assignment operator.

Definition at line 111 of file TAxis.cxx.

◆ RotateTitle()

void TAxis::RotateTitle ( Bool_t rotate = kTRUE )

inline

Rotate title by 180 degrees.

By default the title is drawn right adjusted. If rotate is TRUE, the title is left adjusted at the end of the axis and rotated by 180 degrees

Definition at line 193 of file TAxis.h.

◆ SaveAttributes()

void TAxis::SaveAttributes	(	std::ostream &	out,
		const char *	name,
		const char *	subname
	)

virtual

Save axis attributes as C++ statement(s) on output stream out.

Reimplemented from TAttAxis.

Definition at line 647 of file TAxis.cxx.

◆ Set() [1/3]

void TAxis::Set	(	Int_t	nbins,
		Double_t	xmin,
		Double_t	xmax
	)

virtual

Initialize axis with fix bins.

Definition at line 717 of file TAxis.cxx.

◆ Set() [2/3]

void TAxis::Set	(	Int_t	nbins,
		const Float_t *	xbins
	)

virtual

Initialize axis with variable bins.

Definition at line 729 of file TAxis.cxx.

◆ Set() [3/3]

void TAxis::Set	(	Int_t	nbins,
		const Double_t *	xbins
	)

virtual

Initialize axis with variable bins.

Definition at line 747 of file TAxis.cxx.

◆ SetAlphanumeric()

void TAxis::SetAlphanumeric ( Bool_t alphanumeric = kTRUE )

Set axis alphanumeric.

Definition at line 765 of file TAxis.cxx.

◆ SetBinLabel()

void TAxis::SetBinLabel	(	Int_t	bin,
		const char *	label
	)

virtual

Set label for bin.

If no label list exists, it is created. If all the bins have labels, the axis becomes alphanumeric and extendable. New labels will not be added with the Fill method but will end-up in the underflow bin. See documentation of TAxis::FindBin(const char*)

Definition at line 809 of file TAxis.cxx.

◆ SetCanExtend()

void TAxis::SetCanExtend ( Bool_t canExtend )

inline

Definition at line 86 of file TAxis.h.

◆ SetDecimals()

void TAxis::SetDecimals ( Bool_t dot = kTRUE )

inline

Sets the decimals flag By default, blank characters are stripped, and then the label is correctly aligned.

If the dot is the last character of the string, it is also stripped, unless this option is specified.

Definition at line 203 of file TAxis.h.

◆ SetDefaults()

void TAxis::SetDefaults ( )

virtual

Set axis default values (from TStyle)

Definition at line 789 of file TAxis.cxx.

◆ SetDrawOption()

virtual void TAxis::SetDrawOption ( Option_t * option = "" )

inlinevirtual

Set drawing option for object.

This option only affects the drawing style and is stored in the option field of the TObjOptLink supporting a TPad's primitive list (TList). Note that it does not make sense to call object.SetDrawOption(option) before having called object.Draw().

Reimplemented from TObject.

Definition at line 149 of file TAxis.h.

◆ SetLimits()

virtual void TAxis::SetLimits	(	Double_t	xmin,
		Double_t	xmax
	)

inlinevirtual

Definition at line 154 of file TAxis.h.

◆ SetMoreLogLabels()

void TAxis::SetMoreLogLabels ( Bool_t more = kTRUE )

inline

Set the kMoreLogLabels bit flag When this option is selected more labels are drawn when in log scale and there is a small number of decades (<3).

The flag (in fBits) is passed to the drawing function TGaxis::PaintAxis

Definition at line 213 of file TAxis.h.

◆ SetNoAlphanumeric()

void TAxis::SetNoAlphanumeric ( Bool_t noalpha = kTRUE )

inline

Definition at line 87 of file TAxis.h.

◆ SetNoExponent()

void TAxis::SetNoExponent ( Bool_t noExponent = kTRUE )

inline

Set the NoExponent flag By default, an exponent of the form 10^N is used when the label value are either all very small or very large.

The flag (in fBits) is passed to the drawing function TGaxis::PaintAxis

Definition at line 223 of file TAxis.h.

◆ SetParent()

virtual void TAxis::SetParent ( TObject * obj )

inlinevirtual

Definition at line 157 of file TAxis.h.

◆ SetRange()

void TAxis::SetRange	(	Int_t	first = `0`,
		Int_t	last = `0`
	)

virtual

Set the viewing range for the axis from bin first to last.

To set a range using the axis coordinates, use TAxis::SetRangeUser.

If first == last == 0 or if last < first or if the range specified does not intersect at all with the maximum available range [0, fNbins + 1], then the range is reset by removing the bit TAxis::kAxisRange. In this case the functions TAxis::GetFirst() and TAxis::GetLast() will return 1 and fNbins.

If the range specified partially intersects [0, fNbins + 1], then the intersection range is set. For instance, if first == -2 and last == fNbins, then the set range is [0, fNbins] (fFirst = 0 and fLast = fNbins).

NOTE: for historical reasons, SetRange(0,0) resets the range even though Bin 0 is technically reserved for the underflow; in order to set the range of the axis so that it only includes the underflow, use SetRange(a,0), where a < 0

Definition at line 903 of file TAxis.cxx.

◆ SetRangeUser()

void TAxis::SetRangeUser	(	Double_t	ufirst,
		Double_t	ulast
	)

virtual

Set the viewing range for the axis from ufirst to ulast (in user coordinates).

To set a range using the axis bin numbers, use TAxis::SetRange.

Definition at line 928 of file TAxis.cxx.

◆ SetTicks()

void TAxis::SetTicks ( Option_t * option = "+" )

virtual

Set ticks orientation.

option = "+" ticks drawn on the "positive side" (default) option = "-" ticks drawn on the "negative side" option = "+-" ticks drawn on both sides

Definition at line 954 of file TAxis.cxx.

◆ SetTimeDisplay()

virtual void TAxis::SetTimeDisplay ( Int_t value )

inlinevirtual

Definition at line 161 of file TAxis.h.

◆ SetTimeFormat()

void TAxis::SetTimeFormat ( const char * tformat = "" )

virtual

Change the format used for time plotting.

The format string for date and time use the same options as the one used in the standard strftime C function, i.e. : for date :

     %a abbreviated weekday name
     %b abbreviated month name
     %d day of the month (01-31)
     %m month (01-12)
     %y year without century

for time :

     %H hour (24-hour clock)
     %I hour (12-hour clock)
     %p local equivalent of AM or PM
     %M minute (00-59)
     %S seconds (00-61)
     %% %

This function allows also to define the time offset. It is done via F which should be appended at the end of the format string. The time offset has the following format: 'yyyy-mm-dd hh:mm:ss' Example:

     h = new TH1F("Test","h",3000,0.,200000.);
     h->GetXaxis()->SetTimeDisplay(1);
     h->GetXaxis()->SetTimeFormat("%d\/%m\/%y%F2000-02-28 13:00:01");

This defines the time format being "dd/mm/yy" and the time offset as the February 28th 2003 at 13:00:01

If F is not specified, the time offset used will be the one defined by: gStyle->SetTimeOffset. For example like that:

     TDatime da(2003,02,28,12,00,00);
     gStyle->SetTimeOffset(da.Convert());

Definition at line 1002 of file TAxis.cxx.

◆ SetTimeOffset()

void TAxis::SetTimeOffset	(	Double_t	toffset,
		Option_t *	option = `"local"`
	)

virtual

Change the time offset If option = "gmt", set display mode to GMT.

Definition at line 1028 of file TAxis.cxx.

◆ UnZoom()

void TAxis::UnZoom ( )

virtual

Reset first & last bin to the full range.

Definition at line 1114 of file TAxis.cxx.

◆ ZoomOut()

void TAxis::ZoomOut	(	Double_t	factor = `0`,
		Double_t	offset = `0`
	)

virtual

Zoom out by a factor of 'factor' (default =2) uses previous zoom factor by default Keep center defined by 'offset' fixed ie.

-1 at left of current range, 0 in center, +1 at right

Definition at line 1186 of file TAxis.cxx.

Member Data Documentation

◆ fBits2

UShort_t TAxis::fBits2

private

Definition at line 39 of file TAxis.h.

◆ fFirst

Int_t TAxis::fFirst

private

Definition at line 37 of file TAxis.h.

◆ fLabels

THashList* TAxis::fLabels

private

Object owning this axis.

Definition at line 43 of file TAxis.h.

◆ fLast

Int_t TAxis::fLast

private

Definition at line 38 of file TAxis.h.

◆ fModLabs

TList* TAxis::fModLabs

private

Definition at line 44 of file TAxis.h.

◆ fNbins

Int_t TAxis::fNbins

private

Definition at line 33 of file TAxis.h.

◆ fParent

TObject* TAxis::fParent

private

Definition at line 42 of file TAxis.h.

◆ fTimeDisplay

Bool_t TAxis::fTimeDisplay

private

Definition at line 40 of file TAxis.h.

◆ fTimeFormat

TString TAxis::fTimeFormat

private

Definition at line 41 of file TAxis.h.

◆ fXbins

TArrayD TAxis::fXbins

private

Definition at line 36 of file TAxis.h.

◆ fXmax

Double_t TAxis::fXmax

private

Definition at line 35 of file TAxis.h.

◆ fXmin

Double_t TAxis::fXmin

private

Definition at line 34 of file TAxis.h.

Libraries for TAxis:

[legend]

Public Types

Public Member Functions

Private Types

Private Member Functions

Private Attributes

Additional Inherited Members

Member Enumeration Documentation

◆ anonymous enum

◆ EStatusBits

Constructor & Destructor Documentation

◆ TAxis() [1/4]

◆ TAxis() [2/4]

◆ TAxis() [3/4]

◆ TAxis() [4/4]

◆ ~TAxis()

Member Function Documentation

◆ CanBeAlphanumeric()

◆ CanExtend()

◆ CenterLabels()

◆ CenterTitle()

◆ ChangeLabel()

◆ ChooseTimeFormat()

◆ Copy()

◆ Delete()

◆ DistancetoPrimitive()

◆ DrawClone()

◆ ExecuteEvent()

◆ FindBin() [1/3]

◆ FindBin() [2/3]

◆ FindBin() [3/3]

◆ FindFixBin() [1/2]

◆ FindFixBin() [2/2]

◆ GetBinCenter()

◆ GetBinCenterLog()

◆ GetBinLabel()

◆ GetBinLowEdge()

◆ GetBinUpEdge()

◆ GetBinWidth()

◆ GetCenter()

◆ GetCenterLabels()

◆ GetCenterTitle()

◆ GetDecimals()

◆ GetFirst()

◆ GetLabels()

◆ GetLast()

◆ GetLowEdge()

◆ GetModifiedLabels()

◆ GetMoreLogLabels()

◆ GetNbins()

◆ GetNoExponent()

◆ GetParent()

◆ GetRotateTitle()

◆ GetTicks()

◆ GetTimeDisplay()

◆ GetTimeFormat()

◆ GetTimeFormatOnly()

◆ GetTitle()

◆ GetXbins()

◆ GetXmax()

◆ GetXmin()

◆ HasBinWithoutLabel()

◆ ImportAttributes()

◆ IsAlphanumeric()

◆ IsVariableBinSize()

◆ LabelsOption()

◆ operator=()

◆ RotateTitle()

◆ SaveAttributes()

◆ Set() [1/3]

◆ Set() [2/3]

◆ Set() [3/3]

◆ SetAlphanumeric()

◆ SetBinLabel()

◆ SetCanExtend()

◆ SetDecimals()

◆ SetDefaults()

◆ SetDrawOption()

◆ SetLimits()

◆ SetMoreLogLabels()

◆ SetNoAlphanumeric()