TAxis

class TAxis : public TNamed, public TAttAxis

    public:

                          TAxis()
                          TAxis(Int_t nbins, Double_t xmin, Double_t xmax)
                          TAxis(Int_t nbins, const Double_t* xbins)
                          TAxis(const TAxis& axis)
                  virtual ~TAxis()
             virtual void CenterLabels(Bool_t center = kTRUE)
             virtual void CenterTitle(Bool_t center = kTRUE)
              const char* ChooseTimeFormat(Double_t axislength = 0) const
           static TClass* Class()
             virtual void Copy(TObject& axis) const
             virtual void Delete(Option_t* = "")
            virtual Int_t DistancetoPrimitive(Int_t px, Int_t py)
         virtual TObject* DrawClone(Option_t* = "") const
             virtual void ExecuteEvent(Int_t event, Int_t px, Int_t py)
            virtual Int_t FindBin(Double_t x)
            virtual Int_t FindBin(const char* label)
            virtual Int_t FindFixBin(Double_t x) const
         virtual Double_t GetBinCenter(Int_t bin) const
              const char* GetBinLabel(Int_t bin) const
         virtual Double_t GetBinLowEdge(Int_t bin) const
         virtual Double_t GetBinUpEdge(Int_t bin) const
         virtual Double_t GetBinWidth(Int_t bin) const
             virtual void GetCenter(Double_t* center) const
                   Bool_t GetCenterLabels() const
                   Bool_t GetCenterTitle() const
                   Bool_t GetDecimals() const
                    Int_t GetFirst() const
               THashList* GetLabels()
                    Int_t GetLast() const
             virtual void GetLowEdge(Double_t* edge) 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
           virtual Bool_t GetTimeDisplay() const
      virtual const char* GetTimeFormat() const
      virtual const char* GetTimeFormatOnly() const
      virtual const char* GetTitle() const
           const TArrayD* GetXbins() const
                 Double_t GetXmax() const
                 Double_t GetXmin() const
             virtual void ImportAttributes(const TAxis* axis)
          virtual TClass* IsA() const
             virtual void LabelsOption(Option_t* option = "h")
                   TAxis& operator=(const TAxis&)
             virtual void RotateTitle(Bool_t rotate = kTRUE)
             virtual void SaveAttributes(ofstream& out, const char* name, const char* subname)
             virtual void Set(Int_t nbins, Double_t xmin, Double_t xmax)
             virtual void Set(Int_t nbins, const Float_t* xbins)
             virtual void Set(Int_t nbins, const Double_t* xbins)
             virtual void SetBinLabel(Int_t bin, const char* label)
             virtual void SetDecimals(Bool_t dot = kTRUE)
             virtual void SetDefaults()
             virtual void SetDrawOption(Option_t* = "")
             virtual void SetLimits(Double_t xmin, Double_t xmax)
             virtual void SetMoreLogLabels(Bool_t more = kTRUE)
             virtual void SetNoExponent(Bool_t noExponent = kTRUE)
             virtual void SetParent(TObject* obj)
             virtual void SetRange(Int_t first = 0, Int_t last = 0)
             virtual void SetRangeUser(Double_t ufirst, Double_t ulast)
             virtual void SetTicks(Option_t* option = "+")
             virtual void SetTimeDisplay(Int_t value)
             virtual void SetTimeFormat(const char* format = "")
             virtual void SetTimeOffset(Double_t toffset, Option_t* option = "local")
             virtual void ShowMembers(TMemberInspector& insp, char* parent)
             virtual void Streamer(TBuffer& b)
                     void StreamerNVirtual(TBuffer& b)
             virtual void UnZoom()

Data Members

    private:

           Int_t fNbins        Number of bins
        Double_t fXmin         low edge of first bin
        Double_t fXmax         upper edge of last bin
         TArrayD fXbins        Bin edges array in X
           Int_t fFirst        first bin to display
           Int_t fLast         last bin to display
        UShort_t fBits2        second bit status word
          Bool_t fTimeDisplay  on/off displaying time values instead of numerics
         TString fTimeFormat   Date&time format, ex: 09/12/99 12:34:00
        TObject* fParent       !Object owning this axis
      THashList* fLabels       List of labels

    public:

      static const enum TAxis:: kTickPlus       
      static const enum TAxis:: kTickMinus      
      static const enum TAxis:: kAxisRange      
      static const enum TAxis:: kCenterTitle    
      static const enum TAxis:: kCenterLabels   
      static const enum TAxis:: kRotateTitle    
      static const enum TAxis:: kPalette        
      static const enum TAxis:: kNoExponent     
      static const enum TAxis:: kLabelsHori     
      static const enum TAxis:: kLabelsVert     
      static const enum TAxis:: kLabelsDown     
      static const enum TAxis:: kLabelsUp       
      static const enum TAxis:: kIsInteger      
      static const enum TAxis:: kMoreLogLabels  
      static const enum TAxis:: kDecimals       

Class Description

 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.

*-*-*-*-*-*-*-*Axis constructor for axis with fix bin size*-*-*-*-*-*-*-*
*-*            ===========================================

