Skip to content

A MATLAB toolbox to rapidly evaluate synthetic lethal sets in organisms using the genome-scale metabolic models

Notifications You must be signed in to change notification settings

RamanLab/FastSL

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FastSL

Efficient discovery of synthetic lethal gene and reaction sets in genome-scale metabolic models.

Paper DOI

Fast-SL is a parallelized workflow for identifying synthetic lethal (SL) relationships in metabolic networks. It accompanies the publication below and provides MATLAB scripts and sample data to reproduce the reported experiments and to adapt the pipeline to new genome-scale models.

  • High-throughput enumeration of single, double, and triple synthetic lethal sets.
  • 🤝 Parallel MATLAB implementation that accelerates the COBRA Toolbox-based workflow.
  • 📄 Reproducible reference implementation for the Bioinformatics 2015 Fast-SL paper.

Table of contents

  1. Getting started
  2. Quick start
  3. Repository structure
  4. Reproducibility resources
  5. Citing Fast-SL
  6. Maintainers & contact
  7. Acknowledgements

Getting started

Prerequisites

Fast-SL depends on the COBRA Toolbox ecosystem for MATLAB.

  • MATLAB R2013b or newer
  • COBRA Toolbox
  • A linear programming (LP) solver supported by COBRA (e.g., Gurobi, GLPK).
  • For the parallel Fast-SL implementation: IBM CPLEX v12.0 or later (available free for academics via the IBM Academic Initiative). Serial execution works with any COBRA-compatible solver.

Installation

  1. Clone or download this repository into your MATLAB path.
  2. Install and initialize the COBRA Toolbox following the official instructions.
  3. Ensure your chosen LP solver is installed, licensed, and configured in MATLAB via changeCobraSolver.
  4. Add the Fast-SL directories to the MATLAB path (e.g., addpath(genpath('FastSL'))).

Quick start

Once prerequisites are satisfied, launch MATLAB and run the helper scripts provided with the repository:

% Load the sample E. coli model and compute synthetic lethal reactions
addpath(genpath('FastSL'));
example_fastSL;

% Compute gene-level lethals for the same model
example_fastSLgenes;

To call the core routine directly, inspect the MATLAB documentation:

help fastSL

Key arguments of fastSL include the stoichiometric model structure (S, lb, ub, c, b, rxns) plus optional parameters for lethality cutoff, interaction order (up to 3), reaction exclusion lists, and ATP maintenance reaction identifiers.

Repository structure

Path Description
Models/ Genome-scale models (MAT files) for E. coli (iAF1260), Mycobacterium tuberculosis (iNJ661), and Salmonella enterica (STM v1.0), plus corresponding reaction exclusion lists (eliList_*.mat).
Parallel FastSL/ Parallelized MATLAB scripts leveraging CPLEX for accelerated synthetic lethality enumeration.
Genes/ Example results and helper scripts for gene-level synthetic lethal analysis.
Rxns/ Reaction-level lethality outputs mirroring the published experiments.
Sample Results/ Pre-computed synthetic lethal sets for the bundled models, useful for verifying your environment.
README.md Project overview (this document).

Reproducibility resources

  • Run example_fastSL and example_fastSLgenes to reproduce the main tables from the paper for the bundled models.
  • Compare your generated .mat result files with the contents of Sample Results/ to confirm consistent solver configuration.
  • The Parallel FastSL/ directory contains scripts configured for multi-core execution using CPLEX. Adjust solver options and parallel pool settings within MATLAB to match your hardware.

Citing Fast-SL

If you use this repository in academic work, please cite:

Aditya Pratapa, Shankar Balachandran, and Karthik Raman. “Fast-SL: An efficient algorithm to identify synthetic lethal sets in metabolic networks.” Bioinformatics 31.20 (2015): 3299–3305. https://doi.org/10.1093/bioinformatics/btv352

@article{pratapa2015fastsl,
  title   = {Fast-SL: An efficient algorithm to identify synthetic lethal sets in metabolic networks},
  author  = {Pratapa, Aditya and Balachandran, Shankar and Raman, Karthik},
  journal = {Bioinformatics},
  volume  = {31},
  number  = {20},
  pages   = {3299--3305},
  year    = {2015},
  doi     = {10.1093/bioinformatics/btv352}
}

Maintainers & contact

Fast-SL is maintained by members of the Raman Lab, IIT Madras. For questions or contributions, please open an issue or email the corresponding authors listed in the publication.

Acknowledgements

About

A MATLAB toolbox to rapidly evaluate synthetic lethal sets in organisms using the genome-scale metabolic models

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages