1 TRANSP_news
This document contains *very brief* descriptions of new TRANSP
features.  Generally, detailed descriptions of namelist controls
and/or new code outputs associated with the new feature, are
described in the main TRANSP help file.

The date in the subtopic refers to the approximate date of availability
of the new feature.

Old news will be purged out of this document from time to time.

2 Oct_2008_alt_versions
A choice of versions is now available to TRANSP users.  Details follow
here (this is a copy of email sent to TRANSP users in Oct. 2008):

The Fusion Grid TRANSP service now supports user access to two versions 
of the code:

  pshare -- production shared version (this is the default choice)
  tshare -- test shared version

At present, pshare dates from May 2008 and will not be updated until 
after APS, whereas tshare was updated in early October 2008.

PTRANSP users should use the tshare version to get the latest transport 
equation solver options and fixes.

The tshare version contains the most recent available TORIC ICRF wave code,
which includes repaired HHFW capability and other physics updates from the
TORIC authors.  For minority heating scenarios, its results are similar but
not identical to the TORIC copy (which dates back to Dec. 2007) installed
in the May 2008 version of the code (pshare).

To invoke tshare using the PPPL command line procedure "tr_start", append
the optional argument "tshare", as in:

  [make sure you have a Fusion Grid proxy and all your data is ready]

  # select tshare and check/send data
  tr_start 123456A78 tshare

  # launch job
  tr_send 123456A78

to run 123456A78 using the tshare version of the code.  If the "tshare"
argument is omitted, the pshare version is run.

If the tshare version is being used for an active job, the PPPL web 
monitor http://w3.pppl.gov/transp/transpgrid_monitor_active will show a 
line "trexe" which will contain a binary path which includes the word 
"tshare", i.e.:  /p/xshare/tshare/transp/codesys.  For pshare jobs no 
such line will appear.

Later, in the run output, if you use MDSplus, the code build date is
stored in the TRANSP tree top level data node DATE_EXEFILE.  If you
receive the output in file format, one of the files returned is 
<runid>TR.INF which contains the code build date in a line that looks
like this:

>>>>Code COMMONs BUILD date:  Fri Oct  3 20:10:48 EDT 2008

(this is the current tshare build date)... or...

>>>>Code COMMONs BUILD date:  Tue May 13 05:36:50 EDT 2008

(this is the current pshare build date).

After APS, pshare will be updated.  There will be times in the future
when the two versions, pshare and tshare, will be identical.

The updated tr_start scripts are available via the "tr_client" module at
the NTCC site http://w3.pppl.gov/NTCC or otherwise by request, send email
to Transp_support@pppl.gov.

2 Nov_2005_NCLASS_code
The namelist variable NCMODEL selects the NCLASS code base used
for the neoclassical analysis.  Previously NCMODEL=1 was the default
which used Wayne Houlberg's original fortran 77 code.  The default
is now NCMODEL=2 which uses Wayne's f90 NCLASS module.  There are
a few additional features available with NCMODEL=2 described in
tranp.hlp along with the capability for executing NCLASS through
a stand alone program.  The driver for NCMODEL=2 is based on
Wayne's forcebal program.  Also the default for NLSQUEEZ has been
changed from .TRUE. to .FALSE. so squeezing is turned off.  This
change is based on the recommendation to Bob Budny by Wayne. 


2 Jun_2005_TRANSP_internal_upgrade

To improve consistency of internal treatment of sources and current
drive terms, all internal arrays representing profiles of particle
sources, momentum sources, and power sources, have their area or 
volume normalizations taken out.  (Previously this was done for beam 
heating but not other sources; now it is done for *all* sources, torques, 
and powers).  (Exceptions: neutral gas model profiles with neutral source
index; neutral gas model particle, momentum and power balance terms, 
poloidal field diffisuion equation energy balance check, and certain 
otherm sums for "output only" such as particle, momentum, and power
balance checks).

The motivation here is to treat all auxilliary heating sources and 
related terms the same way as the beam sources are treated; also to 
facilitate generation of an MKS-based communications mechanism btw
TRANSP and external predictive solvers.

