IRPact_modellierung.decision

Class DeliberativeConsumerAgentAdoptionDecisionProcess

java.lang.Object

IRPact_modellierung.decision.DecisionMakingProcess

IRPact_modellierung.decision.ConsumerAgentAdoptionDecisionProcess

IRPact_modellierung.decision.UtilitarianConsumerAgentAdoptionDecisionProcess

IRPact_modellierung.decision.DeliberativeConsumerAgentAdoptionDecisionProcess

public class DeliberativeConsumerAgentAdoptionDecisionProcess
extends UtilitarianConsumerAgentAdoptionDecisionProcess

Decision process that models consumer agent adoption based on 'Deliberative Decision' after Schwarz. In this process weighted utilities based on subjective norm, behaviour control and attitude are added to evaluate products. For subjective norm, the adoption pattern of neighbours in the social network of an agent is used, for attitude the preferences of the agent are used and for behaviour control the importance of the products are accounted. The agent will adopt the product with the highest weighted utility

Field Summary

Fields inherited from class IRPact_modellierung.decision.UtilitarianConsumerAgentAdoptionDecisionProcess

associatedUtilityFunction

Constructor Summary

Constructors

Constructor and Description
DeliberativeConsumerAgentAdoptionDecisionProcess(UtilityFunction associatedUtilityFunction, java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.Double>> importanceAttitudeProtoMap)

Method Summary

Modifier and Type	Method and Description
boolean	betterProductAvailable(SimulationContainer simulationContainer, ConsumerAgent consumerAgent, Product productToCompare, java.util.Set<Product> potentialProducts, double systemTime) Method to see if any of the potential products have a higher utility for the consumerAgent at systemTime than the productToCompare, based on DeliberativeDecision utilitarian approach
protected double	calculateUtility(SimulationContainer simulationContainer, Product product, ConsumerAgent consumerAgent, double systemTime) Method to calculate the utility of the given product for the consumerAgent at systemTime using the DeliberativeDecision utility function.
Product	makeProductAdoptionDecision(SimulationContainer simulationContainer, ConsumerAgent consumerAgent, java.util.Set<Product> potentialProducts, double systemTime) Agent will make a decision to adopt one of the products entering this decision process based on the process of Deliberative Decision if more than one product is available.

Methods inherited from class IRPact_modellierung.decision.UtilitarianConsumerAgentAdoptionDecisionProcess

getUtilityFunctionUsed

Methods inherited from class java.lang.Object

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

Constructor Detail

DeliberativeConsumerAgentAdoptionDecisionProcess

public DeliberativeConsumerAgentAdoptionDecisionProcess(UtilityFunction associatedUtilityFunction,
                                                        java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.Double>> importanceAttitudeProtoMap)

Method Detail

makeProductAdoptionDecision

public Product makeProductAdoptionDecision(SimulationContainer simulationContainer,
                                           ConsumerAgent consumerAgent,
                                           java.util.Set<Product> potentialProducts,
                                           double systemTime)
                                    throws java.lang.IllegalArgumentException

Agent will make a decision to adopt one of the products entering this decision process based on the process of Deliberative Decision if more than one product is available. The product with the highest utility will be adopted.

Specified by:

makeProductAdoptionDecision in class ConsumerAgentAdoptionDecisionProcess

Parameters:

simulationContainer - The container the simulation runs in

consumerAgent - The consumer agent making the decision

potentialProducts - The products eligible for the adoption of this agent

systemTime - The current time of the simulation

Returns:

The product the ConsumerAgent decides to adopt

Throws:

java.lang.IllegalArgumentException - Will be thrown when no potential products are given

betterProductAvailable

public boolean betterProductAvailable(SimulationContainer simulationContainer,
                                      ConsumerAgent consumerAgent,
                                      Product productToCompare,
                                      java.util.Set<Product> potentialProducts,
                                      double systemTime)

Method to see if any of the potential products have a higher utility for the consumerAgent at systemTime than the productToCompare, based on DeliberativeDecision utilitarian approach

Specified by:

betterProductAvailable in class ConsumerAgentAdoptionDecisionProcess

Parameters:

simulationContainer - The container the simulation runs in

consumerAgent - The consumer agent making the decision

productToCompare - The product of interest (that is compared to the other products)

potentialProducts - The products the productToCompare is compared to

systemTime - The current time of the simulation

Returns:

true if there is a better product in potentialProducts than productToCompare, false if not

calculateUtility

protected double calculateUtility(SimulationContainer simulationContainer,
                                  Product product,
                                  ConsumerAgent consumerAgent,
                                  double systemTime)
                           throws java.lang.IllegalArgumentException

Method to calculate the utility of the given product for the consumerAgent at systemTime using the DeliberativeDecision utility function. The total utility is a weighted sum of partial utilities representing subjective norm, behaviour control and attitude of the agent. The weighting is done by the subjective norm (fraction of adopters in the social network of the agent) and its complement in the unit interval of the weighted sum of behaviour control and attitude. The latter weighted sum is weighted by the importanceAttitude for the agent (and its complement for behaviourControl), where importance attitude is based on the agents preferences and product attributes, whereas behaviour control is based on the product attributes importance and product attributes. For more details see userDocumentation or Schwarz

Specified by:

calculateUtility in class UtilitarianConsumerAgentAdoptionDecisionProcess

Parameters:

simulationContainer - The container the simulation is contained in

product - The product whose utility is to be calculated

consumerAgent - The consumer agent for which the utility is calculated

systemTime - The time at which the utility is calculated

Returns:

A double value representing the utility of product for consumerAgent at systemTime

Throws:

java.lang.IllegalArgumentException