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.
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.
Start by copying the files
from the package to a directory on your local disc.
Diffpack is installed using the
Follow the instructions given in
INSTALL.txt, and use
as parameter to the
-s argument in the installation script
(this assumes that the package is mounted under the directory
As platform ("machinetype") you can currently choose
To install the GNU Compiler 4.2 compiler, please follow the instructions of its documentation.
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.
dplicense.dat" into folder
%NOR%\ext\LicenseServer\. Please do not change the license file name.
%NOR%\ext\LicenseServer\StartInuLicenseServer.bat. This will start a service on your machine which is called "
InuLicenseServer". It will be automatically started at startup of your computer.
(inulicenseserver.log)can be found in
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.
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
This invokes a special Diffpack make command.
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.
The executable file for a Diffpack application (
app) can be run without additional arguments as follows:
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
> ./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
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
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 www.diffpack.de.
Any technical questions can be directed to firstname.lastname@example.org