
Pieter Buning / Larry Pierce
NASA Ames Research Ctr.
(415) 694-4492 or FTS 464-4492
pierce@prandtl.nas.nasa.gov

Bugs with version 3.6 of PLOT3D:


----------------------------------------------------------------------
All versions of PLOT3D and TURB3D:

in SUBROUTINE VECCM1: "ISHAPT" should be "ISHPAT"  ("commands" module)
in SUBROUTINE INV2X2: "S(3)" should be "S(2)"      ("particles" module)
----------------------------------------------------------------------


----------------------------------------------------------------------
VAX/VMS versions of PLOT3D and TURB3D: 

^C during a PLOT causes a FORTRAN STOP.  PLOT3D and TURB3D need to be 
modified for compatibility with VMS version 5 (they are presently 
compatible with VMS version 4.5).
----------------------------------------------------------------------

The above was true as of 3/9/89.


----------------------------------------------------------------------
I've found a bug in FBSYMB in the IRIS and SUPERCOMPUTER/IRIS versions
of PLOT3D and TURB3D (unix+iris2 and unix+iris2_rgla/local):  

References to BUF(IBUF+2) etc should be BUF(3) etc.  IBUF is undefined,
but if it was defined it would have the value 1.
Look in SUBROUTINE FBSYMB in file iris2.f.
----------------------------------------------------------------------

The above was true as of 3/10/89.


----------------------------------------------------------------------
All versions of PLOT3D and TURB3D: 

in module "commands", SUBROUTINE 
CONMAN: MCONT (the maximum number of manually entered contour levels)
is not checked, so it is possible for array overflow to occur.
----------------------------------------------------------------------

The above was true as of 4/3/89.


----------------------------------------------------------------------
IRIS 4D versions (stand-alone or local) of PLOT3D and TURB3D: 

the file "port.h" (referenced by
the Seiko screen-save stuff in iris2c.c) does not exist on many of the
new 4D's.  In order to get the code to compile/link, one should delete
all references to "port.h" from file iris2c.c.
----------------------------------------------------------------------


----------------------------------------------------------------------
IRIS 4D versions (stand-alone or local) of PLOT3D and TURB3D: 

Replace all occurrences of "1024" with "XMAXSCREEN+1" in file iris2c.c.
This might fix some of the problems.
----------------------------------------------------------------------

The above was true as of 4/11/89.


----------------------------------------------------------------------
All versions of PLOT3D (and TURB3D too):

The routines SUBSAD, WALSAD, RAKIJK, and RAKXYZ will not deal with 
overflow situations (e.g. the user inputs more RAKES than PLOT3D can
store) very gracefully.  This will be fixed in version 3.7.  For now,
just beware when using SUBSETS, WALLS, or RAKES.
----------------------------------------------------------------------

The above was true as of 3/30/89.


----------------------------------------------------------------------
All versions of PLOT3D (and TURB3D too):

SHOW PLOT will not always indicate correctly whether or not additional
text is turned on or off (PLOT/ADDITIONAL or PLOT/NOADDITIONAL).   This
will be fixed in version 3.7.
----------------------------------------------------------------------

The above was true as of 5/4/89.


----------------------------------------------------------------------
On the IRIS 2xxx/3xxx.  If sub-directory arcgraph does not contain a file 
called "fixit.f" then when PLOT3X (or TURB3X) is being 'made', 
ld may give errors of the form:

   Undefined:
   ishftc
   iand
   *** Error code 1
   
   Stop.

Try doing the following:
1) delete the plot3x executable file that was created.
2) cd arcgraph
3) create a FORTRAN (.f) file with two FUNCTION's in it: ISHFTC and IAND.
   You can put the following code into that file:

      FUNCTION IAND(I1,I2)
      COMMON/GGELOG/ LOUT,EACTIV

      WRITE(LOUT,100)
100   FORMAT(' ARCGRAPH ERROR (IAND): ',/,
     .       ' this dummy routine is never supposed to be called.')

      STOP ' IAND '
      END
      FUNCTION ISHFTC(I1,I2)
      COMMON/GGELOG/ LOUT,EACTIV

      WRITE(LOUT,100)
