Maple

Revision as of 18:28, 14 June 2021 by Botto (talk | contribs) (→‎Jobs Longer than 20 Minutes in Length)

Description

Maple is a software tool for mathematical computation. It has many features that are useful for students and research scientists as well as mathematicians. It has powerful tools for symbolic mathematics and algebraic computing. It can also do numerical computations and graphing.

Version

  • 2020

Authorized Users

  • CIRCE account holders
  • RRA account holders
  • SC account holders

Platforms

  • CIRCE cluster
  • RRA cluster
  • SC cluster
  • Workstation/PC

Modules

Maple requires the following module file to run:

  • apps/maple/2020

Installation

  • NOTE: If you are off-campus, you MUST be connected to the USF VPN (https://vpn.usf.edu) prior to installing/running Maple.

Windows Installation

Before starting the installation:

  1. Double-click on the Maple installation executable to start it.
  2. At the Introduction page, click Next.
  3. Accept the License Agreement, then click Next.
  4. Specify where you would like Maple to be installed, then click Next.
  5. Specify whether or not you would like a shortcut installed on your desktop, then click Next.
  6. For the license type, Choose Network License and click Next.
  7. Type in the license information specifying: license0.rc.usf.edu and port 27000, then click Next.
  8. Confirm the installation details displayed, then click Install.
  9. Once the installation exits, it should give you a set of instructions on how to start Maple in graphical and console modes. Click Next.
  10. Click “Done” to exit the installer.

Linux Single User Installation

Disclaimer: This procedure was tested on a Fedora machine. Your mileage may vary.

Before starting the installation:

  1. Open a terminal and become root on your machine via the 'su' command.
  2. Run the installation wizard by:
    sh /path/to/installer.bin
  3. At the Introduction page, click Next
  4. Accept the License Agreement, then click Next
  5. Specify where you would like Maple to be installed, then click Next. We recommend /usr/local/maple2020
  6. Specify whether or not you would like a shortcut installed on your desktop, then click Next
  7. For the license type, Choose Network License and click Next
  8. Type in the license information specifying: license0.rc.usf.edu and port 27000, then click Next
  9. Confirm the installation details displayed, then click Install
  10. Once the installation exits, it should give you a set of instructions on how to start Maple in graphical and console modes. Click Next
  11. Click “Done” to exit the installer
  12. Be sure the directory $MAPLE/bin is added to your path. Where $MAPLE is the installation directory from step 5)

You should be able to start xmaple or maple from the command line.

Mac OS X Single User Installation

Disclaimer: These are the standard instructions for a Mac OS X machine. Your mileage may vary.

Before starting the installation:

  1. Double-click on the installer. Supply the administrative password if asked.
  2. At the Introduction page, click Next.
  3. Accept the License Agreement, then click Next.
  4. Specify where you would like Maple to be installed, then click Next.
  5. Specify whether or not you would like a shortcut installed on your desktop, then click Next.
  6. For the license type, Choose Network License and click Next.
  7. Type in the license information specifying: license0.rc.usf.edu and port 27000, then click Next.
  8. Confirm the installation details displayed, then click Install.
  9. Once the installation exits, it should give you a set of instructions on how to start Maple in graphical and console modes. Click Next.
  10. Click “Done” to exit the installer.

You should be able to launch Maple by double clicking on the Maple 2020 icon in the Applications/Maple 2020 directory.

Running Maple on CIRCE/SC

The Maple user guide is essential to understanding the application and making the most of it. The guide and this page should help you to get started with your simulations. Please refer to the Documentation section for a link to the guide.

  • Note on CIRCE: Make sure to run your jobs from your $WORK directory!
  • Note: Scripts are provided as examples only. Your SLURM executables, tools, and options may vary from the example below. For help on submitting jobs to the queue, see our SLURM User’s Guide.

Submitting a Job

There are two ways to run Maple on CIRCE/SC, depending on the runtime of your particular job.

Jobs Shorter than 20 Minutes in Length

Establishing a GUI connection to CIRCE/SC

To use Maple, you will need to connect to CIRCE/SC with GUI redirection, either using:

  • CIRCE/SC Desktop Environment
  • SSH with X11 redirection
    • If connecting from OSX or Linux via SSH, please ensure that you use one of the following commands to properly redirect X11: 
      • [user@localhost ~]$ ssh -X circe.rc.usf.edu
        or
      • [user@localhost ~]$ ssh -X sc.rc.usf.edu

Once connected to CIRCE/SC, you can open Maple using the steps below: 

[user@login0 ~]$ module add apps/maple/2020
[user@login0 ~]$ xmaple

Jobs Longer than 20 Minutes in Length

To run Maple jobs on the CIRCE/SC clusters, users will need to submit their jobs to the scheduling environment if their jobs take more than 20 minutes to run on a standard PC.

If, for example, you have a Maple script file named test.mpl with all your functions defined in it, you would set up a submit script similar to the one below to use the Maple kernel:

  • The script below (for testing, name it “maple-test.sh”) can be copied into your job directory (the folder with your input files) and modified so that you can submit batch processes to the queue.
#!/bin/bash
#
#SBATCH --comment=maple-test
#SBATCH --ntasks=4
#SBATCH --job-name=maple-test
#SBATCH --output=output.%j.maple-test
#SBATCH --time=00:30:00

#### SLURM 4 processor Maple test to run for 30 minutes.

module purge
module load apps/maple/2020

maple < test.mpl

 
Next, you can change to your job’s directory, and run the sbatch command to submit the job: 

[user@login0 ~]$ cd my/jobdir
[user@login0 jobdir]$ sbatch ./maple-test.sh
  • You can view the status of your job with the “squeue -u <username>” command.

Documentation

Home Page, User Guides, and Manuals


More Job Information

See the following for more detailed job submission information:

Reporting Bugs

Report bugs with Maple to the IT Help Desk: rc-help@usf.edu

Retrieved from "https://wiki.rc.usf.edu/index.php?title=Maple&oldid=2428"