I Want to:-

Here we have a little problem, for instructions on how to get a copy of the documentation is, as you might suspect, in the documentation! If SNOMAN has already been installed at your site then then you already have all the documetation. If not, then the best best thing is to contact a neighbouring site and get a copy from them or to contact:-

n.west1@physics.oxford.ac.uk

The Next Step

The next step you might consider is to:-

Get a copy of the code and install it

Go Back to the Snoman Companion Top Page

I want to ... Get a copy of the code and install it

Prerequisites

If you have not done so already, you should:-

Get a copy of the Documentation
Learn what documentation exists and how it is organised

Get a copy of the code and install it

Full instructions can be found in:-

...snoman/tools/exe/install.doc

A summary of this can also be found at the start of the section SNOMAN - Operating Instructions of the User Manual

The Next Step

The next step you might consider is to:-

Run SNOMAN

Go Back to the Snoman Companion Top Page

I want to ... Run SNOMAN

Prerequisites

If you have not done so already, you should:-

Learn what SNOMAN is and what it can do

Run SNOMAN

This is subdivide into the following goals:-

Run the Standard Monte Carlo job
Change the Standard Monte Carlo job
Look at SNOMAN Output
Look at the Data Structure Output

The Next Step

The next step you might consider is to:-

Write Code to Access the Data Structure
Add Code to SNOMAN

Go Back to the Snoman Companion Top Page

Run the Standard Monte Carlo job

Prerequisites

If you have not done so already, you should:-

Learn what SNOMAN is and what it can do

and, you might want to:-

Learn what documentation exists and how it is organised
Learn about the Data Structures of SNOMAN

Run the Standard Monte Carlo job

See section SNOMAN - Operating Instructions / Running of the the Standard Jobs. User Manual

The Next Step

The next step you might consider is to:-

Change the Standard Monte Carlo job
Look at SNOMAN Output

Go Back to the Snoman Companion Top Page

I want to ... Change the Standard Monte Carlo job

Prerequisites

If you have not done so already, you should:-

Run the Standard Monte Carlo job

Change the Standard Monte Carlo job

You control what SNOMAN does via Command Files and Titles Files See section SNOMAN - Operating Instructions / Running Your Own Jobs of the User Manual

The Next Step

The next step you might consider is to:-

Look at SNOMAN Output

Go Back to the Snoman Companion Top Page

I want to ... Look at SNOMAN output

Prerequisites

If you have not done so already, you should:-

Run the Standard Monte Carlo job

Look at SNOMAN output

There are 4 types of output, so this goal is subdided into:-

Look at Printed Output
Look at n-tuple Output
Look at Graphical Output
Look at the Data Structure Output

The Next Step

The next step you might consider is to:-

Write Code to Access the Data Structure

Go Back to the Snoman Companion Top Page

I want to ... Look at Printed Output

Prerequisites

If you have not done so already, you should:-

Run the Standard Monte Carlo job

Look at Printed Output

SNOMAN produces two types of printed output:-

Screen output. This is written to FORTRAN unit IQPRNT (normally the screen). The output is kept to a minimum. The idea is that there is just sufficient information for the user to confirm that everything is O.K. The screen output contains:-
- What SNOMAN has been asked to do as defined by the Command Files and Titles Files
- Its progress through the job, by showing the percentage completed at regular intervals.
- Brief messages about any serious errors encountered.
- End of job summaries.
Log output. This is written to FORTRAN unit IQLOG, which writes to a file with a unique name (the name is given at the start of the screen output). This gives all the output that was shown on the screen apart from the percentage complete. Additional information is written to the log file including:-
- More information about errors as necessary.
- Statistics on the ZEBRA memories.

The Next Step

The next step you might consider is to:-

Look at n-tuple Output

Go Back to the Snoman Companion Top Page

I want to ... Look at n-tuple Output

Prerequisites

If you have not done so already, you should:-

Run the Standard Monte Carlo job
Look at Printed Output

Look at n-tuple Output

This goal is subdivided into:-

