Building the programs

The following is a set of instructions for building the compressible-flow simulation program mb_cns.exe and its pre- and post-processors. The package should work on any Unix-like platform with an ANSI C compiler. This includes the Win32 platform, for which there is also a collection of pre-compiled binaries (found in the download section of the CFCFD home page).

The original development was done in a SUN OS environment at ICASE with the vectorisation tuned for Cray Y/MP and Cray 2 supercomputers. Further development was done under IBM AIX, HP/UX, Fujitsu VCC, IRIX, OS/2, Win32 systems, and (most recently) Linux. To build on Win32, it is best to have installed the Cygwin Unix-like environment.

Assumed Directories

As of August, 1998, the mb_cns, L1d, and plot packages have been rearranged into a unified directory tree as described below.

The zip, tar and make files are set up assuming the following directory arrangement within the top level directory $HOME/cfcfd/code/. Within that directory, mb_cns, L1d, nm, gas_models, util and plot packages each have a directory. Within the mb_cns directory the following subdirectories are of interest:

The other packages will have a similar hierarchy of subdirectories.

Unpacking the Source Files

Put the tarred and gzipped files (mb_cns.tar.gz, cfd_util.tar.gz and cfd_plot.tar.gz) into a root directory. Your $HOME directory is a good choice. Unzip and extract from the tar file all of the source and documentation files

   % gzip -d mb_cns.tar
   % tar -xvf mb_cns.tar
   
or, if you are using GNU utilities,
   % tar --gunzip -xvf mb_cns.tar.gz
   
Do the same for the other tar balls (cfd_util.tar.gz, cfd_plot.tar.gz). At this point, you should have all of the source code for the MB_CNS package, the (postscript and hypertext) documentation and a few example data files.

Invoking the Makefile

Change to the source directory and build the executable programs by invoking the make file and specifying the target computer. For example, the programs can be built for a UNIX workstation with the GNU C compiler using

% make TARGET=for_gnu
To make the program for a multiprocessor Origin 3000 use
% make TARGET=for_sg_mp
And then install the executable files using
% make install
For further target architectures, see the systems.mk. Actually, TARGET=for_gnu is the default so you don't need to explicitly request it when invoking make in a GNU environment.

You should also build the plotting programs by going into their build directory (cfcfd/code/plot/unix) and invoking the make utility in a similar manner.

At this point you should have a complete set of executables in the $HOME/cfd_bin directory and you are now ready to try running them. Of course, it will be convenient to have $HOME/cfd_bin as part of your search path.


MB_CNS (C) P. A. Jacobs
Last Updated 13-Oct-04, 25-Oct-05