Change Log for Trace

This file describes changes, additions, and bug fixes in TRACE 2-D/3-D 
in reverse chronological order since we began keeping these records in
December, 1994.  


February 13, 2006  New Windows version of Trace-2D

Trace-2D has been recompiled to run on Win2K or newer versions
of MS Windows. The interface has been made identical to Trace-3D.


February 2, 2005  Windows version 70LY

We fixed a bug in the line parser used in Trace 3-D.  In previous 
versions, a tab character appearing in certain places could cause 
the parser to fail to recognize valid numerical entries.  Tab 
characters between parameters was not a problem.  However, a 
trailing tab or a tab between the last numerical parameter and a 
comment string (starting with either a semicolon or an exclamation 
mark) prevented the code from identifying the last numerical 
parameter as a number. 


September 20, 2004  Windows version 69LY

Variable XPMF is no longer ignored.  



May 6, 2004  Windows version 68LY

Filenames and paths up to 256 character are now supported.  The 
previous limit was 64 characters.  As of this date, the Linux 
version has not yet been updated.

We made some cosmetic changes to the program menus, enlarged the 
online help dialog box, and added a "Previous page" button to 
the help dialog box.

The solenoid element now has a third parameter, which is a flag 
that indicates whether the code should use a fixed or rotating 
frame for the transformation through the solenoid.  The default
is to use the fixed frame of reference.  If the flag is "1" the
code will use a rotating frame provide that the beam is axisymmetic.
The tolerance on the test for axisymmetry is that the beam alphas
in the X and Y planes are equal within 0.1% and the beam betas 
in the X and Y planes are equal within 0.1%.


 

April 29, 2002, Windows and Linux version 67LY

The "R" command now displays the R-matrix instead of its transpose.  
This bug only effected the display. 



March 18, 2002, Windows and Linux version 66LY

With this release, we introduce a Linux version of Trace 3-D.  The 
directory structure under Trace has changed.  Please refer to file 
_ReadMe.TR for details.  While preparing the Linux version, a number of 
changes were made in the source to improve robustness of the code. 



February 25, 2002, Windows version 66LY

The "R" command was modified slightly to also save the sigma matrix. By 
checking the IBS option on the R-matrix screen and transferring a stored 
R-matrix to the initial R-matrix the corresponding saved sigma matrix is 
transferred to the initial sigma matrix.  This step also sets IBS to the 
current hold array.  When saving the R-matrix, in addition to the sigma 
matrix, the beam energy and current are also saved.  The energy and 
current are also restored with the IBS option checked. 

When starting with a file in which IBS is 15 or greater, the code will 
use the corresponding saved r-matrix, sigma-matrix, current, and energy. 

A new pop-up menu item contains the program commands.  For those 
commands that print data on the screen, the position can be selected by 
clicking a mouse button in the desired location on the screen before 
executing the pop-up command. 

Menu commands that are not active before loading an input file are now 
grayed out. 

Trace 3-D now cleans up after it runs and deletes any .$3d files it has 
generated. 



January 23,2002,  Windows version 65LY

Trace 3-D now uses Winteracter version 4.0. 

The "R" command has a new screen and is easier to use.  A new feature 
sets the initial R-matrix to a saved R-matrix instead of always starting 
a run with the R-matrix set to the identity matrix.  The saved R-matrix 
can be saved in the input file. The namelist entry is HRM for the saved 
R-matrices. 

The "X" command now has a new screen that is easier to use.  

A text editor has been added to Trace 3-D. 

XXI is the beam current that corresponds to the saved beams in the HOLD 
array. XXI is now saved in the namelist file with the save command.  



October 17, 2001,  Windows version 64LY

Trace 3-D has been updated with Winteracter version 3.10.  This update 
added new hard copy graphic formats SVG (Scalable Vector Graphics) and PNG 
(Portable Network Graphics).  The appropriate extension of the plot file 
names are always used.  The code generates the complete path and name of 
the plot file automatically, the user can change the name in the Options 
dialog. 



September 7, 2001,  Windows version 63LY

Trace 3-D has three new namelist parameters in the input file that
control graphics displays.
- If DISPR is nonzero, then Trace plots the R-matrix element(1,6)
  "dispersion function" versus z position.  The value of DISPR is the
  plot limit.
- If BETAX is nonzero, then Trace plots the x Twiss Beta function
  versus z position.  The value of BETAX in is the plot limit in units
  of mm/mrad.
- If BETAY is nonzero, then Trace plots the y Twiss Beta function
  versus z position.  The value of BETAY in is the plot limit in units
  of mm/mrad.

