Track3P (multipacting) keyword reference¶

Input-file keywords read by Track3P (multipacting), grouped by the block that contains them, with the type and default value taken from the code. A blank Default means the code supplies no fixed value when the keyword is absent, or the entry is a block or switch. Presence required means the run stops without it. What each keyword does is explained in the module guides and the command syntax pages.

Child Langmuir¶

Keyword	Type	Default	Presence
`Apply current density average extra factor`
`Apply current density extra factor`
`Backward velocity factor`
`Current density multiplicative factor`
`Direction at emitter`	`list`
`EGUN total microcurrents`
`First inter cycle factor`
`Forward velocity factor`
`Given delta phi`
`Input current density`
`Inter cycle averaging factor`
`Max allowed distance`
`Max allowed emission distance wrt z axis`
`Max allowed total current`
`Min allowed distance`
`Particles per face`
`Reference z for emission surface`
`Strategy`
`Use average J`
`Use electric field direction for initial backward velocity`
`Use electric field direction for initial forward velocity`
`Whole boundary is emitter`

DKSingleEmit¶

Keyword	Type	Default	Presence
`FileName`	`string`	`"DKSingleImpacts"`	optional
`SymmetryBoundaryIDs`

Domain¶

Keyword	Type	Default	Presence
`SlowParticleTermination`	`string`	`"off"`	optional
`SymmetryFactor`
`SymmetryPlane`	`list`
`A`	`int`	`0`	optional
`B`	`int`	`1`	optional
`Backward velocity pattern`
`BField`	`list`
`Bins`	`int`	`0`	optional
`Box augmentation in X negative direction`
`Box augmentation in X positive direction`
`Break localizers in X direction`
`BTimeFactor`	`list`
`CombineRatio`	`list`
`decoupledFieldFiles`
`Directory`	`string`	`"/usr/work/"`	optional
`dt`	`double`	`1e-13`	optional
`dt backward`			required
`EField`	`list`
`ElectroStaticFieldMap`	`block`
`Emission box x max`
`Emission box x min`
`Emission box y max`
`Emission box y min`
`Emission box z max`
`Emission box z min`
`Emission Nx`
`Emission Ny`
`Emission Nz`
`ETimeFactor`	`list`
`ExternalMagneticField`
`FieldDir` (alias `PostprocessFile`)	`string`		required
`FrequencyScanID`	`int`	`0`	optional
`HighEnergy`	`double`	`1000000000.0`	optional
`InitialEnergy`	`double`	`2.0`	optional
`InterpolationMethod`	`string`	`"EigenVector"`	optional
`Localizer for find elements`	`block`
`LowEnergy`	`double`	`5.0`	optional
`MagneticFieldMap`	`block`
`MaxImpacts`	`int`	`50`	optional
`Meshfile`			required
`Minimum backward velocity factor`
`Mode`	`block`
`ModeAmplitude`
`Modefile`			required
`ModeID`	`int`	`0`	optional
`ModeID1`	`int`	`0`	optional
`ModeID2`	`int`	`0`	optional
`ModePhase`
`MonitorListFile`		`m_dirname`	optional
`Nx`
`Ny`
`Nz`
`Offset`	`int`	`0`	optional
`Overall box x max`
`Overall box x min`
`Overall box y max`
`Overall box y min`
`Overall box z max`
`Overall box z min`
`PostprocessFile`
`SolidRegion`	`int`	`0`	optional
`Strategy for dt`
`SymmetryFactor`	`int`	`1`	optional
`SymmetryPlane`	`list`
`t0`	`double`	`0.0`	optional
`Tau3p_Startup`	`block`
`Time steps per element`
`Tracking box x max`	`list`
`Tracking box x min`	`list`
`Tracking box y max`	`list`
`Tracking box y min`	`list`
`Tracking box z max`	`list`
`Tracking box z min`	`list`
`Tracking Nx`	`list`
`Tracking Ny`	`list`
`Tracking Nz`	`list`
`Type`	`string`	`"Omega3p"`	optional
`Upper limit for dt multiplicative factor`
`VacuumRegion`
`Voltage`	`list`
`Window_Vol`

