xal.smf.impl.profile

Class ProfileDevice

java.lang.Object

xal.smf.AcceleratorNode

xal.smf.impl.profile.ProfileDevice

All Implemented Interfaces:

ElementType, DataListener

Direct Known Subclasses:

WireHarp, WireScanner

public abstract class ProfileDevice
extends AcceleratorNode

This class presents the common behavior of profile data acquisition devices. It also provides some tools for managing the device and its connections. For example, testing batch acquisition of data and configuration channels, along with some common enumerations.

Child classes can define their own specific behavior using the component-based classes ParameterSet and SignalSet. They allow the profile device to define configuration parameters and measurement data acquisition channels.

Derived classes must define the AcceleratorNodeAcceleratorNode.getType() method, since this class has no device type of its own. It simply represents the common behavior of profile data acquisition devices.

Ported from XAL on Jul 15, 2014.
· Jonathan M. Freed

Since:

Mar 21, 2014

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ProfileDevice.ANGLE Enumeration of the projection angles used to produce the profile data.
static class	ProfileDevice.GAIN Enumeration of the gain constants for the ProfileDevice amplifier gain values.
static interface	ProfileDevice.IProfileData Interface exposed by data structures containing formatted data acquired from profile diagnostic devices.
static interface	ProfileDevice.IProfileDomain Interface for the generic description of the domain of profile data.
static class	ProfileDevice.MACROPULSE Sections of the beam used by the analysis parameter selection methods for setting which part of the acquired beam is used for computing the sample values.
static class	ProfileDevice.MVTVAL Enumeration of the various motion states.
static class	ProfileDevice.TRGEVT Enumeration of the available triggering events for the data acquisition.

Field Summary

Fields inherited from class xal.smf.AcceleratorNode

channelSuite, m_bolIsSoft, m_bolStatus, m_bolValid, m_bucAlign, m_bucAper, m_bucTwiss, m_dblLen, m_dblPos, m_dblS, m_mapAttrs, m_objAccel, m_seqParent, m_strEId, m_strId, m_strPId

Constructor Summary

Constructors

Constructor and Description
ProfileDevice(java.lang.String strId) Constructor for ProfileDevice.

Method Summary

Modifier and Type	Method and Description
<T extends ParameterSet> T	acquireConfig(java.lang.Class<T> clsType) Retrieves a given set of configuration parameter values.
<T extends SignalSet> T	acquireData(java.lang.Class<T> clsType) Acquires the current measurement data from the wire scanner data buffers.
void	configureHardware(ParameterSet datPvFlds) Set all the hardware parameter values associated with the given data set.
Monitor	createMonitor(XalPvDescriptor.IPvDescriptor pvdFld, IEventSinkValue snkEvents, int... mskEvtType) Setup a value monitor on the given process variable (i.e., using its handle).
boolean	testConnection(java.lang.Class<?> clsScada, double dblTmOut) Test the connections in all the channels of the given parameter set for this accelerator device.
boolean	testConnection(java.util.Collection<ScadaFieldDescriptor> setFds, double dblTmOut) Test the connections in all the channels of the given parameter set for this accelerator device.

Methods inherited from class xal.smf.AcceleratorNode

addBucket, channelSuite, clear, dataLabel, findChannel, getAccelerator, getAlign, getAndConnectChannel, getAper, getBucket, getBuckets, getChannel, getDesignPropertyValue, getEId, getHandles, getId, getLength, getLivePropertyChannels, getLivePropertyValue, getParent, getPId, getPitchAngle, getPosition, getPrimaryAncestor, getRollAngle, getSDisplay, getSoftType, getStatus, getTwiss, getType, getValid, getXOffset, getYawAngle, getYOffset, getZOffset, hasBucket, hasParent, isKindOf, isMagnet, lazilyGetAndConnect, removeFromParent, setAccelerator, setAlign, setAper, setLength, setParent, setPitchAngle, setPosition, setRollAngle, setSDisplay, setStatus, setTwiss, setValid, setXOffset, setYawAngle, setYOffset, setZOffset, toString, update, write

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ProfileDevice

public ProfileDevice(java.lang.String strId)

Constructor for ProfileDevice.

Parameters:

strId -

Since:

Mar 21, 2014

Method Detail

acquireConfig

