flixopt.calculation
This module contains the Calculation functionality for the flixopt framework. It is used to calculate a SystemModel for a given FlowSystem through a solver. There are three different Calculation types: 1. FullCalculation: Calculates the SystemModel for the full FlowSystem 2. AggregatedCalculation: Calculates the SystemModel for the full FlowSystem, but aggregates the TimeSeriesData. This simplifies the mathematical model and usually speeds up the solving process. 3. SegmentedCalculation: Solves a SystemModel for each individual Segment of the FlowSystem.
Attributes
Classes
Calculation
Calculation(name: str, flow_system: FlowSystem, active_timesteps: Optional[DatetimeIndex] = None, folder: Optional[Path] = None)
class for defined way of solving a flow_system optimization
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
name
|
str
|
name of calculation |
required |
flow_system
|
FlowSystem
|
flow_system which should be calculated |
required |
active_timesteps
|
Optional[DatetimeIndex]
|
list with indices, which should be used for calculation. If None, then all timesteps are used. |
None
|
folder
|
Optional[Path]
|
folder where results should be saved. If None, then the current working directory is used. |
None
|
Functions
FullCalculation
FullCalculation(name: str, flow_system: FlowSystem, active_timesteps: Optional[DatetimeIndex] = None, folder: Optional[Path] = None)
Bases: Calculation
class for defined way of solving a flow_system optimization
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
name
|
str
|
name of calculation |
required |
flow_system
|
FlowSystem
|
flow_system which should be calculated |
required |
active_timesteps
|
Optional[DatetimeIndex]
|
list with indices, which should be used for calculation. If None, then all timesteps are used. |
None
|
folder
|
Optional[Path]
|
folder where results should be saved. If None, then the current working directory is used. |
None
|
Functions
AggregatedCalculation
AggregatedCalculation(name: str, flow_system: FlowSystem, aggregation_parameters: AggregationParameters, components_to_clusterize: Optional[List[Component]] = None, active_timesteps: Optional[DatetimeIndex] = None, folder: Optional[Path] = None)
Bases: FullCalculation
class for defined way of solving a flow_system optimization
Class for Optimizing the FlowSystem including:
1. Aggregating TimeSeriesData via typical periods using tsam.
2. Equalizing variables of typical periods.
Args:
name: name of calculation
flow_system: flow_system which should be calculated
aggregation_parameters: Parameters for aggregation. See documentation of AggregationParameters class.
components_to_clusterize: List of Components to perform aggregation on. If None, then all components are aggregated.
This means, teh variables in the components are equalized to each other, according to the typical periods
computed in the DataAggregation
active_timesteps: pd.DatetimeIndex or None
list with indices, which should be used for calculation. If None, then all timesteps are used.
folder: folder where results should be saved. If None, then the current working directory is used.
Functions
SegmentedCalculation
SegmentedCalculation(name: str, flow_system: FlowSystem, timesteps_per_segment: int, overlap_timesteps: int, nr_of_previous_values: int = 1, folder: Optional[Path] = None)
Bases: Calculation
Dividing and Modeling the problem in (overlapping) segments. The final values of each Segment are recognized by the following segment, effectively coupling charge_states and flow_rates between segments. Because of this intersection, both modeling and solving is done in one step
Take care: Parameters like InvestParameters, sum_of_flow_hours and other restrictions over the total time_series don't really work in this Calculation. Lower bounds to such SUMS can lead to weird results. This is NOT yet explicitly checked for...
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
name
|
str
|
name of calculation |
required |
flow_system
|
FlowSystem
|
flow_system which should be calculated |
required |
timesteps_per_segment
|
int
|
The number of time_steps per individual segment (without the overlap) |
required |
overlap_timesteps
|
int
|
The number of time_steps that are added to each individual model. Used for better results of storages) |
required |
folder
|
Optional[Path]
|
folder where results should be saved. If None, then the current working directory is used. |
None
|