LANLLANL Home - LANL Directory - Search LANL Web
Los Alamos Accelerator Code Group
Los Alamos
Accelerator Code Group *
|LANL| LANSCE| LANL Accelerators| Home|
|About Us| LAACG Codes| Accelerator Physics| News|
|Beam Physics| General Resources| Software/Methods| Site Index|

  Download Area for Trace





   ->Supported Versions

   ->Reporting Bugs



   ->LAACG Codes

Download Area for Trace


(c) Copyright, the Regents of the University of California.

This software was produced under U.S. Government contract W-7405-ENG-36 by Los Alamos National Laboratory, which is operated by the University of California for the U.S. Department of Energy. Neither the Government nor the University makes any warranty, express or implied, or assumes any liability or responsibility for the use of this software.

Unpublished -- rights reserved under Copyright Laws of the United States.

By accepting this software, the user agrees not to modify the software for commercial purposes without explicit written permission from the LAACG. Additionally, the user agrees not to incorporate this software, unmodified or otherwise, into software packages that will be sold, without explicit written permission from the LAACG. Lastly, the user agrees not to distribute this software to anyone who does not accept all the terms set forth here.


Subdirectories of the Trace directory on this file server contain source and executable code for Trace 3-D and Trace 2-D programs. Trace 3-D is an interactive beam-dynamics program that calculates the envelopes of a bunched beam, including linear space-charge forces, through a user- defined transport system. Trace 3-D provides an immediate graphics display of the envelopes and the phase-space ellipses and allows nine types of beam-matching options. The transport system may contain drifts, thin lenses, quadrupole lenses, solenoids, double or triplet lenses, bending magnets, rf gaps or cavities, radio-frequency-quadrupole cells, coupled-cavity linac sections, and user-defined elements.

This software is provided by the Los Alamos Accelerator Code Group (LAACG) of Los Alamos National Laboratory. The software is being provided for your personal use. To help us to document who uses this software, we ask that you do not distribute copies of the software outside your own group or department.



The Trace codes were written by Ken Crandall. A conference paper [Dan Rusthoi, Walter Lysenko, and Ken Crandall, "Further Improvements on Trace 3-D," Proceedings of the 1997 Particle Accelerator Conference (Vancouver, May 12-16, 1997)] discusses a 1997 version intended to run on any platform. The source code for this version is available on this FTP server in directory Trace\OtherVersions\Source1997. The LAACG experience has been that this "universal" version of Trace is very difficult to implement and it is essentially unsupported. The LAACG distributes executable code for Windows and Linux as discussed below.



The 1997 Trace manual is available in PDF and Microsoft Word formats. Also copies of the 1997 Particle Accelerator Conference paper in several formats (PS, PDF and MS Word) are available.


Supported Versions

Subdirectories Windows and Linux contain the latest version of Trace 3-D for these two platforms. These two versions originate from the same source files. The Windows code is compiled with Lahey Fortran LF90 and Winteracter. The Linux code uses Lahey Fortran LF95 and Winteracter for Linux. Instructions for using the commands are contained in the program menu. We recommend as a useful reference the manual "Trace 3-D Documentation," (LA-UR-97-886) by K. R. Crandall and D. P. Rusthoi in directory Trace\DOC. Each subdirectory contains a copy of the example files.

Linux compilers will usually link the executable with the shared version of the Motif library. Distributing a dynamically linked executable means that the end users require a compatible version of that library. This would complicate installation and configuration of Trace3d on the end user's system, if they do not have the same version of the Motif shared library. To avoid this requirement Trace3d was linked statically.


Reporting Bugs

We would appreciate hearing from you if you discover a bug or if you have suggestions for improvements we might make in the codes. We already have added several features suggested by users.


Trace Download

Note: If you are a user of Parmela, Parmila, or the RFQ Design Codes, then you will not need to download the Trace codes separately unless you need this code for different platforms. The Setup program for Parmela, Parmila, and the RFQ Design Codes will install Trace 3-D for Windows, documentation in both PDF and Microsoft Word formats, and several Trace example files.

Latest Version Number

The latest version number of the code is:

06_JB published on 04/25/2006 (for Windows - 2D)
69LY published on 02/13/2006 (for Windows - 3D)
67LY published on 08/11/2005 (for Linux - 3D)
1.0 published in about 1985 ( for DOS - 2D)

Download Trace

Log of Changes
See the list of changes, additions, and bug fixes for Trace. These changes are listed in reverse chronological order. If you are already a user of a Los Alamos code, you can check back here to see if there have been any updates to the codes after the version you have installed.
Log of Changes

Operating System Support
  • Windows: WinXP, Win 2000
  • Linux: native version outdated, recent version works fine under Wine (both PC and Mac)
  • MacOS: no support


Trace Registration

To download Trace, we ask that you register as a user. If you did not register during the download step please use the form below. Registered users receive notification by email of new features and bug fixes.

Registration Form

* This work is supported by the U. S. Department of Energy, Office of Science, Division of High Energy Physics.

 Los Alamos National Laboratory
Operated by the University of California for the National Nuclear Security Administration,
of the US Department of Energy.    
Copyright © 2003 UC | Disclaimer/Privacy

Last modified: Mon 27 Oct 2014 10:41 PM , LDD or FLK