Call MATLAB from .NET

Write .NET programs that work with MATLAB^®

MATLAB Engine API for .NET provides an interface between .NET programming languages and MATLAB. This API enables programs to launch MATLAB, evaluate MATLAB functions with arguments, and exchange data between MATLAB and .NET programs.

To access .NET libraries directly from MATLAB instead, see Call .NET from MATLAB.

If you need to maintain existing .NET programs created for MATLAB R2022a or earlier that work with the Microsoft^® Component Object Model (COM), see Write COM Applications to Work with MATLAB.

Functions

expand all

MATLAB Functions

`matlab.engine.shareEngine`	Convert running MATLAB session to shared session
`matlab.engine.engineName`	Return name of shared MATLAB session
`matlab.engine.isEngineShared`	Determine if MATLAB session is shared
`matlab.engine.typedinterface.generateCSharp`	Generate C# code interface for MATLAB namespaces, classes, and functions (Since R2023b)

Classes

expand all

MATLAB Engine for .NET

MathWorks.MATLAB.Engine.MATLABEngine .NET class using MATLAB as a computational engine (Since R2022b)

MATLAB Data API for .NET

`MathWorks.MATLAB.Types.MATLABArray`	.NET class to represent pointers to MATLAB arrays (Since R2022b)
`MathWorks.MATLAB.Types.MATLABObject`	.NET class to represent scalar instances of MATLAB classes (Since R2022b)
`MathWorks.MATLAB.Types.MATLABStruct`	.NET class to represent scalar MATLAB structures (Since R2023a)
`MathWorks.MATLAB.Types.MATLABWorkspace`	.NET class to manage interactions with MATLAB base workspace variables (Since R2022b)
`MathWorks.MATLAB.Types.RunOptions`	.NET class to specify options for MATLAB function evaluation (Since R2022b)
`MathWorks.MATLAB.Types.MATLABProvider`	.NET base class for invoking MATLAB functions (Since R2023b)

Topics

Set Up and Build Engine Applications

Elements of a .NET Engine Program

Get started with MATLAB Engine API for .NET.
- Requirements to Build .NET Engine Programs
- Test Your .NET Development Environment

Start MATLAB from .NET Application

Start MATLAB Session from .NET
Start a .NET engine session synchronously or asynchronously, and pass startup options to MATLAB.
Connect .NET Application to Running MATLAB Session
Connect the .NET engine to a running MATLAB session that has been started as or converted to a shared session.

Data Mapping

Pass .NET Data Types to MATLAB Functions
Convert .NET data to MATLAB data.
Handle MATLAB Data in .NET Applications
Convert MATLAB data to .NET data.
Strongly Typed Interface for C#

A strongly typed interface enforces a strict data type mapping between MATLAB and C# to use in .NET applications.

Call MATLAB Functions from .NET

Execute MATLAB Functions from .NET
Pass variables to MATLAB function calls and return values to .NET applications.
Use MATLAB Structures in .NET
Define MATLAB structure data types in .NET using the MathWorks.MATLAB.Types.MATLABStruct class.
Use MATLAB Dictionary Objects in .NET
These examples show how to pass dictionary variables to MATLAB function calls and return dictionary values to .NET applications.
Use MATLAB Handle Classes in C#
Integrate MATLAB handle classes with C# applications.

Troubleshooting

MathWorks.MATLAB.Exceptions Exception Classes for .NET

The MathWorks.MATLAB.Exceptions namespace contains the exception classes for the .NET engine.

Related Information

Call .NET from MATLAB