Program "mpi_tjet" (LES of non-isothermal circular jet in air)
    
Version 0.3 of Dec 20, 2001
    
Purpose: Comparison between experimental data found in [Abramovitcsh] on non-isothermal jet in coflowing stream.

Author: Chernousov A. A. <andrei2000@mail.rb.ru>           

---

User manual (step by step):

1.  Untar "mpi_tjet.tar.gz" to e.g. your home directory. Subdirectory "mpi_tjet" will 
    be created.
  
2.  cd to "mpi_tjet" directory (referred as "." in the following)
  
3.  Build "mpi_tjet" using command 'make' or 'make mpi_tjet'
  
4.  Broadcast "mpi_tjet" binary over the nodes of a Beowulf cluster (change to fit your needs
    and run "./broadcast" script)
   
5.  Set the appropriate cluster configuraton in "pg_mpi_tjet" file
  
6.  [Optional] Set the appropriate test problem input data in "./ini2bin/mpi_tjet.ini"
    and then compile "./ini2bin/ini2bin.c" and run "./ini2bin/ini2bin". Copy/move
    the resulting "./ini2bin/mpi_tjet.bin" file to "."
    (Default setting in "./ini2bin/mpi_tjet.ini" assumes that every of cartesian grid
    3D subdomains will have 125*125*43 cells in x, y and z-dimension, and the radius
    of the non-isothermal jet equals to 7 meters)
  
7.  Make sure that the symlink "@mpirun" correctly points to "mpirun" script found 
    in the MPI system directory (you must be able to read/run "mpirun" using this link,
    see MPIR_HOME in the Makefile). 
    Otherwise create the link using command 'ls -s [..see.MPIR_HOME!..] mpirun'

8.  Run "@mpirun" using e.g. "run" command file
  
9.  Stop the running parallel job by changing 'g' (go) character in "stopfile" to 's' (stop)
  
10. [Optional :-)] Visualize the output. 
    for 2D plot: Copy files "[numstep].[0-numprocs]"  to "./mb2dat" directory
        Make "mb2dat.c". Run "command". Answer: "[numstep]" and "[numprocs]"
	Several binary files with binary-coded 2D flowfields of |vorticity|
	will produce text datafiles "winfield.dat" and "datafile.da"
	You may use "winfield.dat" with "winfield.exe" win32 executable,
	or use "datafile.da" for plot the flowfield via Gnuplot (see "./plot")
    for 1D averaged profile: Copy any one of files "probes.[0-numprocs]" to "./probes"
        as "probes.dat", compile and run "./probes/probes". You will be asked
	for initial and final steps in time to compute averaged profiles of U an T
	versus y-coordinate in the middle section the process's subdomain,
	and for this subdomain cells count in y-direction (HIG).
	The resulting file "probe.dat" will contain time-averaged profiles of U(y) [m/s]
	and T(y) [K].
  
11. To continue with LES, change 'Answer' parameter in "./ini2bin/mpi_tjet.ini" to 1,
    run "./ini2bin/ini2bin" and move "./ini2bin/mpi_tjet.bin" to ".".
    Run "run". Now the processes will read saved solution arrays from "backup.[0-numprocs]"
    files.

----