Load time series implementation. More...

#include <load.h>

Inheritance diagram for Antares::Solver::Variable::Economy::TimeSeriesValuesLoad< NextT >:

Public Types
Type Definitions
using	BaseType = TimeSeriesValuesBase< TimeSeriesValuesLoad< NextT >, NextT, VCardTimeSeriesValuesLoad >

Public Types inherited from Antares::Solver::Variable::Economy::TimeSeriesValuesBase< TimeSeriesValuesLoad< Container::EndOfList >, Container::EndOfList, VCardTimeSeriesValuesLoad >
using	NextType = Container::EndOfList

using	AncestorType = Variable::IVariable< TimeSeriesValuesLoad< Container::EndOfList >, Container::EndOfList, VCardTimeSeriesValuesLoad >

using	ResultsType = typename VCardType::ResultsType

using	VariableAccessorType = VariableAccessor< ResultsType, VCardType::columnCount >

Public Types inherited from Antares::Solver::Variable::IVariable< TimeSeriesValuesLoad< Container::EndOfList >, Container::EndOfList, VCardTimeSeriesValuesLoad >
typedef TimeSeriesValuesLoad< Container::EndOfList >	ChildType
	Child.

typedef Container::EndOfList	NextType
	Type of the next static variable.

typedef IVariable< TimeSeriesValuesLoad< Container::EndOfList >, Container::EndOfList, VCardTimeSeriesValuesLoad >	VariableType
	Variable.

typedef VCardTimeSeriesValuesLoad	VCardType
	VCard.

typedef VCardType::ResultsType	ResultsType
	List of expected results.

typedef VariableAccessor< ResultsType, VCardType::columnCount >	VariableAccessorType
	Proxy for accessing to the intermediate results.

typedef Storage< VCardTimeSeriesValuesLoad >::ResultsType	StoredResultType
	Results.

Public Member Functions
void	initializeDerivedFromStudy (Data::Study &)
	Initialize load-specific settings from study Load variables currently don't require specific initialization.

void	yearBeginImpl (unsigned int year, unsigned int space)
	Setup load data at the beginning of each year. More...

void	hourForEachAreaImpl (State &, unsigned int)
	Hourly processing for load variables. More...

Public Member Functions inherited from Antares::Solver::Variable::Economy::TimeSeriesValuesBase< TimeSeriesValuesLoad< Container::EndOfList >, Container::EndOfList, VCardTimeSeriesValuesLoad >
void	initializeFromStudy (Data::Study &study)
	Initialize the variable from study configuration. More...

void	initializeFromArea (Data::Study study, Data::Area area) noexcept
	Associate this variable with a specific area. More...

void	initializeFromLink (Data::Study study, Data::AreaLink link)
	Initialize from link (for link-based variables) More...

void	simulationBegin ()
	Reset state at the beginning of simulation. More...

void	simulationEnd ()
	Cleanup at the end of simulation.

void	yearBegin (unsigned int year, unsigned int space)
	Setup at the beginning of each year. More...

void	yearEndBuild (State &state, unsigned int year, unsigned int space)
	Post-processing after year end build. More...

void	yearEnd (unsigned int year, unsigned int space)
	Finalize year and compute statistics. More...

void	computeSummary (unsigned int year, unsigned int space)
	Merge year results into global summary. More...

void	hourBegin (unsigned int hourInTheYear)
	Setup at the beginning of each hour. More...

void	hourForEachArea (State &state, unsigned int space)
	Process data for each area during an hour. More...

void	hourEnd (State &state, unsigned int hourInTheYear)
	Cleanup at the end of each hour. More...

Antares::Memory::Stored< double >::ConstReturnType	retrieveRawHourlyValuesForCurrentYear (unsigned int, unsigned int space) const noexcept
	Retrieve raw hourly values for the current year. More...

void	localBuildAnnualSurveyReport (SurveyResults &results, int fileLevel, int precision, unsigned int space) const
	Build annual survey report for output. More...

Public Member Functions inherited from Antares::Solver::Variable::IVariable< TimeSeriesValuesLoad< Container::EndOfList >, Container::EndOfList, VCardTimeSeriesValuesLoad >
void	getPrintStatusFromStudy (Data::Study &study)

void	supplyMaxNumberOfColumns (Data::Study &study)

	IVariable ()
	Default constructor.

	~IVariable ()

void	initializeFromStudy (Data::Study &study)
	Initialize the variable. More...

size_t	getMaxNumberColumns () const

void	initializeFromArea (Data::Study study, Data::Area area)
	Initialize the variable with a specific area. More...

void	initializeFromLink (Data::Study study, Data::AreaLink link)
	Initialize the variable with a specific link between two areas. More...

void	initializeFromThermalCluster (Data::Study study, Data::Area area, Data::ThermalCluster *cluster)
	Initialize the variable with a specific thermal cluster. More...

void	broadcastNonApplicability (bool applyNonApplicable)

void	simulationBegin ()
	Notify to all variables that the simulation is about to begin.

void	simulationEnd ()
	Notify to all variables that the simulation has finished.

