Growth rates and fluxes¶
One of the major applications of micom is to identify growth rates and fluxes for a given community. We will return to our E. coli toy example.
[10]:
from micom import Community, data
tax = data.test_taxonomy()
com = Community(tax)
FBA¶
If one is only interested in the community growth rate \(\mu_c\) we can use normal FBA to optimize this growth rate. By default micom assigns the community growth rate as the objective for a community model.
[11]:
print(com.objective.expression)
com.optimize()
1.0*community_objective
[11]:
status: optimal
taxa:
abundance | growth_rate | reactions | metabolites | |
---|---|---|---|---|
compartments | ||||
Escherichia_coli_1 | 0.25 | 1.526449 | 95 | 72 |
Escherichia_coli_2 | 0.25 | 0.653014 | 95 | 72 |
Escherichia_coli_3 | 0.25 | 0.242410 | 95 | 72 |
Escherichia_coli_4 | 0.25 | 1.073813 | 95 | 72 |
medium | NaN | NaN | 20 | 20 |
optimize
returns a full-fledged solution object and you can inspect several aspects of it. For instance to get individual growth rates and information for the taxa:
[12]:
sol = com.optimize()
sol.members
[12]:
abundance | growth_rate | reactions | metabolites | |
---|---|---|---|---|
compartments | ||||
Escherichia_coli_1 | 0.25 | 1.526449 | 95 | 72 |
Escherichia_coli_2 | 0.25 | 0.653014 | 95 | 72 |
Escherichia_coli_3 | 0.25 | 0.242410 | 95 | 72 |
Escherichia_coli_4 | 0.25 | 1.073813 | 95 | 72 |
medium | NaN | NaN | 20 | 20 |
By default micom does not return fluxes since that can be slow for realistic large community models. If you want fluxes as well you can do so by passing the fluxes
argument to optimize
. You can also specifiy if you would like the fluxes to be obtained by parsimonious FBA.
[13]:
sol = com.optimize(fluxes=True, pfba=True)
sol.fluxes
[13]:
reaction | ACALD | ACALDt | ACKr | ACONTa | ACONTb | ACt2r | ADK1 | AKGDH | AKGt2r | ALCD2x | ... | RPI | SUCCt2_2 | SUCCt3 | SUCDi | SUCOAS | TALA | THD2 | TKT1 | TKT2 | TPI |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
compartment | |||||||||||||||||||||
Escherichia_coli_1 | 0.0 | 0.0 | 0.000000 | 9.657372 | 9.657372 | 0.000000 | 0.0 | 8.010490 | 0.0 | 0.0 | ... | -4.124228 | 0.0 | 0.0 | 8.010490 | -8.010490 | 2.753937 | 0.0 | 2.753937 | 2.202890 | 12.573226 |
Escherichia_coli_2 | 0.0 | 0.0 | 0.000000 | 4.771520 | 4.771520 | 0.000000 | 0.0 | 4.066985 | 0.0 | 0.0 | ... | -1.657659 | 0.0 | 0.0 | 4.066985 | -4.066985 | 1.071449 | 0.0 | 1.071449 | 0.835711 | 5.752211 |
Escherichia_coli_3 | 0.0 | 0.0 | 0.000000 | 2.474664 | 2.474664 | 0.000000 | 0.0 | 2.213129 | 0.0 | 0.0 | ... | -0.498116 | 0.0 | 0.0 | 2.213129 | -2.213129 | 0.280506 | 0.0 | 0.280506 | 0.192996 | 2.545629 |
Escherichia_coli_4 | 0.0 | 0.0 | -0.000327 | 7.125203 | 7.125203 | -0.000327 | 0.0 | 5.966669 | 0.0 | 0.0 | ... | -2.846022 | 0.0 | 0.0 | 5.966669 | -5.966669 | 1.882062 | 0.0 | 1.882062 | 1.494416 | 9.038452 |
medium | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | ... | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN |
5 rows × 115 columns
By defaults fluxes are stratified by taxa and the external medium to aid further analysis.
Returning to the growth rates we can see the major problem with regular FBA for community levels. Usually it will maximize growth for only a few taxa in the model yielding unrealistically high growth rates. However, in our setup we have 5 identical E. coli strains and we would expect all of the taxa to grow with the same rate (see Methods section).
Cooperative tradeoff¶
Cooperative tradeoff is a two step methods that allows you to get a unique solution for the the individuals growth rates that favors individual growth but still allows for a sup-optimal community growth rate. For that we always have to decide on a fraction of the maximum community growth rate we want to enforce. Our own results based on a data set of 189 gut microbiomes suggest that this tradeoff has tobe substantially lower than the optimal community growth rate to yield realistic growth rates (<=50% optimum). For our E. coli model we can start with getting the best solution while still maintaining optimal community growth (100% of maximum).
Cooperative tradeoff requires a QP-capable solver such as cplex or gurobi (both have academic licenses available)!
[14]:
sol = com.cooperative_tradeoff(fraction=1.0)
sol
[14]:
status: optimal
taxa:
abundance | growth_rate | reactions | metabolites | |
---|---|---|---|---|
compartments | ||||
Escherichia_coli_1 | 0.25 | 0.873922 | 95 | 72 |
Escherichia_coli_2 | 0.25 | 0.873922 | 95 | 72 |
Escherichia_coli_3 | 0.25 | 0.873922 | 95 | 72 |
Escherichia_coli_4 | 0.25 | 0.873922 | 95 | 72 |
medium | NaN | NaN | 20 | 20 |
As we see all taxa now grow at the same rate as would be expected. If we want fluxes as well we can again request those using the fluxes
and pfba
arguments.
[15]:
sol = com.cooperative_tradeoff(fluxes=True, pfba=True)
sol.fluxes
[15]:
reaction | ACALD | ACALDt | ACKr | ACONTa | ACONTb | ACt2r | ADK1 | AKGDH | AKGt2r | ALCD2x | ... | RPI | SUCCt2_2 | SUCCt3 | SUCDi | SUCOAS | TALA | THD2 | TKT1 | TKT2 | TPI |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
compartment | |||||||||||||||||||||
Escherichia_coli_1 | 2.558942e-09 | 1.258398e-09 | -1.022332e-07 | 6.007249 | 6.007249 | -1.022332e-07 | 2.584638e-09 | 5.064376 | 1.595951e-09 | 1.300544e-09 | ... | -2.281503 | 3.842359e-09 | 2.496730e-09 | 5.064376 | -5.064376 | 1.496984 | 2.593182e-09 | 1.496984 | 1.181498 | 7.477382 |
Escherichia_coli_2 | 2.558942e-09 | 1.258398e-09 | -1.022332e-07 | 6.007249 | 6.007250 | -1.022332e-07 | 2.584638e-09 | 5.064376 | 1.595951e-09 | 1.300544e-09 | ... | -2.281503 | 3.842359e-09 | 2.496730e-09 | 5.064376 | -5.064376 | 1.496984 | 2.593182e-09 | 1.496984 | 1.181498 | 7.477382 |
Escherichia_coli_3 | 2.558942e-09 | 1.258398e-09 | -1.022332e-07 | 6.007250 | 6.007249 | -1.022332e-07 | 2.584638e-09 | 5.064375 | 1.595951e-09 | 1.300544e-09 | ... | -2.281503 | 3.842359e-09 | 2.496730e-09 | 5.064375 | -5.064375 | 1.496984 | 2.593182e-09 | 1.496984 | 1.181498 | 7.477382 |
Escherichia_coli_4 | 2.558942e-09 | 1.258398e-09 | -1.022332e-07 | 6.007249 | 6.007250 | -1.022332e-07 | 2.584638e-09 | 5.064376 | 1.595951e-09 | 1.300544e-09 | ... | -2.281503 | 3.842359e-09 | 2.496730e-09 | 5.064376 | -5.064376 | 1.496984 | 2.593182e-09 | 1.496984 | 1.181498 | 7.477382 |
medium | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | ... | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN | NaN |
5 rows × 115 columns
Also if you have prior information about the growth rates you can also enforce a minimum individual growth rate for the taxa.
[16]:
sol1 = com.cooperative_tradeoff(min_growth=0.1) # single value
sol2 = com.cooperative_tradeoff(min_growth=[0.1, 0.2, 0.3, 0.4]) # one value for each taxa
print(sol1, sol2)
<CommunitySolution 0.874 at 0x7f8bae77c110> <CommunitySolution 0.874 at 0x7f8bae299190>
Finally, you might want to see the impact of the tradeoff parameter on your solution. For this you can simply pass in an array-like type as the fraction
parameter.
[17]:
import numpy as np
sols = com.cooperative_tradeoff(fraction=np.arange(0.1, 1.01, 0.1))
sols
[17]:
tradeoff | solution | |
---|---|---|
0 | 1.0 | <CommunitySolution 0.874 at 0x7f8bae2c3050> |
1 | 0.9 | <CommunitySolution 0.787 at 0x7f8bae568490> |
2 | 0.8 | <CommunitySolution 0.699 at 0x7f8bae742450> |
3 | 0.7 | <CommunitySolution 0.612 at 0x7f8bae4893d0> |
4 | 0.6 | <CommunitySolution 0.524 at 0x7f8bae540950> |
5 | 0.5 | <CommunitySolution 0.437 at 0x7f8bae107650> |
6 | 0.4 | <CommunitySolution 0.350 at 0x7f8bae1104d0> |
7 | 0.3 | <CommunitySolution 0.262 at 0x7f8bae69b0d0> |
8 | 0.2 | <CommunitySolution 0.175 at 0x7f8bae5311d0> |
9 | 0.1 | <CommunitySolution 0.087 at 0x7f8bae437190> |
The solutions can than be inspected by the usual pandas methods. See the pandas documentation for more infos.
[18]:
rates = sols.solution.apply(lambda x: x.members.growth_rate)
rates
[18]:
compartments | Escherichia_coli_1 | Escherichia_coli_2 | Escherichia_coli_3 | Escherichia_coli_4 | medium |
---|---|---|---|---|---|
0 | 0.873922 | 0.873922 | 0.873922 | 0.873922 | NaN |
1 | 0.786529 | 0.786529 | 0.786529 | 0.786529 | NaN |
2 | 0.699137 | 0.699137 | 0.699137 | 0.699137 | NaN |
3 | 0.611745 | 0.611745 | 0.611745 | 0.611745 | NaN |
4 | 0.524353 | 0.524353 | 0.524353 | 0.524353 | NaN |
5 | 0.436961 | 0.436961 | 0.436961 | 0.436961 | NaN |
6 | 0.349569 | 0.349569 | 0.349569 | 0.349569 | NaN |
7 | 0.262176 | 0.262176 | 0.262176 | 0.262176 | NaN |
8 | 0.174784 | 0.174784 | 0.174784 | 0.174784 | NaN |
9 | 0.087392 | 0.087392 | 0.087392 | 0.087392 | NaN |
[ ]: