next up previous contents
Next: -fdtd/-windowwake: Wakepotential in a Up: Solver sections: Eigenvalues and Previous: -fdtd/-pexcitation: What port-mode should   Contents

-fdtd/-lcharge: Properties of relativistic line charges

 ##############################################################################
 # Flags: nomenu, noprompt, nomessage,                                        #
 ##############################################################################
 # section: -lcharge                                                          #
 ##############################################################################
 # ----- Parameters of a line charge: ------                                  #
 # charge    =        0.0               -- [As]                               #
 # shape     = gaussian                 -- gaussian | triangular | table      #
 #    tablefile=  -none-
 #    xtable =        1.0               -- [m]                                #
 # sigma     =  undefined               -- [m]                                #
 # isigma    =  6                       -- number of sigmas to use.           #
 # xposition =        0.0               -- [m]                                #
 # yposition =        0.0               -- [m]                                #
 # direction = +z                       -- +z, -z                             #
 # soffset   =        0.0               -- [m]                                #
 # ----- other parameters: ------                                             #
 # ds        =       auto               -- [m]                                #
 # shigh     =       auto               -- [m]                                #
 # showdata  = no                       -- ( yes | no )                       #
 # napoly    = yes                      -- ( yes | no )                       #
 #   naccuracy=      10.0e-6     -- wanted acc for poisson-eq in Napoly alg.  #
 #   ignoretem= yes                     -- should be "yes" for Wx, Wy         #
 ##############################################################################
 # ?, nextcharge, return, help                                                #
 ##############################################################################

In this section one specifies the properties of one or several relativistic line charges. When computing with the conventional algorithm, ie. not with the windowwake algorithm, one can specify up to 100 linecharges, each with a different charge, different position, different distribution and different direction of flight. When using the windowwake algorithm, all charges must go in positive z-direction, and they must have the same shape. They may differ in their positions and charge. Once the properties of a linecharge are specified, one switches to the next linecharge with the command '-nextcharge'.

The standard usage of this section is to compute wakepotentials. When a inonzero charge is specified, and a time domain computation is performed, the wakepotentials are computed as the potential that is seen by witness particles that are traveling in positive z-direction.


Example The following specifies that we want to model a line charge traveling with the speed of light along the axis (x,y)=(0,0). The total charge of the line-charge shall be 1 pC, and its gaussian width sigma shall be 1 mm. We want to have a s-resolution of the wakepotentials of 1/10 mm, and we are interested in s-values up to 100 mm.
 -lcharge
    xpos= 0
    ypos= 0
    charge= 1e-12
    sigma= 1e-3

    ds= 0.1e-3
    shigh= 100e-3


Example An example for a table file describing a charge shape is given below.

# -lcharge
#    shape= table, tablefile= Bunch1.txt
#    xtable= 1e-6, charge= 1e-12
#
# Everything behind a '#' is ignored.
# Lines in the tablefile may be empty, or they may
# contain two (or more) numbers.
# The first number is a position, the next number is
# a relative charge. What follows behind these two numbers is ignored.
#
# bunch1 (linac entrance)
# s[microns]   No. of macro-particles
# ________________________________________________


0,      0
1       -1.32067
2       -1.10711
3       -0.894051
4       -0.6815
5       -0.469454
6       -0.25791
7       -0.046869
8       0.16367
9       0.373709
10       0.583247


next up previous contents
Next: -fdtd/-windowwake: Wakepotential in a Up: Solver sections: Eigenvalues and Previous: -fdtd/-pexcitation: What port-mode should   Contents