11 Input, Output, and Interacting with Other Products

All Products Maple MapleSim

Home : Support : Online Help : Manuals : User Manual : 11 Input, Output, and Interacting with Other Products

Contents Previous Next Index

11 Input, Output, and Interacting with Other Products

11.1 In This Chapter

Section

Topics

Writing to Files - Saving to Maple file formats

•	Saving Data to a File

•	Saving Expressions to a File

Reading from Files -Opening Maple files

•	Reading Data from a File

•	Reading Expressions from a File

Exporting to Other Formats - Exporting documents in file formats supported by other software

•	Exporting Documents

•

MapleNet

Connectivity - Using Maple with other programming languages and software

•	Translating Maple Code to Other Programming Languages

•	Accessing External Products from Maple

•	Accessing Maple from External Products

•	Sharing and Storing Maple Worksheet Content with the MapleCloud^TM

11.2 Writing to Files

Maple supports file formats in addition to the standard .mw file format.

After using Maple to perform a computation, you can save the results to a file for later processing with Maple or another program.

Note: Make sure you have write access to the directory in order to execute the example in the following subsections.

Saving Data to a File

If the result of a Maple calculation is a long list or a large array of numbers, you can convert it to Matrix form and write the numbers to a file using the ExportMatrix command. This command writes columns of numerical data to a file, allowing you to import the numbers into another program. To convert a list or a list of lists to a Matrix, use the Matrix constructor. For more information, refer to the Matrix help page.

>	$L := [\begin{array}{c} −81 & −98 & −76 & −4 & 29 \\ −38 & −77 & −72 & 27 & 44 \\ −18 & 57 & −2 & 8 & 92 \\ 87 & 27 & −32 & 69 & −31 \\ 33 & −93 & −74 & 99 & 67 \end{array}] &colon;$

>	$ExportMatrix (matrixdata.txt, L) &colon;$

If the data is a Vector or any object that can be converted to type Vector, use the ExportVector command. To convert lists to Vectors, use the Vector constructor. For more information, refer to the Vector help page.

>	$R ≔ [3, 3.1415, - 65, 0]$

$R := [3, 3.1415, - 65, 0]$

(11.1)

>	$V ≔ Vector (R)$

>	$ExportVector (vectordata.txt, V) &colon;$

You can extend these routines to write more complicated data, such as complex numbers or symbolic expressions. For more information, refer to the ExportMatrix and ExportVector help pages.

For more information on matrices and vectors, see Linear Algebra.

Saving Expressions to a File

If you construct a complicated expression or procedure, you can save them for future use in Maple. If you save the expression or procedure in the Maple internal format, Maple can retrieve it more efficiently than from a document. Use the save command to write the expression to a .m file. For more information on Maple internal file formats, refer to the file help page.

>	$qbinomial ≔ (n, k) \to \frac{\prod_{i = n - k + 1}^{n} (1 - q^{i})}{\prod_{i = 1}^{k} (1 - q^{i})} &colon;$

In this example, small expressions are used. In practice, Maple supports expressions with thousands of terms.

>	$expr ≔ qbinomial (10, 4)$

$expr := \frac{(1 - q^{7}) (1 - q^{8}) (1 - q^{9}) (1 - q^{10})}{(1 - q) (1 - q^{2}) (1 - q^{3}) (1 - q^{4})}$

(11.2)

>	$nexpr ≔ normal (expr)$

$nexpr := (q^{6} + q^{5} + q^{4} + q^{3} + q^{2} + q + 1) (q^{4} + 1) (q^{6} + q^{3} + 1) (q^{8} + q^{6} + q^{4} + q^{2} + 1)$

(11.3)

You can save these expressions to the file qbinom.m.

>	$save qbinomial, expr, nexpr, qbinom.m$

Clear the memory using the restart command and retrieve the expressions using the read command.

$restart$

>	$read qbinom.m$

$expr$

$\frac{(1 - q^{7}) (1 - q^{8}) (1 - q^{9}) (1 - q^{10})}{(1 - q) (1 - q^{2}) (1 - q^{3}) (1 - q^{4})}$

(11.4)

For more information on writing to files, refer to the save help page.

	Saving Data as Part of a Workbook
	You can save all files related to a common Maple project as a workbook (.maple) file. Saving your data files and worksheets (or documents) as a workbook allows you to use this saved data across all .mw file inside your workbook.

11.3 Reading from Files

The most common reason for reading files is to load data, for example, data generated in an experiment. You can store data in a text file, and then read it into Maple.

Reading Data from a File

Import Data Assistant

If you generate data outside Maple, you can read it into Maple for further manipulation. This data can be an image, a sound file, or columns of numbers in a text file. You can easily import this external data into Maple using the Import Data Assistant, where the supported file formats include files of type Excel^®, MATLAB^®, Image, Audio, Matrix Market, and Delimited.

