SilcsBio Software Installation

Minimum hardware requirement

SilcsBio software requires relatively robust computational resources for the molecular dynamics (MD) components of the SILCS and SSFEP protocols. For example, computing SILCS FragMaps for a 35 kDa target protein takes 80-90 hours of walltime when run in parallel on ten compute nodes, each equipped with 8 3-GHz CPU cores. The software can take advantage of GPU acceleration: the addition of a single NVIDIA GeForce RTX 2070 GPU to each node will reduce the walltime to 24-48 hours. In the case of SSFEP, walltime using these GPU-equipped nodes will be 3-4 hours.

SilcsBio software is designed to run the compute-intensive MD on a cluster using a cluster queue management system such as OpenPBS, Sun Grid Engine, or SLURM. With both SILCS and SSFEP, subsequent evaluation of relative ligand affinities takes seconds to minutes on a single CPU core, allowing for modifications to be rapidly evaluated for a large number of ligands to a given target.

For customers without ready access to an appropriate in-house computing cluster, SilcsBio offers three possible solutions. The first solution is the SilcsBio Workstation. The SilcsBio Workstation combines the SilcsBio server and GUI software with high-perfomance GPU-computing hardware in a quiet, sleek form factor for use in an office setting. The SilcsBio Workstation is a complete turn-key solution that is ready to plug in to a standard wall electrical socket. The second solution is for SilcsBio to perform computations as a service and supply data to the customer for subsequent in-house analysis. For this service, in the case of SILCS, SilcsBio requires only the structure of the target, and, in the case of SSFEP, only the structure of the protein-parent ligand complex. Depending on the choice of SSFEP or SILCS, no intellectual property disclosure to SilcsBio in the form of proposed chemical modifications to the parent ligand (SSFEP) or even the parent ligand itself (SILCS) is required. The third solution is for SilcsBio to assist customers with setting up their own virtual cluster using Amazon Web Services. Please contact info@silcsbio.com for additional information on these solutions.

Software requirement

SILCS FragMap generation and SSFEP calculations use the MD simulation package GROMACS. Although the SilcsBio software is compatible wth GROMACS version 5.1.0 and later, we recommend GROMACS version 2019.6. The package can be obtained at http://manual.gromacs.org/documentation/2019.6/download.html and must be installed in order to use the SilcsBio software package.

Below is a recommended sequence of commands for general installation of GROMACS (with GPU acceleration):

cd <GROMACS source directory>
mkdir build
cd build
cmake .. -DGMX_BUILD_OWN_FFTW=on \
  -DREGRESSIONTEST_DOWNLOAD=on \
  -DGMX_GPU=on \
  -DBUILD_SHARED_LIBS=off \
  -DGMX_PREFER_STATIC_LIBS=on \
  -DGMX_BUILD_SHARED_EXE=off \
  -DCMAKE_INSTALL_PREFIX=<GROMACS install location>
make
make install

If your compute nodes do not have GPUs, use the following command:

cd <GROMACS source directory>
mkdir build
cd build
cmake .. -DGMX_BUILD_OWN_FFTW=on \
  -DREGRESSIONTEST_DOWNLOAD=on \
  -DBUILD_SHARED_LIBS=off \
  -DGMX_PREFER_STATIC_LIBS=on \
  -DGMX_BUILD_SHARED_EXE=off \
  -DCMAKE_INSTALL_PREFIX=<GROMACS install location>
make
make install

Please refer to http://manual.gromacs.org/documentation/current/install-guide/index.html for further detail.

Installing the SilcsBio server software

The SilcsBio server software package is delivered as a zip-compressed file. Unzip and place the files to an accessible location. The files have the following directory structure

silcsbio.$VERSION/
  data/
  examples/
  lib/
  programs/
  silcs/
  silcs-hotspots/
  silcs-mc/
  silcs-memb/
  silcs-pharm/
  ssfep/
  ssfep-memb/
  templates/
  utils/
  VERSION

The top-level silcsbio.$VERSION/ folder contains software for running SILCS and SSFEP simulations. The programs/, silcs*/, and ssfep*/ folders contain executable code, and the templates/ folder contains templates for job submission and input scripts. Some template files may need to be edited with information for your queuing system.

If you are a system administrator, place the top-level silcsbio.$VERSION/ folder where it can be accessed by other users, such as /opt/silcsbio/. If you are a single user, you may place the folder in your home directory.

For SilcsBio server software to work, the two shell environment variables GMXDIR and SILCSBIODIR need to be set. To do so, replace <gromacs/bin> and <silcsbio> with the complete file paths for the corresponding folders:

# bash
export GMXDIR=<gromacs/bin>
export SILCSBIODIR=<silcsbio>

Currently, the SilcsBio server software is compatible only with the Bash shell environment. You may insert the above environment variable settings in .bashrc for convenience.

Installing the SilcsBio Graphical User Interface

The SilcsBio Graphical User Interface (GUI) enables running SILCS and SSFEP simulations and analyzing results through a GUI instead of the command line. The SilcsBio GUI is available for Windows, macOS, and Linux. Please download and install the software on your local desktop or laptop computer.

In addition to providing standalone features such as FragMap visualization and ligand modification, the SilcsBio GUI can set up, launch, manage, and analyze compute-intensive SILCS and SSFEP simulations. To enable this functionality requires a simple configuration step to allow the GUI to communicate with your SilcsBio server software.

Please follow the Remote server setup process as described in Graphical User Interface Quickstart. Contact support@silcsbio.com if you need help with this process.

Installing visualization plugins

Note

These plugins are used for visualization of FragMaps. If you are only interested in SSFEP, or do not intend to use any external programs to visualize FragMaps, you may skip this section.

VMD plugin installation

For VMD versions later than 1.9, the plugin can be installed using the VMD Preference menu, which can be found in the “VMD Main” window using the menu selection Extensions ‣ VMD Preferences:

_images/vmd-prefs.png

In the preference window, select the “Custom” tab and press the “New” button. Enter the following lines in the “Code” section:

lappend auto_path [file join $env(SILCSBIODIR) utils plugins vmd]
vmd_install_extension silcs silcs::fragmap "SilcsBio/FragMap Tools"

If you have not set the environment variable SILCSBIODIR, replace $env(SILCSBIODIR) with the full path to the silcsbio folder. Enter an appropriate name for the plugin under “Description:”, then press the “Update” button. Finally, press the “Write Settings to VMDRC” button and then restart VMD to confirm the plugin installation.

_images/vmd-install-plugin.png

PyMOL plugin installation

The PyMOL plugin can be installed using the plugin manager, which can be found using the PyMol menu selection Plugin ‣ Plugin Manager:

_images/pymol-prefs.png

This will open a plugin manager window. Select the “Install New Plugin” tab. Press the “Choose file…” button in the “Install from local file” section, then choose silcsbio.2019.1/utils/plugins/pymol/fragmap_tools.py. This will install the PyMOL plugin. Restart PyMOL to confirm the installation.

_images/pymol-install-plugin.png