# 17.1.1.2.1.1. cobra.flux_analysis.deletion¶

## 17.1.1.2.1.1.1. Module Contents¶

### 17.1.1.2.1.1.1.1. Classes¶

 KnockoutAccessor Access unique combinations of reactions in deletion results.

### 17.1.1.2.1.1.1.2. Functions¶

 _reactions_knockouts_with_restore(model, reactions) _get_growth(model) _reaction_deletion(model, ids) _gene_deletion(model, ids) _init_worker(model) _multi_deletion(model, entity, element_lists, method=’fba’, solution=None, processes=None, **kwargs) Provide a common interface for single or multiple knockouts. _entities_ids(entities) _element_lists(entities, *ids) single_reaction_deletion(model, reaction_list=None, method=’fba’, solution=None, processes=None, **kwargs) Knock out each reaction from a given list. single_gene_deletion(model, gene_list=None, method=’fba’, solution=None, processes=None, **kwargs) Knock out each gene from a given list. double_reaction_deletion(model, reaction_list1=None, reaction_list2=None, method=’fba’, solution=None, processes=None, **kwargs) Knock out each reaction pair from the combinations of two given lists. double_gene_deletion(model, gene_list1=None, gene_list2=None, method=’fba’, solution=None, processes=None, **kwargs) Knock out each gene pair from the combination of two given lists.
cobra.flux_analysis.deletion.LOGGER[source]
cobra.flux_analysis.deletion.CONFIGURATION[source]
cobra.flux_analysis.deletion._reactions_knockouts_with_restore(model, reactions)[source]
cobra.flux_analysis.deletion._get_growth(model)[source]
cobra.flux_analysis.deletion._reaction_deletion(model, ids)[source]
cobra.flux_analysis.deletion._gene_deletion(model, ids)[source]
cobra.flux_analysis.deletion._reaction_deletion_worker(ids)[source]
cobra.flux_analysis.deletion._gene_deletion_worker(ids)[source]
cobra.flux_analysis.deletion._init_worker(model)[source]
cobra.flux_analysis.deletion._multi_deletion(model, entity, element_lists, method='fba', solution=None, processes=None, **kwargs)[source]

Provide a common interface for single or multiple knockouts.

Parameters
• model (cobra.Model) – The metabolic model to perform deletions in.

• entity ('gene' or 'reaction') – The entity to knockout (cobra.Gene or cobra.Reaction).

• element_lists (list) – List of iterables cobra.Reactions or cobra.Genes (or their IDs) to be deleted.

• method ({"fba", "moma", "linear moma", "room", "linear room"}, optional) – Method used to predict the growth rate.

• solution (cobra.Solution, optional) – A previous solution to use as a reference for (linear) MOMA or ROOM.

• processes (int, optional) – The number of parallel processes to run. Can speed up the computations if the number of knockouts to perform is large. If not passed, will be set to the number of CPUs found.

• kwargs – Passed on to underlying simulation functions.

Returns

A representation of all combinations of entity deletions. The columns are ‘growth’ and ‘status’, where

indextuple(str)

The gene or reaction identifiers that were knocked out.

growthfloat

The growth rate of the adjusted model.

statusstr

The solution’s status.

Return type

pandas.DataFrame

cobra.flux_analysis.deletion._entities_ids(entities)[source]
cobra.flux_analysis.deletion._element_lists(entities, *ids)[source]
cobra.flux_analysis.deletion.single_reaction_deletion(model, reaction_list=None, method='fba', solution=None, processes=None, **kwargs)[source]

Knock out each reaction from a given list.

Parameters
• model (cobra.Model) – The metabolic model to perform deletions in.

• reaction_list (iterable, optional) – cobra.Reactions to be deleted. If not passed, all the reactions from the model are used.

• method ({"fba", "moma", "linear moma", "room", "linear room"}, optional) – Method used to predict the growth rate.

• solution (cobra.Solution, optional) – A previous solution to use as a reference for (linear) MOMA or ROOM.

• processes (int, optional) – The number of parallel processes to run. Can speed up the computations if the number of knockouts to perform is large. If not passed, will be set to the number of CPUs found.

• kwargs – Keyword arguments are passed on to underlying simulation functions such as add_room.

Returns

A representation of all single reaction deletions. The columns are ‘growth’ and ‘status’, where

indextuple(str)

The reaction identifier that was knocked out.

growthfloat

The growth rate of the adjusted model.

statusstr

The solution’s status.

Return type

pandas.DataFrame

cobra.flux_analysis.deletion.single_gene_deletion(model, gene_list=None, method='fba', solution=None, processes=None, **kwargs)[source]

Knock out each gene from a given list.

Parameters
• model (cobra.Model) – The metabolic model to perform deletions in.

• gene_list (iterable) – cobra.Genes to be deleted. If not passed, all the genes from the model are used.

• method ({"fba", "moma", "linear moma", "room", "linear room"}, optional) – Method used to predict the growth rate.