Emitter¶

Keyword	Type	Default	Presence
`a`
`BoundaryID`
`Child Langmuir`	`block`
`Direction`	`list`
`E`
`Emit Angle`	`int`	`45`	optional
`Energy`
`EnergyScale`	`double`	`1.0`	optional
`FowlerLaw`	`string`	`"RF"`	optional
`Imax`
`M`
`Name`	`string`	`"FieldEmission"`	optional
`NumberParticlesPerFace`	`int`	`1`	optional
`ParticlesFile`
`PhaseWindow`	`double`	`10.0`	optional
`Position`	`list`
`PositionFile`
`Q`
`RadiationFile`
`SampleType`
`Scale`	`double`	`1.0`	optional
`ScaleFactor`	`int`	`1`	optional
`SkipPhaseSteps`	`int`	`0`	optional
`SkipTimeSteps`
`Suppression factor`			required
`SuppressionFactor`	`double`	`2.0`	optional
`t1`	`double`	`1.0`	optional
`Velocity`	`list`
`WorkFunction`	`double`	`4.4`	optional
`Write to file`	`int`	`1`	optional
`WriteToFile`	`int`	`0`	optional
`x0`	`double`	`-1.0e+10`	optional
`x1`	`double`	`1.0e+10`	optional
`XOffset`	`double`	`0.0`	optional
`XScale`	`double`	`1.0`	optional
`y0`	`double`	`-1.e10`	optional
`y1`	`double`	`1.e10`	optional
`YOffset`	`double`	`0.0`	optional
`YScale`	`double`	`1.0`	optional
`z0`	`double`	`-1.e10`	optional
`z1`	`double`	`1.e10`	optional
`ZOffset`	`double`	`0.0`	optional
`ZScale`	`double`	`1.0`	optional

EnhancementCounter¶

Keyword	Type	Default	Presence
`BoundarySurfaceID1`
`BoundarySurfaceID2`
`MinimumEC`	`double`	`10.0`	optional
`SEYFileName1`
`SEYFileName2`
`Token`	`string`	`"off"`	optional

Excitation¶

Keyword	Type	Default	Presence
`Pulse`	`block`

FieldScales¶

Keyword	Type	Default	Presence
`EmissionOutput`
`Interval`
`Maximum`
`Minimum`
`Point`	`list`
`ScanToken`

Gas¶

Keyword	Type	Default	Presence
`Bounding Box Max`	`list`
`Bounding Box Min`	`list`
`L`
`P`
`PART`
`QQ`

Localizer for find elements¶

Keyword	Type	Default	Presence
`Box x max`
`Box x min`
`Box y max`
`Box y min`
`Box z max`
`Box z min`

MagneticFieldMap¶

Keyword	Type	Default	Presence
`File`
`Print`
`Scaling`
`Units`

Mat¶

Keyword	Type	Default	Presence
`BoundarySurfaceID`

Material¶

Keyword	Type	Default	Presence
`d`	`double`	`0.000001`	optional
`Density`	`int`	`1`	optional
`Einit`
`ElasticEmitterCoefficient`	`double`	`0.4`	optional
`ElasticThreshold`	`int`	`2`	optional
`FE`
`FPhi`
`FTheta`
`MinimumNumElectrons`	`double`	`1.0`	optional
`Model`	`int`	`1`	optional
`Phi`
`SecondaryEmissionYield`
`Sigma0`
`SolidBlockID`
`Theta`

Mode¶

Keyword	Type	Default	Presence
`Amplitude`
`EndPoint`	`list`
`ID`
`Phase`
`Rz`
`StartPoint`	`list`

Monitor¶

Keyword	Type	Default	Presence
`Common plane normal`	`list`
`Compute densities`
`DeltaT`
`Distance between first and last planes`
`Dot direction`	`list`
`Final instant`
`First plane point`	`list`
`Gun3p iteration`
`Initial instant`
`Max x for densities`
`Max y for densities`
`Measure length`
`Monitored direction`	`list`
`Monitored length lower bound`
`Monitored length upper bound`
`Number of divisions`
`Number of planes`
`Number of rings`
`Particle initial position`	`list`
`Plane normal`	`list`
`Plane point`	`list`
`Plane writing periodicity`
`R cross treshold`
`R for bounded emittance`
`Write each plane`
`Write to disk`
`X cross treshold`
`X number of densities`
`Y cross treshold`
`Y number of densities`
`Z cross treshold`

