IMOC Installation

Since IMOC is provided as a loadable module and set of Tcl scripts, you need to have Tcl/Tk (Version 8.x) up and running on your system. To get started with Tcl/Tk, more information can be found at the URL The Tcl Developer Xchange.

MS-Windows (Defunct)

The imoc.zip file includes prebuilt DLLs for both Tcl 8.0 and 8.3. Just unzip the package somewhere convenient and run the Setup.exe. This is an InstallShield setup program, so just follow the prompts.

By default, the Tcl scripts and the DLLs are installed into an imoc directory within your "Program Files/" directory. Also, a moc_startup entry is added to the Programs menu under the Start button. Starting the program this way will result in the wish interpreter not accepting input from the console. This may not be a bother if you intend using only the GUI for interaction with IMOC. However, if you wish to be able to type commands directly into the console window, start the wish interpreter alone and then source moc_startup.tcl to load the IMOC program scripts. You can find a copy of this startup script in the "Program Files/imoc/source/" directory. Depending on which version of Tcl/Tk you have installed, your wish interpreter may be called wish83.exe. It should be found in the Tcl directory "Program Files/Tcl/bin/".

If you have IMOC as source code only, you will need to build the DLLs. On Win32 systems, the IMOC library presently needs to be linked against a particular Tcl library. There is a makefile for the Borland C/C++ compiler and the DLLs for both Tcl versions 8.0 and 8.3 can be built in the directory imoc/borland. The makefile assumes that Tcl/Tk was installed on drive C: (as per my system). If you need to use the makefile, you may need to edit it to suit your system. This will probably involve changing the drive where Tcl is installed and/or the removal of one of the DLL targets.

UNIX/Linux (Updated April 2007)

For Linux/UNIX, unpack the gzipped tar file imoc.tar.gz within a convenient directory. The source and documentation files should end up within this directory cfcfd2/app/imoc. Note that the makefile depends on systems.mk in the directory cfcfd2/lib/util/source so you may need to unpack the cfd_util.tar.gz file also.

Build the loadable library by running
make
followed by
make install
in the imoc/unix directory. The makefile will try to install the run-time files in $HOME/imoc_bin. After installation $HOME/imoc_bin/source contains the Tcl files and the shared object file, $HOME/imoc_bin/doc contains the HTML documentation and $HOME/imoc_bin/demo contains some sample IMOC scripts.

Before running the IMOC program, ensure that you have:

To run IMOC with the graphical user interface, start up the wish (Tcl with Tk) interpreter and source the script $IMOC_HOME/source/moc_startup.tcl. This will leave the interpreter console able to accept command input. Alternatively, one could start with the command
wish -f $IMOC_HOME/source/moc_startup.tcl
but, in this latter case, the wish interpreter will no longer accept typed commands from the console. Starting with the command
./moc_startup.tcl
has the same effect, bringing the GUI up and leaving the Tcl console to show output but not accept input.


PJ, 02-Feb-2000, updated 27-May-2001, 21-Apr-2007.