Install

Grab a binary from the table (for MATLAB, use the newest compatible version below):

or see download page for more options/versions ...

Unzip in your home directory and adapt the path:

New: install with pip install casadi (you must have pip --version >= 8.1!)

Troubleshooting

Get started with the example pack.

Getting error "CasADi is not running from its package context." in Python? Check that you have casadi-py27-np1.9.1-v3.2.3/casadi/casadi.py. If you have casadi-py27-np1.9.1-v3.2.3/casadi.py instead, that's not good; add an extra casadi folder.

Release notes

New features

• Introduced differentiable exponential matrix node expm (requires slicot)
• Introduced differentiable N-dimensional lookup tables: interpolant with 'bspline' solver.

Bugs in the SUNDIALS interface fixed

CasADi 3.1 included a refactored support for ODE/DAE sensitivity analysis. While more efficient, this also exposed some bugs that have now been fixed in the CasADi 3.2 release, including:

• A bug affecting second order sensitivity analysis using CVODES was fixed. Cf. #1924.
• Segfault in IDAS Cf. #1911.

API changes

• The if_else and conditional operations are now non-short-circuiting by default for both SX and MX. This means that if_else(c,x,y) is now equivalent to if_else(c,x,y,False) and not if_else(c,x,y,True) as before. Also note that if_else(c,x,y,True) is only supported for MX. Cf. #1968.
• The functions Function::jacobian, Function::derivative and Function::hessian, which have had an internal character since CasADi 3.0, have been deprecated and will be removed in their current forms in the next release. The user is encouraged to work with expressions (e.g. J = jacobian(f,x) or Jv = jtimes(f,x,v) or [H,g] = hessian(f,x)) or use Function::factory (*). To allow a smooth transition, Function::jacobian and Function::hessian will be available as Function::jacobian_old and Function::hessian_old in this and next release. Cf. #1777.

(*) example in Matlab:

x = MX.sym('x')
y = x^2;
f = Function('f',{x},{y})
%J = f.jacobian(0,0) replacement:
J = Function('J',{x},{jacobian(y,x), y}) % alternative 1
J = f.factory('J',{'i0'},{'jac:o0:i0','o0'}) % alternative 2
%H = f.hessian(0,0) replacement:
[H,g] = hessian(y,x);
H = Function('H',{x},{H,g}) % alternative 1
H = f.factory('H',{'i0'},{'hess:o0:i0:i0','grad:o0:i0'}) % alternative 2

Improvements to C code generation

• The generated code now follows stricter coding standards. It should now be possible to compile the code with the GCC flags -Wall -Werror. Cf. #1741.

Changes to the build system

