A short introduction for those who may not have ever used a terminal command line before. The text that is in monospace font
is meant to be typed directly onto the command line (but look out for directions that may include sections like YOUR_USER_NAME_HERE
which usually means you should type your actual username).
Step-by-step guide
The Basics:
- First, see the the "Getting Started in UT ATLAS" page. You'll need an account on the UT ATLAS cluster.
- Once you have your account, open a terminal window (linux), the Terminal application (OSX), or download and install an Xterm application for Windows (for example, MobaXterm is a good one, and free).
- On the command line
ssh
into one of thetau
machines, for examplessh -X -Y YOUR_USER_NAME@tau6.hep.utexas.edu
- You should now have a command prompt on the machine. To make sure you can open an X-Window try
xclock
. You should see a little clock open in a window. You can kill the clock withCtrl-C
, or useCtrl-Z
and thenbg
if you'd like to keep it running in the background. (Here's a useful and brief overview of linux commands.) - Now take a look at what is in your
.bashrc
file. This is a list of commands that run whenever you log in. You can edit it withemacs .bashrc &
. (More about emacs can be found in this emacs tour.) - You should make sure (add) the following lines to this file:
export ATLAS_LOCAL_ROOT_BASE=/cvmfs/atlas.cern.ch/repo/ATLASLocalRootBase/
export ALRB_localConfigDir=/code/localConfig
. /cvmfs/atlas.cern.ch/repo/ATLASLocalRootBase/user/atlasLocalSetup.sh
- Save the file in emacs with
Ctrl-X Ctrl-S
, and then quit withCtrl-X Ctrl-C
.
Getting Started with ROOT:
- If you are not already familiar with ROOT there are many good tutorials on the web. I recommend this one. You can download ROOT, read the users manual, find support forums and more all at root.cern.ch.
- On the UT ATLAS cluster, log off and log in again. The ATLAS setup scripts should now have run as you logged in and you should be able to setup ROOT with
localSetupROOT
. - Now you can start root with
root -l
. - At this point you should be able to follow the tutorial mentioned above. It comes with some introductory slides that you can check out. There are some files you'll need that you can grab with
wget -r --no-parent --reject "index.html*" http://www.nevis.columbia.edu/~seligman/root-class/files
.
Getting Started on the Grid:
- Request a grid certificat and membership in the ATLAS and USATLAS VO: https://www.racf.bnl.gov/docs/howto/grid/gridcertfaq
- Export the certificate from your browser (or keychain) and save as .p12 file. Copy the file over to the cluster.
- Install the certificate https://www.racf.bnl.gov/docs/howto/grid/installcert
- Check that it works using
voms-proxy-init -voms atlas:/atlas/usatlas
Analysis Software
The next steps will involve specific analysis software, and there are several possibilities (most require access to ATLAS webpages).
- AnalysisTop and TopxAODs.
- RIVET
- ...
Related articles