Tutorial — Retro-Biosynthesis¶
Galaxy-SynBioCAD portal is the first toolshed for synthetic biology, metabolic engineering, and industrial biotechnology1. It provides tools aimed at finding pathways to synthesize heterologous compounds in chassis organisms (RetroRules2, RetroPath2.03, RP2Paths3, rpCompletion1).
Retrosynthesis is a concept originally proposed for synthetic chemistry where chemists have to work backwards, starting from a target product to reach precursors that are endogenous to the chassis (host organism).
Typically, the target compound, also named “source compound” is the compound of interest one wishes to produce, while the precursors are usually compounds that are natively present in a chassis strain.

How to produce target from chassis?
In this tutorial, we want to obtain the reactions producing the lycopene (source) into the iML1515 Escherichia Coli strain (chassis).
To do that, we will use the following RetroSynthetis Workflow composed of 3 key steps.
First, we aggregate the metabolites present in the chassis and download reaction rules.
Then, RetroPath2.0 generates feasible metabolic routes between a collection of chemical species contained within a GEM SBML (Systems Biology Markup Language) file of the selected organism, a target molecule that the user wishes to produce, and reaction rules extracted from RetroRules.
Lastly, the metabolic network is then deconstructed into individual pathways using RP2paths and rpCompletion takes those individual metabolic pathways to filter them (duplicated pathways are removed), splits them into sub-pathways by adding the appropriate cofactors, and finally converted them to SBML files.
Lastly, the metabolic network is then deconstructed into individual pathways using RP2paths and rpCompletion takes those individual metabolic pathways to filter them (duplicated pathways are removed), splits them into sub-pathways by adding the appropriate cofactors, and finally converted them to SBML files.