Trace 3-D now parses every line of namelist input and checks for
possible errors in the input parameters.  (The code no longer uses the
FORTRAN implementation of namelist.)  This feature results in better
diagnostic messages and can help save time debugging an input file.  You
can use either a dollar sign ($) or an ampersand (&) as the namelist
delimiter.  In addition, comments can appear on any line in the input
file.  Comment indicators are the, semicolon (;) and exclamation mark
(!).  The types of errors that the code will report include
 - misspelled or invalid variable names
 - missing numerical entry
 - too many entries for the dimension of an array
 - wrong type entry (e.g. number where string expected or vice versa)
 - string variables without matching quotation marks
 - incorrect number of indices for array entries
 - array indices out of range

We updated the Fortran coding in Trace 3-D.  All named common blocks
have been eliminated and global variables are now declared in a Fortran
90 module.  All functions, subroutines, and modules have the "IMPLICIT
NONE" declaration, which requires declaring the type of every variable
and array.  All variables and arrays are initialized at declaration.
These changes make the code more robust and easier to maintain.



July 3, 2001

We fixed a problem in the Windows version of Trace 3-D that affected the
"@" aperture command.  After entering the "@" command, the program no
longer fails with the message "error opening aperture file."



January, 2000

A few cosmetic changes were made to the Windows version of Trace 3-D for
lower resolution displays. The Help screen should always appear on
screen now. For resolutions of 800 X 600 and 640 X 400 the characters
were made larger to improve readability. We also fixed the bend routine
for the case where the field gradient index =1.  This problem and a fix
for it was brought to may attention by G. H. Gillespie. Before this fix
there was several R-matrix elements calculated as 0/0.


August, 1998

A Windows version of TRACE 3-D is now available in the directory
TRACE\EXE\Windows.  With the release of this version, the older codes
for PC users found in the TRACE\EXE\PC directory will no longer be
actively supported.


February, 1997

We fixed a crash that occurred upon starting the PC version of TRACE 2-D
(executable file TR2D.EXE).  The error has probably existed for about
3 months.


November, 1996

We fixed a problem with the mouse in the graphics display screen.  The
cursor previously was stuck at the top or bottom of the screen and the
only way to move around the screen was to use the arrow keys.


July, 1996

Though not a code problem, we believe we may have discovered why some
users occasionally have trouble connecting to one of our FTP servers.
A user in Germany reported that the name PC-AOT-1.ATDIV.LANL.GOV was
being resolved to an IP address different from 128.165.32.190.  The
different address was actually one of two IP addresses that PC-AOT-1
reserves for dynamic assignment to local dial-in clients.  We found that
three different IP addresses were assigned the same name in the domain-
name server (DNS) look-up tables.  We have now changed these assignments
so that PC-AOT-1.ATDIV.LANL.GOV will always point to 128.165.32.190.


February 7, 1996

TRACE-3D for VAXVMS was modified to allow for offset beams and/or
beam-line elements, including calculations for the beam centroids.
For more information refer to the Microsoft Word document TR_V44.DOC
in the VAXVMS directory.


June 7, 1995

Sector bending magnets (BEND elements) in TRACE 3-D now use the
following equation for the R(5,6) matrix element, which is the correct
expression for magnets with a field index n other than zero.

            1
R(5,6)= ÄÄÄÄÄÄÄÄÄÄÄÄ * [kx*s0*beta^2 - sin(kx*s0)]
         kx^3*rho^2

              Ú          1     ¿      s0
            + ³ 1 - ÄÄÄÄÄÄÄÄÄÄ ³ * ÄÄÄÄÄÄÄÄ,
              À     (kx*rho)^2 Ù    gamma^2

where kx^2 = (1-n)/rho^2, n is the field index, rho is the radius of the
bend, and s0 (= rho* alpha) is the distance travelled by the design
particle in going through a bend angle alpha.  Previous versions of
the code omitted the term on the last line, which was only correct for
the case n = 0.  This correction was made in the PC, CRAY, and ALPHAVMS
versions.

BEND elements in the PC version of TRACE 3-D can now include a vertical
bend.  Select the vertical bend option by entering a negative value for
the fourth BEND parameter.  This option has been in the CRAY and VAX
versions for some time.

In TRACE 3-D, the energy-gain expression used for RFGAP elements now
correctly includes charge state of the particle.  The code previously
assumed singly charged ions.  This correction was made in the PC, CRAY,
and ALPHAVMS versions.