Download and Install

Prerequisites

You will probably need root access to install some of the prerequisites.

You need these packages to use GEMS:

  • A c++ compiler (e.g. g++)
  • make
  • openssl
  • git (optional but recommended)
  • python3 (python3.4 is known to work and others might)
  • swig
  • boost

Installation instructions will vary according to operating system. If you use Ubuntu, you should be able to use a command like this:

If you use another operating system, please check its installation instructions.

Obtaining the software

The following does not require root access.

  1. Change to directory in which you want GEMS to live.
  2. Get GEMS from the git repo (*)
  3. Change directory to GEMS
  4. Get GMML from the git repo. Use the full command below because you need the repo to be named gmml rather than GMML as with the default clone.

(*) There are non-git ways to obtain gems and gmml.  Please see https://github.com/GLYCAM-Web/GEMS and https://github.com/GLYCAM-Web/GMML for more information.

Compiling and Installing

  1. The compilation requires gems to know where the header files for your python3 installation are.
    1. Some popular Linux distros put them in /usr/include/python3, and the program will look there for them.  If that works for you, then the script will set an environment variable, PYTHON_HOME to that location and proceed.
    2. If you need it set to something else, find the directory in your python3 installation that contains the file Python.h and set PYTHON_HOME in a manner similar to one of the examples below.  On some systems, the Python.h for python3.4 is in /usr/include/python3.4m/.

  2. You should still be in the gems directory.  Change to that directory if not.
  3. Run make.sh file in order to compile gmml and create the gems interface

Testing the Installation

Testing the installation requires BASH. This is already installed on most systems. If the command “which bash” returns no information or returns an error, contact your system administrator.

  1. From the gems directory, run the following command:
  2. See the output written to the terminal.  If all goes well, the output should look something like:

Example Use

Make sure you are still in the gems directory where you typed make.sh and tested the installation.

  1. Try the command that was used for the test (below).  You can leave off the redirects (the bits after the greater-than signs) if they don’t work in your shell or if you want the output to go to the terminal.
  2. Check out how the test_installation.bash script was written, especially if you are familiar with bash.  It might help.
  3. Try similar sample commands at the tops of files named *.py. They will be in the comments near the top of the file and will come just after a line that says “#SAMPLE COMMAND :”.
  4. You can also request help from most of the gems functions.  For example: