Synthetic consortia represent an emerging research area in synthetic biology, promising to solve various industrial challenges through the metabolic diversity, division of labor, and spatial organization inherent in microbial consortia. As synthetic biology advances into multi-cellular systems, new design strategies are essential for engineering distributed functions across networks of cells. However, existing strategies either lack scalability or require extensive reformulation, limiting their usage to various applications. In this work, we propose an application-agnostic approach to partitioning networks of interacting biological components using graph-based algorithms. We developed a three-stage algorithm, named Oriole, that verifies and optimizes the subgroup distribution of all entities within a network, considering constraints, objectives, and other biological considerations essential for engineering these systems. We validated our algorithm on three types of networks, including 30 small-graph benchmarks, 537 regular electronic circuit designs, and 43 large circuit benchmarks. One large circuit benchmark was recently implemented in the wet lab. Compared with the published sub-graph partitioning solution, the results generated by our new algorithm reduced design time from days to hours and decreased the total number of cells required for the multi-cellular system by 3%. This case study demonstrates that our algorithm provides a more efficient approach to designing multi-cellular systems.
Download the repository from GitHub, create a venv environment, and install the necessary packages. Here we use python3.8 as the python interpreter.
$ git clone https://github.com/CIDARLAB/Oriole.git
$ cd algorithm
$ python3 -m venv venv/
$ venv/bin/pip3 install -r requirements.txtAfter you install all the packages, you are able to run the algorithm.
The desired input graph format for Oriole algorithm is ".edgelist". Users can use this command to create the graphs of their own benchmarks. Since many the schematics of regular electronic circuits can be represented in JSON format, we provide an edge list generator for users to get the desired input format of Oriole algorithm.
$ venv/bin/python3 generateEdgeList.py -settings ./settings.txt -samples md5_opt_nor2In the "settings.txt" file, users can create a new row and modify constraints for their benchmark.
You can run the verification stage of Oriole algorithm to verify the 2-bit MD5 benchmarks with the following command. The algorithm outputs a verified subgroup solution after passing this stage. Otherwise, it reports error. Don't forget to comment the command "Merging()" and command "EdgeColoring()" if you only want to do the verification step.
$ venv/bin/python3 algorithm/partition_edge_color.py -settings ./settings.txt -samples md5_opt_nor2You can run the merging stage of Oriole algorithm to find more optimal subgroup solutions for the 2-bit MD5 benchmarks with the following command. Don't forget to comment the command "Verification()" and "EdgeColoring()" if you only want to do the merging step.
$ venv/bin/python3 algorithm/partition_edge_color.py -settings ./settings.txt -samples md5_opt_nor2You can run the edge coloring stage of Oriole algorithm to find color assignment and the corresponding subgroup solution for the 2-bit MD5 benchmarks with the following command. Don't forget to comment the command "Verification()" and command "Merging()" if you only want to do the edge coloring step.
$ venv/bin/python3 algorithm/partition_edge_color.py -settings ./settings.txt -samples md5_opt_nor2Feel free to dive in! Open an issue or submit PRs.
This project exists thanks to all the people who contribute.
BSD 2-Clause License
Copyright (c) 2024, CIDAR LAB All rights reserved.
See LICENSE for more information.