MapleInterface -- Interface to Maple.

Description

What's new:

December 1, 2009: Added functions msqrt computing the modular square root (for large numbers) and integralBasis computing an integral basis of an algebraic function field.

October 4, 2009: Added method callMaple(String).

August 25, 2009: Added an Option store to callMaple to store the result of a computation in a file, and a function readMaple to read the file.

Overview:

The goal of this package is to provide an interface to run Maple scripts from Macaulay 2.

Setup:

This package is just an interface. To use it you need a licence for Maple and have the program installed on your machine.

Install this package by doing

installPackage("MapleInterface")

Edit the file init-MapleInterface.m2 in the directory .Macaulay2 in your home directory changing the line

"MapleCommand" => "maple"

"MapleCommand" => StringWithMapleCommand

where StringWithMapleCommand is a string containing the command starting command-line Maple in the shell.

This is usually "maple" on Unix machines (be sure that you do not put the command launching xmaple).

If you are using Macaulay 2 in cygwin and the Windows native Maple version best put the complete path to the Maple command line executable, e.g., StringWithMapleCommand could be (depending on the Maple version)

"C:/Program Files/Maple 9.5/bin.win/cmaple9.5.exe"

(English Windows version)

"C:/Programme/Maple 9.5/bin.win/cmaple9.5.exe"

(German Windows version).

To test whether the interface is working do, e.g.,

callMaple("","","returnvalue:=1;")

(which should return 1)

Caveat

Note that the file init-MapleInterface.m2 will be overwritten when you reinstall a newer version of the package, but there will be a backup.

Author

Janko Boehm <[email protected]>

Version

This documentation describes version 0.3 of MapleInterface.

Citation

If you have used this package in your research, please cite it as follows:

@misc{MapleInterfaceSource,
  title = {{MapleInterface: interface to Maple. Version~0.3}},
  author = {Janko Boehm},
  howpublished = {A \emph{Macaulay2} package available at
    \url{https://github.com/Macaulay2/M2/tree/master/M2/Macaulay2/packages}}
}

Exports

Functions and commands
- callMaple -- Run a Maple program from Macaulay 2.
- integralBasis -- Compute an integral basis of an algebraic function field.
- msqrt -- Compute modular square root.
- readMaple -- Read the result of a previous Maple computation.
Methods
- callMaple(String) -- see callMaple -- Run a Maple program from Macaulay 2.
- callMaple(String,String,String) -- see callMaple -- Run a Maple program from Macaulay 2.
- integralBasis(Ideal) -- see integralBasis -- Compute an integral basis of an algebraic function field.
- msqrt(ZZ,ZZ) -- see msqrt -- Compute modular square root.
- readMaple(String) -- see readMaple -- Read the result of a previous Maple computation.
Symbols
- store -- Store result of a Maple computation in a file.

For the programmer

The object MapleInterface is a package, defined in MapleInterface.m2, with auxiliary files in MapleInterface/.

The source of this document is in MapleInterface.m2:190:0.