Getting the most out of your plots
Introduction
For plotting and fitting, org.lcsim provides an implementation of AIDA.
This tutorial will assume that you are working in JAS3 and have either loaded an existing AIDA file or created objects in AIDA with the org.lcsim plugin.
If you have executed some of the examples in JAS3, you have already used AIDA in lines like these:
AIDA aida = AIDA.defaultInstance(); ... aida.cloud1D("nTracks").fill(tracks.size());
These lines create and fill an unbinned one-dimensional histogram named nTracks with the return value of tracks.size()
Teminology
AIDA provides two different kinds of histograms: binned and unbinned.
Binned histograms are called IHistogram1D, IHistogram2D, IHistogram3D
for one, two and three-dimensional histograms.
Similarly, unbinned histograms are called ICloud1D, ICloud2D, ICloud3D
Getting started
Viewing and Loading Plots
Lets start with viewing AIDA objects. You can either create them with the AIDA examples, the org.lcsim examples or you can load an existing AIDA file with File->Open File...
in the menu.
All AIDA objects are arranged in trees. You can have many trees open at the same time; they are represented as Folders, . Trees can contain, e.g. Clouds and/or Histograms , with the name of the object appearing next to it. If a folder is closed, double-clicking will open it and display its contents. Similarly, double-clicking on an open folder will close it, so that the contents are hidden.
Trees that are created by the org.lsim examples will have non-descriptive names like aida5312aida.
A double-click on a Cloud or a Histogram will cause JAS3 to plot the contents.
Clouds are automatically displayed with 50 bins over the range of the data.
If the active page shows source code or the examples, double clicking on an item in the tree will create a new plot page and display the item.
If, however, the active page is already a plot page, double-clicking on an item will cause the displayed plot to be overwritten, and all your modifications (like changing the binning, the color or the text) to be lost !
If you want to display more than one plot on a page, you have to use the context menu.
- Right click on the item you want to plot to open its context menu
- Select
Show in New Plot
In order to display an item together with an already displayed item, select Overlay on Current Plot
from the context menu
Saving in various graphics formats (e.g. PNG, EMF, JPG, etc.)
Overlaying Plots
Changing Layout/Style/Properties with the Mouse
Advanced Topics
For this section, you will want to take a look at
PAIDA and AIDA API
Changing Layout/Style/Properties with a Script
While it is convenient to be able to manipulate your data with the mouse, in many cases you will want to apply the same modifications to a set of similar data, or perform more complicated modifications that are quite possible to do with AIDA, but not (yet) implemented in JAS3. This is where a script comes in handy