[Feature]: Define callbacks (and where to register them) in the Energyplus API for Sinergym environments.

[AlejandroCN7]

Feature 🚀

A clear and concise description of the feature proposal.

Motivation

Right now, the interface for sending and receiving simulation data is done with predefined callbacks registered at specific moments of the simulation flow.

The idea is to leave this as it is, since any change can cause the simulation to malfunction. However, functionality could be created to modify these function registers in the environment with the responsibility of the user.

If this is done, it would be convenient to create some kind of property in the environment that allows us to know the current state of which callbacks are defined and at what point in the simulation each one is called.

Solution

One way to accomplish this would be with some method created in the environment layer. In this method, you would specify the callback function you want to register (previously created) and the name of the runtime method of the Energyplus API where you want to register it (only the name in STR, then you would check if it is correct). An example:

collect_obs():
    # The code to read Output:Variables, for example
    pass

env.clear_simulator_callbacks()
env.simulation_registration(collect_obs,'callback_after_predictor_before_hvac_managers')

Checklist

• I have checked that there is no similar issue in the repo (required)

📝 Please, don't forget to include more labels besides Feature request if it is necessary.