To launch the Import Data Assistant:

1.	From the Tools menu, select Assistants, and then Import Data.

2.	A dialog window appears where you can navigate to your data file. Select the file that you want to import data from, and then select the file type before clicking Next.

3.	From the main window, you can preview the selected file and choose from the applicable options based on the format of the file read in before importing the data into Maple. See Figure 11.1 for an example.

Figure 11.1: Import Data Assistant

	ImportMatrix Command
	The Import Data Assistant provides a graphical interface to the ImportMatrix command. For more information, including options not available in the assistant, refer to the ImportMatrix help page.

Reading Expressions from a File

You can write Maple programs in a text file using a text editor, and then import the file into Maple. You can paste the commands from the text file into your document or you can use the read command.

When you read a file with the read command, Maple treats each line in the file as a command. Maple executes the commands and displays the results in your document but it does not, by default, insert the commands from the file in your document.

For example, the file ks.txt contains the following Maple commands.

S:= n -> sum( binomial( n, beta ) * ( ( 2*beta )! / 2^beta - beta!*beta ), beta=1..n );

S(19);

Note that the file should not contain prompts (>) at the start of lines.

When you read the file, Maple displays the results but not the commands.

$S := n \to \sum_{β = 1}^{n} binomial (n, β) (\frac{(2 β) &excl;}{2^{β}} - β &excl; β)$

$1024937361666644598071114328769317982974$

(11.5)

>	$filename ≔ cat (kernelopts (datadir), kernelopts (dirsep), ks, kernelopts (dirsep), ks.txt) &colon;$

>	$read filename$

$S := n \to \sum_{β = 1}^{n} binomial (n, β) (\frac{(2 β) &excl;}{2^{β}} - β &excl; β)$

$1024937361666644598071114328769317982974$

(11.6)

If you set the interface echo option to 2, Maple inserts the commands from the file into your document.

>	$interface (echo = 2) &colon; read filename$

> S:= n -> sum( binomial( n, beta ) * ( ( 2*beta )! / 2^beta - beta!*beta ), beta=1..n );

$S := n \to \sum_{β = 1}^{n} binomial (n, β) (\frac{(2 β) &excl;}{2^{β}} - β &excl; β)$

> S(19);

$1024937361666644598071114328769317982974$

(11.7)

For more information, refer to the read and interface help pages.

	Reading Data From Workbook Attachments
	Data stored in a workbook in the form of an attachment, can be accessed easily using the workbook URI. For information on workbook attachments, see worksheet,workbook,attachFiles. For information on the workbook URI format, see worksheet,workbook,uri.

11.4 Exporting to Other Formats

Exporting Documents

You can save your documents by selecting Save or Save As from the File menu. By selecting Export As from the File menu, you can also export a document in the following formats: HTML, LaTeX, Maple input, Maplet application, Maple text, plain text, PDF, and Rich Text Format. This allows you to access your work outside Maple.

HTML

The .html file that Maple generates can be loaded into any HTML browser. Exported mathematical content can be displayed in one of two formats, GIF or MathML 2.0, and is saved in a separate folder. MathML is the Internet standard, sanctioned by the World Wide Web Consortium (W3C), for the communication of structured mathematical formulae between applications. For more information about MathML, refer to the MathML help page.

Maple documents that are exported to HTML translate into multiple documents when using frames. If the frames feature is not selected, Maple creates only one page that contains the document contents.

LaTeX

The .tex file generated by Maple is ready for processing by LaTeX. All distributions of Maple include the necessary style files. By default, the LaTeX style files are set for printing the .tex file using the dvips printer driver. You can change this behavior by specifying an option to the \usepackage LaTeX command in the preamble of your .tex file. For more information, refer to the exporttoLaTeX help page.

	Maple Input
	You can export a Maple document as Maple input so that it can be loaded using the Maple Command-line version. Important: When exporting a document as Maple input for use in Command-line Maple, your document must contain explicit semicolons in 1-D Math input. If not, the exported .mpl file does not contain semicolons, and Command-line Maple generates errors.

Maplet Application

The Export as Maplet facility saves a Maple document as a .maplet file, so that you can run it using the command-line interface or the MapletViewer. The MapletViewer is an executable program that can launch saved Maplet applications. It displays and runs Maplet applications independently of the Maple Worksheet interface.

