Working with HADES WebDB
HADES analysis workshop, Darmstadt, Germany, 31 January - 1 February 2012
Ilse Koenig, GSI Darmstadt
Outline:
• Version management in Oracle
•
•
•
•
•
Generic parameter container
HADES WebDB
Login
Folder structure
Examples
Version management in Oracle
1. Parameters are not stable, but may change from run to run
2. They may change for the same run over time (history)
3. They may come in different flavors (depending e.g. on an algorithm)
3-dimensional version management
history
invalid_since
2 different flavours (contexts)
(year 4000 for actual version)
For example: beam, simulation
version
automatically defined
date_create
runs
valid_since
valid_until (default year 4000)
defined by user
Analysis workshop GSI 2012
Working with WebDB
Ilse Koenig
2
Parameter versions
history
year 4000
parameter
release
version 3
version 4
version 1
history date
Version 1
version 2
date_create v2
invalid_since v1
During
a beam
time3 the
Later
new
versions
anduser
4
inserts the
a version
1.
replace
old ones
Each new run is initialized
with version
Before
a DST1.production we
do a beam time specific
parameter
release
Later he adds
a version 2.
“history
date
with
name”
New
runs are
then
initialized
with version 2.
Old versions can be retrieved
The
point date
of
withcrossing
an old history
run start and history date
defines the parameter version
version 1
date_create v1
runs
valid_since v1
valid_until v1
Analysis workshop GSI 2012
valid_since v2
year 4000
run start
Working with WebDB
Ilse Koenig
3
Generic parameter container HParCond
All parameters are stored as name – object pairs in the same set of tables
different versions
parameter container
parameter
name
type: Int_t, Float_t, Double_t, Char_t,
Text_t, UChar_t, class type
any class derived from TObject
decoded in the analysis interface
by ROOT streamer
object
stored as byte array (RAW or BLOB)
number of values (single value or array)
class version
streamer info, root version for ROOT classes
own version management
allows to add or discard (invalidate) a parameter
makes it (almost) code independent
Analysis workshop GSI 2012
Working with WebDB
Ilse Koenig
4
Login in HADES WebDB
Direct link:
http://webdb.gsi.de/pls/hades_webdb/hxsite.main
Click on Login button.
From HADES web page => internal => logbook => “HADES Oracle Database”
Pops up login form.
Login as user hades
…_oper
read only access (except beam time logbook)
detector specific write access (parameter validation, …)
Analysis workshop GSI 2012
Working with WebDB
Ilse Koenig
5
HADES WebDB: Root folder
user
Search in application
titles and descriptions
Analysis workshop GSI 2012
Working with WebDB
Ilse Koenig
6
HADES WebDB folders
Experiment infos, DAQ runs and logbooks
DAQ and Trbnet configuration, TRB TDC corrections
Monitoring of Magnet, Cryo and Cave temperatures and pressures
Root folder for interfaces to Slow Control data
Slow Control data stored online
Slow Control data for all beam times since 2010
Slow Control data for all beam times before 2010
Folder for RICH detector (since 2010)
Folder for MDC detector (since2010)
Folder for MDC detector (before 2010)
Folder for RPC detector (since 2010)
Folder for RPC detector (before2010)
ROOT folder for the analysis
Parameters in HADES analysis Hydra1 (runs before 2010)
Parameters in HADES analysis Hydra2 (runs after 2010)
Simulation projects and runs
Geometry used by simulation and analysis
Run validation for DST production
HADES Analysis Logbook (not used anymore)
HADES institutes, people and author lists
Documentation of Oracle accounts and utility software
Analysis workshop GSI 2012
Working with WebDB
Ilse Koenig
7
HADES WebDB folder Hydra2 Parameters
Starting from a beam time it gives access to (almost) all parameter
containers and shows changes since last parameter release
Folder for condition-style parameter containers
Folder for tree-style parameter containers
Analysis workshop GSI 2012
Working with WebDB
Ilse Koenig
8
HADES WebDB: Hydra2 Parameters
Help
all parameter containers
grouped by shared libraries
with links to the data
Analysis workshop GSI 2012
has changed
Working with WebDB
Ilse Koenig
9
HADES WebDB: Parameter sets of HRpcClusFPar
Back to folder
Link to the data
Form to compare sets for different contexts, runs, history dates
Analysis workshop GSI 2012
Working with WebDB
Ilse Koenig
10
HADES WebDB: Data of HRpcClusFPar
Analysis workshop GSI 2012
Working with WebDB
Ilse Koenig
11