Table of Contents
1 ModelInfonewline2 MeshPartitioningnewline3 Normal finite element parametersnewline4 P-window for short-range wakefieldnewline5 Gaussian beam going through a cavitynewline6 Time Integration Parametersnewline7 Wakefield Monitornewline8 Point Monitornewline9 Power Monitornewline10 Volume Monitornewline11 CheckPointnewline12 LinearSolvernewline13 Load a TEM waveguide mode on a coax port
ModelInfo
Tell T3P which mesh file to load and what boundary conditions are used for the different side sets in the mesh file (default: Electric)
ModelInfo: {
File: coarse.ncdf
BoundaryCondition: {
Electric: 2
Magnetic: 3 4
Absorbing: 5 6
}
}
MeshPartitioning
To specify the method to partition the mesh
MeshPartitioning: {
Method: PARMETIS //the other option is ZOLTAN
Zoltan: { //if the main method is ZOLTAN, this container will provide further zoltan specific options
Method: RCB
Dimension: 1
Partition Direction: Z
}
}
Normal finite element parameters
FiniteElement:
Unknown macro: { Order}
P-window for short-range wakefield
*set the basis order to be 0 (p=0).
FiniteElement: {
Order: 0 //p=0 outside of the window
CurvedSurfaces: on
}
*set an automatic moving window that following with the beam
PRegion: {
Type: AutomaticMovingWindow
Order: 2 //inside the window, p=2 (basis function order)
Back: 0.1 //back pudding is 0.1 beamsize
Front: 1 //front pudding is full beamsize
}
Gaussian beam going through a cavity
*The first step is to provide beam information:
LoadingInfo: {
Bunch: {
Type: Gaussian //Gaussian bunch
Sigma: 2e-3 //sigma of the nuch
Nsigmas: 5 //beam occupies the location from -5 sigma to +5 sigma, total of 10 sigmas
Charge: 1. //charge
}
Symmetry factor: 4 //factor by which to reduce the charge to account for symmetry conditions (monopole on axis: use 4, dipole at X (or Y) offset: use 2 in connection with proper electric boundary conditions in one plane)
StartPoint: 0 0 0 //beam goes from left to right. StartPoint is the position where the beam enters the structure (typically at low Z values)
}
*The second step is to put a BeamLoading
Loading: {
Type: BeamLoading
Direction: 0.0, 0.0, 1.0
}
*The third step is to put a BeamBoundaryLoading
Loading: {
Type: BeamBoundaryLoading
BoundaryID: 5
Origin: 0.0 0.0 0. //origin of the 2D coordinate in the 3D coord system
XDirection: 1.0 0.0 0.0 //x-axis of the 2D coordinate in the 3D coord system
YDirection: 0.0 1.0 0.0 //y-axis of the 2D coordinate in the 3D coord system
// For circular beampipes
Beampipe radius: 0.04 //if it is circular, specify the radius of the beam
Beam offset: 0 //and offset of the beam in x-direction of the local 2D coordinate system (value needs to be consistent with StartPoint above)
//An analytical solution will be used.
// For arbitrary beampipe
Poisson2D: {} //this will provide a numerical solution
}
Time Integration Parameters
TimeStepping: {
MaximumTime: 10.e-10 //the maximal time to step
DT: 2e-12 //delta T
}
Wakefield Monitor
<font color="red">need more expalantion</font>
Monitor: {
Type: WakeField
Name: wake
InID: 5
OutID: 6
Start contour: 0.05
End contour: 0.10
Start structure: 0.0
End structure: 0.15
Smax: 0.3 //
}
Point Monitor
To record the field values at specified location
Monitor: {
Type: Point //point monitor
Name: monA //an output file called monA.out will be generated
//it contains: t Hx Hy Hz Ex Ey Ez
Coordinate: 0.00002, 0.02, 0.1495 //the location
}
Power Monitor
Monitor: {
Type: Power
ReferenceNumber: 4 //which reference surface to monitor
Name: mymon2
TimeStart: 0 //when power monitor starts
TimeEnd: 30.0e-9 //when it ends
TimeStep: 0.125e-11 //how often it records power density
}
Volume Monitor
Monitor: {
Type: Volume
Name: vol
TimeStart: 10.e-9 //when volume monitor starts
TimeEnd: 500.e-9 //when it ends
TimeStep: 50.e-9 //how often it records volume fields
}
After T3P finished runs, users should run acdtool to generate mode files for each records of the volume fields using the following command:
acdtool postprocess volmontomode t3pinput <jobname>
The mode files generated can be viewed using paraview.
CheckPoint
request T3P code to checkpointing itself every certain timesteps so that one can restart T3P.
CheckPoint: {
Action: restart //default should be restart. If there is no data available, it will have fresh start.
Ntimesteps: 100 //every 100 times steps, code will checkpoint itself
Directory: CHECKPOINT //the default directory to store checkpointing data
}
LinearSolver
The options for linear solvers in the implicit timestepping.
LinearSolver: {
Solver: CG //other options include MUMPS if it is compiled in
Preconditioner: CHOLESKY //other options include DIAGONAL
PrintFrequency: 50 //if you want print solver convergence history
QuietMode: 1 //Set it to 1 if you do not want to print anything
Tolerance: 1e-10 //relative tolerance
MaxIterations: 3000 //maxima number of iterations before CG quits
}
Load a TEM waveguide mode on a coax port
Loading: {
Type: PortModeLoading //loading type
Port: {
ReferenceNumber: 3 //port is at reference surface 3
Origin: 0.0 0.0 -0.011
XDirection: 1.0 0.0 0.0
YDirection: 0.0 1.0 0.0
ESolver: {
Type: Analytic
Mode: {
WaveguideType: Coax
ModeType: TEM
A: 0.0011
B: 0.0033
}
}
}
Excitation: {
Power: 1.
Pulse: {
Type: Monochromatic
Frequency: 10.5e9
Rise periods: 150
Fall periods: 150
T0: 0.
TMax: 100.e-9
}
}
}