Training

The best way to learn BOPTEST is by using it! Here you can find a list with links to training material (tutorials, workshops, presentations, etc.) that you may want to use for learning. We provide a small description for each so you know what material suits you best.

User Tutorials and Workshops

RLEM2023 Workshop: Introduction to the BOPTEST Framework

  • 🗓️ Last updated: 2023/11/13

  • ⚙️ Compatible with: BOPTEST-v0.5.0, BOPTEST-Gym-v0.5.0

  • 🔗 Links: Open In Colab, presentation BOPTEST project, presentation MPC and RL examples in BOPTEST

  • ⏰ Duration: 3.5 hours

  • 📝 Brief description: This is an introductory, hands-on tutorial to guide you through usage of the BOPTEST framework and its Gym interface for performance benchmarking of control algorithms. This one is similar to the one of BS2023 workshop but is more extensive and elaborates further in the BOPTEST native API and its Gym interface. The tutorial is split into four main parts:

    1. Presentation 1: Introduction to the BOPTEST project, goals and approach
    2. Exercise 1: Introductory hands-on tutorial on the software
    3. Presentation 2: MPC and RL examples in BOPTEST
    4. Exercise 2: Learning BOPTEST-Gym: the OpenAI-Gym interface of BOPTEST

BS2023 Workshop: Introduction to the BOPTEST Framework

  • 🗓️ Last updated: 2023/09/04

  • ⚙️ Compatible with: BOPTEST-v0.4.0, BOPTEST-Gym-v0.4.0

  • 🔗 Links: Open In Colab, presentation BOPTEST project, presentation ADRENALIN contest

  • ⏰ Duration: 1.5 hours

  • 📝 Brief description: This is an introductory, hands-on tutorial to guide you through the BOPTEST framework and its Gym interface for performance benchmarking of control algorithms. The first exercise is common to the one from the BS2021 workshop but the second exercise explains BOPTEST-Gym instead of diving further into the BOPTEST API. The overall time is also shorter. Therefore, this tutorial gives a faster (but less deep) intro to both BOPTEST and BOPTEST-Gym. The tutorial is split into three main parts:

    1. Presentation 1: Introduction to the BOPTEST project, goals and approach
    2. Exercise 1: Introduction to the BOPTEST API and sample controller testing
    3. Exercise 2: Learning BOPTEST-Gym: the OpenAI-Gym interface of BOPTEST

CCAI2022 Workshop: BOPTEST-Gym - Building Control with RL using BOPTEST

  • 🗓️ Last updated: 2023/11/11

  • ⚙️ Compatible with: BOPTEST-v0.5.0,BOPTEST-Gym-v0.5.0

  • 🔗 Links: Open In Colab

  • ⏰ Duration: 2.5 hours

  • 🎥 Video: An explanatory video of this tutorial can be found here for the CCAI2022 Summer School on August 18, 2022. The video starts with a one-hour lecture on the application of machine learning in buildings. The part of BOPTEST-Gym follows right after and lasts for 1.5 hours. Please note that the software version used in the video is BOPTEST-v0.2.0. The framework and tutorial have been updated since then so you may notice slight differences in the content and interface. However, the main concepts and explanation behind remains the same.

  • 📝 Brief description: This is an introductory, hands-on tutorial to guide you through the main concepts of Reinforcement Learning (RL) for controlling Heating, Ventilation and Air Conditioning (HVAC) systems for buildings. It applies RL to a building emulator from BOPTEST using its BOPTEST-Gym interface. Compared to other tutorials, this one dives focuses more into concepts of RL and elaborates further on the BOPTEST-Gym interface. The tutorial has the following parts:

    1. Background on RL in buildings
    2. The OpenAI-Gym standard
    3. The BOPTEST framework
    4. Implementing RL for a building with BOPTEST-Gym

BS2021 Workshop: Introduction to the BOPTEST Framework

  • 🗓️ Last updated: 2023/04/06

  • ⚙️ Compatible with: BOPTEST-v0.4.0

  • 🔗 Links: Open In Colab, presentation BOPTEST project, presentation MPC example in BOPTEST.

  • ⏰ Duration: 3.5 hours

  • 📝 Brief description: This is an introductory, hands-on tutorial to guide you through the BOPTEST framework for performance benchmarking of control algorithms. The tutorial is split into four main parts:

    1. Presentation 1: Introduction to the BOPTEST project, goals and approach
    2. Exercise 1: Introduction to the BOPTEST API and sample controller testing
    3. Presentation 2: Example development and evaluation of an MPC controller
    4. Exercise 2: Improving controller performance and reporting results

Software Development Guidance

An introduction to BOPTEST Software for Test Case Development and Interaction

  • 🗓️ Last updated: 2023/04/16

  • ⚙️ Compatible with: BOPTEST-v0.4.0

  • 🔗 Links: link to pdf

  • 📝 Brief description: The purpose of this tutorial is to provide basic introduction of the BOPTEST framework and associated software components to potential test case developers and controller testers. Therefore, the tutorial is split into three main parts:

    1. Software requirements
    2. Test case development
    3. Test case interaction