Market Configuration

The market configuration in HAMLET defines how energy trading occurs, including market mechanisms, clearing types, pricing structures, and grid interactions. This section explains how to configure different markets in the simulation.

General Market Settings

Each market is defined in the configuration file under a unique market name and contains the following key parameters:

lem_continuous:    # Market name (must be unique in the region)
   active: True    # Enable (True) or disable (False) the market
   type: electricity  # Type of energy market (e.g., electricity)

Market Clearing Options

The clearing type determines whether trades are settled before or after energy delivery.

clearing:
   type: ex-ante     # Options: ex-ante (before delivery), ex-post (after delivery)
   method: pda       # Options: None, pda (Periodic Double Auction), community (ex-post)
   pricing: uniform  # Options: uniform (same price for all), discriminatory (different prices)
   coupling: None    # Options: None, above_c, above_l, below_c, below_l

Ex-Ante Clearing: Matches bids/offers before energy is delivered.
Ex-Post Clearing: Settles transactions after energy usage (planned feature).
Market Coupling: Determines whether uncleared bids are passed to other markets.

Market Timing

The timing section defines when and how often the market clears:

timing:
   start: 0           # Start time of the market (Unix timestamp or timedelta)
   opening: 900       # Time until the first clearing (seconds)
   horizon: [0, 86400] # Market clearing horizon (start and end in seconds)
   duration: 900      # Duration of each energy delivery period (seconds)
   frequency: 900     # Interval between market clearings (seconds)
   closing: 900       # Time before delivery when last auction occurs (seconds)
   settling: continuous  # Options: continuous (settle each step), period (settle for entire period)

Retailer and Pricing Configuration

If no local trade is possible, agents buy or sell energy through a retailer. Retail pricing can be fixed or time-varying.

pricing:
   retailer:
      energy:
         method: fixed  # Options: fixed, file
         fixed:
            price: [0.05, 0.15]  # Prices for selling and buying (€/kWh)
            quantity: [1e5, 1e5] # Max trade quantity (Wh)
            quality: 0  # Energy quality label (market-defined)
         file:
            file: retailer_prices.csv  # External price file

Grid Fees and Levies

Markets can include grid fees, levies, and balancing costs.

Grid Fees .. code-block:: yaml

grid:
method: fixed # Options: fixed, file fixed:

local: [0, 0.04] # Grid fees for local market trades (€/kWh) retail: [0, 0.08] # Grid fees for retailer transactions (€/kWh)

file:
file: grid_fees.csv # External grid fee file

Levies .. code-block:: yaml

levies:
method: fixed # Options: fixed, file fixed:

price: [0, 0.18] # Levies for selling and buying (€/kWh)

file:
file: levie