Atlantis is an event display software developed for ATLAS. The official website can be found http://www.hep.ucl.ac.uk/atlas/atlantis/ here
How to Setup
First you need to have Athena sourced.
alias asetup='source $AtlasSetup/scripts/asetup.sh'
To run Atlantis, type
You can load a file directly into Atlantis with the default settings, you can type
Instead of having to reconfigure Atlantis each time you open it, you can load in a particular color scheme and configuration file whne you start it. If it's your first time using Atlantis, you'll have to create these from scratch.
Saving/Loading a Color Scheme
To create a new color scheme,
- Open atlantis
- Go to preferences,
- Click on Color Map Editor
- Click on the box with coordinates: 8, default(1)
- Select black in the bottom left hand corner
- click ok twice.
Now the background color should be black. To save this color scheme,
1. Go to preferences.
1. Click on save current color map.
To load this color scheme into atlantis, type
atlantis -c colormapfilename.xml
Saving/Loading a Configuration File
Creating and saving a configuration file is the same in principle as creating a color scheme, but there are vastly more options available. When making event displays for the Z' analysis, I had multiple settings enabled and disabled relevant to the calorimetry, as well as certain cuts on the data (e.g. only display tracks with a pt > 5.0 GeV
/c). The settings you select are entirely based on what kind of analysis you're performing and what exactly you want to display.
To create a configuration File,
- Configure the event display the way you want it,
- Go to perferences
- Click on Save Current Configuration.
- Give it a relevent name like "Z_Prime_Configuration_File".
Now you can open Atlantis with this file each time and it will load the settings and cuts you have defined in your configuration file. To load this configuration, type
atlantis -m configurationfilename.xml
To Load them both simultaneously along with a file, type
atlantis -c colormapfile.xml -m configurationfile.xml eventfile.xml
Relevant Command Line Settings
Creating Event Displays
Creating a single event display is pretty straitforward.
- Load in your desired color scheme, configuration file, and event file
- Click File
- Click Save Image of Canvas
- Select the desired output name and file type
If you have multiple .xml event files in the same directory, you can scroll through them with the forward and reverse arrow buttons in the upper right corner of Atlantis, following the process above to save each of them.
This is useful for a couple of events, but it would be nice if there was a way to automate the whole process. The following command will read in events and output an image for each automatically!
atlantis -c configfile.xml -m colorfile.xml -o ./ 1024x682 -p 1 eventfile.xml
The "eventfile.xml" in the above line should be the first event file in the directory. Atlantis will load that and run through all subsequent evet files (by descending number), creating an image for each. If the output filename isn't specifed, each file will be named after the run number and event number. The output format is hard coded to .png in the version of Atlantis I use (18.104.22.168). There is an option in the latest version of Atlantis (AtlantisJava
-09-16-01-02) to output files in the .eps format. The command is "--outputformat eps", but I haven't tried this.
Example: Creating Event Displays
Let's use the four .xml files from the Z' analysis and create an event display for each. They can be downloaded here:
The configuration file and colormap can be downloaded here:
atlantis -c Z_config.xml -m Z_colormap.xml -o ./ 1024x682 -p 1 ./JiveXML_180400_77876087.xml
The output files will be given the name name as the input. You'll get something that looks like this:
In addition to Atlantis, there's also the Virtual Point 1 (VP1) event display software for ATLAS; however, unlike Atlantis, VP1 runs on ESD/AOD files, so there's no intermediate conversion process that needs to take place between getting files from the GRID and opening them in VP1. The official webpage can be found http://atlas-vp1.web.cern.ch/atlas-vp1/index.php here
. The biggest difference however is that VP1 provides a full 3D reconstruction of the event.
How to Setup
In order to run VP1, you must have your Athena sourced and then just run
You can also load in an ESD file with VP1 when you open it. Type
If you want to open more than one file you can specify them like this
vp1 myfile2.pool.root myfile1.pool.root myfile3.pool.root
You can scroll through your list of events with the arrow in the lower left.
For a full list of options and commands you can type
to bring up the help menu.
If you load VP1 with an event, you can displays the tracks and energy in the calorimeter via the following:
- Click on the "All Studies" button.
- Check the "Tracks" and "Clusters" boxes in the left hand menu.
- Go to the "Tracks" tab and under the "Track Particles" heading, check the box that says "TrackParticleCandidate"
- Under the "Clusters" tab, click on the "CaloCalTopCluster" box.
- Now if you want to add in sections of the detector, go back to the main menu and click on the "Geo" tab.
- You can find more complete instructions on the VP1 website and ATLAS computing sites.
Saving/Loading a Configuration File
Once you've configured the settings, you can save them to a file. Go to the "Configuration" tab in the upper menu. In the drop down box, there's an option to "Save current tab configuration to file". The file format is .VP1 and it can be loaded along with any event files during start up by typing
vp1 myfile.pool.root vp1config.vp1
Saving an Event Display
To save your event display, click on the image of the camera in the upper left.
- 28 Jul 2011