xal.smf

Class Ring

java.lang.Object

xal.smf.AcceleratorNode

xal.smf.AcceleratorSeq

xal.smf.AcceleratorSeqCombo

xal.smf.Ring

All Implemented Interfaces:

ElementType, DataListener

public class Ring
extends AcceleratorSeqCombo

Ring is a subclass of combo sequence that is intended to support the special needs of a Ring. A ring is made up of ring segments.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	s_strType node type

Fields inherited from class xal.smf.AcceleratorSeq

_sequences, m_arrNodes, m_bucSequence, nodeTable

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
Ring(java.lang.String strID, Accelerator accelerator, DataAdaptor adaptor) Constructor
Ring(java.lang.String strID, java.util.List<AcceleratorSeq> segments) Primary Constructor

Method Summary

Modifier and Type	Method and Description
double	getRelativePosition(double position, AcceleratorNode referenceNode) Convert the sequence position to a position relative to the specified reference node.
double	getShortestRelativePosition(AcceleratorNode node, AcceleratorNode referenceNode) Get the shortest relative postion of one node with respect to a reference node.
boolean	isLinear() Identify whether the sequence is within a linear section.

Methods inherited from class xal.smf.AcceleratorSeqCombo

equals, getAllInclusiveNodes, getAllNodes, getBaseConstituents, getBaseConstituentsWithQualifier, getConstituentNames, getConstituents, getConstituentsWithQualifier, getEntranceID, getInstance, getInstance, getInstance, getInstanceForRange, getInstancesForRange, getLength, getNodes, getNodeWithId, getPosition, getSequences, getSequences, getType, hashCode, write

Methods inherited from class xal.smf.AcceleratorSeq

addBucket, addNode, addNodeAt, addSequenceChain, addSoft, appendNodesOfClassWithQualifier, appendNodesWithQualifier, canPrecede, contains, dataLabel, filterNodesByClass, filterNodesByStatus, formsRing, getAllInclusiveNodes, getAllInclusiveNodesWithQualifier, getAllNodes, getAllNodesOfType, getAllNodesWithQualifier, getAllSeqs, getDistanceBetween, getIndexOfNode, getLeaves, getNodeAt, getNodeCount, getNodes, getNodesOfClassWithQualifier, getNodesOfClassWithQualifier, getNodesOfClassWithStatus, getNodesOfType, getNodesOfType, getNodesWithQualifier, getNodesWithQualifier, getPredecessors, getPrimaryAncestor, getRelativePosition, getSequence, getSequenceBuc, getSequences, indexToAddNode, orderSequences, recurNodeSearch, recurSeqSearch, removeAllNodes, removeNode, setSequence, sortNodes, sortNodesByProximity, sortNodesByRelativePosition, update, writeDeeply

Methods inherited from class xal.smf.AcceleratorNode

channelSuite, clear, findChannel, getAccelerator, getAlign, getAndConnectChannel, getAper, getBucket, getBuckets, getChannel, getDesignPropertyValue, getEId, getHandles, getId, getLivePropertyChannels, getLivePropertyValue, getParent, getPId, getPitchAngle, getPosition, getRollAngle, getSDisplay, getSoftType, getStatus, getTwiss, 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

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

s_strType

public static final java.lang.String s_strType

node type

See Also:

Constant Field Values

Constructor Detail

Ring

public Ring(java.lang.String strID,
            java.util.List<AcceleratorSeq> segments)

Primary Constructor

Ring

public Ring(java.lang.String strID,
            Accelerator accelerator,
            DataAdaptor adaptor)

Constructor

Method Detail

isLinear

public boolean isLinear()

Identify whether the sequence is within a linear section. This helps us to determine whether it is meaningful to identify one node as being downstream from another.

Overrides:

isLinear in class AcceleratorSeq

Returns:

false since by definition the ring is not a linear section

getRelativePosition

public double getRelativePosition(double position,
                                  AcceleratorNode referenceNode)

Convert the sequence position to a position relative to the specified reference node.

Overrides:

getRelativePosition in class AcceleratorSeq

Parameters:

position - the position of a location relative to the sequence's start

referenceNode - the node relative to which we wish to get the position

getShortestRelativePosition

public double getShortestRelativePosition(AcceleratorNode node,
                                          AcceleratorNode referenceNode)

Get the shortest relative postion of one node with respect to a reference node. This is really useful for ring sequences.

Overrides:

getShortestRelativePosition in class AcceleratorSeq

Parameters:

node - the node whose relative position is sought

referenceNode - the reference node relative to which the node's position is calculated

Returns:

the distance (positive or negative) of the node with respect to the reference node whose magnitude is shortest