//**************************************************************************
//* RayTrace analysis directory
//*
//* 20060221 K.Hoshina
//**************************************************************************

// programs

Raytrace.C:
	executes raytrace program and store photons into TFile.
	in the end of run, it outputs random seed into random_seed.txt.
	If random_seed.txt is not empty, the script reads last line of the 
	file at the beginning of the run and use it as new random seed.
        If you want to store stepping history, call

	raytrace->SetStoreHistory(kTRUE);    // store stepping history: large filesize

	inside the script.

	usage:
	$ root -b -q Raytrace.C\(10000,\"test.root\"\)  

	arguments: nphotons(int), outfilename

Plot4D.C:
	requires output of raytrace.C and fill geometrical & timing
	informations into TH4D histgrams.

	usage:
	$ root -b -q Plot4D.C\(\"test.root\",\"test_out.root\",\"recreate\"\)

	arguments: infilename, outfilename, option ("recreate" or "update")
	if you choose "update" option, it updates old outputfile.

View4D.C:
	Draw 3D hist and 1D timing hist at (x,y,z) from TH4D histgram.
	
	usage:
        $ root -l View4D.C\(\"test_out.root\",125,0.995,90,180\)

	arguments: infilename, distance(int, [m]), x, y, z (double) 

Plot3D.C:
	same as Plot4D.C, but fills TH3D

Plot3DDebug.C:
	same as Plot3D.C, but dumps out scattering history

Normalize.C:
	normalize histograms to use the hist as a PDF table


// shell scripts

testrun.sh:
	example script to execute raytrace program 
        and generate TH4D histgram.

	usage:
	$ sh testrun.sh

manyrun.sh:
	run Raytrace.C as many as given number (count).
	each run contains 100k event.
	output file name would be "raytrace100k_$count.root".

	usage:
	$ sh manyrun.sh 100

	arguments: max number of repeated count

merge4D.sh:
	merge photons generated by the manyrun.sh into one TH4D histogram.

	usage:
	$ sh merge.sh 100

	arguments: max number of reading files

merge3D.sh:
	same as merge4D.sh but for TH3D output
	
// python script

dom_position.py:
	utilitiy to cauculate a geometorical parameters of receiver doms...

	usage:
	$ python dom_position.py