• The build system has been refactored and CasADi/C++ can be conveniently compiled with Visual Studio C++ on Windows. The installation now also includes CMake configure files, which makes it convenient to locate and use a CasADi installation in C++ code. Cf. #1982.
• The logic for source builds have changed. Before, the build system would try to locate third-party packages on the system and compile and install the third-party interfaces if this was successful. Now, the logic is that third-party packages are not installed unless the user specifically indicates this e.g. -DWITH_IPOPT=ON`. Cf.
  #1989, #1988.
• The default installation directories for the SWIG interfaces (for Python, Octave and MATLAB) has changed. It is now installed as subdirectories of the CMAKE_INSTALL_PREFIX location by default, but this can be changed by explicitly setting the CMake variables BIN_PREFIX, CMAKE_PREFIX, INCLUDE_PREFIX, LIB_PREFIX, MATLAB_PREFIX and PYTHON_PREFIX. A flat installation directory (without subdirectories) can be obtained by setting the WITH_SELFCONTAINED option. This is the default behavior on Windows. Cf. #1991, #1990

Changes to precompiled binaries

Python 2.6 (#1976), Python 3.6 (#1987) and Octave 4.2 (#2002, #2000) are now supported.

Install

Grab a binary from the table (for MATLAB, use the newest compatible version below):

1 Use this when you have Python(x,y).
2 Check your Python console if you need 32bit or 64bit - bitness should be printed at startup.

Or see the download page for more options.

Unzip in your home directory and adapt the path:

New: install with pip install casadi

Get started with the example pack.

Troubleshooting

Getting error "CasADi is not running from its package context." in Python? Check that you have casadi-py27-v3.3.0/casadi/casadi.py. If you have casadi-py27-v3.3.0/casadi.py instead, that's not good; add an extra casadi folder.

Release notes

New and improved features

Support for finite differences

CasADi is now able to calculate derivatives using finite differences approximations. To enable this feature, set the "enable_fd" option to true for a function object. If the function object has built-in derivative support, you can disable it by setting the options enable_forward, enable_reverse and enable_jacobian to false.

The default algorithm is a central difference scheme with automatic step-size selection based on estimates of truncation errors and roundoff errors. You can change this to a (cheaper, but less accurate) one-sided scheme by setting fd_method to forward or backward. There is also an experimental discontinuity avoiding scheme (suitable if the function is differentiated near nonsmooth points that can be enable by setting fd_method to smoothing.

New linear solvers with support for C code generation

Two sparse direct linear solvers have been added to CasADi's runtime core: One based on an up-looking QR factorization, calculated using Householder reflections, and one sparse direct LDL method (square-root free variant of Cholesky). These solvers are available for both SX and MX, for MX as the linear solver plugins "qr" and "ldl", for MX as the methods "SX::qr_sparse" and "SX::ldl". They also support for C code generation (with the exception of LDL in MX).

Faster symbolic processing of MX graphs

A speed bottleneck, related to the topological sorting of large MX graphs has been identified and resolved. The complexity of the sorting algorithms is now linear in all cases.

Other improvements

• A\y and y'/A now work in Matlab/Octave
• Matrix power works
• First major release with Opti
• shell compiler now works on Windows, allowing to do jit using Visual Studio
• Added introspection methods instruction_* that work for SX/MX Functions. See accessing_mx_algorithm example to see how you can walk an MX graph.
• Experimental feature to export SX/MX functions to pure-Matlab code.
• DM::rand creates a matrix with random numbers. DM::rng controls the seeding of the random number generator.

Distribution/build system

• Python interface no longer searches for/links to Python libraries (on Linux, OSX)
• Python interface no longer depends on Numpy at compile-time; CasADi works for any numpy version now
• Python binaries and wheels have come a step closer to true manylinux.
  CasADi should now run on CentOS 5.

API changes

Refactored printing of function objects

The default printout of Function instances is now shorter and consistent across different Function derived classes (SX/MX functions, NLP solvers, integrators, etc.). The new syntax is:

from casadi import *
x = SX.sym('x')
y = SX.sym('x',2)
f = Function('f', [x,y],[sin(x)+y], ['x', 'y'], ['r'])
print(f) # f:(x,y[2])->(r[2]) SXFunction
f.disp() # Equivalent syntax (MATLAB style)
f.disp(True) # Print algorithm

I.e. you get a list of inputs, with dimension if non-scalar, and a name of the internal class (here SXFunction).
You can also get the name as a string: str(f) or f.str(). If you want to print the algorithm, pass an optional argument "True", i.e. f.str(True) or f.disp(True).

Changes to the codegen C API

The C API has seen continued improvements, in particular regarding the handling of external functions with memory allocation. See the user guide for the latest API.

Other changes

• inv() is now more efficient for large SX/DM matrices, and is evaluatable for MX (cparse by default).
  The old variant is still available for SX/MX as inv_minor, and for MX as inv_node.
• Linear solver-related defaults are now set to csparse as opposed to symbolicqr
• In Matlab, when the CasADi result is a vector<bool>, this gets mapped to a logical matrix. E.g. which_depends is affected by this change.
• The sum-of-squares operator is now called sumsqr instead of sum_square.
• The API of the Linsol class has changed.