last modified: 31-AUG-1993 | catalog | categories | new | search |

ESTS0428 POISSON, SUPERFISH,

POISSON SUPERFISH, Poisson Equation Solver for Radio Frequency Cavity

top ]
1. NAME OR DESIGNATION OF PROGRAM:  POISSON, SUPERFISH, magnet & RF
cavity design.
top ]
2. COMPUTERS
To submit a request, click below on the link of the version you wish to order. Only liaison officers are authorised to submit online requests. Rules for requesters are available here.
Program name Package id Status Status date
POISSON,SUPERFISH ESTS0428/01 Arrived 03-MAY-2001

Machines used:

Package ID Orig. computer Test computer
ESTS0428/01 IBM PC
top ]
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.
top ]
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.
top ]
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.
top ]
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.
top ]
7. UNUSUAL FEATURES OF THE PROGRAM

Application of widely-used accelerator design codes on PC.
top ]
8. RELATED AND AUXILIARY PROGRAMS:
top ]
9. STATUS
Package ID Status date Status
ESTS0428/01 03-MAY-2001 Masterfiled Arrived
top ]
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, included references:
- 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.
top ]
11. MACHINE REQUIREMENTS:
top ]
12. PROGRAMMING LANGUAGE(S) USED
Package ID Computer language
ESTS0428/01 FORTRAN-77
top ]
13. OPERATING SYSTEM UNDER WHICH PROGRAM IS EXECUTED:  MS-DOS 3.3 or above.
top ]
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.
top ]
15. NAME AND ESTABLISHMENT OF AUTHORS

   J. Colman
   Brookhaven National Laboratory
   UPTON, NY, U.S.A.
top ]
16. MATERIAL AVAILABLE
ESTS0428/01
miscellaneous    mag tapeLETTER Information File                    MISTP
miscellaneous    mag tapePCREADME.TXT README File                   MISTP
source program   mag tapeALT_FOR.EXE Source File (Compressed)       SRCTP
load module      mag tapePFMP_EXE.EXE Executable File (Compressed)  LODTP
source program   mag tapePFMP_FOR.EXE Source File (Compressed)      SRCTP
test-case output mag tapePPLOTS.EXE a Postscript Format Plot File   OUTTP
miscellaneous    mag tapePCREADME.TXT README File                   MISTP
load module      mag tapeALT_EXE.EXE Executable File (Compressed)   LODTP
load module      mag tapeSSSP_EXE.EXE Executable File (Compressed)  LODTP
miscellaneous    mag tapeDOCUMNTS.EXE Documentation File (Compress.)MISTP
miscellaneous    mag tapeLHYTUNER.EXE Documentation File            MISTP
symb data lib    mag tapeLIBPC.EXE Symb. Data Lib. (Compressed)     LBSTP
test-case data   mag tapeSAMPLEIN.EXE Sample Input (Compressed)     DATTP
test-case output mag tapeSAMPLOUT.EXE Sample Output (Compressed)    OUTTP
source program   mag tapeSSSP_FOR.EXE Source File (Compressed)      SRCTP
miscellaneous    mag tapePCREADME.TXT README File                   MISTP
miscellaneous    mag tapeLAHEY.DOC LAHEY Documentation File         MISTP
report                   LA-UR-87-115 (January 1987)                REPPT
report                   LA-UR-87-126                               REPPT
top ]
17. CATEGORIES
  • V. Particle Accelerators and High Voltage Machines

Keywords: accelerators, magnetic fields, magnets, mesh generation, poisson equation, potentials, three-dimensional, two-dimensional.