How to Input a FCF File

Follow these steps to integrate a FCF (Future Cost Function) file into your study:

1. Prepare the FCF File Ensure that the FCF file (cuts.json) is available in your study’s input directory.

2. Load the Study Load your study database using the following command (make sure to replace PATH with your study path):

   db = IARA.load_study(PATH; read_only = false)

3. Link the Time Series File Link the FCF file (cuts.json) to your study’s configuration using the code snippet below:

   IARA.link_time_series_to_file(
       db,
       "Configuration";
       fcf_cuts = "cuts.json",
   )

4. Close the Study Once the file is linked, close the database:

   IARA.close_study!(db)

For a complete working example, refer to the modify_case.jl file in the test/case_01/base_case_simulation directory.

Use cases for FCF Input

1. Minimum Cost Run: If you have already trained a policy and wish to run a decoupled simulation using that trained policy, you can input an FCF file to ensure that the simulation utilizes the expected cost function.
2. Clearing Simulations:
   • HYBRID: If you are running a clearing simulation with the HYBRID construction type, you may to input a FCF file to define the water values for the simulation. This option is enabled through the configuration setting use_fcf_in_clearing.
   • COST_BASED: If you are running a clearing simulation with the COST_BASED construction type, inputting an FCF file is mandatory to define the water values for the simulation.