LOCKER:          gmsh_v3.0.1

FILE:            /mit/gmsh_v3.0.1/README.athena

CONTENTS:        Gmsh 3.0.1, GetDP 2.11.0 version locker

DESCRIPTION:     Gmsh is a 3d finite-element mesh generator with built-in
                 pre- and post-processing capabilities, incorporating a
                 GUI

                 GetDP is a finite-element solver integrated with Gmsh. It
                 uses mixed elements to discretize de Rahm-type complexes
                 in one, two and three dimensions

HOW TO RUN:

  COMMAND:
	 
       setup gmsh
       gmsh & (to run Gmsh GUI)
       gmsh <input files> <options>  (to run gmsh in command-line mode)
       getdp <input files> <options> (to run getdp in standalone mode)

FROM UBUNTU PANEL:	 no

INTERFACES:	 GUI, command-line

VERSIONS:	 For Linux 64: Gmsh 3.0.1, GetDP 2.11.0
                  
DEPENDENCIES:	 none known

DATAFILES:	 Platform-independent

LICENSE SERVER:	 no

-------------------------------------------------------------------------

SUPPORT ISSUES --

I/S SUPPORT:

  CONSULTING:	 none

  TRAINING:	 none

  DOCUMENTATION: internal Help system
                 Gmsh: http://gmsh.info/#Documentation
                 GetDP: http://getdp.info/#Documentation
                 Local manuals 
                 Gmsh:  http://web.mit.edu/gmsh_v3.0.1/gmsh.pdf
                 GetDP: http://web.mit.edu/gmsh_v3.0.1/getdp.pdf
OTHER SUPPORT:

 CONSULTING:	 (none)

 TRAINING:       Gmsh tutorial at 
                 https://www.youtube.com/watch?v=xL2LmDsDLYw
                 Complete examples at
                 http://onelab.info/wiki/GetDP

 WEB PAGE:       Gmsh: http://gmsh.info
                 GetDP: http://getdp.info
                
BUG REPORTS:	 Use sendbug

-------------------------------------------------------------------------

LEGAL ISSUES -- 

STATUS: GPLv2 or later license; 
        see http://gmsh.info/doc/LICENSE.txt

 SITES:         any
 
 RESTRICTIONS:  
 
 DOCUMENTATION: 
                
-------------------------------------------------------------------------

ABOUT THIS LOCKER --

MAINTAINER(S):	 swmaint (group), alexp

DIRECTORY STRUCTURE:

          examples          - examples
	  getdp-2.11.0-Linux - GetDP top level
            bin             -  GetDP binary
          gmsh-3.0.1-Linux  - Gmsh top level
	    bin             - Gmsh binary

MODIFY HISTORY:
	5/8/17 - Alex Prengel
                  Created this README.athena, initial locker setup

MISCELLANEOUS:

If you have run a previous release of gmsh, you should delete your ~/.gmshrc
file if it exists to avoid version mismatch problems.

Gmsh/GetDP are set up to run from a terminal window where the user's
home directory is reset to /var/tmp/$USER. The reason for this is that
these applications use a network socket in the user's home directory
to communicate, and AFS file systems (where user's home directories
normally reside) don't support sockets.

Although you can run the applications from this location, please note that
any files you generate during program runs won't be saved unless you copy them
to a permanent location (such as your Athena home directory). You can run
them from your Athena home directory directly to get around this issue.

Note: Gmsh can run complete workflows; to see how this works unzip
some of the examples in /mit/gmsh_v3.0.1/getdp-models or the magnet demo
in /mit/gmsh_v3.0.1/getdp-2.11.0-Linux/share/doc/getdp/demos in a
writable location, launch gmsh and select File -> Open and pick the
primary .pro file (you may need to read the documentation to know
which one(s) to pick or experiment with different choices), then click
on Run at the bottom of the left side panel. The solver should be
preset to GetDP.