High Level Applications Infrastructure and Current Status

1 BROOKHAVEN SCIENCE ASSOCIATES

High Level Applications Infrastructure and Current Status

Guobao Shen, Lingyun Yang*Controls Group & Accelerator Physics Group

ASAC October 14th 2010


Outline

• Software requirement overview• Specifications of High level applications (HLA)• HLA System infrastructure• Applications/APIs Implementation and progress• APIs for further applications• ConclusionsAcknowledgement: Accelerator Physics Group, Controls Group, Diagnostics & Instrumentation Group, Injection System.

G. Portman(ALS), M. Borland, Marty Kraimer (APS)


Requirement: Who, What and by When• Controls + AP group, with support from other members when

needed: diagnostics, RF, ID, network, database, …• Requirement was defined in

• Common use cases for high level controls are listed. (J. Bengtsson etc. 2008)

• Assumptions and plan for commissioning defined the over all tasks for high level applications. (F. Willeke 2009, S. Krinsky 2010)

• These provide a full list of functionalities/features (concise). • We focus on high level controls part (mainly physics related). • Other discussions with experts from ALS/SLAC/APS ( EPICS

meeting)• Deadline is set for LINAC, Booster and Storage ring.

All are summarized in a HLA user guide and API reference manualAll are summarized in a HLA user guide and API reference manual


Control Software Requirement

• Overview of commissioning software• General monitoring: orbit, magnet, RF, vacuum,

temperature, alarm, logbook, …• Orbit control and feedback• Beam diagnostics: DCCT, size, emittance, …• Other major subsystem: Safety, RF, Injection, …• Accelerator physics toolkit: beam measurement,

manipulation, lattice modeling, …• HLA will be applications plus toolkit.

• Special applications for injection, first turn orbit• AP tools with mature algorithm: BBA, LOCO• Toolkit, APIs for scripting, easy to expand. (evolve to app later)


Application Manual and Spec

• Requirements in references• Defined in a “one line” form, very brief. • Reorganize them as a complete and orthogonal set

of functions.• Application user guide and API ref manual

• Compile from references• Examples and usage• Algorithm description• Data structure• API definition and formalize• Help doc will be available in control terminal.• “Divide” work for AP and control group,

keep the interface clear.• Packaging and distribution


HLA System Infrastructure


HLA System Infrastructure

• Service provide data with a meaningful name:• CH1YSP01 or CH1[0] instead of “SR:C01-MG:G03A.SP”

• In a meaningful manner:• Synchronized reading of BPMs ? parameter

scanned ? equilibrium data ?• Integrated information :

• Log, archive, magnet measurement, …• Maintenance is easier.

• Hardware is changed, removed, temporary disabled, …

• Port to another facility.“Chef and the customer: make sure the menu/order is placed correctly”


Current Infrastructure Status• Combining 2 services

MySQLRDB

Channel Finder Service Gather Service

Channel Access v3

BPM

Network

VacuumPower Supply

PVAccess client

Client API Library

Orbit display

SR:C04-MG:G06A<HCM:H2>Fld:SP, 97.61726

SR:C05-MG:G03A<HCM:M1>Fld:SP,117.0594

SR:C06-MG:G02B<HCM:L2>Fld:SP, 138.9133

Local bump


Tools developed and to be provided

• MATLAB Middle Layer (LOCO included)• New development

• Python language• interactive environment, visualization, full set of

numerical routines, scripting, glue FORTRAN and C/C++ easily, flexible ordering of parameter, …

• API set comparable to MATLAB Middle Layer• User guide for HLA applications, example scripts• Reference Manual for all APIs.• Integrated data management

• magnet measurement, ID field, magnet relations.


Tools developed and to be provided• Virtual accelerator based on Tracy-II and EPICS.• Application Programming Interface is defined.• Version control system is established (used since June 2010)• Applications:

• Beam based alignment is prototyped.• Orbit correction: flexible data/bpm/corrector• Linear lattice reconstruction (LOCO)

• Data flow and structure between services/clients is partially defined. Data management is in coding stage

• lattice layout, organization, dependence, measured data, history data, revision history.

• Backend modeling capabilities is planned, elegant/Tracy-II.


About HLA and Python

the Pseudo-script looks like … #!/usr/bin/env python import nsls2hla as sr import matplotlib.pylab as plt import numpy as np import time dat=np.zeros((180,5), ‘d’) for ik,k in enumerate(np.linspace(-0.5, 0.5, 5): sr.setKicker(“CH2G6C01A”, k)

s, orbit1 = sr.getOrbit(group=“CELL30”) sr.step(“QH1”)

s, orbit2 = sr.getOrbit(group=“CELL30”) dat[:, ik] = orbit2 – orbit1 plt.plot(np.linspace(-0.5, 0.5, 5), dat[4,:], ‘o’) plt.savefig(“orbit-var.png”)


About HLA and PythonVisualization …


About HLA and PythonInteractive …


Expanding for Further Applications

• Collect physics algorithms: both general and NSLS-II specific• Code and documentation:

• Be prepared for new requirements• Terminology definition in a unified form, easy to

read/understand.• Manual and spec document under development• Code development, functions or algorithms: For “getOrbit”,

“getTune”, “measureChromaticity”, …• Development policy

• First implement those functions with an algorithm we know • Review on those implementations.


Conclusions

• HLA manual and spec are developed• Initial revision of user guide and APIs are finished• Work (coding, document) divided between AP and

controls are clear.• Infrastructure to support HLA development

• Coding/testing environment is set up.• Some physics routines are prototyped and demoed.• Basic services are ready, e.g. orbit, current.• Working on more services: Lattice management,

Magnetic-Current conversion, logscore, …• Plan on tools development are clear, design stage is almost

done, and the rest are mainly coding and parameter tuning

High Level Applications Infrastructure and Current Status

Documents

Transcript of High Level Applications Infrastructure and Current Status