FromMFile converts a MATLAB® .m file into equivalent Maple input. The form of the converted output is controlled by one or more optional parameter.

When only one argument is given, FromMFile displays the code translation and evaluates it.  Specifying the evaluate option will execute the translated code without first displaying the translated code.  Specifying the string option will leave the translation as an unparsed string. It is recommended that translated code be reviewed first before evaluating it.

The second argument to FromMFile is the name of an output file. The target output can be a Maple worksheet file (.mw), or a Maple command file (.mpl).  A worksheet file can be opened via File->Open in Maple's graphical user interface.  A command file can be executed via Maple's read command.

When the second argument is a file name that ends in .mw, the output format is assumed to be Maple's xml worksheet format.  To write a worksheet to a file name that doesn't end in .mw use the worksheet option.  Similarly, use worksheet = false to write a command file using the extension .mw (but we don't recommend doing this).

By default overwrite is set to true.  Thus, if the target mwfile or mplfile already exists, it will be silently overwritten.  Specify overwrite = false to disallow writing over an existing file.

FromMFile will identify functions that are referenced in the current file, but implemented in a separate file.  Consider the following two files:

When the AddTranslator option is set to false, the translator bypasses the AddTranslator extension mechanism and gives a general MATLAB® to Maple syntax translation without attempting to interpret the meaning of MATLAB® function calls.

For further discussion on MATLAB® to Maple translation see FromMatlab.

This function is part of the Matlab package, so it can be used in the short form FromMFile(..) only after executing the command with(Matlab).  However, it can always be accessed through the long form of the command by using Matlab[FromMFile](..).

$\mathrm{with}\left(\mathrm{Matlab}\right)\:$

$\mathrm{mfile}≔\mathrm{cat}\left(\mathrm{kernelopts}\left(\mathrm{datadir}\right)\,''/help/Matlab/r1.m''\right)\:$

$\mathrm{FromMFile}\left(\mathrm{mfile}\,'\mathrm{string}'\,'\mathrm{path}'=\left[\right]\right)$

$''r1\; :=\; proc(\; a,\; b\; )\; local\; r;\; \#\; file\; r1.m\; ?FromMfile\; function\; reference\; example\; 1/2\; r\; :=\; r2(a)\; .\; r3(b);\; return\; r;\; end\; proc;''$

$\mathrm{FromMFile}\left(\mathrm{mfile}\,'\mathrm{string}'\right)$

$''r1\; :=\; proc(\; a,\; b\; )\; local\; r;\; \#\; file\; r1.m\; ?FromMfile\; function\; reference\; example\; 1/2\; r\; :=\; r2(a)\; .\; r3(b);\; return\; r;\; end\; proc;\; r2\; :=\; proc(\; a\; )\; local\; r;\; \#\; file\; r2.m\; ?FromMfile\; function\; reference\; example\; 2/2\; r\; :=\; 2\; .\; a;\; return\; r;\; end\; proc;''$

$\mathrm{mplfile}≔\mathrm{FileTools}:-\mathrm{TemporaryFile}\left(''r1''\,''.mpl''\right)$

$\mathrm{mplfile}≔''/tmp/mpldoc3/r1yYoYxV9R.mpl''$

$\mathrm{FromMFile}\left(\mathrm{mfile}\,\mathrm{mplfile}\right)$

$\mathrm{mwfile}≔\mathrm{FileTools}:-\mathrm{TemporaryFile}\left(''r1''\,''.mw''\right)$

$\mathrm{mwfile}≔''/tmp/mpldoc3/r1bx70dpPu.mw''$

$\mathrm{FromMFile}\left(\mathrm{mfile}\,\mathrm{mwfile}\right)$

$\mathrm{FromMFile}\left(\mathrm{mfile}\,'\mathrm{path}'=\left[\right]\right)$

Evaluating:
r1 := proc( a, b )
    local r;
    # file r1.m ?FromMfile function reference example 1/2
    r := r2(a) . r3(b);
        return r;
end proc;

$\mathbf{proc}\left(a\,b\right)\mathbf{local}r\;r≔\mathrm{`.`}\left(\mathrm{r2}\left(a\right)\,\mathrm{r3}\left(b\right)\right)\;\mathbf{return}r\mathbf{end\; proc}$

$\mathrm{r1}\left(10\,2\right)$

$\mathrm{r2}\left(10\right)\mathrm{r3}\left(2\right)$