You are here: Foswiki>AtlasSingleTop Web>EventDisplaySoftware (28 Jul 2011, ChristopherWillis)Edit Attach


Atlantis is an event display software developed for ATLAS. The official website can be found here

How to Setup

First you need to have Athena sourced.

export AtlasSetup=/afs/
alias asetup='source $AtlasSetup/scripts/'

To run Atlantis, type

You can load a file directly into Atlantis with the default settings, you can type
Atlantis eventfile.xml

Configuring Atlantis

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,
  1. Open atlantis
  2. Go to preferences,
  3. Click on Color Map Editor
  4. Click on the box with coordinates: 8, default(1)
  5. Select black in the bottom left hand corner
  6. 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,
  1. Configure the event display the way you want it,
  2. Go to perferences
  3. Click on Save Current Configuration.
  4. 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

  • To load a color scheme use
    -m colorfile.xml
  • To load a configuration file use
     c configfile.xml
  • To define relevant output options
    -o widthxheight outputname.xml
  • To set the output rate in seconds
    -p pause
  • To bring up the help menu, type
    Atlantis --help

Creating Event Displays

Creating a single event display is pretty straitforward.

  1. Load in your desired color scheme, configuration file, and event file
  2. Click File
  3. Click Save Image of Canvas
  4. 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 ( 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:
  1. JiveXML_180400_77876087.xml
  2. JiveXML_180400_79792562.xml
  3. JiveXML_182456_55629595.xml
  4. JiveXML_183462_48979599.xml

The configuration file and colormap can be downloaded here:
  1. Z_colormap.xml
  2. Z_config.XML

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: JiveXML_180400_77876087


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 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
vp1 myfile.pool.root
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
vp1 -h
to bring up the help menu.

Configuring VP1

If you load VP1 with an event, you can displays the tracks and energy in the calorimeter via the following:

  1. Click on the "All Studies" button.
  2. Check the "Tracks" and "Clusters" boxes in the left hand menu.
  3. Go to the "Tracks" tab and under the "Track Particles" heading, check the box that says "TrackParticleCandidate"
  4. Under the "Clusters" tab, click on the "CaloCalTopCluster" box.
  5. Now if you want to add in sections of the detector, go back to the main menu and click on the "Geo" tab.
  6. 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.


-- ChristopherWillis - 28 Jul 2011
Topic attachments
I Attachment Action Size Date Who Comment
JiveXML_180400_77876087-YX-EventInfo-RZ-2011-07-21-15-08-31.pngpng JiveXML_180400_77876087-YX-EventInfo-RZ-2011-07-21-15-08-31.png manage 136 K 21 Jul 2011 - 13:11 UnknownUser  
JiveXML_180400_77876087.xmlxml JiveXML_180400_77876087.xml manage 1 MB 21 Jul 2011 - 12:36 UnknownUser xml file
JiveXML_180400_79792562.xmlxml JiveXML_180400_79792562.xml manage 3 MB 21 Jul 2011 - 12:37 UnknownUser xml file
JiveXML_182456_55629595.xmlxml JiveXML_182456_55629595.xml manage 4 MB 21 Jul 2011 - 12:37 UnknownUser xml file
JiveXML_183462_48979599.xmlxml JiveXML_183462_48979599.xml manage 3 MB 21 Jul 2011 - 12:38 UnknownUser xml file
Z_colormap.xmlxml Z_colormap.xml manage 14 K 21 Jul 2011 - 12:39 UnknownUser  
Z_config.XMLXML Z_config.XML manage 131 K 21 Jul 2011 - 12:39 UnknownUser  
Topic revision: r6 - 28 Jul 2011, ChristopherWillis
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback