Skip to content

BESS Arbitrage v0.1

Latest

Choose a tag to compare

@LorenzoGiannuzzo LorenzoGiannuzzo released this 17 Sep 08:30
· 67 commits to updates since this release

BESS Arbitrage using NSGA-III. The algorithm defines for a specific time window the charged/discharged energy of a Li-ion battery on a hourly base.

Run the main script from command line to start the optimization process:

python main.py --input_json <absolute_path_to_input_json> --output_json <absolute_path_to_output_json> --technology <BESS_technology> --size <BESS_size_in_kWh>

Input:

  • python main.py: Executes the main Python script that performs the BESS optimization.
  • --input_json <absolute_path_to_input_json>: Specifies the absolute path to the input JSON file containing the PUN timeseries data.
  • --output_json <absolute_path_to_output_json>: Specifies the absolute path where the output JSON file will be saved.
  • --technology <BESS_technology>: Defines the technology type of the Battery Energy Storage System (e.g., "Li-ion" for Lithium-ion).
  • --size <BESS_size_in_kWh>: Specifies the size of the Battery Energy Storage System in kilowatt-hours (kWh).
  • --power <BESS_nominal_power_in_kW>: Specifies the nominal power of the Battery Energy Storage System in kW.
  • --soc <SoC_at_step_0>: Specifies the initial state of charge of the Battery Energy Storage System in %.
  • --dod <Depth_of_Discharge>: Specifies the range of SoC in %.
  • --minimize_C <Boolean>: Parameter that requires no values. Default values is FALSE, is it's in command line, it's set to be True. If TRUE, it changes the optimization problem maximizing revenues and minimizing C-rate

Output:

The output consists in a .json file structured for each timestep of the considered time_window as follows:
{

datetime: --- Expressed as the following format "2024-05-19T22:00:00+00:00Z".
PUN: --- Expressed in EUROs/kWh.
soc: --- State Of Charge (SoC) expressed as a factor between 0 and 1.
c_d_energy: --- Energy which is charged/discharged expressed in kWh. Negative if discharged, positive if charged.
Nominal C-rate --- Nominal Charge/Discharge velocity, expressed as % of the total capacity of the BESS.
C-rate: --- Charge/Discharge velocity, expressed as % of the total capacity of the BESS.
revenues: --- Cash flow resulted from charging/discharging energy from t BESS, expressed in EUROs.
technology: --- Typology of BESS.
size: --- Total capacity of the battery, expressed in kWh.
dod: --- Depth of Discharge, expressed as "Min_SoC - Max_SoC".

}