Description

From GMT Home Page: GMT (Generic Mapping Tools) is an open source collection of ~60 tools for manipulating geographic and Cartesian data sets (including filtering, trend fitting, gridding, projecting, etc.) and producing encapsulated postscript file (EPS) illustrations ranging from simple x-y plots via contour maps to artificially illuminated surfaces and 3-D perspective views. GMT supports ~30 map projections and transformations and comes with support data such as GSHHS coastlines, rivers, and political boundaries.

Version

• 5.1.0

Authorized Users

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

Platforms

• CIRCE cluster
• RRA cluster
• SC cluster

Modules

GMT requires the following module file to run:

• apps/gmt/5.1.0

• See Modules for more information.

Running GMT on CIRCE

The GMT 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!

Starting the Application

Establishing a GUI connection to CIRCE/SC

To use GMT, 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, you can simply load the GMT module, then execute GMT-related scripts and binaries.

• To view the output postscript files, you can use evince.

Documentation

Home Page, User Guides, and Manuals

• GMT Home Page:
  • http://www.soest.hawaii.edu/GMT/
• GMT User Guide
  • /apps/gmt/5.1.0/docs/GMT_Docs.pdf

Benchmarks, Known Tests, Examples, Tutorials, and Other Resources

• GMT Examples
  • /apps/gmt/5.1.0/share/doc/examples

More Job Information

See the following for more detailed job submission information:

• SLURM User’s Guide
• Scheduling and Dispatch Policies
• Advanced Submit Techniques

Reporting Bugs

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