xal.model.elem

Class IdealDrift

java.lang.Object

xal.model.elem.Element

xal.model.elem.ThickElement

xal.model.elem.IdealDrift

All Implemented Interfaces:

IComponent, IElement

public class IdealDrift
extends ThickElement

Represents a drift space in a particle beam transport/accelerator system.

NOTE

This class has been modified to accommodate PMQs by acting as quadrupoles with diminishing fields when placed next to a PMQ element. I'm not sure this is the best implementation as it is tightly coupled with several other elements.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	s_strType string type identifier for all IdealDrift objects

Fields inherited from interface xal.model.IElement

LightSpeed, Permeability, Permittivity, UnitCharge

Constructor Summary

Constructors

Constructor and Description
IdealDrift() JavaBean constructor - creates a new unitialized instance of IdealDrift BE CAREFUL
IdealDrift(java.lang.String strId, double dblLen) Creates a new instance of IdealDrift

Method Summary

Modifier and Type	Method and Description
double	elapsedTime(IProbe probe, double dblLen) Returns the time taken for the probe to drift through part of the element.
double	energyGain(IProbe probe, double dblLen) Return the energy gain imparted to a probe object.
double	getKDrift() I guess this is the strength of the adjacent PMQ quadrupole magnet if it exists.
void	prepareFringe() I think this method looks for PMQ magnets next to this drift then stores them as a private class.
PhaseMap	transferMap(IProbe probe, double dblLen) Computes the partial tranfer map for an ideal drift space.

Methods inherited from class xal.model.elem.ThickElement

getLength, initializeFrom, setLength

Methods inherited from class xal.model.elem.Element

addCloseElements, applyAlignError, backPropagate, backPropagate, compDriftingTime, compProbeLocation, getAlignX, getAlignY, getAlignZ, getCloseElements, getHardwareNodeId, getId, getPosition, getType, getUID, print, propagate, propagate, setAlign, setAlignX, setAlignY, setAlignZ, setHardwareNodeId, setId, setPosition, 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

string type identifier for all IdealDrift objects

See Also:

Constant Field Values

Constructor Detail

IdealDrift

public IdealDrift(java.lang.String strId,
                  double dblLen)

Creates a new instance of IdealDrift

Parameters:

strId - string identifier for the element

dblLen - length of the drift

IdealDrift

public IdealDrift()

JavaBean constructor - creates a new unitialized instance of IdealDrift BE CAREFUL

Method Detail

getKDrift

public double getKDrift()

I guess this is the strength of the adjacent PMQ quadrupole magnet if it exists.

Returns:

adjacant PMQ magnet strength ?

Since:

Apr 19, 2011

prepareFringe

public void prepareFringe()

I think this method looks for PMQ magnets next to this drift then stores them as a private class.

Since:

Apr 19, 2011

elapsedTime

public double elapsedTime(IProbe probe,
                          double dblLen)

Returns the time taken for the probe to drift through part of the element.

Specified by:

elapsedTime in interface IElement

Specified by:

elapsedTime in class Element

Parameters:

probe - propagating probe

dblLen - length of subsection to propagate through meters

Returns:

the elapsed time through sectionUnits: seconds

energyGain

public double energyGain(IProbe probe,
                         double dblLen)

Return the energy gain imparted to a probe object.

Specified by:

energyGain in interface IElement

Specified by:

energyGain in class ThickElement

Parameters:

dblLen - dummy argument

probe - dummy argument

Returns:

returns a zero value

transferMap

public PhaseMap transferMap(IProbe probe,
                            double dblLen)
                     throws ModelException

Computes the partial tranfer map for an ideal drift space. Computes the transfer map for a drift of length dblLen.

Specified by:

transferMap in interface IElement

Specified by:

transferMap in class ThickElement

Parameters:

dblLen - length of drift

probe - requires rest and kinetic energy from probe

Returns:

transfer map of an ideal drift space for this probe

Throws:

ModelException - should not be thrown

See Also:

IElement.transferMap(IProbe,double)