Snapshot of GEMrefine showing the metabolites, genes and reactions of a metabolic reconstruction (top two panels) along with reactions and metabolites from the ModelSEED biochemistry database (bottom panel).
GEMrefine was released by In Silico Fermentation in October 2026. Please continue reading this page to learn more about the application and to download this free software.
A draft genome-scale metabolic reconstruction generated from an annotated genome using computational pipelines such as the DOE ModelSEED and Kbase platforms invariably contains incomplete metabolic pathways due to missing reactions. While many of these reaction gaps have no effect on functional capabilities, incomplete pathways associated with important functions need to be identified, completed and tested through a process known as manual refinement or curation. Draft reconstructions typically undergo multiple rounds of manual refinement to generate a high-fidelity model containing accurate descriptions of key metabolic functions. The COBRA toolbox provides numerous functions to facilitate the refinement process, but the user must write MATLAB or python code to use the available functions and establish a suitable workflow.
GEMefine is a MATLAB application that enables manual refinement and analysis of draft metabolic reconstructions within a GUI environment. The main app allows the tabularization and search of all metabolites, reactions and genes along with their associated properties. Existing reactions and metabolites can be edited, while new metabolites and genes can be automatically added through the manual addition of new reactions. For draft models generated with the ModelSEED and Kbase platforms or other pipelines such as gapseq that utilize ModelSEED nomenclature, new reactions and metabolites can be added directly from tables containing the ModelSEED biochemistry database. An integrated companion app allows detailed structural and functional analysis of the refined reconstruction. To identify pathway gaps, the user can display blocked reactions as well as dead-end and blocked metabolites. Pathway completeness can be checked by calculating the maximal flux between any two metabolites. Nutrient uptake bounds can be modified before performing flux balance analysis (FBA) and flux variability analysis (FVA) to calculate and plot the growth rate, nutrient uptake fluxes, and product secretion fluxes. The modified model can be saved in either app at any point during the refinement process.
The following PDF file provides an overview of how GEMrefine can be used to refine and analyze draft metabolic reconstructions.
GEMrefine has the following requirements:
- Version 2024a or newer version of MATLAB.
- Installed COBRA toolbox for MATLAB.
- A linear program (LP) solver compatible with COBRA. A list of compatible LP solvers is available here.
- Genome-scale metabolic reconstructions compatible with COBRA. GEMrefine as been tested using draft reconstructions generated using KBase and gapseq as well as curated reconstructions from the BIGG repository and the Virtual Metabolic Human resource (i.e., AGORA models).
GEMrefine can be freely downloaded using the link below. The software is distributed under The GNU General Public License v3.0.
The Zip file should be processed as follows:
- Download and unzip the file using Zip archive software.
- The unzipped file will contain the following files and folders: (1) the main app, GEMrefine_v1_0.mlappinstall; (2) the MATLAB files metDatabase and rxnDatabase containing app versions of the ModelSEED compound and reaction databases; (3) the MATLAB files Clostridium_difficile_CD196_2_reconstruction_v1 containing a KBase generated draft reconstruction of the gut pathogen strain Clostridioides difficile CD196; and (4) the PDF file GEMrefine_overview.
- Save the files and other metabolic reconstructions in the desired working directory.
- To install the GEMrefine app, go to the Apps tab on the main Matlab page and click “Install App”. Select the saved GEMrefine_v1_0.mlappinstall. The GEMrefine app will appear as a new icon in the Apps tab.
- Initialize the COBRA toolbox using the command initCobraToolbox() and then launch the app by clicking on the icon.
Please contact us by email if you have any questions or feedback about GEMrefine.
