Skip to content

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

Open
edkerk wants to merge 9 commits into
developfrom
feat/kcat-evidence
Open

edkerk wants to merge 9 commits into
developfrom
feat/kcat-evidence

Conversation

@edkerk

@edkerk edkerk commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

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. geckopy has the same functions in CompMetEng/geckopy#96.

  • kcatEvidence: 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 flexibilizeEnzConcs relaxed) or by the output of sensitivityTuning (tunedKcats). compute adds the EC-tree estimate without a source file.
  • kcatsForReactions: 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 kcatsFromOKP accepts.
  • kcatsFromOKP: the option jobTag 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. ecRxns takes names, indices or a logical vector, where it took a logical vector only.
  • sensitivityTuning: the option evidence adds tunedKcats.evidence, the table of kcatEvidence for the tuned reactions.
  • kcatsFromECTree: BRENDA measurements have no direction, so a reverse direction (_REV) gets the value of its forward direction; its detail now ends with direction=reverse.
  • upgradeGECKOproject: 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.
kcatEvidence puts the kcat of each source file next to the model kcat and, for a tuned kcat, its prior. kcatsForReactions 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. sensitivityTuning can return the evidence of the tuned reactions.
@github-actions

github-actions Bot commented Nov 19, 2026 •

Copy link
Copy Markdown

Unit test results

104 tests   103 ✅  13s ⏱️
  1 suites    0 💤
  1 files      1 ❌

For more details on these failures, see this check.

Results for commit 3a1945c.

♻️ This comment has been updated with latest results.

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 added a commit to CompMetEng/gecko-docs that referenced this pull request Nov 20, 2026
[Tune kcats with
sensitivityTuning](https://github.com/CompMetEng/gecko-docs/blob/develop/docs/guide/standard-tuning.md)
states that an equal flux (within a relative 1e-9) goes to the first
enzyme or reaction of the model, so that MATLAB and Python select the
same kcats. To be merged after
[CompMetEng/GECKO#37](CompMetEng/GECKO#37) and
the geckopy PR.
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