Moltiverse

Moltiverse is an open-source molecular conformer generator available as a command line application written in the modern Crystal language.

Moltiverse uses the robust ecosystem of open-source applications to process the molecules and perform conformational sampling. The conformer generation protocol consists of seven main steps:

  1. Molecular pre-processing: Conversion of SMILES code into three-dimensional coordinates using Open Babel.
  2. Structure stretching.
  3. Molecule parameterization with the GAFF2 force field using Amber Tools.
  4. Energetic minimization.
  5. Molecular sampling in vacuum with the M-eABF method using the NAMD molecular simulation engine.
  6. Structure clustering.
  7. Conformer ensemble refinement using electronic structure optimization calculations with XTB software.

Installation

Prerequisites

Quick Install

To install Moltiverse and its dependencies:

curl -fsSL https://raw.githubusercontent.com/ucm-lbqc/moltiverse/master/INSTALL.sh | bash

This command creates a "moltiverse" conda environment. To use Moltiverse, activate the environment:

conda activate moltiverse

Verifying Installation

To check that dependencies and versions are working correctly:

moltiverse --check
moltiverse --version

Custom Installation

To install a specific release or select which dependencies to install, download the 'INSTALL.sh' file and execute it:

bash INSTALL.sh

Requirements

External software:

Usage

[!IMPORTANT] This application is still under development and is not ready for production. Please note that we have not yet released a version or documentation. But stay tuned, we will do it soon ;).

  1. Check the examples directory for example input files:
    • molecule.smi: An SMI file containing a single SMILES code and molecule name.
    • molecules.smi: An SMI file with multiple SMILES codes and molecule names.
  2. You can modify the SMI file with your own molecules. SMILES codes can be obtained from PubChem.
  3. Running the application: 
    moltiverse -l molecule.smi --procs 2
moltiverse -l molecules.smi --procs 2

This command executes the entire protocol, creating a folder for each molecule in the SMI file. Each folder will contain the final conformers in various formats. The output files are as follows:

Note: For most analyses and applications, use the *qm.pdb or *qm.sdf files, as they represent the final, optimized conformers. The -P or --procs option assigns processor cores to run the protocol. For laptops or modest computers we recommend to use a small amount of cores (1 to 4) to avoid failures. For computing clusters, a higher number of cores is preferred.

  1. To test moltiverse with a short testing protocol (not for production, just for testing), use:

    moltiverse -l molecule.smi --procs 2 -p test

The testing protocol performs only 0.8 ns of simulaton divided into two RDGYR windows, generating ~800 structures. The full protocol "c1" performs 24 ns of simulation divided into 12 RDGYR windows, generating ~30000 structures.

  1. Visualization

The following Notebook can be useful to quickly visualize an output SDF file and calculate some properties.

[!IMPORTANT] The notebook uses RDKit to calculate the properties, and these may differ from those calculated with chem.cr in our benchmark. The notebook is only for quick visualization and analysis.

  1. Developing a new protocol

The c1.yml configuration file defines essential collective variables that govern the C1 protocol's behavior. When adapting the protocol to larger molecules, such as peptides or macrocycles, it is necessary to modify the upper and lower limits of the radius of gyration, along with other relevant variables as needed. Then pass the new protocol file to the -p option, as:

moltiverse -l molecule.smi --procs 2 -p path-to-new_protocol.yml

c1.yml

colvars:
  - component:
      type: rdgyr
    lower_bound: 3.0
    upper_bound: 9.0
    bin_width: 0.05
    windows: 12
    force_constant: 10.0
simulation_time: 2.0
fullsamples: 250
metadynamics: true
hillweight: 3.0
hillwidth: 3.0
newhillfrequency: 50
n_variants: 1
output_frequency: 400

Citing

If you use moltiverse in your research, please consider citing the following preprint:

Bedoya M, Adasme-Carreño F, Peña-Martínez PA, Muñoz-Gutiérrez C, Peña-Tejo L, Márquez Montesinos JCE, et al. Moltiverse: Molecular Conformer Generation Using Enhanced Sampling Methods. ChemRxiv. 2024; doi:10.26434/chemrxiv-2024-qs0pc-v2  This content is a preprint and has not been peer-reviewed.

Supplementary data

https://doi.org/10.6084/m9.figshare.27346974.v3

Contributing

  1. Fork it (https://github.com/ucm-lbqc/moltiverse/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors

License

GPL-3.0