evalin

(Not recommended) Evaluate MuPAD expressions without specifying their arguments

evalin(symengine,...) is not recommended. Use equivalent Symbolic Math Toolbox™ functions that replace MuPAD^® functions instead. For more information, see Compatibility Considerations.

Syntax

result = evalin(symengine,MuPAD_expression)

[result,status] = evalin(symengine,MuPAD_expression)

Description

result = evalin(symengine,MuPAD_expression) evaluates the MuPAD expression MuPAD_expression, and returns result as a symbolic object. If MuPAD_expression throws an error in MuPAD, then this syntax throws an error in MATLAB^®.

[result,status] = evalin(symengine,MuPAD_expression) lets you catch errors thrown by MuPAD. This syntax returns the error status in status and the error message in result if status is nonzero. If status is 0, result is a symbolic object; otherwise, it is a character vector.

Examples

Perform MuPAD Command

Compute the eigenvalues of the following matrix:

evalin(symengine,'linalg::eigenvalues(matrix([[x,y],[y,x]]))')

ans =
[x + y, x - y]

Input Arguments

MuPAD_expression — Input

character vector

Character vector containing a MuPAD expression.

Output Arguments

result — Computation result

character vector | symbolic object

Computation result returned as a symbolic object or character vector containing a MuPAD error message.

status — Error status

integer

Error status returned as an integer. If F with the arguments x1,...,xn executes without errors, the error status is 0.

Tips

• Results returned by evalin can differ from the results that you get using a MuPAD notebook directly. The reason is that evalin sets a lower level of evaluation to achieve better performance.

• evalin does not open a MuPAD notebook, and therefore, you cannot use this function to access MuPAD graphics capabilities.

Compatibility Considerations

evalin(symengine,...) is not recommended

Not recommended starting in R2018b

Symbolic Math Toolbox includes operations and functions for symbolic math expressions that parallel MATLAB functionality for numeric values. Unlike MuPAD functionality, Symbolic Math Toolbox functions enable you to work in familiar interfaces, such as the MATLAB Command Window or Live Editor, which offer a smooth workflow and are optimized for usability.

Therefore, instead of passing MuPAD expressions to evalin, use the equivalent Symbolic Math Toolbox functionality to work with symbolic math expressions. For a list of available functions, see Symbolic Math Toolbox functions list.

To convert a MuPAD notebook file to a MATLAB live script file, see convertMuPADNotebook.

If you cannot find the Symbolic Math Toolbox equivalent for MuPAD functionality, contact MathWorks Technical Support.

Although the use of evalin is not recommended, there are no plans to remove it at this time.

Introduced in R2008b