*-*-*-*-*-*-*-*Axis constructor for variable bin size*-*-*-*-*-*-*-*-*-*-*
*-*            ======================================

   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

 Return kTRUE if kCenterLabels bit is set, kFALSE otherwise.

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

 Return kTRUE if kCenterTitle bit is set, kFALSE otherwise.

 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.

*-*-*-*-*-*-*-*-*-*Copy axis structure to another axis-*-*-*-*-*-*-*-*-*-*-*
*-*                ===================================

*-*-*-*-*-*-*-*-*-*-*Compute distance from point px,py to an axis*-*-*-*-*-*
*-*                  ============================================

*-*-*-*-*-*-*-*-*-*-*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.

*-*-*-*-*-*-*-*-*Find bin number corresponding to abscissa x-*-*-*-*-*-*
*-*              ===========================================

 If x is underflow or overflow, attempt to rebin histogram

 Find bin number with label.
 If label is not in the list of labels, add it.
 If the number of labels exceeds the number of bins, double the number
 of bins via TH1::LabelsInflate (if the histogram can be rebinned).

*-*-*-*-*-*-*-*-*Find bin number corresponding to abscissa x-*-*-*-*-*-*
*-*              ===========================================

 Return label for bin

             return first bin on the axis
       - 0 if no range defined

             return last bin on the axis
       - fNbins if no range defined

*-*-*-*-*-*-*-*-*-*-*Return center of bin*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*                  ====================

*-*-*-*-*-*-*-*-*-*-*Return low edge of bin-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*                  ======================

*-*-*-*-*-*-*-*-*-*-*Return up edge of bin-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*                  ======================

*-*-*-*-*-*-*-*-*-*-*Return bin width-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*                  ================

*-*-*-*-*-*-*-*-*Return an array with the center of all bins-*-*-*-*-*-*-*
*-*              ===========================================

*-*-*-*-*-*-*-*-*Return an array with the lod edge of all bins-*-*-*-*-*-*-*
*-*              =============================================

 Return *only* the time format from the string fTimeFormat

 return the ticks option (see SetTicks)

  Set option(s) to draw axis with labels
  option = "a" sort by alphabetic order
         = ">" sort by decreasing values
         = "<" sort by increasing values
         = "h" draw labels horizonthal
         = "v" draw labels vertical
         = "u" draw labels up (end of label right adjusted)
         = "d" draw labels down (start of label left adjusted)

 Return kTRUE if kRotateTitle bit is set, kFALSE otherwise.

 Copy axis attributes to this

    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

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

*-*-*-*-*-*-*-*-*Initialize axis with fix bins*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
*-*              =============================

*-*-*-*-*-*-*-*-*Initialize axis with variable bins*-*-*-*-*-*-*-*-*-*-*-*-*
*-*              ==================================

*-*-*-*-*-*-*-*-*Initialize axis with variable bins*-*-*-*-*-*-*-*-*-*-*-*-*
*-*              ==================================

 Set axis default values (from TStyle)

 Returns kTRUE if kDecimals bit is set, kFALSE otherwise.
 see TAxis::SetDecimals

 Set the Decimals flag
 By default, blank characters are stripped, and then the
 label is correctly aligned. The dot, if last character of the string,
 is also stripped, unless this option is specified.
 One can disable the option by calling axis.SetDecimals(kTRUE).
 The flag (in fBits2) is passed to the drawing function TGaxis::PaintAxis

 Set label for bin

          Set the axis limits

 Return kTRUE if kMoreLogLabels bit is set, kFALSE otherwise.

 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

 Returns kTRUE if kNoExponent bit is set, kFALSE otherwise.
 see TAxis::SetNoExponent

 Set the NoExponent flag
 By default, an exponent of the form 10^N is used when the label values
 are either all very small or very large.
 One can disable the exponent by calling axis.SetNoExponent(kTRUE).
 The flag (in fBits) is passed to the drawing function TGaxis::PaintAxis

  Set the viewing range for the axis from bin first to last
  To set a range using the axis coordinates, use TAxis::SetRangeUser.

  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.

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

*-*-*-*-*-*-*-*-*-*-*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());

 Change the time offset
 If option = "gmt" the time offset is treated as a GMT time.

 Stream an object of class TAxis.

 Reset first & last bin to the full range

Inline Functions

                  void Delete(Option_t* = "")
              TObject* DrawClone(Option_t* = "") const
            THashList* GetLabels()
                 Int_t GetNbins() const
              TObject* GetParent() const
                Bool_t GetTimeDisplay() const
           const char* GetTimeFormat() const
           const char* GetTitle() const
        const TArrayD* GetXbins() const
              Double_t GetXmin() const
              Double_t GetXmax() const
                  void SetDrawOption(Option_t* = "")
                  void SetParent(TObject* obj)
                  void SetTimeDisplay(Int_t value)
               TClass* Class()
               TClass* IsA() const
                  void ShowMembers(TMemberInspector& insp, char* parent)
                  void StreamerNVirtual(TBuffer& b)
                TAxis& operator=(const TAxis&)