Picture Books New

Picture Books (New)

Introduction

There is now a program to generate picture books easier than last time. It's located in analyzer/picture_books/rootana and has a very similar interface to the one in rootana (not a coincidence).

Running

Here's the command to run the program:

> ./picture_book.exe -d <directory> -o output.tex -r <first> <last> -m test.txt

where <directory> is the location where all the output ROOT files from rootana are located (note that these should have the format out0xxxx.root), <first> and <last> are the initial and final run numbers you want to run over (don't worry if some of the output files in that range don't exist - the program will ignore them). If you only want to generate plots from one run then just use -r n n+1 where n is the run number you want.

Config File

The config file is very similar in format to the one for rootana. Here's an example which also shows all the possible options:

[CHAPTERS]
Germanium Amplitudes
Trend Amplitudes
Times
TDP TDiffs
TDP Amplitudes

[Germanium Amplitudes]
module=PlotAmplitude
plot_type=Amplitude
sub_plot_type=Ge
logX=true
x_low=100
x_high=1000

[Trend Amplitudes]
module=PlotAmplitude
plot_type=Amplitude
trend_plot=true
draw_option=COLZ
logZ=true

[Times]
module=PlotTime
plot_type=Time
logY=true
y_low=100
y_high=1000

[TDP TDiffs]
module=PlotTDPs
plot_type=_tdiff
draw_option=COLZ
logZ=true
z_low=100
z_high=1000

[TDP Amplitudes]
module=PlotTDPs
plot_type=__amp
draw_option=COLZ
logZ=true
stats_box=true
y_high=3000
x_low=1000

In the [CHAPTERS] section we have the name of each chapter and under each individual chapter section we have the options that dictate what the plots will look like for that chapter.

Config Options

The possible options are:

Option	Type	Default	Description
module	string	"Not specified"	This is a compulsory option that is the name of the directory that houses the plots you want printing for each chapter (usually the module name)
plot_type	string	"all"	This option can be used to specify a subset of the plots in the given folder by searching the histogram name for the given string (e.g. if you only want the TDiff plots from the PlotTDPs folder then set plot_type=_tdiff)
sub_plot_type	string	"all"	The same as plot_type but just in case you want to take a further subset
draw_option	string	""	The standard ROOT option that will be passed to TH1::Draw() e.g. "COLZ"
stats_box	bool	false	Do you want the stats box on the plot?
trend_plot	bool	false	Do you want to combine the individual run plots into a trend plot for this chapter? (Note can only be used on TH1F histograms)
logX/Y/Z	bool	false	Do you want this axis to be on a log scale?
x/y/z_low	int	-999999	What you want the lower limit on this axis to be set to (if you want it changing)
x/y/z_high	int	-999999	What you want the upper limit on this axis to be set to (if you want it changing)

Conclusion

Hopefully, that all makes sense. If you use it and find any bugs or want an option added to the code then don't hesitate to open an issue on GitHub.