small fixes & docu

Author: tboldagh

README.md

@@ -8,7 +8,7 @@ Python version 3 is required (tested on 3.9).
 from fast import *
 h = get(_file0, "histoX")
 h = get(_file0, "histoY")
-cnv() # a canvas (can be skipped)
+cnv() # a canvas
 frame((10, 0, 10), (10, 0, 100)) # define axes ranges (not needed if histograms have reasonable ranges already), but often convenient to use
 axis("size [mm]", "count") # label axes (not needed if original histograms have reasonably named axes)
 
@@ -50,7 +50,7 @@ In addition they key can be supplemented by move/resize directives that are:
 * `n` to make object narrower and 
 * `s` shorter
 * `t` taller. 
-Capital move directives move by 3 quants, i..e LU is the same as llluuu.
+Capital move directives move by 3 quants, i.e. LU is the same as llluuu.
 # piroot 
 Is a wrapper of python + ROOT that allows to execute following comamnds:
 ```
@@ -103,6 +103,29 @@ Some more examples of how to automate plots making can be found in scripts/examp
 *Beware, that there is very limited checks of command line options.*
 That is, it will not catch typos for you!
 
+# Included scripts
+There is couple of "small" scripts included that are ready to be used for making quite a diverse set of plots. First of all `draw.py` can be used to draw same histogram from multiple files, multiple hitograms from one file and nearly all settings of the plot can be customised from command line. See the source code for all the options.
+
+A simpler version, `simple.py` just good for signle histogram an only af few customizations available through command line.  
+
+A useful script called `content.py` can be used to list content of the ROOT file like this:
+``sh
+piroot -q file.root content.py 
+``
+
+For interactive exploration of the ROOT file with python the `browse.py` script is provided. It repackages ROOT file as full fledged python object. An example of interactive discovery of histogram and plotting is shown below.
+``sh
+piroot basic_checks.root browse.py
+...starting python
+- - - - - - - - - - - - - - - - - - - - welcome to piROOT - opening files - - - - - - - - - - - - - - - - - - - -
+.opening basic_checks.root
+. indexing file content (every / is dir, every * is object )
+///../../../../../.......................................................................................... done
+. this is interactive browser of the ROOT file
+. to browse file with tab completion start with typing: ro. and hit <TAB>
+ro.<TAB> << try this
+ro.basic_checks.NChR.Draw("hpe")
+``
 
 
 

fast/fast.py

@@ -477,7 +477,7 @@ def _followSubPads(pad, currentdir):
             _savePrimitive( obj )
 
 
-def _save(cnv, name, dumpROOT=False, base ="plots"):
+def _save(cnv, name, dumpROOT=False):
     anyformat=False
     if name.endswith(".pdf"):
         anyformat=True
@@ -514,19 +514,21 @@ def _saveToDir( cnv,  dirn,  name, dumpROOT=False):
     ROOT.gSystem.ChangeDirectory(dirn)
     # print(".. changed to directory "+dirn)
 
-    _save(cnv, name, dumpROOT, "")
+    _save(cnv, name, dumpROOT)
     ROOT.gSystem.ChangeDirectory(startdir)
 
 
-
 def save(name, dumpROOT=False):
     """Save the content of current canvas as PDF in plots/ subdir, if dumpROOT is enabled additional ROOT file with all the conntent is made"""
     global _cnvs
     global _legend
     global _legendpos
     ROOT.gStyle.SetOptTitle(0)
     _cnvs[-1].Update()
-    _saveToDir(_cnvs[-1], "plots", name, dumpROOT=dumpROOT)
+    import os
+    plotsdir = os.environ.get("QPLOTDIR", "plots") 
+
+    _saveToDir(_cnvs[-1], plotsdir, name, dumpROOT=dumpROOT)
 
 def s(name):
     """A abbreviated save"""
@@ -553,8 +555,8 @@ def _putlabelABS(locx, locy, text, sz=0.1):
         locx = 1 + locx
     if locy < 0:
         locy = 1 + locy
-    l = ROOT.TLatex(); #l.SetTextAlign(12);
-    l.SetTextSize(sz);
+    l = ROOT.TLatex() #l.SetTextAlign(12);
+    l.SetTextSize(sz)
     l.SetNDC()
     l.SetTextFont(42)
     l.SetTextColor(ROOT.kBlack)

fast/myop.py

@@ -33,7 +33,8 @@ def run_args(self):
 
     def save(self, filename):
         """ Save options for reuse """
-        fullfname="plots/"+filename+".sh"
+        import os
+        fullfname=os.environ.get("QPLOTDIR", "plots")+"/"+filename+".sh"
 
         with open(fullfname, "w") as f:            
             f.write('piroot ')