Project

General

Profile

MAUSUser » History » Version 23

Tunnell, Christopher, 23 August 2011 18:01

1 1 Rogers, Chris
h1. MAUS User Documentation
2
3 4 Rogers, Chris
MAUS usage is handled by several applications that enable basic usage of the framework. Each application runs several modules against a particular configuration. The particular modules that the application runs, and the configuration that is run against, can all be modified by the user.
4
5 18 Rogers, Chris
h2. Offline data access
6
7
To get at the MICE data, look here:
8
9
http://micewww.pp.rl.ac.uk/projects/computing-software/wiki
10
11 1 Rogers, Chris
h2. Applications
12
13 17 Rogers, Chris
There are several applications in the MAUS schema
14 2 Rogers, Chris
15 19 Tunnell, Christopher
h2. Getting Help
16
17 21 Tunnell, Christopher
When filling out a support request, you will almost certainly be asked some of the following information so it is useful for us if you try to answer as many of the questions as possible from the list below.
18
19
# What version of MAUS are you using?  Are you using the trunk or a release?  If you are using your own branch, where can we see the code and what have you changed?  Is it reproducible in the trunk?
20
# What version of Linux or Mac are you using?  What distribution?
21 22 Tunnell, Christopher
# What version of gcc are you using: <pre>g++ --version</pre>
22 21 Tunnell, Christopher
# If you are seeing weird behavior when running a command, please send us the output file and also the terminal output.  You can pipe terminal output to a file by doing for example: <pre>my_application.py 1>maus_standard_output 2>maus_standard_errors</pre>
23 19 Tunnell, Christopher
24 23 Tunnell, Christopher
After making an effort to answer these questions, please post your support query to the "support tracker":http://micewww.pp.rl.ac.uk/projects/maus/issues/new where somebody will answer your questions.
25
26 19 Tunnell, Christopher
Please *do not* email the code maintainers directly because we will send you to this webpage and frequently accidentally miss emails.  This website is the way you are not forgotten.
27
28 1 Rogers, Chris
h2. Configuration manipulation
29
30
MAUS uses a set of user-modifiable files to control the application configuration. Variables such as input geometry, field arrangement and detector parameters can all be modified by the user.
31
32
* Documentation on geometry file generation is available in "pdf":http://www.mice.iit.edu/software/g4mice_doc/Mice_Module-2-4-1.pdf or "html":http://www.mice.iit.edu/software/g4mice_doc/Mice_Module-2-4-1.html format.
33
* Documentation on global run controls is available in "html":http://www.mice.iit.edu/software/g4mice_doc/datacards-2-4-1.html format.
34
* [[Materials-2-4-1|List of valid materials]]
35
36
h2. Changing application modules
37
38 16 Rogers, Chris
MAUS uses a modular structure in its applications. Uses can alter the modules which a particular application runs or define their own application. The different modules are listed in the [[Components]] section.
39 13 Rogers, Chris
40
h2. File IO
41
42 15 Rogers, Chris
Data is passed between different parts of the framework in tree-like structured data files. The tree structure is described in the [[DataStructure]] section.