IRPact_modellierung.needs

Class NeedDevelopmentScheme

java.lang.Object

IRPact_modellierung.needs.NeedDevelopmentScheme

Direct Known Subclasses:

DefaultNeedDevelopmentScheme, StochasticNeedDevelopmentScheme

public abstract class NeedDevelopmentScheme
extends java.lang.Object

A NeedDevelopmentScheme describes how needs develop and what happens when a product expires. Needs are created through two processes, depending on how they came to be, namely whether they stem from a processes connected to surging of needs (often mediated through the process model), or from a more specific process, the lifetime expiration of a product. The processes evaluate the state of the ConsumerAgent (potentially) developing the need and the time in the temporal mode, when the need surges. A NeedDevelopmentScheme gives meaning to a NeedNeedIndicatorMap that is associated with it.

Constructor Summary

Constructors

Constructor and Description
NeedDevelopmentScheme(java.util.Map<Need,java.lang.Double> needIndicatorMap)

Method Summary

Modifier and Type	Method and Description
abstract java.util.List<NeedEvent>	createNeedEvents(SimulationContainer simulationContainer, ConsumerAgent consumerAgent) This method creates a set of NeedEvents based on the state of the consumerAgent and the simulation.
abstract java.util.List<NeedEvent>	productExpiration(Product expiredProduct, ConsumerAgent associatedConsumer, double systemTime) This method is generally called when a products' lifetime expired, and the model needs to 'decide' what NeedEvents are scheduled based on the properties of the product and the consumerAgent whose product expired
java.util.List<NeedNeedIndicatorMap>	sortNeedIndicatorMapByValue() Method to sort the needIndicatorMap associated with this NeedDevelopmentScheme by its numeric values
java.util.List<Need>	sortNeedsByNeedIndicatorValue() Method to sort the needs in the needIndicatorMap associated with this NeedDevelopmentScheme by its numeric values

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NeedDevelopmentScheme

public NeedDevelopmentScheme(java.util.Map<Need,java.lang.Double> needIndicatorMap)

Method Detail

createNeedEvents

public abstract java.util.List<NeedEvent> createNeedEvents(SimulationContainer simulationContainer,
                                                           ConsumerAgent consumerAgent)

This method creates a set of NeedEvents based on the state of the consumerAgent and the simulation. This need creation is generally triggered from the process model, but can be called from other places as well. How this is used depends on the implementation of the model and its implementation.

Parameters:

simulationContainer - The container the simulation runs in

consumerAgent - The ConsumerAgent whom the needs are associated with

Returns:

A list of NeedEvents based on the implementation, which order depends on the implementation

productExpiration

public abstract java.util.List<NeedEvent> productExpiration(Product expiredProduct,
                                                            ConsumerAgent associatedConsumer,
                                                            double systemTime)

This method is generally called when a products' lifetime expired, and the model needs to 'decide' what NeedEvents are scheduled based on the properties of the product and the consumerAgent whose product expired

Parameters:

expiredProduct - The product whose lifetime exceeded

associatedConsumer - The ConsumerAgent who adopted the product before its expiration

systemTime - The time of the expiration of the product

Returns:

A list of NeedEvents triggered by the expiration of the given product

sortNeedIndicatorMapByValue

public java.util.List<NeedNeedIndicatorMap> sortNeedIndicatorMapByValue()

Method to sort the needIndicatorMap associated with this NeedDevelopmentScheme by its numeric values

Returns:

A list of NeedNeedIndicatorMap sorted by their value

sortNeedsByNeedIndicatorValue

public java.util.List<Need> sortNeedsByNeedIndicatorValue()

Method to sort the needs in the needIndicatorMap associated with this NeedDevelopmentScheme by its numeric values

Returns:

A list of needs sorted by the value of the entry in the needIndicatorMap of the respective need