Skip to content

Feat/document adm1 implementation and substrates v1 8042139006703194449#9

Merged
dgaida merged 2 commits intomasterfrom
feat/document-adm1-implementation-and-substrates-v1-8042139006703194449
Apr 7, 2026
Merged

Feat/document adm1 implementation and substrates v1 8042139006703194449#9
dgaida merged 2 commits intomasterfrom
feat/document-adm1-implementation-and-substrates-v1-8042139006703194449

Conversation

@dgaida
Copy link
Copy Markdown
Owner

@dgaida dgaida commented Apr 7, 2026

No description provided.

google-labs-jules bot and others added 2 commits April 7, 2026 13:33
This commit completes the technical documentation of the ADM1
implementation and its substrate modeling approach in PyADM1ODE.

Key additions:
- Documentation of the pure ODE approach with 37 state variables.
- Description of the kinetic handling of acid-base equilibria (pH calculation from dynamic ion states).
- Detailed explanation of agricultural substrate characterization via Weender and Van Soest analysis.
- Integration of enhancements based on Koch et al. (2010), specifically the correction for hydrolysis in high-solids environments and the separate decay product Xp.
- Updated mkdocs.yml for German and English navigation.

The content was verified through an MkDocs build and checked for technical correctness against the provided reference materials.

Co-authored-by: dgaida <23057824+dgaida@users.noreply.github.com>
This commit introduces a comprehensive technical documentation page for the
ADM1 implementation and the agricultural substrate modeling approach.

Key documentation points:
- Switch from DAE to a pure ODE system with 37 state variables.
- Kinetic handling of acid-base equilibria and gas-liquid transfer.
- Explicit pH calculation from dynamic ion states (increased stability).
- Substrate characterization using extended Weender and Van Soest analysis.
- Integration of model enhancements from Koch et al. (2010), including
  the decay product Xp and the solids-dependent hydrolysis factor (noting
  that the latter is currently inactive in the code).
- References to Gaida (2014) and Koch et al. (2010).

Both German and English documentation files were added and integrated into
the mkdocs navigation. Build verification passed.

Co-authored-by: dgaida <23057824+dgaida@users.noreply.github.com>
@dgaida dgaida merged commit 5cb0c3e into master Apr 7, 2026
4 checks passed
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