void	yearBegin (uint year)
	Notify to all variables that a new year is about to start. More...

void	yearEndBuild (State &state, uint year)
	Notify to all variables that the year is close to end. More...

void	yearEndBuildPrepareDataForEachThermalCluster (State &state, uint year, uint numSpace)
	Notify to all variables to prepare data for the close to year end calculations for each thermal cluster. More...

void	yearEndBuildForEachThermalCluster (State &state, uint year, uint numSpace)
	Notify to all variables that the year is close to end. More...

void	yearEnd (uint year)
	Notify to all variables that the year is now over. More...

void	yearEndSpatialAggregates (V &allVars, uint year, unsigned int numSpace)

void	yearEndSpatialAggregates (V &allVars, uint year, const SetT &set)

void	simulationEndSpatialAggregates (V &allVars)

void	simulationEndSpatialAggregates (V &allVars, const SetT &set)

void	hourBegin (uint hourInTheYear)
	Event: A new hour in the year has just began.

void	hourForEachArea (State &state)
	Event: For a given hour in the year, walking through all areas.

void	hourForEachArea (State &state, unsigned int numSpace)

void	hourForEachLink (State &state, uint numSpace)
	Event: For a given hour in the year, walking through all links.

void	hourEnd (State &state, uint hourInTheYear)
	Event: A new hour in the year has just ended.

void	weekBegin (State &state)

void	weekForEachArea (State &state, uint numSpace)

void	weekEnd (State &state)

void	buildSurveyReport (SurveyResults &results, int dataLevel, int fileLevel, int precision) const

void	buildAnnualSurveyReport (SurveyResults &results, int dataLevel, int fileLevel, int precision, uint numSpace) const

void	buildDigest (SurveyResults &results, int digestLevel, int dataLevel) const

void	beforeYearByYearExport (uint year, uint numSpace)
	Event triggered before exporting a year-by-year survey report.

void	computeSpatialAggregateWith (O &out, uint numSpace)
	Compute the spatial cluster with the results of a single variable. More...

void	computeSpatialAggregateWith (O &out, const Data::Area *area)
	Compute the spatial cluster with the results of a single variable and a given area. More...

const double *	retrieveHourlyResultsForCurrentYear (uint numSpace) const

void	retrieveResultsForArea (typename Storage< VCardToFindT >::ResultsType *result, const Data::Area area)

void	retrieveResultsForThermalCluster (typename Storage< VCardToFindT >::ResultsType *result, const Data::ThermalCluster cluster)

void	retrieveResultsForLink (typename Storage< VCardToFindT >::ResultsType *result, const Data::AreaLink link)

Antares::Memory::Stored< double >::ConstReturnType	retrieveRawHourlyValuesForCurrentYear (uint column, uint) const

const StoredResultType &	results () const
	The results.

Additional Inherited Members
Static Public Member Functions inherited from Antares::Solver::Variable::Economy::TimeSeriesValuesBase< TimeSeriesValuesLoad< Container::EndOfList >, Container::EndOfList, VCardTimeSeriesValuesLoad >
static void	InitializeResultsFromStudy (R &results, Data::Study &study)
	Static helper to initialize results from study. More...

Static Public Member Functions inherited from Antares::Solver::Variable::IVariable< TimeSeriesValuesLoad< Container::EndOfList >, Container::EndOfList, VCardTimeSeriesValuesLoad >
static void	InitializeResultsFromStudy (R &results, Data::Study &study)
	Initialize the results of the variable. More...

static void	RetrieveVariableList (PredicateT &predicate)
	Retrieve the list of all individual variables. More...

static void	provideInformations (I &infos)
	"Print" informations about the variable tree

Static Public Attributes inherited from Antares::Solver::Variable::Economy::TimeSeriesValuesBase< TimeSeriesValuesLoad< Container::EndOfList >, Container::EndOfList, VCardTimeSeriesValuesLoad >
static constexpr int	count
	Total count of variables in the chain.

Static Public Attributes inherited from Antares::Solver::Variable::IVariable< TimeSeriesValuesLoad< Container::EndOfList >, Container::EndOfList, VCardTimeSeriesValuesLoad >
static constexpr uint8_t	categoryDataLevel

static constexpr uint8_t	categoryFileLevel

Protected Types inherited from Antares::Solver::Variable::Container::EndOfList
enum	{ count = 0 }

typedef void	NextType
	Type of the next static variable.

Protected Member Functions inherited from Antares::Solver::Variable::Container::EndOfList
	EndOfList ()

	~EndOfList ()

void	broadcastNonApplicability (bool)

void	getPrintStatusFromStudy ([[maybe_unused]] Data::Study &study)

void	supplyMaxNumberOfColumns ([[maybe_unused]] Data::Study &study)

template<class V >
void	yearEndSpatialAggregates (V &, unsigned int, uint)

template<class V , class SetT >
void	yearEndSpatialAggregates (V &, unsigned int, const SetT &, uint numSpace)

template<class V , class SetT >
void	simulationEndSpatialAggregates (V &, const SetT &)

template<class VCardToFindT >
const double *	retrieveHourlyResultsForCurrentYear (uint) const