Important: When exporting a document as a Maplet Application for use in Command-line Maple or the MapletViewer, your document must contain explicit semicolons. If not, the exported .maplet file does not contain semicolons, and Command-line Maple and the MapletViewer generates errors.

	Maple Text
	Maple text is marked text that retains the distinction between text, Maple input, and Maple output. Thus, you can export a document as Maple text, send the text file by email, and the recipient can import the Maple text into a Maple session and regenerate the computations in the original document.

	PDF
	Export a Maple document to a Portable Document Format (PDF) file so that you can open the file in a reader such as Adobe^® Acrobat^®. The PDF document is formatted as it would appear when the Maple worksheet is printed using the active printer settings. Note: Images, plots, and embedded components may be resized in the PDF file.

	Plain Text
	Export a Maple document as plain text so that you can open the text file in a word processor.

	Rich Text Format (RTF)
	Export a Maple document to a rich text format file so that you can open and edit the file in a word processor. Note: The generated .rtf format is compatible with Microsoft Word and Microsoft WordPad only.

Summary of Translation

Table 11.1: Summary of Content Translation When Exporting to Different Formats

Content	HTML	LaTeX	Maple Input	Maplet Application	Maple Text	Plain Text	Rich Text Format	PDF Format
Text	Maintained	Maintained	Preceded by #	Preceded by #	Preceded by #	Maintained	Maintained	Maintained
1-D Math	Maintained	Maintained	Maintained	Maintained	Preceded by >	Preceded by >	Static image	Static image
2-D Math	GIF or MathML	LaTeX	1-D Math (if possible)	1-D Math (if possible)	1-D Math or character-based typesetting	1-D Math or character-based typesetting	Static image	Either text or shapes depending on option selected
Plot	GIF	Postscript file	Not exported	Not exported	Not exported	Not exported	Static image	Static image
Animation	Animated GIF	Not exported	Not exported	Not exported	Not exported	Not exported	Not exported	Static image
Hidden content	Not exported	Not exported	Not exported	Not exported	Not exported	Not exported	Not exported	Not exported
Manually inserted page break	Not supported	Not supported	Not supported	Not supported	Not supported	Not supported	RTF page break object	Maintained
Hyperlink	Links to help pages become plain text. Links to documents are renamed and converted to HTML links	Plain text	Plain text	Plain text	Plain text	Plain text	Plain text	Plain text
Embedded image or sketch output	GIF	Not exported	Not exported	Not exported	Not exported	Not exported	Static image	Static image
Spreadsheet	HTML table	LaTeX tables	Not exported	Not exported	Not exported	Not exported	RTF table	Static image
Document style	Approximated by HTML style attributes	LaTeX environments and sections, LaTeX macro calls	Not exported	Not exported	Not exported	Not exported	RTF style	Maintained

MapleNet

Overview of MapleNet

Using MapleNet, you can deploy Maple content on the web. Powered by the Maple computation engine, MapleNet allows you to embed dynamic formulas, models, and diagrams as live content in webpages. The MapleNet software is not included with the Maple software. For more information on MapleNet, visit http://www.maplesoft.com/maplenet.

	MapleNet Documents and Maplets
	After you upload your Maple document to the MapleNet server, it can be accessed by anyone in the world using a web browser. Even if viewers do not have a copy of Maple installed, they can view documents and Maplets, manipulate 3-D plots, and execute code at the click of a button.

	Custom Java Applets and JavaServer Pages^TM Technology
	MapleNet provides a programming interface to the Maple math engine so commands can be executed from a Java applet or using JavaServer Pages^TM technology. Embed MapleNet into your web application, and let Maple handle the math and visualization.

11.5 Connectivity

Translating Maple Code To Other Programming Languages

	Code Generation
	The CodeGeneration package is a collection of commands and subpackages that enable the translation of Maple code to other programming languages. Languages currently supported include: C, C#, Fortran 77, Java, MATLAB^®, Visual Basic, Perl, and Python. For details on Code Generation, refer to the CodeGeneration help page.

Accessing External Products from Maple

External Calling

External calling allows you to use compiled C, C#, Fortran 77, or Java code in Maple. Functions written in these languages can be linked and used as if they were Maple procedures. With external calling you can use pre-written optimized algorithms without the need to translate them into Maple commands. Access to the NAG library routines and other numerical algorithms is built into Maple using the external calling mechanism.

External calling can also be applied to functions other than numerical algorithms. Routines exist that accomplish a variety of non-mathematical tasks. You can use these routines in Maple to extend its functionality. For example, you can link to controlled hardware via a serial port or interface with another program. The Database package uses external calling to allow you to query, create, and update databases in Maple. For more information, refer to the Database help page.

For more information on using external calling, refer to the ExternalCalling help page.

Mathematica Translator

The MmaTranslator package provides translation tools for converting Mathematica^® expressions, command operations, and notebooks to Maple. The package can translate Mathematica input to Maple input and Mathematica notebooks to Maple documents. The Mma subpackage contains commands that provide translation for Mathematica commands when no equivalent Maple command exists. In most cases, the command achieves the translation through minor manipulations of the input and output of similar Maple commands.

Note: The MmaTranslator package does not convert Mathematica programs.