Retrosynthesis Workflow
Note that we will run the steps of this workflow individually so as not to neglect the understanding of the intermediate steps as well. Then, we will run the workflow automatically so that it itself retrieves the outputs from the previous step and gives them as input to the next tool.
Before starting
- Navigation: Use the right sidebar to navigate through the tutorial.
- Tools: Each tool is represented by its icon and version .
- Troubleshooting: for issues using Galaxy please check the Galaxy FAQ.
Data Preparation¶
RetroSynthesis workflow will be run with the following inputs:
- Chemical structure of the compound to produce, given by its InChI,
- Chemical structure of metabolites available in the chosen chassis (E. coli),
- Reaction rules modeling possible metabolic transformations.
Targeted compound and chassis
In the course of this tutorial, we'll focus on the production of xylitol in an Escherichia Coli strain. To model the metabolism of this strain, we will use the E. coli core model available in the BiGG database4.
The data used are pretty straight forward to obtain. Firstly, we download an SBML model, then we select all sinks to use into the RetroPath2.0 software from this model. Lastly, we request from RetroRules all possible reactions to find a chemical reaction cascade that produces the target.
Create a new history¶
How-to: Create a new history
- Click on the icon, right panel (top of the history panel).
- Select Create New.
- Rename history to
RetroSynthesis - Xylitolby clicking on its name (default is "Unnamed history").
Source: Creating a New History — Galaxy FAQ
It is recommended to create a new history for each tutorial to avoid confusion with existing datasets.
Metabolic model¶
Hands-on: Acquire a SBML model
Run Pick SBML Model (Galaxy Version 0.0.3) with parameter:
- Strain :
Escherichia coli str. K-12 substr. MG1655 (e_coli_core)
Strain selection
Double check that the e_coli_core E. coli's model is selected.
There are many strains related to E. coli. Here, we select the core model for simplicity and computational efficiency.
Q1: What is the BiGG database?
The BiGG Models database is a repository of genome-scale metabolic network reconstructions that provides standardized, high-quality models for various organisms, facilitating research in systems biology and metabolic engineering.
Q2: Why using a SBML model?
SBML (Systems Biology Markup Language) is a widely used format for representing computational models in systems biology. It allows for the exchange and sharing of models between different software tools and platforms, making it easier to collaborate and reproduce results.
Q3: How many files are generated? What are they?
4 files:
- e_coli_core: the SBML model file (XML/SBML format)
- e_coli_core (taxon id): the NCBI taxonomy ID of the organism (TXT/TSV format)
- e_coli_core (compartments): the list of compartments in the model (TSV format)
- e_coli_core (biomass reactions): the list of biomass reactions in the model (TSV format)
Q4: What is the file format of the model?
The model is in SBML format, which is based on XML.
Hands-on: Rename datasets
Rename output datasets of Pick SBML Model:
| Current name | New name |
|---|---|
e_coli_core |
Model - SBML |
e_coli_core (taxon id) |
Model - Taxon ID |
e_coli_core (compartments) |
Model - Compartments |
e_coli_core (biomass reactions) |
Model - Biomass Reactions |
How-to: Rename a dataset
- Click on the pencil icon for the dataset to edit its attributes
- In the central panel, change the Name field
- Click the Save button
Source: Renaming a Dataset — Galaxy FAQ
Sink compounds¶
Hands-on: Create a sink file
Run Sink from SBML (Galaxy Version 5.12.1) with parameters:
- Strain:
- Select mode Single dataset: icon
- Select dataset :
Model - SBML
- SBML compartment ID:
c - Advanced options : dead-end metabolites removal using FVA
How-to: Select a dataset by drag-and-drop
- In the history panel, click and hold the left mouse button on the desired dataset
- Drag and drop the dataset on top of the input field
Q1: What does this tool do?
This tool extracts all metabolites present in the SBML model and creates a sink file (CSV format) that can be used as input for RetroPath2.0.
Q2: How many compounds are listed in the file?
52 compounds.
Q3: What is FVA? How is it used here?
Flux Variability Analysis (FVA) is a computational method used to analyze the range of possible fluxes through metabolic reactions in a given metabolic network. It helps to identify reactions that can carry flux under specific conditions, such as growth on a particular substrate. In this context, FVA is used to remove dead-end metabolites from the sink file, ensuring that only metabolites that can be produced or consumed in the metabolic network are included.
Note: Compartment ID
The compartment ID must correspond to the one used in the SBML model. Here, c is the BiGG code for the cytoplasm. Other common compartment IDs are e for extracellular and p for periplasm.
For SBML model from another source, this value must be adapted accordingly. Available compartments can be manually checked in the SBML file by searching for compartment id=.
Hands-on: Rename dataset
Rename the output dataset of Sink from SBML:
| Current name | New name |
|---|---|
Sink - Model - SBML |
Sink - Model |
Reaction rules¶
Hands-on: Download reaction rules
Run RRules Parser (Galaxy Version 2.6.0+galaxy0) with parameters:
- Select Rule Type :
RetroRules (retro) - Select diameters of reactions rules :
8,12 - Toggle Compress output :
No - Filter by EC number :
No
Q1: How a reaction rule differs from a regular reaction?
A regular reaction describes a specific chemical transformation between defined reactants and products, while a reaction rule is a generalized representation that captures the underlying transformation pattern. Reaction rules can be applied to a broader range of substrates, enabling the prediction of reactions for compounds that share similar structural features.
Q2: What is a diameter in this context?
The diameter of a reaction rule defines the size of the molecular environment around the reaction center that is considered when applying the rule. It determines how specific or general the rule is, with larger diameters capturing more of the surrounding structure and thus being more specific.
Q3: What is the impact of choosing low or high diameters?
Choosing low diameters results in more general rules that can be applied to a wider range of substrates, leading to more potential reactions, but may also lead to less accurate predictions. Conversely, higher diameters yield more specific rules that are tailored to particular substrates, potentially improving accuracy but limiting applicability.
Q4: What is the format of the output file?
The output file is in CSV format and contains information about the predicted reactions, including reactants, products, and their associated SMILES and InChI representations.
Q5: Where is located the encoding of the reaction rules?
The encoding of the reaction rules is located in the Rule column.
Q6: How many rules have been downloaded?
58,596 rows.
Hands-on: Rename dataset
Rename the outputed dataset of RRules Parser to Reaction Rules.
Retrosynthesis¶
Run algorithm using RetroPath2.0¶
RetroPath2.0 is an open-source tool for building retrosynthesis networks by combining reaction rules and a retrosynthesis-based algorithm to link the desired target compound to a set of available precursors. RetroPath2.0 core code is available at myExperiment.
The retrosynthesis network is outputted as a CSV file listing predicted reactions and chemicals (provided as SMILES and InChI) along with other information like a penality score for each reaction.
Hands-on: Build a reaction network
Run RetroPath2.0 (Galaxy Version 2.3.0) with the following parameters:
- Select Rules File:
- Single dataset input
- Dataset
Reaction Rules
- Select Sink File:
- Single dataset input
- Dataset
Sink - Model
- Select Target Compound:
- InChI type By string
- Source InChI :
InChI=1S/C5H12O5/c6-1-3(8)5(10)4(9)2-7/h3-10H,1-2H2/t3-,4+,5+
- Maximal Pathway length
2 - Advanced options : leave default values
InChI format
Be careful, InChI must start by InChI=.
Q1: What is Xylitol? What does it look like? Where to find more information?
Xylitol is a natural sugar alcohol used as a sweetener in various food products, and it has applications in dental care due to its ability to reduce tooth decay. More information can be found on its PubChem entry.

