Sovereign 8s.is mirror of standardgalactic/gems
  • Python 78.8%
  • Shell 12.8%
  • nesC 3.9%
  • Fortran 2.3%
  • HTML 0.9%
  • Other 1.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2025-06-03 12:51:58 -04:00
.hooks prepush make proper use of fresh build scripts 2022-06-22 00:42:35 -04:00
apps old glylib submodule removed 2022-06-22 01:53:50 -04:00
bin added detect_sugars+compilation process to GEMS for AD2 2025-03-27 23:16:39 -04:00
dat/SNFG/Spring_2016 fixed datetime issue in json API return strings. 2020-02-26 04:06:34 -05:00
docs updated setup instance to use json instead of flags, documented IC 2024-06-17 16:45:58 -06:00
Doxygen Improved Doxygen 2020-03-20 04:36:54 -04:00
gemsModules Fix logfile names and logging dests to match MD_Utils better 2025-06-03 12:37:45 -04:00
gRPC small correction to allow response forwarding back to gRPC delegator 2025-03-08 18:33:25 -05:00
logs More code updates to make sequence testing practical. 2021-05-26 02:18:47 -04:00
project_management Added initial developer docs about MDaaS 2023-08-04 18:47:17 -04:00
testbin added run_evaluate_upload_PDB_test to pre-push test 10 2021-10-14 14:27:09 -04:00
tests Fixed test 008 after changing dep/seq zipfile log names. 2025-06-03 12:51:58 -04:00
utilities zip_wrapper and compare_zips 2025-06-03 03:37:23 -04:00
.gitignore added detect_sugars+compilation process to GEMS for AD2 2025-03-27 23:16:39 -04:00
00_View_Documentation.bash Download URLs and structure info works for minimal.json 2021-06-04 23:03:52 -04:00
clean.sh Added error handling to make and updated clean script 2022-03-21 21:56:25 -04:00
instance_config.template.json AD Evaluate service basically functional 2025-02-27 15:19:09 -05:00
LICENSE Create LICENSE 2019-06-17 22:11:30 -04:00
make.sh added detect_sugars+compilation process to GEMS for AD2 2025-03-27 23:16:39 -04:00
mkdocs.yml Download URLs and structure info works for minimal.json 2021-06-04 23:03:52 -04:00
Obsidian.md updated docs: API overview and use of obsidian 2023-05-17 04:57:32 -04:00
README.md Merge branch 'gems-test' into merge_BigOliver-deprecate_migrate. 2023-06-10 19:01:28 +00:00
requirements.txt suppress dependabot alert; irrelevant to GLYCAM DevEnv which installs reqs manually 2024-11-25 09:55:14 -05:00

GLYCAM Extensible Modeling Scripts (GEMS)

This code serves as a convenient interface to the molecular modeling code in the Glycam Molecular Modeling Library.

The code is constantly in flux, but the main idea is that you use a JSON file as input to the bin/delegate script.

We need more docs. Would you like to help?

Used by GLYCAM-Web

This code also serves as the main interface to GLYCAM-Web. Use of this interface ensures that the services provided by the website give exactly the same results as you would get using GEMS on the command line.

Funding Sources

We are very grateful to our funders.
Please check them out!

Installing GEMS (GLYCAM Extensible Modeling Script)

This document is likely somewhat out of date. We're working on that.

Prerequisites
Obtaining the software
Compiling and Installing
Testing the Installation
Example Use
Documentation

Prerequisites

In order to install GEMS, you will need to have the following software available on your system:

  • openssl
  • git
  • python3.9
  • python3.9-dev (you need the Python header files for your Linux distro, which may not be part of your existing Python package)
  • swig (Version >= 4.0.2)
  • Kernel headers (the source code for the Linux kernel, which may not be installed on your system)
  • cmake (Version >= 3.13.4)
  • boost

NOTE - installing some prerequisites may require root access. Also swig must be installed from their website

Please note that in order to use GEMS you must also have GMML installed and compiled. Most of the above packages are needed for compiling GMML

Installation instructions will vary according to the package management software your distro uses. If you use Ubuntu or any other Debian based system, you should be able to use a command like this:

sudo apt-get install openssl git python3.9 python3.9-dev build-essential cmake libboost-all-dev 

For other Linux distros, please follow the instructions for the package management software included with your system.


Obtaining the software

Once you have installed the prerequisites, you can install the GEMS software.

NOTE - installing GEMS does not require root access.

Change to the directory where you will install GEMS, and clone the GEMS repo from Github:

git clone https://github.com/GLYCAM-Web/gems.git

This will create a gems directory. Change to the gems directory, and clone the GMML repo from Github:

cd gems/
git clone https://github.com/GLYCAM-Web/gmml.git

Compiling and Installing

To compile the software, make sure you are still in the gems directory:

pwd
/gems

Set your PYTHON_HOME environment variable to the location of the Python.h file for your Python version. For Ubuntu, use something like one of the following:

export PYTHON_HOME=/usr/include/python3.9
or
setenv PYTHON_HOME /usr/include/python3.9

Make sure to use the correct path to your Python version, and the correct version of Python. For other Linux distros, please follow the instructions to set environment variables specific to your system.

There are a handful of ways to use more processors while compiling:

.../gems$ make.sh -j 8

This will compile GMML with 8 cores.

Testing the Installation

Make sure you are still in the gems directory, and run the following command to test the installation:

Please note that there are tests within the tests/ directory but many will fail because they require you to have a stack running that can handle DNS because we submit a JSON request with one of the tests (specifically test 008). These tests are expected to fail if you are only running GEMS.

Make sure you are still in the gems directory, and run the following command, which is all on one line:
python3 bin/AmberMDPrep.py tests/inputs/016.AmberMDPrep.4mbzEdit.pdb You should see a lot of info that ends: Disulphide bonds: Chain terminations: A | 25 | NH3+ | 301 | CO2- B | 25 | NH3+ | 299 | CO2- C | 25 | NH3+ | 299 | CO2- D | 26 | NH3+ | 299 | CO2- E | 25 | NH3+ | 301 | CO2- F | 25 | NH3+ | 298 | CO2- G | 25 | NH3+ | 298 | CO2- H | 25 | NH3+ | 298 | CO2- I | 25 | NH3+ | 299 | CO2- J | 24 | NH3+ | 300 | CO2- We made it to the end. Congratulations!