The output seen by the user is unchanged.

For quantities appearing in "outcor/plotgen.i", volume normalizations
and area normalizations are re-inserted for output, with the expressions
(item)/DVOL(#1,2) or (item)/DAREA(#1).

2 Apr_2005_f90_upgrade

The TRANSP internal COMMON has been replaced with a fortran-90 module
with dynamically allocated components.  This means the following 
former restrictions on code use have been removed:

  (a) no limit on size/amount of input data
  (b) "no limit" other than size of output file on number of radial 
      zones.  A soft limit of 800 is still enforced; if the code is
      run at this resolution some output utilities may need conversion.
      NZONES up to 800 (or slightly more) may be set, but is not
      necessarily recommended.
  (c) "no limit" other than size of memory and output files on the
      number of fast ion distribution function spatial zones-- i.e
      NZONES_FB -- i.e. NZONES_FB > 20 may be set.  Since the size
      of this grid scales as NZONES_FB**2, NZONES_FB =~50 is probably
      still a limit in practice.  NZONES has to be an integer multiple
      of NZONES_FB, as before.

For traditional runs (NZONES=20 or 50; NZONES_FB=10), the code will run
~10% faster, because it is not carrying statically allocated arrays far
bigger than needed to meet these modest resolution requirements.
   
2 17 Dec_2004_MSE_sim

A new feature has been added to the code, for simulation of MSE signals.
Please look for "N_MSESIM" in the "Transp Help" webpage:

  http://w3.pppl.gov/~pshare/help/transp.htm

2 Dec_2004_Various

Miscellaneous changes to TRANSP due to requests received by D. McCune
on visit to JET & MAST (Culham) and IPP/Garching:

  => default value of DANOM_QLIM0 reset to 0.0
     (no anomolous diffusion in "current hole" regions by default)

  => NLBEAMCX switch added; NLBEAMCX=.FALSE. to suppress Monte Carlo
     fast ion charge exchange losses; NLBEAMCX=.TRUE. by default.

  => TABORT default changed, to avoid spurious crashes when TINIT=0.0.

2 Oct_2004_TaupMN

The default value of the namelist control TAUPMN has been changed
from 0.0001 to 0.002 seconds -- this variable puts a lower limit
on ion species confinement times and hence an upper limit on recycling
flux at any given time in the simulation.

2 Sep_2004_New_xtranspin

The file i/o of the xtranspin GUI has been redone, so that namelist
changes invoked through the GUI are edited into the namelist in a
"minimalist" fasion, and all user comments are preserved in place.

2 Apr_2004_GA_TORAY_Available

The Electron Cyclotron Resonance Heating (ECRH) package TORAY-GA
is now available in TRANSP. It can be invoked by the switch
NLTORAY=.TRUE. in the TRANSP namelist. In addition to this switch,
other parameters such as number of gyrotrons, on-off times,
and their positions and launch angles need to be specified.
Complete documentation on TORAY-TRANSP is available in Transp Help
(http://w3.pppl.gov/transp/).

2 Apr_2004_PMHD_IN

The TRANSP output profile quantity PMHD_IN now contains the plasma
pressure as used by the MHD equilibrium solver (for TRANSP runs 
which do equilibrium reconstruction, i.e. LEVGEO.NE.8).  This is
a change from the old TRANSP where the profile PTOWB was always 
the pressure profile input for equilibrium solution.

For most TRANSP configurations, PMHD_IN = PTOWB = the sum of pressure
components as defined in source/doc/beta.doc.  However, some namelist
configurations allow these two to be different.  For example, in 
"current hole" experiments with zero or minimal current near the
plasma core, setting grad(PMHD_IN)=0 is often required in order to
obtain an equilibrium solution.  For modeling purposes in such runs 
users can set a lower limit on the toroidal current using

  NLQLIM0 = .TRUE.   ! use QLIM0 to force some toroidal current
  QLIM0 = <upper limit on q near axis>

then in regions near the axis where q >= QLIM0 + DQ_PLIM0, the 
pressure profile (PMHD_IN) is flattened.  DQ_PLIM0 is a namelist
control with a default value of (-0.5d0).

TRANSP post-processing codes which used to read PTOWB may want to 
consider reading PMHD_IN instead.

1 Code_Update_History
 
 Wed Jan 14 10:38:43 EST 2004  -- pshare update
 
 Thu Jan 22 17:47:53 EST 2004  -- pshare update
 
 Mon Feb  2 02:17:15 EST 2004  -- pshare update
 
 Fri Feb  6 11:44:57 EST 2004  -- pshare update
 
 Thu Feb 26 19:04:25 EST 2004  -- pshare update
 
 Mon Mar  1 15:10:24 EST 2004  -- pshare update
 
 Mon Mar 22 19:00:15 EST 2004  -- pshare update
 
 Tue Mar 23 11:37:17 EST 2004  -- pshare update
 
 Wed Mar 31 16:42:53 EST 2004  -- pshare update
 
 Tue Apr  6 17:25:25 EDT 2004  -- pshare update
 
 Wed Apr 14 13:20:54 EDT 2004  -- pshare update
 
 Tue Apr 20 15:27:30 EDT 2004  -- pshare update
 
 Fri Apr 23 00:45:35 EDT 2004  -- pshare update
 
 Fri Apr 30 17:49:14 EDT 2004  -- pshare update
 
 Mon May 10 19:41:40 EDT 2004  -- pshare update
 
 Sun May 23 21:19:32 EDT 2004  -- pshare update
 
 Mon May 24 12:21:27 EDT 2004  -- pshare update
 
 Wed Jun  2 17:31:09 EDT 2004  -- pshare update
 
 Tue Jun  8 23:31:19 EDT 2004  -- pshare update
 
 Thu Jun 10 10:48:21 EDT 2004  -- pshare update
 
 Thu Jun 10 17:27:43 EDT 2004  -- pshare update
 
 Fri Jun 25 14:09:40 EDT 2004  -- pshare update
 
 Tue Jul  6 17:20:57 EDT 2004  -- pshare update
 
 Thu Sep  9 19:01:49 EDT 2004  -- pshare update
 
 Sun Sep 26 21:30:18 EDT 2004  -- pshare update
 
 Tue Nov  9 11:59:13 EST 2004  -- pshare update
 
 Mon Nov 15 16:40:53 EST 2004  -- pshare update
 
 Wed Dec  8 13:16:34 EST 2004  -- pshare update
 
 Wed Dec 15 11:20:44 EST 2004  -- pshare update
 
 Fri Dec 17 19:28:32 EST 2004  -- pshare update
 
 Wed Feb  9 16:28:28 EST 2005  -- pshare update
 
 Wed Mar 16 12:31:57 EST 2005  -- pshare update
 
 Tue May  3 22:00:22 EDT 2005  -- pshare update
 
 Thu May 26 19:10:36 EDT 2005  -- pshare update
 
 Thu Jun  2 00:17:05 EDT 2005  -- pshare update
 
 Fri Jul  1 17:07:20 EDT 2005  -- pshare update
 
 Thu Aug 11 17:18:13 EDT 2005  -- pshare update
 
 Fri Aug 19 16:09:28 EDT 2005  -- pshare update
 
 Tue Sep  6 18:35:23 EDT 2005  -- pshare update
 
 Tue Sep 27 12:52:09 EDT 2005  -- pshare update
 
 Fri Oct 28 13:11:26 EDT 2005  -- pshare update
 
 Wed Jan 11 20:56:52 EST 2006  -- pshare update
 
 Thu Feb 16 17:31:32 EST 2006  -- pshare update
 
 Fri Mar  3 12:58:38 EST 2006  -- pshare update
 
 Mon Mar 20 11:05:41 EST 2006  -- pshare update
 
 Wed Apr  5 12:50:38 EDT 2006  -- pshare update
 
 Wed Apr  5 19:52:49 EDT 2006  -- pshare update
 
 Tue May  2 18:33:15 EDT 2006  -- pshare update
 
 Tue May  9 11:00:00 EDT 2006  -- pshare update
 
 Fri May 26 14:24:11 EDT 2006  -- pshare update
 
 Mon Jun 12 21:02:41 EDT 2006  -- pshare update
 
 Fri Jun 23 17:02:49 EDT 2006  -- pshare update
 
 Tue Jul 18 21:40:39 EDT 2006  -- pshare update
 
 Tue Jul 25 13:14:42 EDT 2006  -- pshare update
 
 Wed Aug 23 20:09:56 EDT 2006  -- pshare update
 
 Thu Sep 28 16:29:31 EDT 2006  -- pshare update
 
 Mon Nov 27 14:18:32 EST 2006  -- pshare update
 
 Mon Jan  8 19:39:04 EST 2007  -- pshare update
 
 Fri Jan 19 19:10:03 EST 2007  -- pshare update
 
 Tue Jan 30 21:05:30 EST 2007  -- pshare update
 
 Tue Feb  6 13:30:02 EST 2007  -- pshare update
 
 Sat Feb 10 13:10:41 EST 2007  -- pshare update
 
 Tue Feb 27 18:56:21 EST 2007  -- pshare update
 
 Tue Mar  6 13:51:08 EST 2007  -- pshare update
 
 Tue Mar  6 17:52:42 EST 2007  -- pshare update
 
 Tue Apr  3 22:44:33 EDT 2007  -- pshare update
 
 Fri Apr 13 18:53:47 EDT 2007  -- pshare update
 
 Tue May 22 19:33:48 EDT 2007  -- pshare update
 
 Tue May 29 19:45:40 EDT 2007  -- pshare update
 
 Thu Jun 21 21:24:34 EDT 2007  -- pshare update
 
 Mon Jul  2 19:21:56 EDT 2007  -- pshare update
 
 Fri Jul  6 15:41:19 EDT 2007  -- pshare update
 
 Mon Jul  9 19:23:55 EDT 2007  -- pshare update
 
 Wed Jul 25 20:20:44 EDT 2007  -- pshare update
 
 Tue Jul 31 14:00:51 EDT 2007  -- pshare update
 
 Thu Aug  9 18:17:18 EDT 2007  -- pshare update
 
 Tue Aug 14 14:59:54 EDT 2007  -- pshare update
 
 Fri Sep  7 03:21:33 EDT 2007  -- pshare update
 
 Fri Sep 28 13:31:14 EDT 2007  -- pshare update
 
 Tue Oct 30 15:45:24 EDT 2007  -- pshare update
 
 Fri Nov 30 20:16:49 EST 2007  -- pshare update
 
 Mon Dec 17 10:53:39 EST 2007  -- pshare update
 
 Tue Jan  8 10:53:23 EST 2008  -- pshare update
 
 Wed Jan 16 16:26:43 EST 2008  -- pshare update
 
 Wed Feb  6 15:16:59 EST 2008  -- pshare update
 
 Mon Mar 17 15:50:12 EDT 2008  -- pshare update
 
 Wed Mar 19 12:39:53 EDT 2008  -- pshare update
 
 Fri Mar 21 17:03:37 EDT 2008  -- pshare update
 
 Fri Apr 25 16:09:39 EDT 2008  -- pshare update
 
 Mon Apr 28 23:28:37 EDT 2008  -- pshare update
 
 Tue Jun  3 14:31:46 EDT 2008  -- pshare update
 
 Fri Jun 27 18:05:14 EDT 2008  -- pshare update
 
 Mon Jul 14 13:51:13 EDT 2008  -- pshare update
 
 Mon Dec  1 15:03:21 EST 2008  -- pshare update
 
 Mon Dec  8 18:43:09 EST 2008  -- pshare update
 
 Mon Jan  5 11:58:21 EST 2009  -- pshare update
 
 Mon Jan  5 15:21:04 EST 2009  -- pshare update
