ESTS0428: POISSON SUPERFISH, Poisson Equation Solver for Radio Frequency Cavity

[Program Service | Recent programs]

ESTS0428 POISSON, SUPERFISH, (Abstract last modified 03-MAY-2001)

POISSON SUPERFISH, Poisson Equation Solver for Radio Frequency Cavity

Abstract Table of Contents:

1. NAME OR DESIGNATION OF PROGRAM - POISSON, SUPERFISH, magnet & RF
cavity design.

2. COMPUTER FOR WHICH PROGRAM IS DESIGNED AND OTHER MACHINE VERSION PACKAGES AVAILABLE -

To request or retrieve programs click on the one of the active versions below. A password and special authorization is required.

Explanation of the status codes.

Program-name Package-ID Status POISSON,SUPERFISH ESTS0428/01 Arrived

Machines used: Package-ID Orig.Computer Test Computer ESTS0428/01 IBM PC

3. DESCRIPTION OF PROGRAM OR FUNCTION - POISSON, SUPERFISH is a group of (1) codes that solve Poisson's equation and are used to compute field quality for both magnets and fixed electric potentials and (2) RF cavity codes that calculate resonant frequencies and field distributions of the fundamental and higher modes. The group includes: POISSON, PANDIRA, SUPERFISH, AUTOMESH, LATTICE, FORCE, MIRT, PAN-T, TEKPLOT, SF01, and SHY.
POISSON solves Poisson's (or Laplace's) equation for the vector (scalar) potential with nonlinear isotropic iron (dielectric) and electric current (charge) distributions for two-dimensional Cartesian or three-dimensional cylindrical symmetry. It calculates the derivatives of the potential, the stored energy, and performs harmonic (multipole) analysis of the potential.
PANDIRA is similar to POISSON except it allows anisotropic and permanent magnet materials and uses a different numerical method to obtain the potential.
SUPERFISH solves for the accelerating (TM) and deflecting (TE) resonant frequencies and field distributions in an RF cavity with two-dimensional Cartesian or three-dimensional cylindrical symmetry. Only the azimuthally symmetric modes are found for cylindrically symmetric cavities.
AUTOMESH prepares input for LATTICE from geometrical data describing the problem, (i.e., it constructs the "logical" mesh and generates (x,y) coordinate data for straight lines, arcs of circles, and segments of hyperbolas).
LATTICE generates an irregular triangular (physical) mesh from the input data, calculates the "point current" terms at each mesh point in regions with distributed current density, and sets up the mesh point relaxation order needed to write the binary problem file for the equation-solving POISSON, PANDIRA, or SUPERFISH.
FORCE calculates forces and torques on coils and iron regions from POISSON or PANDIRA solutions for the potential.
MIRT optimizes magnet profiles, coil shapes, and current densities from POISSON output based on a field specification defined by the user.
PAN-T calculates the temperature distribution in the walls of a
RF-cavity given the electric field at the walls, the thermal conductivity of the wall materials, and the temperature at the outer surface of the wall.
TEKPLOT plots the physical boundaries and mesh resulting from a
LATTICE run and equipotential or field lines generated as a result of POISSON, PANDIRA, MIRT, or SUPERFISH runs.
SF01 and SHY process results from SUPERFISH runs. SF01 calculates quantities useful for a drift-tube linac. SHY calculates the value of the electric field in the TM mode over an area in the XY-plane.

4. METHOD OF SOLUTION - The POISSON group of codes solves Maxwell's static equations (MSE's) in integral form and in two dimensions. When the MSE's are taken together with the boundary conditions, they are equivalent to a generalized form of Poisson's equations in two dimensions. POISSON uses a successive point over-relaxation (SPOR) method to solve the equations, while PANDIRA directly solves the block tridiagonal system of difference equations, and iteration is required only for nonlinear problems. After solving the equations, both compute the derivatives of the potential, namely the fields and their gradients, and calculate the stored energy. SUPERFISH uses the same direct solution method as PANDIRA for the Helmholtz eigenvalue problem.

5. RESTRICTIONS ON THE COMPLEXITY OF THE PROBLEM -
POiSSON: 16000 mesh points, 30 regions;
SUPERFISH: 32000 mesh points; 125 max value for kmax and/or lmax, 60 segments and 3 regions.

6. TYPICAL RUNNING TIME - This is variable depending on the PC configuration, clock rate, etc. For SUPERFISH the DTL sample can be run under 5 minutes on a GATEWAY/486 system. For POISSON Hmag sample the run time is approximately 5 minutes.

7. UNUSUAL FEATURES OF THE PROGRAM - Application of widely-used accelerator design codes on PC.

8. RELATED AND AUXILIARY PROGRAMS -

9. STATUS
ESTS0428/01: 03-MAY-2001 Masterfiled Arrived

10. REFERENCES  -
- POISSON Group Programs User's Guide,
  Los Alamos National Laboratory memorandum, February 14, 1981
- POISSON,SUPERFISH, NESC NO. 9418,
  POISSON,SUPERFISH Tape Directory and Implementation Information,
  National Energy Software Center Note 91-50, February 26, 1991
ESTS0428/01:
- M.T. Menzel and H.K. Stokes:
  User's Guide for the POISSON/SUPERFISH Group of Codes
  LA-UR-87-115 (January 1987).
- POISSON Group Programs User's Guide,
  LA-UR-87-126.

11. MACHINE REQUIREMENTS -

12. PROGRAMMING LANGUAGE(S) USED -
ESTS0428/01: FORTRAN-77

13. OPERATING SYSTEM UNDER WHICH PROGRAM IS EXECUTED - MS-DOS 3.3 or above.

14. OTHER PROGRAMMING OR OPERATING INFORMATION OR RESTRICTIONS - The
TEKPLOT program requires the proprietary Tektronix PLOT10 subroutines INITT, CHRSIZ, TERM, NEWPAG, AOUTST, ANMODE, MOVABS, DRWABS, and TINPUT; these routines are not included.

15. NAME AND ESTABLISHMENT OF AUTHORS -
   J. Colman
   Brookhaven National Laboratory
   UPTON, NY, U.S.A.

16. MATERIAL AVAILABLE -
ESTS0428/01:
LETTER Information File
PCREADME.TXT README File
ALT_FOR.EXE Source File (Compressed)
PFMP_EXE.EXE Executable File (Compressed)
PFMP_FOR.EXE Source File (Compressed)
PPLOTS.EXE a Postscript Format Plot File
PCREADME.TXT README File
ALT_EXE.EXE Executable File (Compressed)
SSSP_EXE.EXE Executable File (Compressed)
DOCUMNTS.EXE Documentation File (Compress.)
LHYTUNER.EXE Documentation File
LIBPC.EXE Symb. Data Lib. (Compressed)
SAMPLEIN.EXE Sample Input (Compressed)
SAMPLOUT.EXE Sample Output (Compressed)
SSSP_FOR.EXE Source File (Compressed)
PCREADME.TXT README File
LAHEY.DOC LAHEY Documentation File
report                   LA-UR-87-115 (January 1987)                REPPT
report                   LA-UR-87-126                               REPPT

17. CATEGORIES -

- V. Particle Accelerators and High Voltage Machines

Keywords: ACCELERATORS, MAGNETIC FIELDS, MAGNETS, MESH GENERATION, POISSON EQUATION, POTENTIALS, THREE-DIMENSIONAL, TWO-DIMENSIONAL