@spec configure(atom(), pos_integer(), pos_integer(), pos_integer()) :: map()

Configure a Forex trading experiment.

Parameters:

• experiment_id: Unique identifier for the experiment
• population_size: Number of trading agents (default: 50)
• data_window: Size of the data window for training (default: 5000)
• generations: Number of generations to evolve (default: 50)

Returns the experiment configuration map.

@spec run(atom(), pos_integer(), pos_integer(), pos_integer()) ::
  :ok | {:error, any()}

Run a Forex trading experiment with the given configuration.

Parameters:

• experiment_id: Unique identifier for the experiment
• population_size: Number of trading agents (default: 50)
• data_window: Size of the data window for training (default: 5000)
• generations: Number of generations to evolve (default: 50)

Returns :ok if the experiment was started successfully.

@spec test_best_agent(atom(), pos_integer(), pos_integer()) :: map() | {:error, any()}

Test the best trading agent from a completed experiment on out-of-sample data.

Parameters:

• experiment_id: ID of the completed experiment
• test_window_start: Starting index for test data (default: 5000)
• test_window_size: Size of the test data window (default: 1000)

Returns a map with test results.