public <T extends ParameterSet> T acquireConfig(java.lang.Class<T> clsType)
                                         throws ConnectionException,
                                                GetException,
                                                BadStructException

Retrieves a given set of configuration parameter values. The values are returned in a new instance of the data structure type provided in the argument. (Note that all configuration parameters are contained in data structures derived from the base class ParameterSet.)

Type Parameters:

T - type parameter of the parameter set requested

Parameters:

clsType - class type of the parameter set requested

Returns:

set of configuration parameters for this device

Throws:

BadStructException - the DAQ data structure and DAQ channels are incompatible or could not be constructed

ConnectionException - unable to connect to a parameter readback channel

GetException - general CA GET exception while reading a parameter value

Since:

Nov 15, 2011

See Also:

ParameterSet

acquireData

public <T extends SignalSet> T acquireData(java.lang.Class<T> clsType)
                                    throws ConnectionException,
                                           GetException,
                                           BadStructException

Acquires the current measurement data from the wire scanner data buffers. The type of data set is determined by the class type parameter T given to this method. (Note that all data sets are data structured derived from the base class Data.)

Type Parameters:

T - specific type of data set being requested

Parameters:

clsType - class type of data being requested

Returns:

measurement data set currently available on this wire scanner data buffers

Throws:

BadStructException - the DAQ data structure and DAQ channels are incompatible or could not be constructed

ConnectionException - unable to connect to a data buffer channel

GetException - general CA GET exception while reading data buffers

Since:

Nov 15, 2011

See Also:

Data

createMonitor

public Monitor createMonitor(XalPvDescriptor.IPvDescriptor pvdFld,
                             IEventSinkValue snkEvents,
                             int... mskEvtType)
                      throws ConnectionException,
                             MonitorException,
                             NoSuchChannelException

Setup a value monitor on the given process variable (i.e., using its handle). The monitor events are sent to the IEventSink object provided.

One can specify the event type which fires the monitor using the argument intEvtType. Any combination of the following event types can be specified with a logical OR operation:

Monitor.VALUE - fire upon PV value change
Monitor.LOG -
Monitor.ALARM - fire upon PV alarm value
The default value (i.e., no argument) is Monitor.VALUE.

Parameters:

pvdFld - handle enumeration for process variable

snkEvents - interface to data sink

mskEvtType - code specifying when the monitor is fired (or'ed combination of {Monitor.VALUE, Monitor.LOG, Monitor.ALARM})

Returns:

A new monitor on the given process variable

Throws:

gov.sns.xal.smf.NoSuchChannelException - if the handle does not identify any process variable of this accelerator node

gov.sns.ca.ConnectionException - channel is not connected

gov.sns.ca.MonitorException - general monitor failure

ConnectionException

MonitorException

NoSuchChannelException

configureHardware

public void configureHardware(ParameterSet datPvFlds)
                       throws PutException,
                              ConnectionException

Set all the hardware parameter values associated with the given data set.

Parameters:

datPvFlds - set of new hardware values

Throws:

ConnectionException - unable to connect PV channel

PutException - general exception setting values

Since:

Dec 17, 2009

testConnection

public boolean testConnection(java.lang.Class<?> clsScada,
                              double dblTmOut)
                       throws BadStructException,
                              BadChannelException

Test the connections in all the channels of the given parameter set for this accelerator device. The test will wait up to the given length of time before declaring failure.

Parameters:

clsScada - type of a SCADA data structure

dblTmOut - time out before test fails (in seconds)

Returns:

true if all connections were successful, false if not all connection were made within given time

Throws:

BadStructException - the given class is not a SCADA data structure

BadChannelException - An unbound channel handle within a field descriptor

BadChannelException

Since:

Feb 4, 2011

testConnection

public boolean testConnection(java.util.Collection<ScadaFieldDescriptor> setFds,
                              double dblTmOut)
                       throws BadChannelException

Test the connections in all the channels of the given parameter set for this accelerator device. The test will wait up to the given length of time before declaring failure.

Parameters:

setFds - set of field descriptors containing channel handles

dblTmOut - time out before test fails (in seconds)

Returns:

true if all connections were successful, false if not all connection were made within given time

Throws:

BadChannelException - An unbound channel handle within a field descriptor

Since:

Feb 4, 2011