PLOT3D_IO
PLOT3D
Read and Write Utilities

PLOT3D_IO is a FORTRAN90 library which reads and writes PLOT3D files.

PLOT3D is a program developed by Pieter Buning at the NASA Ames laboratory, that performs fluid flow calculations in one, two or three dimensions. The program is able to save the results of its calculations in data files that may then be processed by the FAST graphics program, or converted for use by other graphics processors. There are a variety of file formats available:

• formatted or binary data;
• the spatial dimension (1D, 2D or 3D);
• the number of user-defined auxiliary variables;
• the use of blanking to delete portions of the grid;
• the storage of 3D data as a whole, or by planes.

PLOT3D_IO is a simple package of utility routines for working with the PLOT3D graphics files. The current set is restricted to reading data from most binary formats.

Licensing:

The computer code and data files described and made available on this web page are distributed under the GNU LGPL license.

Languages:

PLOT3D_IO is available in a FORTRAN90 version.

Related Data and Programs:

PLOT3D, a data directory which contains a description and examples of PLOT3D data files.

PLOT3D_TO_AVS, a FORTRAN90 program which reads flow data from PLOT3D files and rewrites it into files suitable for input to the AVS graphics system.

Reference:

1. Pamela Walatka, Pieter Buning, Larry Pierce, Patricia Elson,
   PLOT3D User's Guide,
   NASA TM 101067,
   March 1990.

Source Code:

• plot3d_io.f90, the source code;
• plot3d_io.sh, commands to compile the source code;

Examples and Tests:

Q_DEMO shows how to read a Q file. Files you may copy include:

• q_demo.f90, reads a Q file;
• q_demo.sh, commands to compile, link and run the demo;
• q_demo.txt, output from the demo;

XYZ_DEMO shows how to read an XYZ file. Files you may copy include:

• xyz_demo.f90, reads an XYZ file;
• xyz_demo.sh, commands to compile, link and run the demo;
• xyz_demo.txt, the output file;

List of Routines:

In the following list of routines,

• A routine name beginning with "R4" is for single precision real data; a routine name beginning with "R8" is for double precision real data.
• An X, XY, or XYZ file contains 1D, 2D or 3D coordinate data.
• An XYZB file contains 3D coordinate data and blanking.
• A Q file contains density, the momentum vector, and stagnation energy at each point.
• An F file contains a scalar value defined at each point.