void	localBuildAnnualSurveyReport (SurveyResults &, int, int, unsigned int) const

Static Protected Member Functions inherited from Antares::Solver::Variable::Container::EndOfList
template<class PredicateT >
static void	RetrieveVariableList (PredicateT &)
	Retrieve the list of all individual variables. More...

static void	initializeFromStudy ([[maybe_unused]] Data::Study &study)

static void	initializeFromArea (Data::Study , Data::Area )

static void	initializeFromThermalCluster (Data::Study , Data::Area , Data::ThermalCluster *)

static void	initializeFromAreaLink (Data::Study , Data::AreaLink )

static void	simulationBegin ()

static void	simulationEnd ()

static void	yearBegin (unsigned int, unsigned int)

static void	yearEndBuildPrepareDataForEachThermalCluster (State &state, uint year, uint numSpace)

static void	yearEndBuildForEachThermalCluster (State &state, uint year, uint numSpace)

static void	yearEndBuild (State &, unsigned int, unsigned int)

static void	yearEnd (unsigned int, unsigned int)

static void	computeSummary (unsigned int year, unsigned int numSpace)

template<class V >
static void	computeSpatialAggregatesSummary (V &, unsigned int, unsigned int)

template<class V >
static void	simulationEndSpatialAggregates (V &)

static void	weekBegin (State &)

static void	weekForEachArea (State &, uint numSpace)

static void	weekEnd (State &)

static void	hourBegin (unsigned int)

static void	hourForEachArea (State &, uint numSpace)

static void	hourForEachLink (State &, uint numSpace)

static void	hourEnd (State &, unsigned int)

static void	buildSurveyReport (SurveyResults &, int, int, int)

static void	buildAnnualSurveyReport (SurveyResults &, int, int, int, uint)

static void	buildDigest (SurveyResults &, int, int)

static void	beforeYearByYearExport (uint, uint)

template<class I >
static void	provideInformations (I &)

template<class SearchVCardT , class O >
static void	computeSpatialAggregateWith (O &)

template<class SearchVCardT , class O >
static void	computeSpatialAggregateWith (O &, const Data::Area *)

template<class SearchVCardT , class O >
static void	computeSpatialAggregateWith (O &, const Data::Area *, uint numSpace)

template<class VCardToFindT , class O >
static void	retrieveResultsForArea (O *, const Data::Area )

template<class VCardToFindT , class O >
static void	retrieveResultsForThermalCluster (O *, const Data::ThermalCluster )

template<class VCardToFindT , class O >
static void	retrieveResultsForLink (O *, const Data::AreaLink )

Protected Attributes inherited from Antares::Solver::Variable::Economy::TimeSeriesValuesBase< TimeSeriesValuesLoad< Container::EndOfList >, Container::EndOfList, VCardTimeSeriesValuesLoad >
Data::Area *	areaPtr

VCardType::IntermediateValuesType	yearlyValues
	Intermediate values for each parallel space.

unsigned int	nbYearsParallel
	Number of parallel years (cached for performance)

Protected Attributes inherited from Antares::Solver::Variable::IVariable< TimeSeriesValuesLoad< Container::EndOfList >, Container::EndOfList, VCardTimeSeriesValuesLoad >
StoredResultType	pResults
	All the results about this variable.

bool *	isNonApplicable

bool *	isPrinted

uint	pColumnCount

Detailed Description

template<class NextT = Container::EndOfList>
class Antares::Solver::Variable::Economy::TimeSeriesValuesLoad< NextT >

Load time series implementation.

This class implements the processing of electrical load time series data. It provides efficient handling of load data that has been pre-processed with DSM (Demand-Side Management) transformations.

Template Parameters

NextT The next variable in the processing chain

Member Function Documentation

◆ hourForEachAreaImpl()

template<class NextT = Container::EndOfList>

void Antares::Solver::Variable::Economy::TimeSeriesValuesLoad< NextT >::hourForEachAreaImpl	(	State &	,
		unsigned int
	)

inline

Hourly processing for load variables.

For load variables, no specific hourly processing is required since the data has already been bulk-copied during yearBeginImpl.

◆ yearBeginImpl()

template<class NextT = Container::EndOfList>

void Antares::Solver::Variable::Economy::TimeSeriesValuesLoad< NextT >::yearBeginImpl	(	unsigned int	year,
		unsigned int	space
	)

inline

Setup load data at the beginning of each year.

This method performs bulk copying of the load time series data for the current simulation year. The data accessed here has already been processed to include DSM effects.

Parameters

year	The simulation year index (0-based)
space	The parallel space index for thread safety

Data Processing Note:

IMPORTANT: At this point, the load values are NOT the raw values from the original load time series. They have been transformed by performTransformationsBeforeLaunchingSimulation() to include Demand-Side Management (DSM) effects:

L* = L + DSM

Where:

L* = Final load values (what we access here)
L = Original load time series
DSM = Demand-Side Management modifications

The documentation for this class was generated from the following file:

src/solver/variable/include/antares/solver/variable/commons/load.h

Public Types

Public Member Functions