Data Analysis Project

Introduction

The Data Analysis Project [DAP] aim is to provide fast tools (written in ISO C) to analyse the magnetic measurements done on series magnets for the LHC (20'000'000 measurements foreseen). It includes three different parts:

The Data Analysis Web [DAW] interfaces which provides ergonomic access to the DAT and makes analysis virtually possible from anywhere in the world.

The Data Analysis Tools [DAT] are 'command line' programs (named mtaxx) running on our Linux cluster. They will mainly be used for automatic data analysis and magnet report generation. They provide advanced data manipulation (including database access), parameters settings, data analysis and plots. They can be run in direct, batch or persistent mode. They are built on top of the mta library for all complex calculations. The available DAT are:

mtacp the coil parameters analysis tool
mtahp the head parameters analysis tool (under development)
mtamm the magnetic measurement analysis tool (under development)
mtahc the head calibration analysis tool (under development)
mtacf the coil factors analysis tool
mtamf the magnetic field analysis tool
mtafh the field harmonic analysis tool
mtahf the harmonic filter (averages & integrals) analysis tool (under development)
mtasa the standard analysis tool (not yet implemented)

The Data Analysis Library [DAL] (named mta) is a library specialized in the data analysis of the magnetic measurements done by the CERN-LHC/MTA group. The mta library is composed of modules specialized in various fields of magnet analysis. Each new module extends the possibilities of the library. The actual list of included/planned modules is:

coil provides services for the head and coil calibration computation.
losses provides services for field advance and AC losses analysis.
field provides services for field quality analysis.
math provides advanced math services (complex numbers, fft, optimization, etc...).
power will provide services for power tests analysis.
tables provides services for data input and output. Online tables documentation can be found here.
utils povides general purpose services (date, heap, list, string, etc...).

fftw

Settings

To use the DAT and the DAL, you just have to do

# DAP csh setup
if ( -r $prefix/scripts/mtadb_env.csh ) then
source $prefix/scripts/mtadb_env.csh
endif

# DAP sh setup
if [ -r $prefix/scripts/mtadb_env.sh ] ; then
. $prefix/scripts/mtadb_env.sh
fi

according to the shell you are using and where $prefix is the variable set in the .config file during installation. You can add these lines to the configuration file of your favorite shell.

If you are on an AFS client at CERN, replace the $prefix by

/afs/cern.ch/user/m/mtauser/mtadb.

Development

You can use the DAT directly if the settings are set up correctly.

To use the DAL, just put the line

#include <mta.h>

into your C code and compile your program with the

-I$MTADB_PATH/include -lmta

linking option. The $MTADB_PATH is set by the mta environment script described in section Settings

Documentation

PDF documentations on the DAT and the DAL modules are available in the doc directory of the DAP tree.

Download

Since the DAP is permanently under development, the only available download method is through the CVS access. If CVS is not available on your computer, you can ask a backup of the development tree to Laurent Deniau.

Installation

Edit the .config file in the root directory of the DAP development tree to set the installation parameters

prefix := install_directory_path

and do:

make install

More instructions on installation and configuration can be found in the README file.

Feedback

Any suggestions, comments and bugs reports must be send to Laurent Deniau.

CVS access

Read-only access to the DAP development tree is provided via remote-CVS to anyone on the net. Assuming you have CVS installed on your machine you can check out the sources with the following sequence of commands:

#setenv CVSROOT ":pserver:anoncvs@pclhc590.cern.ch:/cvs"
#cvs login
>CVS password: anoncvs
#cvs -z 6 co mta

Once you have got the repository checked out, the commands:

cd mta
cvs update -d

will synchronize your local copy with those in the repository.

Last stable release of the mta library can be checked out with the command:

#cvs -z 6 co -r release-1-3 mta

Read-write access is not provided.

See the CVS manual for additional information on how to use CVS.