From 0b5c8ed1a9ddb98ab9cf88d2745b9d7dc56f6731 Mon Sep 17 00:00:00 2001 From: "Alexander V. Hopp" Date: Fri, 23 Feb 2024 16:57:33 +0100 Subject: [PATCH] First draf of Transfer Learning User Guide --- docs/userguide/transfer_learning.md | 41 +++++++++++++++++++++++++++-- 1 file changed, 39 insertions(+), 2 deletions(-) diff --git a/docs/userguide/transfer_learning.md b/docs/userguide/transfer_learning.md index c6870dfc3e..55886b677e 100644 --- a/docs/userguide/transfer_learning.md +++ b/docs/userguide/transfer_learning.md @@ -1,4 +1,41 @@ # Transfer Learning -This page will soon contain information about transfer learning. -In the meantime, please see the [examples](../../examples/examples) instead. \ No newline at end of file +BayBE offers the possibility to mix data from multiple campaigns in order to accelerate +optimization. +Using data from multiple campaigns is currently supported when using a Gaussian Process +Surrogate model and is implemented by the [`TaskParameter`](baybe.parameters.categorical.TaskParameter). + +```{admonition} Terminology +:class: note +The term "Transfer Learning" is used in a lot of different ways. +The act of combining the data of several contexts can be done via multiple models, +shared architectures, special kernels in a single model and whatnot. +We do not necessarily want to limit to any of these methods, even though BayBE currently +offers only a single one. +``` + +## The role of ``TaskParameter`` + +The ``TaskParameter`` is used to "mark" the context of an individual experiment. The +set of all possible contexts is provided upon the initialization of a ``TaskParameter`` +by providing them as ``values``. + +```python +from baybe.parameters import TaskParameter + +TaskParameter(name="Month", values=["Nov23", "Dec23", "Jan24"]) +``` + +If not specified further, a ``campaign`` using the ``TaskParameter`` as specified above +would now make recommendations for all possible values of the parameter. Using the +``active_values`` argument upon initialization, this behavior can be changed such that +the ``campaign`` only makes recommendations for the corresponding values. + +```python +from baybe.parameters import TaskParameter + +TaskParameter(name="Month", values=["Nov23", "Dec23", "Jan24"], active_values=["Jan24"]) +``` + +This can be abstracted easily to other scenarios such as changing substrates (while +screening same reaction conditions) or formulating mixtures for different cell lines. \ No newline at end of file