This tool clears the energy, secondary and tertiary markets, considering cross-border trading through a flow-based market coupling approach.
To run the tool, the following command must be run:
python main.py [boolean] [boolean] [boolean]
The three boolean arguments refer to their respective market: energy, secondary and tertiary.
Setting the argument to:
- True: will clear the correspoding market.
- False: will ignore the corresponding market clearing optimization.
To run the Market Simulator there are 4 input folders: network, energy, secondary and tertiary.
The network folder input files are mandatory for every optimization.
On the other hand, the energy, secondary and tertiary folders input files are only required if that market is being cleared.
All input files are in csv format.
generators.csv
| Element | Description |
|---|---|
| gen_id | identification code of a generator |
| bus | bus number where the generator is connected |
| fixed_cost | fixed generator costs value in €/pu |
| variable_cost | variable generator costs value in €/pu |
| r_up | amount of energy that the generator is able to increase in production between periods |
| r_down | amount of energy that the generator is able to decrease in production between periods |
| LGC | boolean value to indicate if the energy market optimization considers the generator load gradient curve for complex orders |
| MIC | boolean values to indicate if the energy market optimization considers the generator minimum income coefficient for the complex order |
loads_info.csv
| Element | Description |
|---|---|
| load_id | identification code of a load |
| bus | bus number where the generator is connected |
branches.csv
| Element | Description |
|---|---|
| branch_id | identification code of a branch |
| bus0 | bus where the branch starts |
| bus1 | bus where the branch ends |
| r | resistance value in p.u. |
| x | reactance value in p.u. |
| b | susceptance value in p.u. |
| s_nom | nominal power of the line in p.u. |
buses.csv
| Element | Description |
|---|---|
| bus_id | identification code of a bus |
| zone | zone number from where the bus is from |
| slack | fboolean value to represent the slack bus |
gen_bid_prices.csv
| Element | Description |
|---|---|
| gen_id | identification code of a generator |
| n columns | n amount of columns that represent each timestep to run with each value representing the respective generator bid |
gen_bid_qnt.csv
| Element | Description |
|---|---|
| gen_id | identification code of a generator |
| n columns | n amount of columns that represent each timestep to run with each value representing the respective generator bid |
load_bid_prices.csv
| Element | Description |
|---|---|
| load_id | identification code of a load |
| n columns | n amount of columns that represent each timestep to run with each value representing the respective load bid |
load_bid_qnt.csv
| Element | Description |
|---|---|
| load_id | identification code of a load |
| n columns | n amount of columns that represent each timestep to run with each value representing the respective load bid |
gen_bid_prices.csv
| Element | Description |
|---|---|
| gen_id | identification code of a generator |
| n columns | n amount of columns that represent each timestep to run with each value representing the respective generator bid |
gen_bid_qnt.csv
| Element | Description |
|---|---|
| gen_id | identification code of a generator |
| n columns | n amount of columns that represent each timestep to run with each value representing the respective generator bid |
sec_req.csv
| Element | Description |
|---|---|
| gen_id | identification code of a zone |
| n columns | n amount of columns that represent each timestep to run with each value representing the respective zone secondary reserve requirements |
gen_bid_prices.csv
| Element | Description |
|---|---|
| gen_id | identification code of a generator |
| n columns | n amount of columns that represent each timestep to run with each value representing the respective generator bid |
gen_bid_qnt.csv
| Element | Description |
|---|---|
| gen_id | identification code of a generator |
| n columns | n amount of columns that represent each timestep to run with each value representing the respective generator bid |
ter_req.csv
| Element | Description |
|---|---|
| gen_id | identification code of a zone |
| n columns | n amount of columns that represent each timestep to run with each value representing the respective zone tertiary reserve requirements |
To Market Simulator generates all outputs in csv format. The market results are inserted into their respective folder. Each folder content is as follows:
| File | Description |
|---|---|
| results_gen | generators energy market clearance results for the timesteps defined in the input folders |
| results_load | loads energy market clearance results for the timesteps defined in the input folders |
| File | Description |
|---|---|
| results_secondary | generators secondary market clearance results for the timesteps defined in the input folders |
| File | Description |
|---|---|
| results_tertiary | generators tertiary market clearance results for the timesteps defined in the input folders |