Skip to content

GRONINGEN-MICROBIOME-CENTRE/MicrobeRX

Repository files navigation

Description | Requirements | Installation | Tutorials | Workflow | Citation | License | Information | Disclaimer

DOI

Visitors

Description

MicrobeRX is A tool for enzymatic reaction-based metabolite prediction in the gut microbiome.

The publication and details about the tool can be found here:

MicrobeRX: A tool for enzymatic-reaction-based metabolite prediction in the gut microbiome

Question about usage or troubleshooting? Please leave a comment in the discussion section of this repo

Requirements

MicrobeRX is reliant on a variety of academic software. The following are some of the most noticeable:

  • rdkit
  • datamol
  • pyopenms
  • pubchempy
  • pandas
  • plotly
  • mols2grid
  • rxnMapper
  • ReactionDecoder

Installation

1. Installing MicrobeRX from PIP:

pip install MicrobeRX

2. Installing MicrobeRX from source:

git clone https://github.com/GRONINGEN-MICROBIOME-CENTRE/MicrobeRX.git
cd MicrobeRX
python setup.py install

3. Using MicrobeRX in GoogleColab:

Predict with MicrobeRX Colab

Drug Predictions from MicrobeRX Colab

Tutorials

Workflow

Command line

  • Description

    The script can be run in two modes:

      Single Prediction Mode: When the --smiles argument is provided, the script will perform predictions for the single molecule specified by the smiles string.
    
      Batch Prediction Mode: When the --file argument is provided, the script will read the input file and perform predictions for each molecule listed in the file using multiprocessing.
    
  • Examples

    Single Prediction Mode: microberx --SMILES "CCO" --query_name "ethanol" --biosystem "all" --cutoff 0.6 --out "./predictions/"

    This command will perform predictions for ethanol and save the results in the specified output directory.

    Batch Prediction Mode: microberx --file "input_molecules.tsv" --biosystem "all" --cutoff 0.6 --num_cores 4 --out "./predictions/"

    This command will read the input_molecules.tsv file, perform predictions for each molecule using 4 cores, and save the results in the specified output directory.

  • Output

      The predictions are saved as TSV files in the specified output directory. Each file is named after the query name provided or the names listed in the input file.   
    
  • Arguments

      --smiles : str, optional
      Input smiles string for prediction. If provided, predictions will be made for this single molecule.
    
      --query_name : str, optional
      Query name for the provided smiles string. This name will be used in the output file name.
    
      --file : str, optional
      Input file containing multiple smiles strings and names. The file should be in tab-separated values (TSV) format with columns "name" and "smiles".
    
      --biosystem : str, optional
      Biosystem to use for predictions. Default is 'all'.
    
      --cutoff : float, optional
      Cutoff value for predictions. Default is 0.6.
    
      --num_cores : int, optional
      Number of cores to use for multiprocessing. Default is 4.
    
      --out : str, optional
      Output directory for predictions. Default is the current directory ('./')   
    

Citation

If you use this software or its results in your research, publication, or project, please cite it as follows:

Ruiz-Moreno AJ, Fu J. MicrobeRX: A tool for enzymatic reaction-based metabolite prediction in the gut microbiome DOI: 10.5281/zenodo.10204312

License

This tool is under GPL-3.0 license, see the LICENSE file for details.

Information

  • This release includes the functionalities to generate reaction rules
  • This release includes the functionalities to predict, analyze and visualize metabolites.
  • This release includes the functionalities to find microorganism and enzymes.

Disclaimer

This software is still under development and may contain bugs or errors. The developers do not guarantee the accuracy, completeness, or reliability of the software or its results. Use it at your own risk and discretion. The software is provided "as is" without any warranty of any kind, either express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement. The developers are not liable for any damages, losses, or costs arising from the use of the software or its results.