An output exchange item that can deliver values from an IModelComponent. More...

#include <hydrocouple.h>

Inheritance diagram for HydroCouple::IOutput:

Collaboration diagram for HydroCouple::IOutput:

Public Member Functions

virtual ~IOutput ()=default

IOutput::~IOutput is a virtual destructor.

virtual vector< IInput * > consumers () const =0

Input items that will consume the values, by calling the GetValues() method.

virtual void addConsumer (IInput *consumer)=0

Add a consumer to this output item. Every input item that wants to call the IValueSet::getValue() method, needs to add itself as a consumer first.

virtual bool removeConsumer (IInput *consumer)=0

Remove a consumer.

virtual vector< IAdaptedOutput * > adaptedOutputs () const =0

The adaptedOutputs that have this current output item as adaptee.

virtual void addAdaptedOutput (IAdaptedOutput *adaptedOutput)=0

Add a IAdaptedOutput to this output item.

virtual bool removeAdaptedOutput (IAdaptedOutput *adaptedOutput)=0

Removes an IAdaptedOutput.

virtual void updateValues (const IInput *querySpecifier)=0

Provides the values matching the value definition specified by the

Parameters

querySpecifier

. Extensions can overwrite this base version to include more details in the query, e.g. time and space.

Public Member Functions inherited from HydroCouple::IExchangeItem

virtual ~IExchangeItem ()=default

IExchangeItem::~IExchangeItem is a virtual destructor.

Public Member Functions inherited from HydroCouple::IComponentDataItem

virtual ~IComponentDataItem ()=default

IComponentDataItem::~IComponentDataItem is a virtual destructor.

virtual IModelComponent * modelComponent () const =0

Gets the owner IModelComponent of this IComponentItem. For an IOutput component item this is the component responsible for providing the content of the IOutput.

virtual vector< IDimension * > dimensions () const =0

provides purely descriptive information of the dimensions associated with this IComponentItem

virtual int dimensionLength (const initializer_list< int > &dimensionIndexes={}) const =0

dimensionLength returns the length of the dimension specified by the given dimension indexes. To get the size of the first dimension, use a null integer array as input argument. Length of indices must be a least one smaller than the numDimensions()

virtual IValueDefinition * valueDefinition () const =0

IValueDefinition for this IValueSet defines the variable type associated with this object.

virtual void getValue (hydrocouple_variant &data, const initializer_list< int > &dimensionIndexes) const =0

Gets a multi-dimensional array of values for given dimension indexes and strides along each dimension. IndexArray = x + y * InSizeX + z * InSizeX * InSizeY etc;.

virtual void getValues (hydrocouple_variant *data, const initializer_list< int > &dimensionIndexes, const initializer_list< int > &dimensionLengths={}) const =0

Gets a multi-dimensional array of values for given dimension indexes and strides along each dimension.

virtual void setValue (const hydrocouple_variant &data, const initializer_list< int > &dimensionIndexes)=0

Sets a multi-dimensional array of values for given dimension indexes.

virtual void setValues (const hydrocouple_variant *data, const initializer_list< int > &dimensionIndexes, const initializer_list< int > &dimensionLengths={})=0

Sets a multi-dimensional array of values for given dimension indexes and strides along each dimension.

virtual bool hasEditor () const =0

hasEditor indicates whether this IComponentItem has a UI editor.

virtual void showEditor (void *opaqueUIPointer=nullptr)=0

showEditor shows the editor for this IComponentItem.

virtual bool hasViewer () const =0

hasViewer indicates whether this IComponentItem has a UI viewer.

virtual void showViewer (void *opaqueUIPointer=nullptr)=0

showViewer shows the viewer for this IComponentItem.

Public Member Functions inherited from HydroCouple::IIdentity

virtual ~IIdentity ()=default

IIdentity::~IIdentity is a virtual destructor.

virtual string id () const =0

Gets a unique identifier for the entity.

Public Member Functions inherited from HydroCouple::IDescription

virtual ~IDescription ()=default

IDescription::~IDescription is a virtual destructor.

virtual string caption () const =0

Gets caption for the entity.

virtual void setCaption (const string &caption)=0

Sets caption for the entity.

virtual string description () const =0

Gets additional descriptive information for the entity.

virtual void setDescription (const string &description)=0

Gets additional descriptive information for the entity.

Public Member Functions inherited from HydroCouple::IPropertyChanged

virtual ~IPropertyChanged ()=default

IPropertyChanged::~IPropertyChanged is a virtual destructor.

Public Member Functions inherited from HydroCouple::ISignal< string >

virtual ~ISignal ()=default

ISignal::~ISignal is a virtual destructor.

virtual void connect (const shared_ptr< ISlot< Args... > > &slot)=0

connect is used to connect a slot to the signal.

virtual void disconnect (const shared_ptr< ISlot< Args... > > &slot)=0

disconnect is used to disconnect a slot from the signal.

virtual void blockSignals (bool block)=0

blockSignals is used to block signals from being emitted.