Q2: What is the purpose of the sink file?
The sink file lists metabolites that are available in the chassis organism (E. coli in this case). It is used to determine which predicted compounds are available materials for biosynthesis. Once a predicted compound is found in the sink, retrosynthesis process stops for that branch.
Q3: How many iterations of the retrosynthesis were performed?
2 iterations maximum.
Q4: What is the format of input and output files?
- Reaction rules: CSV file
- Sink: CSV file
- Output: CSV file
Q5: How many reactions are predicted?
37 rows.
Note: Execution time
Depending on the number of rules and the target compound, the execution time may vary from a few minutes to several hours.
Hands-on: Rename dataset
Rename the output dataset of RetroPath2.0 to Retrosynthesis Network.
Enumerate pathways with RP2paths¶
The RetroPath2.0 algorithm produces a reaction network, exploring reachable compounds and reactions starting from the target compound.
Here, we will investigate how to split this network into individual pathways. A pathway is considered valid if it starts from only available material (sink metabolites) and reaches the target.
Hands-on: Enumerate pathways
Run RP2paths (Galaxy Version 1.5.0) with parameters:
- Select RetroPath2.0 Pathways:
- Single dataset input
- Dataset
Retrosynthesis Network(output of RetroPath2.0)
- Advanced options : leave default values
Q1: How many files are produced? What are they?
2 files:
- Compounds: CSV file listing all compounds involved in the pathways, with their SMILES representations.
- Pathways: CSV file listing all identified pathways, with pathway IDs, reactions equations, and compounds IDs.
Q2: What is the formalism used for the structure of compounds? How could it be visualized?
The compounds are represented using SMILES (Simplified Molecular Input Line Entry System) notation. SMILES strings can be visualized using various cheminformatics tools and libraries, such as RDKit, or online SMILES viewers, e.g. PDB Chemical Sketch Tool.
Q3: How many pathways are found?
Path IDs range from 1 to 12: 12 pathways.
Q4: Why is several rows per pathway?
Each pathway is represented by multiple rows, with each row corresponding to a reaction within the pathway.
Hands-on: Rename datasets
Rename the output datasets of RP2paths:
| Current name | New name |
|---|---|
RP2paths (Compounds) |
Master pathways - Compounds |
RP2paths (Pathways) |
Master pathways |
Complete Reactions¶
Reaction rules are often generic, meaning that one rule can correspond to several template reactions. In addition, some compounds are excluded from the rules, on the left side notable as only one substrate is considered at a time.
Here the aim is to build complete reactions, with all substrates and products, and to convert pathways into SBML files. Each "Master pathway" will be completed. In addition, if it can model several reactions, multiple pathways will be generated from one "Master pathway".
Hands-on: Complete reactions
Run Complete Reactions (Galaxy Version 5.12.2) with parameters:
- Select RP2paths pathways:
- Single dataset input
- Dataset
Master pathways
- Select RP2paths compounds:
- Single dataset input
- Dataset
Master pathways - Compounds
- Select RetroPath2.0 metabolic network:
- Single dataset input
- Dataset
Retrosynthesis Network(output of RetroPath2.0)
- Select Sink from SBML:
- Single dataset input
- Dataset
Sink - Model
- Advanced options : leave default values.
Q1: What is the format of the output?
A collection of SBML files, with one file per pathway.
Q2: What is the benefit of this format?
SBML is a standard format for representing computational models in systems biology, allowing for easy sharing and analysis of biological pathways. It is widely supported by various software tools and platforms, facilitating collaboration and reproducibility in research.
Q3: How many pathways have been generated?
10.
Q4: Do these pathways represent a good solution?
We don't know if they represent a good solution. We need to evaluate them.
Hands-on: Rename collection
Rename the output dataset of Complete Reactions to Completed Pathways:
- Click on the collection to open it.
- Click on collection name itself (a tooltip appears: "Click to rename..").
- Enter the new name then press Enter.
- Refresh the history panel by clicking on the icon (top right).
Visualize pathways¶
Hands-on: Visualize pathways
Run Visualize pathways (Galaxy Version 6.5.0+galaxy0) with parameters:
- Select Source SBMLs format :
Collection - Select Source SBML :
Completed PathwaysDrag and drop from history to select the collection. - Advanced options : leave default values
View the output
- Click on the icon of the output dataset
Pathway Visualizationto open it. - Alternatively (1): right-click on the icon and select Open in new tab to open it in a new browser tab.
- Alternatively (2): click on the icon and select Download to download the file and open it locally with a web browser.
Q1: What is the format of the output?
The output is in HTML format, which can be viewed in a web browser.
Q2: How many pathways are visualized?
10 pathways.
Q3: What are possible panels of information?
- Pathway-related information panel (by click on a pathway ID)
- Reaction-related information panel (by click on a reaction node)
- Compound-related information panel (by click on a compound node)
Q4: Do you see any common reactions between the different pathways?
Yes, some reactions are common between different pathways.
Q5: Some reactions look identical, but have different IDs. Why?
They are actually different reactions because they involved different set of co-factors.
Q6: Can you identify any key intermediates in the pathways?
Yes, some intermediates appear in multiple pathways, indicating their importance in the overall metabolic network.
Conclusion¶
In this tutorial we produced candidates pathways to produce Xylitol in an Esherichia Coli strain.
Four main steps were involved:
- Pre-processing input data
- Run Retrosynthesis algorithm with RetroPath2.0
- Enumerate all solutions found by RetroPath2.0
- Complete reactions and convert pathways to SBML files
References¶
-
Hérisson, J.; Duigou, T.; Du Lac, M.; Bazi-Kabbaj, K.; Sabeti Azad, M.; Buldum, G.; Telle, O.; El Moubayed, Y.; Carbonell, P.; Swainston, N.; Zulkower, V.; Kushwaha, M.; Baldwin, G. S.; Faulon, J.-L. The Automated Galaxy-SynBioCAD Pipeline for Synthetic Biology Design and Engineering. Nature Communications 2022, 13 (1), 5082. https://doi.org/10.1038/s41467-022-32661-x. ↩↩
-
Duigou, T.; du Lac, M.; Carbonell, P.; Faulon, J.-L. RetroRules: A Database of Reaction Rules for Engineering Biology. Nucleic Acids Research 2019, 47 (D1), D1229--D1235. https://doi.org/10.1093/nar/gky940. ↩
-
Delépine, B.; Duigou, T.; Carbonell, P.; Faulon, J.-L. RetroPath2.0: A Retrosynthesis Workflow for Metabolic Engineers. Metabolic Engineering 2018, 45, 158--170. https://doi.org/10.1016/j.ymben.2017.12.002. ↩↩
-
King, Z. A.; Lu, J.; Dräger, A.; Miller, P.; Federowicz, S.; Lerman, J. A.; Ebrahim, A.; Palsson, B. O.; Lewis, N. E. BiGG Models: A Platform for Integrating, Standardizing and Sharing Genome-Scale Models. Nucleic Acids Research 2016, 44 (D1), D515--D522. https://doi.org/10.1093/nar/gkv1049. ↩