• solution (cobra.Solution, optional) – A previous solution to use as a reference for (linear) MOMA or ROOM.

• processes (int, optional) – The number of parallel processes to run. Can speed up the computations if the number of knockouts to perform is large. If not passed, will be set to the number of CPUs found.

• kwargs – Keyword arguments are passed on to underlying simulation functions such as add_room.

Returns

A representation of all single gene deletions. The columns are ‘growth’ and ‘status’, where

indextuple(str)

The gene identifier that was knocked out.

growthfloat

The growth rate of the adjusted model.

statusstr

The solution’s status.

Return type

pandas.DataFrame

cobra.flux_analysis.deletion.double_reaction_deletion(model, reaction_list1=None, reaction_list2=None, method='fba', solution=None, processes=None, **kwargs)[source]

Knock out each reaction pair from the combinations of two given lists.

We say ‘pair’ here but the order order does not matter.

Parameters
• model (cobra.Model) – The metabolic model to perform deletions in.

• reaction_list1 (iterable, optional) – First iterable of cobra.Reactions to be deleted. If not passed, all the reactions from the model are used.

• reaction_list2 (iterable, optional) – Second iterable of cobra.Reactions to be deleted. If not passed, all the reactions from the model are used.

• method ({"fba", "moma", "linear moma", "room", "linear room"}, optional) – Method used to predict the growth rate.

• solution (cobra.Solution, optional) – A previous solution to use as a reference for (linear) MOMA or ROOM.

• processes (int, optional) – The number of parallel processes to run. Can speed up the computations if the number of knockouts to perform is large. If not passed, will be set to the number of CPUs found.

• kwargs – Keyword arguments are passed on to underlying simulation functions such as add_room.

Returns

A representation of all combinations of reaction deletions. The columns are ‘growth’ and ‘status’, where

indextuple(str)

The reaction identifiers that were knocked out.

growthfloat

The growth rate of the adjusted model.

statusstr

The solution’s status.

Return type

pandas.DataFrame

cobra.flux_analysis.deletion.double_gene_deletion(model, gene_list1=None, gene_list2=None, method='fba', solution=None, processes=None, **kwargs)[source]

Knock out each gene pair from the combination of two given lists.

We say ‘pair’ here but the order order does not matter.

Parameters
• model (cobra.Model) – The metabolic model to perform deletions in.

• gene_list1 (iterable, optional) – First iterable of cobra.Genes to be deleted. If not passed, all the genes from the model are used.

• gene_list2 (iterable, optional) – Second iterable of cobra.Genes to be deleted. If not passed, all the genes from the model are used.

• method ({"fba", "moma", "linear moma", "room", "linear room"}, optional) – Method used to predict the growth rate.

• solution (cobra.Solution, optional) – A previous solution to use as a reference for (linear) MOMA or ROOM.

• processes (int, optional) – The number of parallel processes to run. Can speed up the computations if the number of knockouts to perform is large. If not passed, will be set to the number of CPUs found.

• kwargs – Keyword arguments are passed on to underlying simulation functions such as add_room.

Returns

A representation of all combinations of gene deletions. The columns are ‘growth’ and ‘status’, where

indextuple(str)

The gene identifiers that were knocked out.

growthfloat

The growth rate of the adjusted model.

statusstr

The solution’s status.

Return type

pandas.DataFrame

class cobra.flux_analysis.deletion.KnockoutAccessor(pandas_obj: pd.DataFrame)[source]

Access unique combinations of reactions in deletion results.

This allows acces in the form of results.knockout[rxn1] or results.knockout[“rxn1_id”]. Each individual entry will return a deletion so results.knockout[rxn1, rxn2] will return two deletions (for individual knockouts of rxn1 and rxn2 respectively). Multi-deletions can be accessed by passing in sets like results.knockou[{rxn1, rxn2}] which denotes the double deletion of both reactions. Thus, the following are allowed index elements:

• single reactions or genes (depending on whether it is a gene or reaction deletion)

• single reaction IDs or gene IDs

• lists of single single reaction IDs or gene IDs (will return one row for each element in the list)

• sets of reactions or genes (for multi-deletions)

• sets of reactions IDs or gene IDs

• list of sets of objects or IDs (to get several multi-deletions)

static _validate(obj: pd.DataFrame) → None[source]
__getitem__(self, args: Union[Gene, List[Gene], Set[Gene], List[Set[Gene]], Reaction, List[Reaction], Set[Reaction], List[Set[Reaction]], str, List[str], Set[str], List[Set[str]]]) → pd.DataFrame[source]

Return the deletion result for a particular set of knocked entities.

argscobra.Reactions, cobra.Gene, str, set, or list

The deletions to be returned. Accepts: - single reactions or genes - single reaction IDs or gene IDs - lists of single single reaction IDs or gene IDs - sets of reactions or genes - sets of reactions IDs or gene IDs - list of sets of objects or IDs See the docs for usage examples.

pd.DataFrame

The deletion result where the chosen entities have been deleted. Each row denotes a deletion.