• GET_UNIT returns a free FORTRAN unit number.
• R4_B_1D_DIM reads a binary 1D file for the dimension.
• R4_B_1D_DIMN reads a binary 1D file for the dimension and NVAR.
• R4_B_1D_F reads a binary 1D file for the F data.
• R4_B_1D_FFILE reads a binary 1D F file.
• R4_B_1D_Q reads a binary 1D Q file for the Q data.
• R4_B_1D_QFILE reads a binary 1D Q file.
• R4_B_1D_X reads a binary 1D X file for the X data.
• R4_B_1D_XYFILE reads a binary 1D X file.
• R4_B_2D_DIM reads a binary 2D file for the dimensions.
• R4_B_2D_DIMN reads a binary 2D file for the dimensions and NVAR.
• R4_B_2D_F reads a binary 2D F file for the F data.
• R4_B_2D_FFILE reads a binary 2D F file.
• R4_B_2D_Q reads a binary 2D Q file for the Q data.
• R4_B_2D_QFILE reads a binary 2D Q file.
• R4_B_2D_XY reads a binary 2D XY file for the XY data.
• R4_B_2D_XYFILE reads a binary 2D XY file.
• R4_B_3D_DIM reads a binary 3D file for the dimensions.
• R4_B_3D_DIMN reads a binary 3D file the dimensions and NVAR.
• R4_B_3D_F reads a binary 3D F file for the F data.
• R4_B_3D_FFILE reads a binary 3D F file.
• R4_B_3D_Q reads a binary 3D Q file for the Q data.
• R4_B_3D_QFILE reads a binary 3D Q file.
• R4_B_3D_XYZ reads a binary 3D XYZ file for the XYZ data.
• R4_B_3D_XYZB reads a binary 3D XYZB file for the XYZB data.
• R4_B_3D_XYZBFILE reads a binary 3D XYZB file.
• R4_B_3D_XYZFILE reads a binary 3D XYZ file.
• R4_B_3DM_DIM reads a binary 3D multiple grid file for the dimensions.
• R4_B_3DM_NGRID reads a binary 3D multiple grid file for the number of grids.
• R4_B_3DM_Q reads a binary 3D multiple grid Q file for the parameters and Q data.
• R4_B_3DM_XYZ reads a binary 3D multiple grid XYZ file for the XYZ data.
• R4_B_3DM_XYZB reads a binary 3D multiple grid XYZB file for the XYZB data.
• R4_B_3DM_QFILE reads a binary 3D multiple grid Q file.
• R4_B_3DM_XYZFILE reads a binary 3D multiple grid XYZ file.
• R4_B_3DM_XYZBFILE reads a binary 3D multiple grid XYZB file.
• R4_B_3DP_F reads a binary 3D plane F file for the F data.
• R4_B_3DP_FFILE reads a binary 3D plane F file.
• R4_B_3DP_Q reads a binary 3D plane Q file for the Q data.
• R4_B_3DP_QFILE reads a binary 3D plane Q file.
• R4_B_3DP_XYZ reads a binary 3D plane XYZ file for the XYZ data.
• R4_B_3DP_XYZB reads a binary 3D plane XYZB file for the XYZB data.
• R4_B_3DP_XYZBFILE reads a binary 3D plane XYZB file.
• R4_B_3DP_XYZFILE reads a binary 3D plane XYZ file.
• R4_B_PARAM reads a binary Q file for the flow parameters.
• R8_B_1D_DIM reads a binary 1D file for the dimension.
• R8_B_1D_DIMN reads a binary 1D file for the dimension and NVAR.
• R8_B_1D_F reads a binary 1D file for the F data.
• R8_B_1D_FFILE reads a binary 1D F file.
• R8_B_1D_Q reads a binary 1D Q file for the Q data.
• R8_B_1D_QFILE reads a binary 1D Q file.
• R8_B_1D_X reads a binary 1D X file for the X data.
• R8_B_1D_XYFILE reads a binary 1D X file.
• R8_B_2D_DIM reads a binary 2D file for the dimensions.
• R8_B_2D_DIMN reads a binary 2D file for the dimensions and NVAR.
• R8_B_2D_F reads a binary 2D F file for the F data.
• R8_B_2D_FFILE reads a binary 2D F file.
• R8_B_2D_Q reads a binary 2D Q file for the Q data.
• R8_B_2D_QFILE reads a binary 2D Q file.
• R8_B_2D_XY reads a binary 2D XY file for the XY data.
• R8_B_2D_XYFILE reads a binary 2D XY file.
• R8_B_3D_DIM reads a binary 3D file for the dimensions.
• R8_B_3D_DIMN reads a binary 3D file the dimensions and NVAR.
• R8_B_3D_F reads a binary 3D F file for the F data.
• R8_B_3D_FFILE reads a binary 3D F file.
• R8_B_3D_Q reads a binary 3D Q file for the Q data.
• R8_B_3D_QFILE reads a binary 3D Q file.
• R8_B_3D_XYZ reads a binary 3D XYZ file for the XYZ data.
• R8_B_3D_XYZB reads a binary 3D XYZB file for the XYZB data.
• R8_B_3D_XYZBFILE reads a binary 3D XYZB file.
• R8_B_3D_XYZFILE reads a binary 3D XYZ file.
• R8_B_3DM_DIM reads a binary 3D multiple grid file for the dimensions.
• R8_B_3DM_NGRID reads a binary 3D multiple grid file for the number of grids.
• R8_B_3DM_Q reads a binary 3D multiple grid Q file for the parameters and Q data.
• R8_B_3DM_XYZ reads a binary 3D multiple grid XYZ file for the XYZ data.
• R8_B_3DM_XYZB reads a binary 3D multiple grid XYZB file for the XYZB data.
• R8_B_3DM_QFILE reads a binary 3D multiple grid Q file.
• R8_B_3DM_XYZFILE reads a binary 3D multiple grid XYZ file.
• R8_B_3DM_XYZBFILE reads a binary 3D multiple grid XYZB file.
• R8_B_3DP_F reads a binary 3D plane F file for the F data.
• R8_B_3DP_FFILE reads a binary 3D plane F file.
• R8_B_3DP_Q reads a binary 3D plane Q file for the Q data.
• R8_B_3DP_QFILE reads a binary 3D plane Q file.
• R8_B_3DP_XYZ reads a binary 3D plane XYZ file for the XYZ data.
• R8_B_3DP_XYZB reads a binary 3D plane XYZB file for the XYZB data.
• R8_B_3DP_XYZBFILE reads a binary 3D plane XYZB file.
• R8_B_3DP_XYZFILE reads a binary 3D plane XYZ file.
• R8_B_PARAM reads a binary Q file for the flow parameters.
• TIMESTAMP prints the current YMDHMS date as a time stamp.

You can go up one level to the graphics source codes.