Simplifying time structure

[jkiviluo]

Rename:

• timeblockSet to timeset

New parameters:

• timeset - timeline: replaces relationship timeset__timeline
• model - periods_available: allows to inform what periods the dataset can contain (makes it possible to avoid domain errors). This parameter is not needed if period_timeset contains all the periods. So, 'period' in flexmodel code will be a join of period_from_model and period_from_period_time.

Obligatory data:

• timeline - timestep_duration: used for domain checking (inform about that in the error message: 'Trying to run a model without known timeline. Use 'timestep_duration' to define the timesteps that are allowed in the data. This is used to ensure all time series data is from valid timesteps and the user can be informed when it is not.)

If timeset does not exist: autogenerate a 'full_timeline' timeset

If solve - period_timeset does not exist: first check that only one timeset available (could be autogenerated) and then assume realized and invested periods are using that timeset. If check fails, then error message: 'More than one timeset available and FlexTool does not know which ones to use. Please use 'period_timeset' parameter of 'solve' class to define which periods and which timesets are part of the solve(s) in the model instance.'

If solve - realized_periods does not exist: assume all periods

If no solve entity: autogenerate 'full_timeline_solve' that uses 'full_timeline' timeset in all available periods.

If model - solves does not exist: check if there is only one solve entity (could be autogenerated) and then use that. If multiple solve entities exist, then error message: 'Data contains multiple solve entities and FlexTool does not know which to use. Please use 'solves' parameter of 'model' class to inform which solves are to be included in the model instance.'

Rewrite description:
solve - realized_invest_periods: Array of the periods that will realize the investment decisions (output in results). It not given, then realized_periods are used to realize investments as well (as long as the periods are in invest_periods).

Deprecate:
timeline - timeline_duration_in_years: I think we nowadays calculate this from timestep_duration - best to remove to avoid confusion.