This is the POSIX-compliant Oasis In-Memory Kernel toolkit.
Please click here to download the latest release.
The source code will change on a regular basis but only the releases are supported. Support enquiries should be sent to support@oasislmf.org.
There are build instructions for Windows 64-bit executables.
Note that the dynamic random number option in the Windows build uses a deterministic seed due to a bug in the mingw compiler. We recommend the random number file option (gulcalc -r) should be used in Windows.
This issue will be handled in future releases by implementing the rdrand random number generator in all environments.
The g++ compiler build-essential and libtool on debian distros or 'Development Tools' on red hat needs to be installed in Linux.
Copy ktools-[version].tar.gz onto your machine and untar.
$ tar -xvf ktools-[version].tar.gzGo into the ktools folder and autogen using the following command;
$ cd ktools-[version]
$ ./autogen.shConfigure using the following command;
$ ./configureMake using the following command;
$ makeNext run the automated test to check the build and numerical results;
$ make checkFinally, install the executables using the following command;
$ make installThe installation is complete. The executables are located in ~/usr/local/bin.
If installing the latest code from the git repository, clone the ktools repository onto your machine.
Go into the ktools folder and autogen using the following command;
$ cd ktools
$ ./autogen.shFollow the rest of the process as described above.
Cygwin 64-bit is required for the Windows native build. Cygwin is a Linux environment running in Windows. http://www.cygwin.com/
Download and run the set-up program for Cygwin. The following Cygwin add-in packages are required;
- gcc-g++
- gcc-core
- make
- diffutils
- automake
- libtools
To build native Windows 64-bit executables;
- mingw64-x86_64-gcc-g++
- mingw64-x86_64-gcc-core
Search for 'mingw', gcc', 'make' and 'diffutils' to find all of the relevant packages (Only 'gcc' illustrated below).
Copy ktools-[version].tar.gz onto your machine.
Open a Cygwin terminal.
Change directory to the location of the tar.gz.
Extract the files using the following command
$ tar -xvf ktools-[version].tar.gzGo into the ktools folder and autgen using the following command;
$ cd ktools-[version]
$ ./autogen.shConfigure using the following command;
$ ./winconfigureMake using the following command;
$ makeNext run the automated test to check the build and numerical results;
$ make checkFinally, install the executables using the following command;
$ make installThe executables are located in C:/Oasis/bin. You should add this bin folder to your path in System Environment Variables.
The installation is complete. Restart the Cygwin session to refresh the path before usage.
There is sample data and six example scripts which demonstrate how to invoke ktools in the /examples folder. These are written in python v2.
For example, to run the eltcalc_example script, go into the examples folder and run the following command (you must have python v2.X installed):
$ cd examples
$ python eltcalc_example.py Email support@oasislmf.org