TH1Editor

Class Description

                                                                      
  TH1Editor                                                           
  Editor for changing TH1 histogram attributes, rebinning & fitting.  
  For all possible draw options (there are a few which are not imple- 
  mentable in graphical user interface) see THistPainter::Paint in    
  root/histpainter/THistPainter.cxx                                   

/* */

/* */

  These changes can be made via the TH1Editor:                        
    Style Tab:                                                        
      'Line'     : change Line attributes (color, thickness)          
                   see TAttLineEditor                                 
      'Fill'     : change Fill attributes (color, pattern)            
                   see TAttFillEditor                                 
      'Title'    : TextEntry: set the title of the histogram          
      'Histogram': change the draw options of the histogram           
          'Plot' : Radiobutton: draw a 2D or 3D plot of the histogram 
                   according to the Plot dimension there will be      
                   different drawing possibilities (ComboBoxes/       
                   CheckBoxes)                                        
    2d Plot:                                                          
      'Error'   : ComboBox: add different error bars to the histogram 
                  (no errors, simple, ...,  see THistPainter::Paint   
      'Add'     : ComboBox: further things which can be added to the  
                  histogram (None, simple/smooth line, fill area      
      'Simple Drawing': CheckBox: draw a simple histogram without     
                  errors (= "HIST" drawoption). In combination with   
                  some other draw options an outer line is drawn on   
                  top of the histogram                                
      'Show markers': CheckBox: draw a marker on to of each bin (="P" 
                  drawoption)                                         
      'Draw bar chart': CheckBox: draw a bar chart (="B" drawoption)  
                  change the Fill Color with Fill in the Style Tab    
                  => will show Bar menue in the Style Tab             
      'Bar option': CheckBox: draw a bar chart (="BAR" drawoption)    
                  => will show Bar menue in the Style Tab             
    3d Plot:                                                          
      'Type'    : ComboBox: set histogram type Lego-Plot or Surface   
                  draw(Lego, Lego1.2, Surf, Surf1..5)                 
                  see THistPainter::Paint                             
      'Coords'  : ComboBox: set the coordinate system (Cartesian, ..  
                  Spheric) see THistPainter::Paint                    
      'Error'   : see 2D plot                                         
      'Bar'     : change the bar attributes                           
            'W' : change Bar Width                                    
            'O' : change Bar Offset                                   
      'Percentage': specifies the percentage of the bar which is drawn
                    brighter and darker (10% == BAR1 drawoption)      
      'Horizontal Bar': draw a horizontal bar chart                   
                                                                      
      'Marker'   : change the Marker attributes (color, appearance,   
                   thickness) see TAttMarkerEditor                    

/* */

      This Tab has two different layouts. One is for a histogram which
      is not drawn from an ntuple. The other one is available for a   
      histogram which is drawn from an ntuple. In this case the rebin 
      algorithm can create a rebinned histogram from the original data
      i.e. the ntuple.                                                
      To see te differences do:                                       
         TFile f("hsimple.root");                                     
         hpx->Draw("BAR1");        // non ntuple histogram            
         ntuple->Draw("px");       // ntuple histogram                
    Non ntuple histogram:                                             
       'Rebin': with the Slider the number of bins (shown in the field
                below the Slider) can be changed to any number which  
                divides the number of bins of the original histogram. 
                Pushing 'Apply' will delete the origin histogram and  
                replace it by the rebinned one on the screen          
                Pushing 'Ignore' the origin histogram will be restored
    Histogram drawn from an ntuple:                                   
       'Rebin'  with the slider the number of bins can be enlarged by 
                a factor of 2,3,4,5 (moving to the right) or reduced  
                by a factor of 1/2, 1/3, 1/4, 1/5                     
       'BinOffset': with the BinOffset slider the origin of the       
                histogram can be changed within one binwidth          
                Using this slider the effect of binning the data into 
                bins can be made visible => statistical fluctuations  
       'Axis Range': with the DoubleSlider it is possible to zoom into
                the specified axis range. It is also possible to set  
                the upper and lower limit in fields below the slider  
       'Delayed drawing': all the Binning sliders can set to delay    
                draw mode. Then the changes on the histogram are only 
                updated, when the Slider is released. This should be  
                activated if the redrawing of the histogram is too    
                time consuming.                                       

/* */

/* */

 Constructor of histogram attribute GUI.

 Create binning tab.

 Destructor of TH1 editor.

 Connect signals to slots.

 Check if object is able to configure with this editor.

 Pick up current values of histogram attributes.

 Slot connected to the histogram title setting.

 Slot connected to the show markers check box.

 Slot connected to the bar Add check box.

 Slot connected to the bar Add check box.

 Slot connected to fAddSimple check box for drawing a simple histogram
 without errors (== HIST draw option) in combination with some other 
 draw options. It draws an additional line on the top of the bins.

 Slot connected to the 'Plot' button group.

 Slot connected to the 2D radio button.

 Slot connected to the 3D radio button.

 Slot connected to the histogram type, the coordinate type, the error type
 and the Add combo box.

 Slot connected to the Bar Width of the Bar Charts.

 Slot connected to the Bar Offset of the Bar Charts.

 Slot connected to the bar percentage settings.

 Slot connected to the Horizontal Bar check button.

 Slot connected to the x-Slider for redrawing of the histogram 
 according to the new Slider range.

 Slot connected to the x-axis Range slider for initialising the
 values of the slider movement.

 Slot connected to the x-axis Range slider for finalizing the 
 values of the slider movement. 

 Slot connected to the number entry fields containing the Max/Min 
 value of the x-axis.

 Slot connected to the rebin slider in case of a not ntuple histogram
 Updates some other widgets which are related to the rebin slider.

 Slot connected to the rebin slider in case of a not ntuple histogram
 (does the Rebinning of the histogram). 

 Slot connected to the rebin slider in case of a not ntuple histogram.

 Slot connected to the BinNumber Slider in case of a ntuple histogram
 (does the Rebinning of the histogram). 

 Slot connected to the rebin slider in case of an ntuple histogram.
 It updates the BinNumberEntryField during the BinSlider movement.

 Slot connected to the Bin number entry of the Rebinning tab.

 Slot connected to the Bin number entry of the Rebinning tab.

 Slot connected to the OffSetSlider that saves the OldBinOffset 
 (nessesary for delay draw mode).

 Slot connected to the OffSetSlider.
 It changes the origin of the histogram inbetween a binwidth and
 rebin the histogram with the new Offset given by the Slider.

 Slot connected to the OffSetSlider.
 It changes the origin of the histogram inbetween a binwidth and
 rebin the histogram with the new offset given by the Slider.

 Slot connected to the OffSetNumberEntry which is related to the 
 OffSetSlider changes the origin of the histogram inbetween a binwidth.

 Slot connected to the Apply button of the Binning tab.

 Slot connected to the Cancel button of the Binning tab.

 Returns the selected histogram type (HIST, LEGO1-2, SURF1-5).

 Return the selected coordinate system of the histogram (POL,CYL,SPH,PSR).

 Return the selected error type (E,E1-5).

 Return the selected shape of the histogram (C, L, LF2).

 Create histogram type combo box.

 Create coordinate system type combo box.

 Create error type combo box.

 Create Line/Bar combo box.

 Create Percentage combo box for bar option.

 Change the error combo box entry.

 Paint a 3D box.

 Return an array of dividers of n (without the trivial divider n).
 The number of dividers is saved in the first entry.