100   FORMAT(' ARCGRAPH ERROR (ISHFTC): ',/,
     .       ' this dummy routine is never supposed to be called.')

      STOP ' ISHFTC '
      END

   Compile the FORTRAN file (using f77 -c) to create a .o file.  
4) put the new .o file just created into the grafix.a archive:

      ar rv grafix.a newfile.o
      ranlib grafix.a

5) now go back up (cd ../) and trying doing the 'make' again.  
   The 'make' should continue where it left off (i.e. it will try to
   link up plot3x again).  This time plot3x should be created 
   correctly (with no errors).

PLOT3X should run fine with these changes.  In the very unlikely event that
FUNCTION IAND or FUNCTION ISHFTC is called, PLOT3X will stop dead in its
tracks, and you should call me (because I don't think this should ever 
happen) !!!  I tested the above procedure and it worked on my IRIS's.

----------------------------------------------------------------------

The above was true as of 6/13/89.


----------------------------------------------------------------------

Bug with the supercomputer/IRIS version of PLOT3D/TURB3D:

The supercomputer PLOT3D/TURB3D process assumes that the IRIS is a 
2xxx/3xxx model, and therefore the color table is incorrect if the IRIS
is a 4D model.  The result is that plots on a 4D may have very weird 
coloring.  This bug will be fixed in future releases.  For now, here is
a quick way to make a PLOT3D/TURB3D executable for your supercomputer that
will have a color-table compatible with your IRIS 4D (but NOT compatible
with your IRIS 2xxx/3xxx):

1) append the following six lines to your supercomputer Makefile (e.g.
   Makefile.c2, Makefile.ymp, etc.):

<TAB>
iris2_rgla.o:<TAB>iris2_rgla.f
<TAB>$(CPP) $(INCLUDES) -P -Dtarget_4d iris2_rgla.f cpptmp.f
<TAB>$(F77) $(F77FLAGS) -c cpptmp.f
<TAB>mv cpptmp.o iris2_rgla.o
<TAB>$(RM) cpptmp.f

   Where you see <TAB> you should insert at least one tab character.

2) Now you must make a minor change to the supercomputer PLOT3D/TURB3D 
   source code.  Edit file "iris2_rgla.f".  Find SUBROUTINE TBL12.  
   Somewhere not far from the top of this routine you will find the 
   following statement:

#ifdef mips

   Replace the above statement with this:

#ifdef target_4d

3) Now you are ready to "make" the supercomputer PLOT3D/TURB3D 
   executable.  If you had previously done a "make", delete the
   following files (or at least move them out of the directory)
   before re-making:

iris2_rgla.o
plot3d (or turb3d)

NOTE: If your IRIS is a 2xxx/3xxx then you should not make the above changes.

----------------------------------------------------------------------

NOTE: the above was true as of 9/12/89.


------------------------------------------------------------------

Bug with the PLOT3D tools MIRRORX and MIRRORQ:

On line 73 of mirrorx.f (line 74 of mirrorq.f), the following line:

      else if (ans.eq.'y' .or. ans.eq.'Y') then

should be replaced with:

      else if (ans.eq.'z' .or. ans.eq.'Z') then

------------------------------------------------------------------

The above was true as of 9/28/89.


------------------------------------------------------------------

Bug with IRIS-4D and Supercomputer/IRIS-4D implementations of PLOT3D:

Sometimes when in "mouse mode" (the mode in which it is possible to 
rotate, translate, and zoom objects in the graphics windows) things
go hay-wire.  This happens when the window being moused in
is partially obscured by another window and the left mouse button is
being used (to rotate).  One possible solution is to move the cursor into 
the area of the window where the left mouse button was first depressed, and 
then toggle the right or middle mouse buttons; sometimes this restores normal
mouse/cursor function; make sure the left mouse button is NOT depressed when 
you try this.

------------------------------------------------------------------

The above was true as of 12/19/89.

