Matlab CAPE-OPEN Thermo Import
This Matlab package allows for importing CAPE-OPEN version 1.1 thermodynamic and physical Property Packages into Matlab. A command driven package allows for selecting a CAPE-OPEN Property Package, and then perform thermodynamic and physical property calculations as well as thermodynamic equilibrium calculations inside Matlab.
The package defines the interfaces to communicate with CAPE-OPEN thermodynamic and physical Property Packages; it does not implement the thermodynamic engine itself. To use this package, you will need to have Matlab (version 5.3 or higher, 32-bits, or version 7.1 or higher, 64-bits) as well as a CAPE-OPEN version 1.1 compliant thermo system installed (for example, TEA which is shipped with the freely available CAPE-OPEN simulation environment COCO Simulator).
To get started with the Matlab CAPE-OPEN thermo import, type help capeOpen in Matlab after installation.
An example:
» handle=capeOpenGetPackage('TEA (CAPE-OPEN 1.1)','C1_C2');
» %let's calculate and plot the phase envelope at 1 atm for this system
» frac=0:0.05:1;
» X=[frac' 1-frac']
X =
0 1.0000
0.0500 0.9500
0.1000 0.9000
0.1500 0.8500
0.2000 0.8000
0.2500 0.7500
0.3000 0.7000
0.3500 0.6500
0.4000 0.6000
0.4500 0.5500
0.5000 0.5000
0.5500 0.4500
0.6000 0.4000
0.6500 0.3500
0.7000 0.3000
0.7500 0.2500
0.8000 0.2000
0.8500 0.1500
0.9000 0.1000
0.9500 0.0500
1.0000 0
» P=101325;
» tbub=capeOpenEquilibriumProp(handle,'temperature',X,'pressure',P,'vaporFraction',0);
» tdew=capeOpenEquilibriumProp(handle,'temperature',X,'pressure',P,'vaporFraction',1);
» plot(frac,[tdew tbub])
Requirements
Matlab CAPE-OPEN Thermo Import will function with CAPE-OPEN version 1.1 compliant thermodynamic Property Package Managers and stand-alone Property Packages.
Matlab version 5.3 or higher, 32-bits, or version 7.1 or higher, 64-bits, must be installed and running at your system. Matlab CAPE-OPEN Thermo Import has been tested with Matlab versions 5.3, 6.1, 7.7, 7.8, 7.9, 7.10, 7.11, 7.12, 7.13, 7.14, 8.0 and 8.1.
 |
| CAPE-OPEN/COCO Compliant |
More information
- Online Help
- van Baten, J.M., Rapid prototyping of unit operation models using generic tools and CAPE-OPEN, extended abstract, 6th US CAPE-OPEN conference, AIChE annual meeting, Nashville, November 2009.
Availability
Matlab CAPE-OPEN Thermo Import is free of charge for personal and academic use. For commercial use, a license fee must be paid. Licensing is on a per-person basis (and can be used on multiple computers). Commerical license fee is € 400,- (if you are outside the European union or inside Spain, VAT of 21% is applicable).
For obtaining a free non-commerical registration number, fill in the following form:
For obtaining a commerical license and registration number, fill in the following form:
For other forms of licenses, please contain mailto:info@amsterchem.com.
Please see the Downloads page for downloading the Matlab CAPE-OPEN Thermo Import installer.
Notes on the Matlab path
The RegisterWithMatlab.exe utility will - if invoked for an All Users installation - add the appropriate statements to the Matlab pathdef.m file for the CAPE-OPEN Thermo Import libraries to be loaded properly. This utility will modify C:\Program Files\Matlab\<version>\toolbox\local\pathdef.m file by default. To this it will add the C:\Program Files\Matlab CAPE-OPEN Thermo Import\ and it subfolder DLL or MEXW32, depending on the Matlab version.
For Windows Vista and later, a virtual store copy of pathdef.m may exist, e.g. C:\Users\<myname>\AppData\Local\VirtualStore\Program Files\MATLAB\<version>\toolbox\local\pathdef.m. In this case, the modifications made to the system copy will not affect Matlab's path and it will appear as if the path registration has failed. This situation will only occur on systems on which the user has edited the pathdef.m file.
To resolve this situation, please manually copy the added lines from the system copy of pathdef.m to the user copy.
For a Current User installation, the matlab path modification needs to be done manually. The easiest solution is to add a startup.m file to the folder in which Matlab starts. In this file, two addpath statements need to appear. The first one adds the Matlab CAPE-OPEN Thermo Import installation folder. The second one adds the MexW sub-folder for Matlab 7.1 or higher, or the DLL sub-folder for Matlab 7.0 or below. The RegisterWithMatlab.exe utility will identify these folders, but will not make the changes.
Change log
Version 1.0.3
- fixed sizes of return values of phase fractions and phase compositions of capeOpenEquilibrium
Version 1.0.4
- calling put_simulationContext after rather than before Initialize
- fixed call to Terminate for Property Packages
Version 1.0.5
- corrected GetEquilibriumProp in case all no properties are to be calculated; old property list was used (answers were correct, but warnings were produced)
- corrected availability of pressure derivatives of single- and two-phase properties
Version 1.0.6
- corrected GetEquilibriumProp for request of multiple properties
- smarter selection of default version (newest version) for registration tool
Version 1.0.7
- fixed crash on failure to create property package
Version 1.0.8
- compiler with newer compiler
- registration tool no longer shows unsupported Matlab versions
- support for x64 matlab (requires Matlab x64 7.1 or higher)
- new installer (NSIS based)
Version 1.0.9
- Fixed dependency of COM bridge on VC runtime libraries
Version 1.0.10
- current-user installation option (allows for installation for users without administrative rights)
Version 1.0.11
- disallowed basis conversions on mole number derivatives
- corrected basis conversions on mole fraction derivatives
Version 1.0.12
- fixed problems with uninstallation of current user install
- next installation will default to single user in case only single user version is already installed