There is a Maplet interface to the MmaTranslator package. For more information, refer to the MmaToMaple help page.

	Matlab Package
	The Matlab package enables you to translate MATLAB^® code to Maple, as well as call selected MATLAB^® functions from a Maple session, provided you have MATLAB^® installed on your system. For more information, refer to the Matlab help page.

Accessing Maple from External Products

Microsoft Excel Add-In

Maple is available as an add-in to Microsoft Excel. This add-in is supported for Excel 365 (desktop) and Excel 2019 for Windows, and provides the following features.

•	Access to Maple commands from Excel

•	Ability to copy and paste between Maple and Excel

•	Access to a subset of the Maple help pages

•	Maple Function Wizard to step you through the creation of a Maple function call

To enable the Maple Excel Add-in:

1.	In Excel, click the File menu and select Options.

2.	Click Add-ins.

3.	In the Manage box select Excel Add-ins, and then Go.

4.	Navigate to the Excel subdirectory of your Maple installation and select the file:

–	WMIMPLEX64.xla (that is, select $MAPLE/Excel/WMIMPLEX64.xla), and click OK.

5.	Select the Maple Excel Add-in check box.

Click OK.

For further details on enabling the Maple Excel Add-in, refer to the Excel help page.

For information on using this add-in, refer to the Using Maple in Excel help file within Excel.

To view this help file:

1.	Enable the add-in.

2.	From the Add-ins tab, view the Maple toolbar.

3.	On the Maple toolbar, click the Maple help icon .

OpenMaple

OpenMaple is a suite of functions that allows you to access Maple algorithms and data structures in your compiled C, C#, Java, or Visual Basic programs. (This is the reverse of external calling, which allows access to compiled C, C#, Fortran 77, and Java code from Maple.)

To run your application, Maple must be installed. You can distribute your application to any licensed Maple user. For additional terms and conditions on the use of OpenMaple, refer to the extern/OpenMapleLicensing.txt file in your Maple installation.

For more details on using OpenMaple functions, refer to the OpenMaple help page.

MapleSim

MapleSim^TM is a complete environment for modeling and simulating multidomain engineering systems. During a simulation, MapleSim uses the symbolic Maple computation engine to generate the mathematical models that represent the system behavior.

Because both products are tightly integrated, you can use Maple commands and technical document features to edit, manipulate, and analyze a MapleSim model. For example, you can use Maple commands and tools to manipulate your model equations, develop custom components based on a mathematical model, and visualize simulation results.

MapleSim software is not included with the Maple software. For more information on MapleSim, visit http://www.maplesoft.com/maplesim.

Sharing and Storing Maple Content

The MapleCloud

You can use the MapleCloud to share or store your Maple documents and workbooks. Upload Maple documents or workbooks. Package workbooks offer a way to share a Maple package with other users, including source code, documentation and examples.

The MapleCloud has private and public sharing. You can share with all Maple users, share with a private group, or upload and store content in a user-specific area that only you can access.

Users need an internet connection to use the MapleCloud. Anyone can access publicly shared documents. To share content, create, manage and join user groups; and view group-specific content, you must log in to the MapleCloud using a Maplesoft.com, Gmail™, or Google Mail™ account name and password.

A Maplesoft.com membership account gives you access to thousands of free Maple resources and MaplePrimes, which is an active web community for sharing techniques and experiences with Maple and related products. To sign up for a free Maplesoft.com membership account, visit http://www.maplesoft.com/members/sign_up_form.aspx. The MapleCloud is integrated with several of these online features, so it is strongly recommended that you use a Maplesoft.com membership account.

For more information on the MapleCloud, refer to the MapleCloud help page.

Contents Previous Next Index

Download Help Document

Maple

Maple Add-Ons

MapleSim

MapleSim Add-Ons

Systems Engineering

Consulting Services

Maple T.A. and Möbius

Education

Industries

Automotive and Aerospace

Robotics

Machine Design & Industrial Automation

Other

Application Areas

Product Pricing

Purchasing

Institutional Student Licensing

Maplesoft Elite Maintenance (EMP)

Support

Product Training

Online Product Help

Webinars & Events

Publications

Content Hubs

Examples & Applications

Community

About Maplesoft

Media Center

User Community

Contact

Online Help

All Products Maple MapleSim

Maple

Powerful math software that is easy to use

Maple Add-Ons

MapleSim

Advanced System Level Modeling

MapleSim Add-Ons

Systems Engineering

Consulting Services

Maple T.A. and Möbius

Education

Industries

Automotive and Aerospace

Robotics

Machine Design & Industrial Automation

Other

Application Areas

Product Pricing

Purchasing

Institutional Student Licensing

Maplesoft Elite Maintenance (EMP)

Support

Product Training

Online Product Help

Webinars & Events

Publications

Content Hubs

Examples & Applications

Community

About Maplesoft

Media Center

User Community

Contact

Online Help

All Products Maple MapleSim