Interactive Analysis Environment of Unified Accelerator Libraries

1
Interactive Analysis Environment of Unified
Accelerator Libraries

• V. Fine, N. Malitsky, R.Talman

2
Abstract

• Unified Accelerator Libraries (UAL,http//www.ual
  .bnl.gov) software is an open accelerator
  simulation environment addressing a broad
  spectrum of accelerator tasks ranging from
  online-oriented efficient models to full-scale
  realistic beam dynamics studies. The paper
  introduces a new package integrating UAL
  simulation algorithms with the Qt-based Graphical
  User Interface and an open collection of analysis
  and visualization components. The primary user
  application is implemented as an interactive and
  configurable Accelerator Physics Player whose
  extensibility is provided by plug-in
  architecture. Its interface to data analysis and
  visualization modules is based on the Qt layer
  (http//root.bnl.gov) developed and supported by
  the Star experiment. The present version embodies
  the ROOT (http//root.cern.ch) data analysis
  framework and Coin 3D (http//www.coin3d.org)
  graphics library.

3
Outline

• Unified Accelerator Libraries
• Architecture
• Element-Algorithm-Probe Framework
• API interface
• Interactive Analysis Extension
• Architecture
• Accelerator Physics Player
• Collection of Accelerator-specific viewers
• Status and applications

4
UAL Objectives ICAP 1996

• Form a customizable and extendable environment
  adaptable to new accelerator applications and
  conceptual models
• Facilitate development, deployment and reuse of
  diverse independently developed accelerator
  programs
• Integrate accelerator conceptual models and
  analysis patterns with modern technologies and
  software

5
UAL Environment
Application main functions
Application Shells
SIMBAD
TIBETAN
TEAPOT
ACCSIM
ZLIB
AIM
PAC
MPI
ICE
UAL Element-Algorithm-Probe Framework
6
Libraries http//www.ual.bnl.gov
7
Element-Algorithm-Probe FrameworkICAP 1998
Probe
Probe
Algorithm
Element
Element
Standard Machine Format
SMF
Accelerator Builder
Accelerator
Accelerator Node
Attribute Set
type

Frame
Field

Accelerator Sequence
Quadrupole
v 2.0 Frame
8
Accelerator Description Exchange Format (ADXF
2.x)http//www.ual.bnl.gov/adxf/

• ADXF file is a XML representation of the
  accelerator state (The Element Concept)
• Its schema has been mapped from the SMF 2.x
  object model.

core
extensions
adxf.xsd
rhic.adxf
ltadxf . gt ltconstantsgt ltconstant namelb
value3.58896 /gt ltconstant nameab
value0.0151186 /gt lt/constantsgt
ltelementsgt ltsbend named0mp08 llb
angleab /gt ltelement namebi8-dh0
designd0mp08 gt ltmfield b0 0 0.005476
0.033503 a0. 0 -0.010166
0.024366 /gt lt/elementgt lt/elementsgt
ltsectorsgt ltsector nameblue gt ltframe
refbi8-dh0 at661.74662424 /gt
lt/sectorgt lt/sectorsgt lt/adxfgt
ltxsschema ltxsinclude schemaLocationadxf_si
mple_types.xsd /gt ltxsinclude
schemaLocationadxf_abstract_types.xsd /gt
ltxsinclude schemaLocationadxf_core.xsd /gt
ltxsinclude schemaLocationadxf_attribute_sets.xs
d /gt ltxsinclude schemaLocationadxf_mad_eleme
nts.xsd /gt ltxselement nameadxf gt
ltxscomplexTypegt ltxssequencegt
ltxselement refconstants minOccurs0

maxOccursunbounded /gt ltxselement
refelements minOccurs0

maxOccursunbounded /gt ltxselement
refsectors minOccurs0

maxOccursunbounded /gt lt/xssequencegt
lt/xselementgt lt/xsschemagt
Position (local or global) of the installed
component which could be a common point for
connecting with the Detector description
9
Accelerator Propagator Description Format (APDF)

• APDF file is a XML representation of the
  accelerator propagator (The Algorithm Concept)
• Its schema is under development.

Applications range from small special tasks to
full-scale realistic beam dynamics studies
Simple matrix-based tracker
Element-by-Element tracker for Model Independent
Analysis studies
simple.apdf
ltapdfgt ltpropagator namesimple
acceleratorblue gt ltlink algorithmTIBETAN
SectorTracker sector Default /gt
ltlink algorithmTIBETANRFCavityTracker
elementsrfac1 /gt ltlink
algorithmTIBETABWCMonitor elementsmend
/gt lt/propagatorgt lt/apdfgt
mia.apdf
ltapdfgt ltpropagator namemia
acceleratorbluegt ltlink algorithmTEAPOTD
riftTracker types Default /gt
ltlink algorithmTEAPOTDriftTracker
typesMarkerDriftVHmonitorMonitor
/gt ltlink algorithmTEAPOTDipoleTracker
typesSBend /gt ltlink
algorithmTEAPOTMltTracker
typesQuadrupoleSextupoleMultipoleKicker /gt
ltlink algorithmTIBETANRFCavityTracker
typesRfCavity /gt ltlink
algorithmAIMMonitor
typesMonitor /gt . lt/propagatorgt lt/apdf
gt
10
User-oriented API
ROOT 2004 Workshop
Evolution
// Declare UI Interface UALQTPlayerShell
shell //
cout ltlt "Read the ADXF
file (lattice description)." ltlt endl //

shell.readADXF(Args() ltlt Arg("file",
latticeFile ))
//
cout ltlt "Read the
APDF file (propagator description)." ltlt endl //

shell.readAPDF(Args() ltlt Arg("file",
apdfFile )) //
cout ltlt "Generate a
bunch distribution." ltlt endl //

shell.setBunch(Args() ltlt Arg("np",
10000) ltlt Arg("enx", 15.0e-6) ltlt Arg("eny",
15.0e-6) ltlt Arg("ctMax", 2.0) ltlt
Arg("deMax", 1.0e-3) ltlt Arg("seed", -100))
1994 C API 1996 Perl API 1998 Perl API
SXF lattice file 2003 Perl API SXF lattice
file XML-based propagator file 2004
C API SXF lattice file XML-based
propagator file 2005 C API XML-based
lattice and propagator files
C with CINT vs Perl/Python Pros debugging,
maintenance Cons none
11
UAL Interactive Analysis ExtensionObjectives

• Bring the UAL off-line applications to the
  RHIC online
• environment for analyzing accelerator physics
  experiments
• and operational data.
• Facilitate modeling and analysis of
  multi-particle
• applications, such as beam-beam and space
  charge effects,
• instabilities, cooling, etc.)

12
Interactive Analysis ExtensionArchitecture
Player Worker
run
UAL collection of algorithms
USER
Basic Player
Player Shell
array of
Beam-Beam Player
Beam-Beam Shell
stack of


Basic Viewer
Basic Controller
Mountain Range Viewer
Beam Editor
ROOT


COIN 3D
Bunch 3D Viewer

Catalog of Accelerator Visualization Components
13
Interactive Analysis Extension (cont)

• Player Shell non-GUI interface/façade to UAL
  classes
• Basic Player main widget of the Interactive
  Analysis Extension
• Player Worker non-GUI thread performing
  time-consuming analysis and simulation
• Basic Controller base class of the various
  editors for changing the UAL parameters
• Basic Viewer base class of the visualization
  components

14
Accelerator Physics Player
UALUSPASBasicPlayer player new
UALUSPASBasicPlayer() player-gtsetShell(she
ll) qApp.setMainWidget(player)
player-gtshow() qApp.exec()
An open collection of viewers
An open collection of algorithms
15
Examples of the Accelerator-Specific Viewers
Turn-By-Turn BPM data (based on ROOT TH2F or
TGraph )
Twiss plots (based on ROOT TGraph)
Bunch 3D Distributions (based on COIN 3D)
16
Status and Applications

• Framework of the UAL Interactive Analysis
  Environment has been implemented and is
  currently developed as a part of
• RHIC joined online and off-line modeling
  environment
• http//www.sns.gov/pac
  05
• Particle Accelerator School course, Cornell, June
  20-24, 2005
• http//uspas.fnal.gov/programs/cornell/Acce
  lSimulation.htm
• The new version UAL1.11 is expected next month
  and will be available from the UAL Web site
  http//www.ual.bnl.gov.