Skip to content

Update documentation for constraints to remove f-values#4112

Open
timothy-nunn wants to merge 2 commits intomainfrom
4051-update-constraint-documentation
Open

Update documentation for constraints to remove f-values#4112
timothy-nunn wants to merge 2 commits intomainfrom
4051-update-constraint-documentation

Conversation

@timothy-nunn
Copy link
Collaborator

@timothy-nunn timothy-nunn commented Feb 25, 2026

Closes #3935
Closes #4051

@timothy-nunn timothy-nunn linked an issue Feb 25, 2026 that may be closed by this pull request
@codecov-commenter
Copy link

codecov-commenter commented Feb 25, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 47.19%. Comparing base (6d036d5) to head (ae4a550).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #4112   +/-   ##
=======================================
  Coverage   47.18%   47.19%           
=======================================
  Files         138      138           
  Lines       29280    29275    -5     
=======================================
  Hits        13817    13817           
+ Misses      15463    15458    -5     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@timothy-nunn timothy-nunn force-pushed the 4051-update-constraint-documentation branch 2 times, most recently from a8efd99 to b5a9745 Compare February 26, 2026 10:09
@timothy-nunn timothy-nunn force-pushed the 4051-update-constraint-documentation branch from b5a9745 to 9e5f240 Compare February 27, 2026 09:06
@timothy-nunn timothy-nunn marked this pull request as ready for review February 27, 2026 09:06
@timothy-nunn timothy-nunn requested a review from a team as a code owner February 27, 2026 09:06
Co-authored-by: je-cook <81617086+je-cook@users.noreply.github.com>
## Add a constraint equation

Constraint equations are added to *PROCESS* in the `process/constraints.py` file. They are registered with the `ConstraintManager` whenever the application is run. Each equation has a unique name that is currently an integer, however upgrades to the input file format in the future will allow arbitrary hashable constraint names.
Constraint equations are added to *PROCESS* in the `process/core/optimisation/constraints.py` file. They are registered with the `ConstraintManager` whenever the application is run. Each equation has a unique name that is currently an integer, however upgrades to the input file format in the future will allow arbitrary hashable constraint names.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is `process/core/solver/ now

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also noticed that "Add an input" is still showing the fortran


PROCESS permits a large number of constraint equations, all of which are formulated
in the source file `constraint equations.f90`.
in the source file `process/core/optimisation/constraints.py`.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same as above with file path

Any computer program naturally contains many equations. The built-in equation
solvers within PROCESS act on a special class, known as constraint equations,
all of which are formulated in the source file `constraint equations.f90`. These
all of which are formulated in the source file `process/core/optimisation/constraints.py`. These
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same path again

```

Here each `icc=n` statement tells PROCESS to activate a constraint with the name `n`. A list of the constraints and
their corresponding names can be found [here](../../source/reference/process/data_structure/numerics/#process.data_structure.numerics.lablcc).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The link seems to take me to an empty page

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.

Update constraint documentation Improve constraint handling in PROCESS

4 participants