Installing on macOS

The Python interface for Cantera should be installed using Anaconda / Miniconda; directions for that can be found on the Conda install page. If you would like to use the Matlab toolbox, these instructions are for you. The Cantera Matlab toolbox requires macOS/Mac OS X version 10.11 (El Capitan) or higher and a 64-bit Intel processor.

Install Conda and the Python Interface

Cantera requires Python and the Python interface to be able to process input files (see Why Two File Formats? for more information). The easiest way to obtain the Cantera Python interface is via Conda. First install Miniconda by running the following commands in Terminal:

cd Downloads
curl https://repo.continuum.io/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o miniconda.sh;
bash miniconda.sh

This installs the minimal Conda installation called Miniconda in a folder in your home directory.

Next, install Cantera into an environment called cantera24:

$HOME/miniconda3/bin/conda create -n cantera24 -c cantera cantera

Download and run the Matlab Interface Installer

Download the Matlab Interface Installer package from GitHub: https://github.com/Cantera/cantera/releases/tag/v2.4.0

When the file has downloaded, find it in Finder, hold Control and click the file. Choose “Open” from the resulting menu, and select “Open” in the security dialog that appears. Click “Continue” to proceed in the installer (noting that the installer may open in the background; you can find its icon on the Dock), agreeing to the Cantera license terms and the terms of the other open source software that we use.

By default, the installer will add some lines to the file $HOME/Documents/MATLAB/startup.m to enable loading the Cantera toolbox when Matlab starts. If you wish to disable this, click “Customize” and de-select the “Install startup.m script” option. Finally, clicking “Install” will install the interface to the $HOME/Applications/Cantera folder.

Test the installation

Open Matlab and enter the following code:

gas = Solution('gri30.cti')
h2o = Solution('liquidvapor.xml','water')

If the installer cannot find the Cantera Python package, it will cause a warning message to be printed to the Matlab console when Matlab starts. To resolve this, edit the startup.m script to include the path to the Python interpreter where Cantera is installed in the line containing PYTHON_CMD.