Skip to content

feat: show the kcats of every source for selected reactions - #96

Merged
edkerk merged 10 commits into
developfrom
feat/kcat-evidence
Nov 20, 2026
Merged

edkerk merged 10 commits into
developfrom
feat/kcat-evidence

Conversation

@edkerk

@edkerk edkerk commented Nov 19, 2026 •

Copy link
Copy Markdown
Collaborator

The kcat of a tuned or relaxed reaction can be compared with what every source gives for it, for a few reactions or for a selection. GECKO has the same functions in CompMetEng/GECKO#37.

  • kcat_evidence: returns the kcat of every source file in data/kcats for the selected reactions next to the kcat of the ecModel and the kcat before tuning. Reactions are selected by name (rxns), by enzyme (enzymes, for example the enzymes that flexibilize_enz_concs relaxed) or by the result of sensitivity_tuning (tuned). compute adds the EC-tree estimate without a source file.
  • kcats_for_reactions: gets the kcats of every source for a few reactions, computes the EC-tree estimate and, with okp, predicts them with one, several or all OpenKineticsPredictor methods that kcats_from_okp accepts.
  • kcats_from_okp: the option job_tag gives a job its own job, input and result files (okp_<method>__<tag>.tsv), so a prediction for a few reactions no longer replaces the job and the result of all reactions. ec_rxns takes names, indices or a boolean array, where it took names only.
  • sensitivity_tuning: the option evidence adds TunedKcatsResult.evidence, the table of kcat_evidence for the tuned reactions.
  • kcats_from_ec_tree: BRENDA measurements have no direction, so a reverse direction (_REV) gets the value of its forward direction; its detail now ends with direction=reverse.
  • upgrade_project: the result of a tagged OKP query is not reported as a stored prediction of a method.

BRENDA measurements have no direction, so a reverse direction gets the value of its forward direction; its detail now ends with direction=reverse.
kcat_evidence puts the kcat of each source file next to the model kcat and, for a tuned kcat, its prior. kcats_for_reactions adds the EC-tree estimate and OKP predictions for a few reactions, kept apart from the OKP job of all reactions by a job tag.
edkerk added a commit to CompMetEng/gecko-docs that referenced this pull request Nov 20, 2026
Adds the guide page "Compare the kcats of the sources for a reaction"
for `kcatEvidence` and `kcatsForReactions` (Python `kcat_evidence`,
`kcats_for_reactions`), the option `jobTag` of `kcatsFromOKP`, and the
option `evidence` of `sensitivityTuning`. The functions are in
CompMetEng/GECKO#37 and CompMetEng/geckopy#96; this pull request is
merged after both, because the page names functions that the submodules
do not have yet.

- `docs/guide/kcat-evidence.md`: new decision page with the function
table, the selection of reactions, the evidence after a tuning and after
a proteomics relaxation, the kcats for one reaction, the OKP predictions
for a few reactions, and a troubleshooting table.
- `docs/guide/index.md`: the page is listed under Decisions.
- `scripts/known_names.txt`: `jobTag`, `job_tag`, `flexed_enzymes` and
`src_ec_tree` are options and columns, not functions.
@edkerk
edkerk merged commit 4d2fc0c into develop Nov 20, 2026
8 checks passed
@edkerk
edkerk deleted the feat/kcat-evidence branch November 20, 2026 18:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant