[FEATURE] Rename Effect domains

[FBumann]

Prerequisite Checks

• I have searched the existing issues and confirmed this feature doesn't already exist.

• I have checked the documentation to ensure this feature isn't already available.

Is your feature request related to a problem?

No response

Describe the solution you'd like

I would like to have the Effect domains named a bit more generic than they are right now.
Currently, each Effect has the following domains, with associated Variables (here with name "Effect"):
invest

• Effect(invest)|total

operation

• Effect(operation)|total
• Effect(operation)|total_per_timestep

And as a sum of Effect(invest)|total + Effect(operation)|total
Effect|total

The split into operation and invest might be nice in many cases, but it feels restrictive in others.

I would prefer to emphazise the resolution instead of the origin of the effects (This should be done by the name instead)

I would propose the following:

Rename operation to temporal

• Effects that vary across the time dimension
• Effect(temporal) - cumulative total across all timesteps
• Effect(temporal)|per_timestep - total from all sources per timestep

Rename invest to periodic

• Effects that apply to periods (annual, monthly, quarterly costs) but don't have a time dimension
• Effect(periodic) - total effects per period

Remove |total suffix

• The base variable naturally represents the total/cumulative amount
• Only use suffixes for variants like per_timestep

This would us leave with:
periodic

• Effect(periodic)

temporal

• Effect(temporal)
• Effect(temporal)|per_timestep

total

• Effect

Please leave your thoughts

This issue is in Progress

Energy System Use Case

This issue is in Progress

Desired Code Example (optional)

Component Category (if applicable)

None

Alternatives considered

No response

Additional context

No response

[baumbude]

... oder
operation to time_resolved /continuous
und
invest to occasional, singular, once

Vielleicht auch doch bisschen abhängig davon wie genau du das umbauen willst. Soll es dann auch ein temporal invest effect geben können?

[FBumann]

@baumbude
time resolved finde ich nicht schlecht. Aber temporal ist quasi gleich und kürzer.
Ist das Adjektiv von TIME.

SINGULAR und ONCE passen mmN nicht, da in einem Modell mit mehreren Jahren das ja nicht einmalig ist. Sondern nur einmal pro Periode/jahr

OCCASIONAL finde ich unpräzise.

Hast du was an temporal und periodic auszusetzen?

[baumbude]

Ja, time_resolved ist zu lang. Temporal finde ich auch ok.
Periodic ist nicht so sehr intuitiv für jmd der nicht mit den Perioden arbeitet, aber natürlich gut in der Periodendenke passt. Mir fällt gerade auch nix besseres ein.

[FBumann]

@baumbude
Temporal und nontemporal wäre auch gut denke ich.
Wäre glaub sogar mein Favorit. Macht die Trennung sehr deutlich, und passt genau zum mathematischen Hintergrund .
Das Ergebnis wäre dann:

temporal

• Effect(temporal)|per_timestep
• Effect(temporal)

nontemporal

• Effect(nontemporal)

total

• Effect

and the constraints:
$$e_{\textit{Effect(temporal)}} = \sum_t e_{\textit{Effect(temporal)|pertimestep}}(t) $$
$$e_{\textit{Effect}} = e_{\textit{Effect(temporal)}} + e_{\textit{Effect(non temporal)}} $$

Das fühlt sich sehr solide und logisch an

[baumbude]

Ja, sehr gut! FBumann ***@***.***> schrieb am Do., 11. Sept. 2025, 08:39:

…

*FBumann* left a comment (flixOpt/flixopt#308) <#308 (comment)> @baumbude <https://github.com/baumbude> Temporal und nontemporal wäre auch gut denke ich. Wäre glaub sogar mein Favorit. Macht die Trennung sehr deutlich, und passt genau zum mathematischen Hintergrund — Reply to this email directly, view it on GitHub <#308 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AGFVXZIGWYYLT3M2CVESZWL3SEKIHAVCNFSM6AAAAACGFQJYT6VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTENZYGQ3DSMBQG4> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[FBumann]

Cool. Danke fürs Feedback. 😃

[FBumann]

Closed with #365