NormalizedField¶

Keyword	Type	Default	Presence
`Beta`	`double`	`1.0`	optional
`N`	`int`	`300`	optional

ParticlesTrajectories¶

Keyword	Type	Default	Presence
`ParticleFile`	`string`	`"./partpath"`	optional
`Skip`	`int`	`1`	optional
`Start`	`int`	`0`	optional
`Stop`	`int`	`1000000`	optional

postprocess¶

Keyword	Type	Default	Presence
`in`

Postprocess¶

Keyword	Type	Default	Presence
`EnhancementCounter`	`block`
`FaradayCup`	`block`
`ImpactsNumberRange`	`list`
`Qb`	`block`
`ResonantParticles`	`block`
`SECFileName`
`SolidRegionSECFileName`
`Toggle`	`string`	`"off"`	optional

Pulse¶

Keyword	Type	Default	Presence
`Frequency`			required

Qb¶

Keyword	Type	Default	Presence
`Current`
`Electron`
`Eps0`
`Vac`
`Vdc`

ResonantParticles¶

Keyword	Type	Default	Presence
`EnergyRange`	`list`
`InitialImpacts`	`int`	`4`	optional
`PhaseTolerance`	`double`	`0.01`	optional

State¶

Keyword	Type	Default	Presence
`Checkpoint`
`Restore`

Tau3p_Startup¶

Keyword	Type	Default	Presence
`Loading`	`block`

(top level or unspecified block)¶

Keyword	Type	Default	Presence
`,`
`:`
`AllOrder`
`AxisFile Toggle`
`beta`
`DeltaGT1`
`Desired impacts number`
`DistanceTolerance`	`double`	`1.0e-5`	optional
`Distribution`
`divX`
`divY`
`divZ`
`DKSingleEmit`	`block`
`Domain`	`block`
`Emitter`	`block`
`End Position`	`list`
`End Theta`	`int`	`90`	optional
`Energy Range`			required
`Ep_Ea`	`double`	`1.0`	optional
`Excitation`	`block`
`FieldLocationContour`
`FieldLocationContour-2point`
`FieldOrderContour`
`FieldOrderContour-2point`
`FieldScales`	`block`
`Forward recompute at crossings`
`Gas`	`block`
`Initial Count`
`Initial Impacts`			required
`Interpolation`
`interval`
`Iteration frequency`
`JobName`	`string`	`""`	required
`Material`	`block`
`material type`
`Maximum energy`
`MaximumEnergy`
`MeshInterface`	`block`
`MinimumEnergy`
`MPParticlesToken`
`Neighbour ID`	`int`	`1`	optional
`NormalizedField`	`block`
`Number of bins`
`Number of points`	`int`	`100`	optional
`NumberOfBins`
`Only on first iteration and post process`
`Only on post process`
`OutputImpacts`	`string`	`"off"`	optional
`OutputImpactsInfo`	`block`
`Parallel`
`Particle IDs`
`ParticlesTrajectories`	`block`
`PIC:`
`Postprocess`	`block`
`postprocess path`
`PtrackMonitor`	`block`
`Push Skip`
`Quantities`
`r`
`Random Seed`	`list`
`SECFileName_1`			required
`SECFileName_2`
`ShapeFile`
`SingleParticleTrajectory`	`string`	`"off"`	optional
`Start Position`	`list`
`Start Theta`	`int`	`0`	optional
`State`	`block`
`Statistics`
`SurfaceIDs`
`SurvivedParticlesToken`
`Time Offset`
`TimestepSkip`
`timestepskip`
`TotalTime`		`20.0 / (emwrap->getFrequency())`	optional
`Window ID`	`int`	`0`	optional
`x`
`XrayEnergy`
`XrayTransformation`
`y`
`z`
`Z range`	`list`
`zmax`
`zmin`