Dynac Quick Reference – Updated Jul-08-2015
DRIFT
Length [cm]
BMAGNET (Magnetic Dipole)
Sectors [#]
Bend Angle [deg]
Bend Radius[cm] BField[kG](0=auto) 1stOrderField# 2ndOrder Field#
EntryFaceAngle [deg] EntryFaceCurve[cm] 1stOrderFringe 2ndOrderFringe ½ Aperture [cm]
ExitFaceAngle [deg] Exit FaceCurve[cm] 1stOrder Fringe 2ndOrderFringe ½ Aperture[cm]
QUADRUPO (Magnetic Quadrupole)
Length [cm] PoleField[kG] ApertureRadius[cm]
STEER (Steering Device)
MeanField[T.m or kV] Flag(0=Mag. Horiz., 1=Mag. Vert., 2=Electrostatic Horiz., 3=Electrostatic, Vert.)
SOLENO
Flag Length[cm] Strength(Flag=0 cm^-1, else kG)
SEXTUPO
Flag Strength(Flag=0: cm^-3, else kG) Length[cm] ApertureRadius[cm]
QUADSXT (Combined Quad & Sextupole)
Flag SStrength(Flag=0: cm^-3, else kG) QStrength(Flag=0: cm^-2, else kG) Length[cm] ApRadius[cm]
SOQUAD (Combined Quad & Solenoid)
Flag SStrength(Flag=0:cm^-1, elsekG) QStrength(Flag=0: cm^-2, else kG) Length[cm] ApRadius[cm]
FDRIFT (Subdivided Drift)
Length[cm] Divisions[#] Flag[0=brief, 1=verbose]
FSOLE (Solenoid with arbitrary Field)
Filename
FieldAttenuation Divisions[#]
QUAELEC (Electric Quadrupole)
Length[cm] Voltage[kV] ApertureRadius[cm]
QUAFK (Quadrupole with k^2 given)
Flag(0=Elec,Else Mag) Strength[cm-2] Length[cm] ApertureRadius[cm]
EDFLEC (Electrostatic Deflector)
Sectors [#]
Radius[cm] Angle[deg] VerticalRadius[cm] Electric Field [kv/cm](if negative, field will be calculated automatically)
CAVNUM (Accelerating Cavity)
Dummy
Dummy Phase[deg relative to max] Field[% relative to 100%] Divisions[#] Flag(1=hadrons, 0 else)
CAVSC (Accelerating Cell)
Dummy Dummy Dummy Length[cm] TTF TP Dummy Dummy Dummy Dummy EField[MV/m]
RFphase[deg] Dummy TPP Frequency[MHz] EFieldAttenuation[fraction] (all on one line)
BUNCHER
Voltage[MV] Phase[deg] Harmonic[#] ApRadius[cm]
FIELD (Specify Cavity Field from File)
Filename
FieldStrength[fraction]
RWFIELD (Rewind Cavity Field)
HARM (Specify Field from Fourier Components)
Length[cm] Frequency[Hz] FieldStrength[fraction]
FourierTerms[#]
FourierCoefficient1 [MV/cm] FourierCoefficient2[MV/cm]… (can be on multiple lines)
EGUN (Electron Gun)
Filename
FieldStrength[fraction] Flag[Space Charge]
RFQTPQ (RFQ)
Filename
Cells[#]
IntervaneVoltageRP[% relative to 100%] IntervaneVoltageNonRP[% relative to 100%]
Phase[% relative to 100%] Window[1=compress to +/- 180 degrees]
STRIPPER (Charge Stripper)
FoilAtomicNumber FoilMass[amu] FoilThickness[gm/cm^2] ProjectileAtomicNumber
SECORD (Enable Second Order Calculations)
FIRORD (Set first order calculations) (default)
RASYN (Enable Synchrotron Radiation for Electrons)
GEBEAM (Generate Particle Distribution)
Flag1(distribution type, see docs) Flag2(0=upright ellipse, 1=read TWISS params)
Frequency[Hz] NumberOfParticles[#]
EnergyOffset[MeV] XOffset[cm] X’Offset[mrad] YOffset[cm] Y’Offset[mrad] PhaseOffset[z]
If Flag2=0: Xmax[cm] X’max[mrad] Ymax[cm] Y’Mx[mrad] dWmax[MeV] dTmax[deg]
If Flag2=1: Alphax Betax[mm/mrad] Emitx[mm.mrad]
Alphay Betay[mm/mrad] Emity[mm.mrad]
Alphaz Betaz[deg/keV] Emitz[keV.deg]
INPUT (Must come after GEBEAM)
RestMassRP[MeV] AtomicNumberRP ChargeRP[#]
KineticEnergyRP[MeV] PhaseOffset[deg]
RDBEAM (Read in Particle Distribution)
Filename
Flag (0 = 6 coordinates, 1 = 6+charge state & mass, 2 = 6 +charge only, 10, 11, 12 = same, but z in ns, not deg)
Frequency[MHz] PhaseOffset[deg] NB: Frequency is in MHz, NOT Hz.
RestMassRP[MeV] AtomicNumberRP
EnergyRP[MeV] ChargeRP[#]
ETAC (Generate Multi-Charge State Distribution)
ChargeStates[#]
If ChargeStates=0: Filename
If ChargeStates>0: One line per state: Charge[#] Percent[%] Eoffset[MeV]
WRBEAM (Write particle distribution to file)
Filename
Flag(0=relative to COG,1=absolute,2=relative to RP) Flag(0=6 coords,1=+particle #, 2=+charge, 3=charge+particle#)
EMIPRT (Control verbosity of ‘dynac.short’)
Flag(0=disable after lenses,1=disable after drifts,2=everywhere)
EMITGR (Generate Scatter Plots)
Title
Flag(0=RP & COG Same, 1=RP & COG different) EmittanceMultiple[RMS]
Xlim[cm] X’lim[mrad] Ylim[cm] Y’lim[mrad] Xlim[cm] Ylim[cm] dPhiLim[deg] dWlim[MeV] (0 for auto)
ENVEL (Generate Envelope Plots)
Title
EnvelopeSize[RMS]
Zstart[m] Zend[m]
Xmax[cm] Ymax[cm] dWmax[dW/W per mille] dPhiMax[deg] (0 for auto)
PROFGR (Generate Profile Plots)
Title
Flag(0=RP & COG Same, 1=RP & COG different) Flag(0=vertical is not logarithmic, 1=vertical logarithmic)
Xlim[cm] Ylim[cm] Zlim[deg] LowerLimit[cm])(dummy for non-log plot)
EMIT (generates distribution properties in ‘dynac.short’)
EMITL (Same as EMIT, but with a text label)
Label
TILT (Arbitrary tilt)
Flag(0=set RP to COG, 1=same RP)
X’shift[deg] Xshift[cm] Yshift[cm] COGWShift[meV] COGPhaseShift[deg]
TILZ (XZ rotation immediately after GEBEAM only)
Slope[deg]
REJECT (reject particles)
Flag(0=fraction,1=MeV) 1/2Energy[Flag] 1/2Phase[deg] 1/2X[cm] 1/2y[cm] 1/2Radius[cm]
CHASE (analyze, rejecting outliers)
XX’Fraction YY’Fraction dW/dtFraction
COMPRES (compress to one phase window)
Window[deg]
ALINER (simulates alignment errors)
Xdisplacement[cm] Ydisplacement[cm] X’rotation[mrad] Y’rotation[mrad]
CHANGREF (changes properties of RP)
Xdisplacement[cm] Ydisplacement[cm] Rotation[deg]
ZROT (rotates beam around z axis)
RotationAngle[deg]
RANDALI (simulates random alignment errors)
Flag(0=off, 1=on)
Xdisplacement[cm] Ydisplacement[cm] X’Rotation[mrad] Y’Rotation[mrad] (only use if Flag=1)
TWQA (simulates quadruople rotation)
Flag(0=systematic,1=random) Angle[deg]
NREF (Define new Reference Particle)
Phase[deg relative to old RP] Energy[Flag2] Flag1[0=relative to RP, 1=relative to COG] Flag2[0=%,1=MeV]
TOF (Activate TOF calculation)
Flag(0=active) Flag(0=no adjustments,1=adjust wrt TOF)
NEWF (New Frequency)
Frequency[Hz]
MMODE (introduce errors in accelerating elements)
Flag(0=disabled,1=systematic errors,2=random errors) PhaseOffset[deg] Field Change[% relative to 100%]
REFCOG (detatch or link RP and COG)
Flag(0: RP=COG, 1: RP and COG independent, 2: RP and COG together at card, independent after)
SCDYNAC (Space Charge Computations)
Flag(+/-1=HERSC, 2=SCHERM, 3=SCHEFF)
BeamCurrent[mA] Flag(1=all except drifts, 2=accelerating elements only, 3=all elements)
Flag = 1
FractionToCalculate
Flag = -1
LMax MMax NMax
CutoffX[RMS] CutoffY[RMS] CutoffZ[RMS]
CutoffEPS
Flag=2
Dummy
Flag=3
Flag(0=Stop Here, 1=read next line)
RadialMeshInt[RMS] LongHalfMesh[RMS] #RadialMesh #LongMesh #ofAdjacentBunches PulseLength[cm] Integrate?[1=yes]
SCPOS (defines space charge computation position)
Z-Fraction
SCDYNEL (Activates space charge in bending magnets)
Length[cm]
DCBEAM (Sets DC beam for space charge calculations)
Flag (0 = bunched, 1 = DC)
ACCEPT (generates accepted and rejected particles for an element)
Title (kept)
Flag(0=RP & COG Same, 1=RP & COG different) EmittanceMultiple[RMS]
Xlim[cm] X’lim[mrad] Ylim[cm] Y’lim[mrad] Xlim[cm] Ylim[cm] dTlim[sec] dWlim[MeV] (0 for auto)
Title (lost)
Flag(0=RP & COG Same, 1=RP & COG different) EmittanceMultiple[RMS]
Xlim[cm] X’lim[mrad] Ylim[cm] Y’lim[mrad] Xlim[cm] Ylim[cm] dTlim[sec] dWlim[MeV] (0 for auto)
COMMENT
Comment (80 char max)
ZONES (defines color codes for plots)
Flag(0=3d, 1=planes) NumberOfZones
Zone1Limit[RMS] Zone2Limit[RMS] … Zone(N-1)Limit[RMS]
STOP
Document maintained by Daniel Alt – alt@nscl.msu.edu