Competition Domain Class
General Description
A Competition object holds the basic information on the parameters of a competition.
Therefore the competition defines the environment for the trading agents.
Competition Properties
A Competition
domain class possesses the following properties:Long serverId
String name
CompetitionStatus competitionStatus
String description
Long initialDuration
Long durationBetweenShifts
Integer timeslotLength
Integer timeslotsOverall
Integer timeslotsOpen
Integer deactivateTimeslotsAhead
Date simulationStartTime
Integer participantCount
Double balancingCostOver
Double balancingCostUnder
ActionType action
Property Descriptions
- serverId: unique identifier of the entity assigned by the server
- name: name of the competition
- competitionStatus: indicates the state of the competition:
- Created: the competition was created by the server
- Initialized: the parameters of the competition are determined
- ReadyToRun: all trading agents have committed their ready state
- Running: the competition is in progress
- Finished: the competition ended
- Interrupted: the competition is halted and can be resumed
- description: further information on the competition
- initialDuration: indicates the time in seconds before an initial deactivation / activation cycle of products is started. The default is 60 seconds. This means that after 60 seconds runtime the oldest product in the competition will be closed and a new product will be opened for trading.
- durationBetweenShifts indicates the time in seconds between deactivation of oldest and activation of newest product. The default is 60 seconds. This means that 60 seconds after a timeslot shift occurred, another shift is triggered, i.e. the oldest product in the competition will be closed and a new product will be opened for trading.
- timeslotLength: defines the length of one timeslot in minutes (remember: every timeslot is represented by one product)
- timeslotsOverall: defines the overall number of time slots in the competition. The default is 24. In combination with the default timeslot length of 60 minutes this means that one 24 hour day will be simulated
- timeslotsOpen: define the number of time slots that are concurrently open for trading. The default is 12. This means that products corresponding to in the future 12 hours are tradeable.
- deactivateTimeslotsAhead: defines how many timeslots ahead of the current competition time a timeslot is closed. The default is 1. In combination with the default timeslot length of 60 minutes this means that trading for products is suspended one hour ahead of competition time.
- simulationStartTime: start date and time of the competition. This is important if historic energy consumer and producer profiles should be reployed.
- participantCount: indicates the number of participants for this competition. When creating the competition this number of user accounts is automatically created.
- balancingCostOver: defines the price for excess demand. E.g. a consumer has a real demand of 110 units but acuired only 100 units. This excess demand will have to be compensated by some external balancing power providers. The customer will be provided with the additional power required, which will be priced at the highest historic price that occurred for this product (timeslot) in the market plus the premium defined here.
- balancingCostUnder: defines the price for excess supply. E.g. a consumer has a real demand of 100 units but acuired 110 units. This is equal to an oversupply and has to be balanced by some external balancing power providers. The customer will lose the excess supply and additionally pays the balancing power premium defined here.
- action: indicates the change in the state of this competition triggered by the server
- Started: the competitionStatus is set to "Running"
- Stopped: the competitionStatus is set to "Finished" or "Interrupted"
- Reset: the competition was reset and competitionStatus is set to "Running" again