README.md

antares-water-values

Water values computation for Antares (https://antares-doc.readthedocs.io/en/latest/)

Installation

git clone https://github.com/AntaresSimulatorTeam/antares-water-values.git

Requirements

• Python 3.9
• Antares Simulator
• Python libraries requirements

Usage

from src import *
import numpy as np 
# Define time and scenario parameters
param = TimeScenarioParameter(len_week=5, len_scenario=1)

# Define reservoir parameters
reservoir = Reservoir("test_data/one_node", "area")
reservoir_management = ReservoirManagement(
    reservoir=reservoir,
    penalty_bottom_rule_curve=3000,
    penalty_upper_rule_curve=3000,
    penalty_final_level=3000,
    force_final_level=False,
)

# Define discretization of stock level
xNsteps = 20
X = np.linspace(0, reservoir.capacity, num=xNsteps)

# Generate mps files 
generate_mps_file(study_path=study_path,antares_path=antares_path)

# Compute Bellman values 
vb = calculate_bellman_values(
    param=param,
    reservoir_management=reservoir_management,
    output_path="test_data/one_node",
    X=X,
    method=["direct", "precalculated", "iterative"][0],
    N=3,
    tol_gap=1e-4,
    len_controls=20
)

Structure

The repository consists in:

• src: python package to launch simulations and compute Bellman values based on the result
• tests: python tests illustrating the use and behaviour of the concepts
• test_data: data for running tests