xal.smf.impl

Class SCLCavity

java.lang.Object

xal.smf.AcceleratorNode

xal.smf.AcceleratorSeq

xal.smf.impl.RfCavity

xal.smf.impl.SCLCavity

All Implemented Interfaces:

ElementType, DataListener

public class SCLCavity
extends RfCavity

SCLCavity class is used to represent an SCL RF cavity.

Nested Class Summary

Nested classes/interfaces inherited from class xal.smf.impl.RfCavity

RfCavity.Property

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	s_strType identifies this class

Fields inherited from class xal.smf.impl.RfCavity

_gaps, BLANK_BEAM_HANDLE, CAV_AMP_AVG_HANDLE, CAV_AMP_SET_HANDLE, CAV_PHASE_AVG_HANDLE, CAV_PHASE_SET_HANDLE, DELTA_TRF_END_HANDLE, DELTA_TRF_START_HANDLE, m_bucRfCavity, T_DELAY_HANDLE

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
SCLCavity(java.lang.String strID) Constructor
SCLCavity(java.lang.String strID, int arrayReserve) Primary Constructor

Method Summary

Modifier and Type	Method and Description
double	getAvgTTF(double beta) Deprecated. Read the comments about being a hard coded kluge job.
double	getFieldWithCavityOff(double current, double energy, double resErr, double plsWdth) Deprecated. This is one of only two methods that uses stuff from outside, and that stuff is the sclcavity sub-package which is completely hard coded for the SNS SCL. We must get rid of sclcavity.
double	getFieldWithCavityOff(double current, double energy, double resErr, double[] plsArry, double sampleRate) Deprecated. This is one of only two methods that uses stuff from outside, and that stuff is the sclcavity sub-package which is completely hard coded for the SNS SCL. We must get rid of sclcavity.
double	getQLoaded()
double	getStructureTTF()
java.lang.String	getType() Get this node's type.
double	toCAFromCavAmpAvg(double value) Convert the cavity amplitude to channel access.
double	toCavAmpAvgFromCA(double rawValue) Convert the raw channel access value to get the cavity amplitude in MV/m.

Methods inherited from class xal.smf.impl.RfCavity

addBucket, getBlankBeam, getCavAmpAvg, getCavAmpSetPoint, getCavFreq, getCavPhaseAvg, getCavPhaseSetPoint, getDesignPropertyValue, getDfltAvgCavPhase, getDfltAvgCavTTF, getDfltCavAmp, getDfltCavPhase, getGaps, getGapsAsList, getLivePropertyChannels, getLivePropertyValue, getRfField, getRFLength, getSTFFit, getSTFFitEnd, getSTFPrimeFit, getSTFPrimeFitEnd, getStructureMode, getTTFFit, getTTFFitEnd, getTTFPrimeFit, getTTFPrimeFitEnd, publishAmplitude, publishPhase, setBlankBeam, setCavAmp, setCavPhase, setDfltCavAmp, setDfltCavPhase, setRfField, toAvgCavPhaseFromCavPhase, toCAFromCavPhaseAvg, toCavPhaseAvgFromCA, toCenterAvgCavPhaseFromCavPhase, update, updateDesignAmp, updateDesignPhase

Methods inherited from class xal.smf.AcceleratorSeq

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

Methods inherited from class xal.smf.AcceleratorNode

channelSuite, clear, findChannel, getAccelerator, getAlign, getAndConnectChannel, getAper, getBucket, getBuckets, getChannel, getEId, getHandles, getId, 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, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

s_strType

public static final java.lang.String s_strType

identifies this class

See Also:

Constant Field Values

Constructor Detail

SCLCavity

public SCLCavity(java.lang.String strID,
                 int arrayReserve)

Primary Constructor

SCLCavity

public SCLCavity(java.lang.String strID)

Constructor

Method Detail

getType

public java.lang.String getType()

Get this node's type.

Overrides:

getType in class RfCavity

Returns:

the type ID of this node.

getStructureTTF

public double getStructureTTF()

Returns:

constant TTF used in the accelerator LLRF

getQLoaded

public double getQLoaded()

Returns:

Q external

getFieldWithCavityOff

@Deprecated
public double getFieldWithCavityOff(double current,
                                                double energy,
                                                double resErr,
                                                double plsWdth)

Deprecated. This is one of only two methods that uses stuff from outside, and that stuff is the sclcavity sub-package which is completely hard coded for the SNS SCL. We must get rid of sclcavity.

Parameters:

current - beam current (mA)

energy - beam kinetic energy (MeV)

resErr - cavity resonance error (Hz)

plsWdth - beam pulse width (micro-sec, single number, assume beam is square wave)

Returns:

cavity field induced by beam loading when the cavity is off

getFieldWithCavityOff

@Deprecated
public double getFieldWithCavityOff(double current,
                                                double energy,
                                                double resErr,
                                                double[] plsArry,
                                                double sampleRate)

Deprecated. This is one of only two methods that uses stuff from outside, and that stuff is the sclcavity sub-package which is completely hard coded for the SNS SCL. We must get rid of sclcavity.

Parameters:

current - beam current (mA)

energy - beam kinetic energy (MeV)

resErr - cavity resonance error (Hz)

plsArry - beam pulse array

sampleRate - BCM sample rate (micro-sec, single number)

Returns:

cavity field induced by beam loading when the cavity is off

toCavAmpAvgFromCA

public double toCavAmpAvgFromCA(double rawValue)

Convert the raw channel access value to get the cavity amplitude in MV/m.

Overrides:

toCavAmpAvgFromCA in class RfCavity

Parameters:

rawValue - the raw channel value

Returns:

the cavity amplitude in MV/m

toCAFromCavAmpAvg

public double toCAFromCavAmpAvg(double value)

Convert the cavity amplitude to channel access.

Overrides:

toCAFromCavAmpAvg in class RfCavity

Parameters:

value - the cavity amplitude

Returns:

the channel access value

getAvgTTF

@Deprecated
public double getAvgTTF(double beta)

Deprecated. Read the comments about being a hard coded kluge job.

get the average TTF for the cavity as a function of beta this should use parameters form the database, the hardwired fit coefficients should go in the database - this is temp.