Understand What an n-tuple is
Change or create an n-tuple
Process an n-tuple in PAW
Process an n-tuple without PAW

The Next Step

The next step you might consider is to:-

Write Code to Access the Data Structure

Go Back to the Snoman Companion Top Page

I want to ... Understand What an n-tuple is

Prerequisites

If you have not done so already, you should:-

Learn about the Data Structures of SNOMAN
Run the Standard Monte Carlo job

Understand What an n-tuple is

An n-tuple is a type of mini-DST. For each "event" a fixed number of variables are recorded. For example 4 variables: energy and position (X, Y and Z) of the production vertex could be recorded in a ntuple for a 100 event run. The resulting n-tuple can be regarded as a table with 4 columns (variables) and 100 rows (events). SNOMAN has the ability to trawl through the Data Structure and generate an n-tuple under user request. It is important to appreciate that the term "event" may not necessarily correspond on a 1:1 basis with real or Monte Carlo events. For example, if running the Monte carlo, an n-tuple can be formed for each boundary vertex. There are many such vertices in a single MC event and so may n-tuple entries.

For further discussion see:-

CERN Long Writeup Q121 PAW The Complete Reference

The Next Step

The next step you might consider is to:-

Change or create an n-tuple
Process an n-tuple in PAW

Go Back to the Snoman Companion Top Page

I want to ... Change or create an n-tuple

Prerequisites

If you have not done so already, you should:-

Understand What an n-tuple is

Change or create an n-tuple

See section SNOMAN - Operating Instructions / Defining Your Own N-tuples of the User Manual

The Next Step

The next step you might consider is to:-

Process an n-tuple in PAW

Go Back to the Snoman Companion Top Page

I want to ... Process an n-tuple in PAW

Prerequisites

If you have not done so already, you should:-

Understand What an n-tuple is

and, you might want to:-

Change or create an n-tuple

Process an n-tuple in PAW

See section SNOMAN - Operating Instructions / Using PAW - A Brief Tutorial

For further discussion see:-

CERN Long Writeup Q121 PAW The Complete Reference

The Next Step

The next step you might consider is to:-

Process an n-tuple without PAW
Look at the Data Structure output

Go Back to the Snoman Companion Top Page

I want to ... Process an n-tuple without PAW

Prerequisites

If you have not done so already, you should:-

Change or create an n-tuple

and, you might want to:-

Process an n-tuple in PAW

Process an n-tuple without PAW

Although n-tuples are designed to be analysed in PAW it is not essential to use PAW. With a little effort an HBOOK utility could be written to read the n-tuple file and convert it to any desired format. If there is a lot of interest in this then something will be done about it.

In the meantime, PAW can be used to convert an n-tuple file. Suppose we have n-tuple 500 in the file hbooksm.ntp and we want to convert the data into a more user friendly form. Proceed as follows:-

Run PAW but set Workstation type to 0 (alphanumeric terminal)
Read the n-tuple file:-
hist/file 20 hbooksm.ntp
Create a user routine, associated with n-tuple 500, that will print out the n-tuple and ask PAW to edit the file immediately:-
ntuple/uwfunc 500 my_user.for pte
PAW will create the file my_user.for and enter an editor. You should edit the file in two ways:-
- Make the routine return false:-
  MY_USER=0.
- Change the print statement to write out the variables you require to the file you require.
and then exit the editor.
Now tell PAW to scan the ntuple using your user routine:-
ntuple/scan 500 my_user.for
Exit PAW.

The Next Step

The next step you might consider is to:-

Look at the Data Structure output

Go Back to the Snoman Companion Top Page

I want to ... Look at the Data Structure output

Prerequisites

If you have not done so already, you should:-

Learn about the Data Structures of SNOMAN
Change the Standard Monte Carlo job
Look at Printed Output

and, you might want to:-

Look at n-tuple Output

Look at the Data Structure output

The primary output from SNOMAN is the Data Structure although you need to turn on the OUT (Event Output) to obtain it. Having created a data structure from SNOMAN your next step is to analyse it. To do this within SNOMAN you will need to:-