JCasADi

Description

Java Wrapper for CasADi 3.7.0.

Caveats

CasADi is not entirely thread-safe. This property is inherited by this Java wrapper. Avoid using multi-threading with CasADi symbolics.

Due to the aforementioned threading issues, no longer needed C++ objects will not be deleted automatically. To do that manually but comfortably, regularly call MANUAL_CLEANER.cleanupUnreachable() (from the WrapUtil file) within the same thread as you create and use objects of the generated CasADi SWIG-proxy-classes.

Tested prerequisites

• Kubuntu 24.04 x64 LTS
• git 2.43.0: sudo apt install git
• g++, gcc 13.3.0: sudo apt install build-essential
• gfortran 13.3.0: sudo apt install gfortran
• x86_64-w64-mingw32-g++, x86_64-w64-mingw32-gcc 13.2.0: sudo apt install mingw-w64 mingw-w64-tools
• x86_64-w64-mingw32-gfortran-posix 13.2.0 sudo apt install gfortran-mingw-w64-x86-64-posix
• CMake 3.28.3 sudo apt install cmake
• SWIG 4.0.1 (3.x does not work!) (see section Ubuntu 24.04 Noble Numbat)
• openjdk 21 LTS: sudo apt install openjdk-21-jdk openjdk-21-demo openjdk-21-doc openjdk-21-jre-headless openjdk-21-source
• Netbeans 25 sudo apt install snap, sudo snap install netbeans --classic

Ubuntu 24.04 Noble Numbat

JCasADi is currently not compatible with the SWIG Version 4.2.0 offered by Ubuntu 24.04.
The following workaround will allow you to use SWIG 4.0.1 with Ubuntu 24.04 instead.

Uninstall all previously installed versions of SWIG:

• Look them up: apt search swig | grep swig
• Delete each (adjustments to be made): sudo apt purge swig

Download SWIG 4.0.1 (from https://launchpad.net/ubuntu/+source/swig):

• https://launchpad.net/ubuntu/+archive/primary/+files/swig4.0_4.0.1-5build1_amd64.deb
• https://launchpad.net/ubuntu/+archive/primary/+files/swig_4.0.1-5build1_all.deb

Install the packages (order matters):

1. sudo dpkg -i swig4.0_4.0.1-5build1_amd64.deb
2. sudo dpkg -i swig_4.0.1-5build1_all.deb

Prevent SWIG from upgrade:
sudo apt-mark hold swig

Prepare build

Clone this repository.

Clone and build the Netbeans Maven project JNativeLibLoader. You will need to rebuild it if it's codebase has changed and if you want to use the changes.

How to build

Open and build the Netbeans Maven project ./JCasADi.

The deployable jar should now be in the following path: ./JCasADi/target/JCasADi-1.0-SNAPSHOT-jar-with-dependencies.jar.

Rebuild

If the wrapper configuration was changed, after git pull execute Netbeans clean&build instead of build or run to be able to use the newest wrapper in Java.