Public Member Functions inherited from HydroCouple::ISignal< const shared_ptr< IComponentDataItemValueChanged > & >

virtual ~ISignal ()=default

ISignal::~ISignal is a virtual destructor.

virtual void connect (const shared_ptr< ISlot< Args... > > &slot)=0

connect is used to connect a slot to the signal.

virtual void disconnect (const shared_ptr< ISlot< Args... > > &slot)=0

disconnect is used to disconnect a slot from the signal.

virtual void blockSignals (bool block)=0

blockSignals is used to block signals from being emitted.

Additional Inherited Members
Protected Member Functions inherited from HydroCouple::ISignal< string >
virtual void	emit (Args... args)=0
	emit is used to emit the signal.

Protected Member Functions inherited from HydroCouple::ISignal< const shared_ptr< IComponentDataItemValueChanged > & >
virtual void	emit (Args... args)=0
	emit is used to emit the signal.

Detailed Description

An output exchange item that can deliver values from an IModelComponent.

If an output does not provide the data in the way a consumer would like to have it the output can be adapted by an IAdaptedOutput, which can transform the data according to the consumer's wishes. E.g. by performing interpolation in time, spatial aggregation, etc.).

Constructor & Destructor Documentation

◆ ~IOutput()

virtual HydroCouple::IOutput::~IOutput ( )

virtualdefault

IOutput::~IOutput is a virtual destructor.

Member Function Documentation

◆ adaptedOutputs()

virtual vector< IAdaptedOutput * > HydroCouple::IOutput::adaptedOutputs ( ) const

pure virtual

The adaptedOutputs that have this current output item as adaptee.

As soon as the output item's values have been updated, for each adaptedOutput its IAdaptedOutput.refresh() method must be called.

The list is readonly. Add and remove from the list by using addAdaptedOutput() and removeAdaptedOutput().

◆ addAdaptedOutput()

virtual void HydroCouple::IOutput::addAdaptedOutput ( IAdaptedOutput * adaptedOutput )

pure virtual

Add a IAdaptedOutput to this output item.

Every adaptedOutput that uses data from this output item, needs to add itself as a consumer first.

If a adaptedOutput is added that can not be handled, or that is incompatible with the already added adaptedOutputs, an exception will be thrown

Parameters

[in] adaptedOutput is consumer that has to be added

◆ addConsumer()

virtual void HydroCouple::IOutput::addConsumer ( IInput * consumer )

pure virtual

Add a consumer to this output item. Every input item that wants to call the IValueSet::getValue() method, needs to add itself as a consumer first.

If a consumer is added that can not be handled, or that is incompatible with the already added consumers, an exception will be thrown.

The addConsumer() method must and will automatically set the consumer's provider (see IInput.provider() )

Parameters

[in] consumer that has to be added

◆ consumers()

virtual vector< IInput * > HydroCouple::IOutput::consumers ( ) const

pure virtual

Input items that will consume the values, by calling the GetValues() method.

Every input item that will call this method, needs to call the addConsumer() method first. If the input item is not interested any longer in calling the IValueSet::getValue(), it should remove itself by calling the removeConsumer() method. The list is readonly. Add and remove from the list by using addConsumer() and removeConsumer(). Please be aware that the "unadulterated" values in the output item, provided by the read only Values property, may be called anyway, even if there are no values available.

◆ removeAdaptedOutput()

virtual bool HydroCouple::IOutput::removeAdaptedOutput ( IAdaptedOutput * adaptedOutput )

pure virtual

Removes an IAdaptedOutput.

If a adaptedOutput is not interested any longer in this output item data, it should remove itself by calling removeConsumer().

Parameters

[in] adaptedOutput is a consumer that has to be removed.

◆ removeConsumer()

virtual bool HydroCouple::IOutput::removeConsumer ( IInput * consumer )

pure virtual

Remove a consumer.

If an input item is not interested any longer in calling the IValueSet::getValue() method, it should remove itself by calling RemoveConsumer.

Parameters

[in] consumer that has to be removed

◆ updateValues()

virtual void HydroCouple::IOutput::updateValues ( const IInput * querySpecifier )

pure virtual

Provides the values matching the value definition specified by the

Parameters

querySpecifier

. Extensions can overwrite this base version to include more details in the query, e.g. time and space.

One might expect to be the querySpecifier to be of the type IInput, because every input item that calls the getValues method needs to add itself as a consumer first.

However, the IExchangeItem suffices to specify what is required. Therefore, to have the flexibility to loosen the "always register as consumer" approach, it is chosen to provide an IExchangeItem as an argument.

Parameters

[in] querySpecifier

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

/home/runner/work/HydroCouple/HydroCouple/HydroCouple/include/hydrocouple.h

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ~IOutput()

Member Function Documentation

◆ adaptedOutputs()

◆ addAdaptedOutput()

◆ addConsumer()

◆ consumers()

◆ removeAdaptedOutput()

◆ removeConsumer()

◆ updateValues()