Install, Compile and Run

Diffpack 4.0.10 - MacOSX10.6 Information


This document describes the Mac OS X 10.6 distribution of the Diffpack 4.0.10 software kernel. If you are going to install add-on toolboxes extending Diffpack's functionality, please make sure that you install this kernel first.

Diffpack is a library collection facilitating high-level design and implementation of simulation software dealing with numerical solution of partial differential equations (PDEs). You, as developer of Diffpack simulators, will create applications in C++ based on the tools provided in the Diffpack libraries.

In a Mac OS X 10.6 environment, you will need the GNU Compiler 4.2 compiler.



Hardware Requirements

For convenient use of Diffpack it is recommended that the target machine has at least a Pentium III processor with a minimum of 512 MB RAM. The installation will occupy about 1 GB of disk space. Better specification will in general provide better working conditions and possibilities for solving larger problems.



Diffpack Installation

Start by copying the files


from the package to a directory on your local disc.

Diffpack is installed using the script. Follow the instructions given in INSTALL.txt, and use /mnt/cdrom/Linux as parameter to the -s argument in the installation script (this assumes that the package is mounted under the directory /mnt/cdrom).

As platform ("machinetype") you can currently choose

-m mac-gcc-4.2
Compiler Installation

To install the GNU Compiler 4.2 compiler, please follow the instructions of its documentation.


Licensing with inuTech License Server

Notice that applications linked against the Diffpack Distribution need a license key to run. There is a free demo key available which will be mailed to you after you have submitted this form.

Diffpack 4.0.10 for Mac OS X 10.6 uses the inuTech License management. This is a node-locked license type that allows computations to run on the machine Diffpack is installed on and the user is locally logged in to.


Compiling with GNU Compiler 4.2

When you have installed the Diffpack Distribution correctly you can compile any Diffpack application examples.

Be aware that a few of the applications also require the adaptivity module which is not part of Diffpack Kernel. These applications can therefore not be compiled, but you can run the accompanying executable and look at the source code as documentation.

Note: When running with a demo license the application will be subject to limitations on array lengths.
Console Applications

You can compile the application simply by typing:

	> Make MODE=(n)opt

standing in the directory of the application. It is essential to use a capital M in Make. This invokes a special Diffpack make command.

GUI Applications

Applications using the Diffpack menu system can be run with a graphical user interface for the menu. In order to use the GUI, you must first compile the application with the command:

	> Make MODE=(n)opt GUIMENU=tcl

Please note that the use of this compilation command requires that you have "tcl", "tk" and "tix" libraries which are added in the delivery.


Running Diffpack Applications

The executable file for a Diffpack application (app) can be run without additional arguments as follows:

	> ./app

If the program uses the Diffpack menu system, you will see a prompt for input. To run the program with the default menu options, type x at the menu prompt and the program will continue. If you wish to change the default menu values you may type h to see a list of all menu items and their options.

If the program is compiled in GUI mode (see the GUI Applications section), it can also be run with a graphical user interface for the menu system by typing

	> ./app --GUI

The GUI will appear on screen and the menu options can be viewed and changed if desired.

The menu options may also be presented to the program through an input file e.g inputfile.i:

	> ./app < inputfile.i

For programs using the menu system, sample input files may be found in the Verify directory of each application directory. To run the program using these input files directly, you must specify the location of the input file:

	./app < Verify/inp.i

In the Verify directory you will also find some shell-scripts e.g, which may serve as examples on how to run the various Diffpack programs.

Some of the applications do not use the menu system, some use command line options to give input to the program instead. The command line options vary between the different applications, and examples on the use can be seen in the shell-scripts in the respective Verify directories.


Release Notes

See the file %NOR%\RELEASENOTES.TXT for details on features and changes in Diffpack 4.0.10. Further, continuously updated information will be available from the web page

Any technical questions can be directed to

Happy Diffpacking!

inuTech GmbH