From 0596174b94671f56279f8df2719b1c7eec7b22ef Mon Sep 17 00:00:00 2001
From: demon143 <59681577+demon143@users.noreply.github.com>
Date: Thu, 18 Nov 2021 09:20:54 +0800
Subject: [PATCH] Update task_management.rst (#654)
* Update task_management.rst
* Update task_management.rst
* Update task_management.rst
* Update task_management.rst
* Update task_management.rst
* Update task_management.rst
* Update task_management.rst
* Update task_management.rst
* Update task_management.rst
* Update task_management.rst
* Update task_management.rst
* Add files via upload
---
docs/_static/img/Task-Gen-Recorder-Collector.svg | 4 ++++
docs/advanced/task_management.rst | 14 +++++++++++---
2 files changed, 15 insertions(+), 3 deletions(-)
create mode 100644 docs/_static/img/Task-Gen-Recorder-Collector.svg
diff --git a/docs/_static/img/Task-Gen-Recorder-Collector.svg b/docs/_static/img/Task-Gen-Recorder-Collector.svg
new file mode 100644
index 000000000..51602c12b
--- /dev/null
+++ b/docs/_static/img/Task-Gen-Recorder-Collector.svg
@@ -0,0 +1,4 @@
+
+
+
+
\ No newline at end of file
diff --git a/docs/advanced/task_management.rst b/docs/advanced/task_management.rst
index 56a3137f9..611cdf136 100644
--- a/docs/advanced/task_management.rst
+++ b/docs/advanced/task_management.rst
@@ -11,7 +11,11 @@ Introduction
The `Workflow <../component/introduction.html>`_ part introduces how to run research workflow in a loosely-coupled way. But it can only execute one ``task`` when you use ``qrun``.
To automatically generate and execute different tasks, ``Task Management`` provides a whole process including `Task Generating`_, `Task Storing`_, `Task Training`_ and `Task Collecting`_.
-With this module, users can run their ``task`` automatically at different periods, in different losses, or even by different models.
+With this module, users can run their ``task`` automatically at different periods, in different losses, or even by different models.The processes of task generation, model training and combine and collect data are shown in the following figure.
+
+
+
+
This whole process can be used in `Online Serving <../component/online.html>`_.
@@ -74,6 +78,8 @@ If you do not want to use ``Task Manager`` to manage tasks, then use TrainerR to
Task Collecting
===============
+Before collecting model training results, you need to use the ``qlib.init`` to specify the path of mlruns.
+
To collect the results of ``task`` after training, ``Qlib`` provides `Collector <../reference/api.html#Collector>`_, `Group <../reference/api.html#Group>`_ and `Ensemble <../reference/api.html#Ensemble>`_ to collect the results in a readable, expandable and loosely-coupled way.
`Collector <../reference/api.html#Collector>`_ can collect objects from everywhere and process them such as merging, grouping, averaging and so on. It has 2 step action including ``collect`` (collect anything in a dict) and ``process_collect`` (process collected dict).
@@ -82,8 +88,10 @@ To collect the results of ``task`` after training, ``Qlib`` provides `Collector
For example: {(A,B,C1): object, (A,B,C2): object} ---``group``---> {(A,B): {C1: object, C2: object}} ---``reduce``---> {(A,B): object}
`Ensemble <../reference/api.html#Ensemble>`_ can merge the objects in an ensemble.
-For example: {C1: object, C2: object} ---``Ensemble``---> object
+For example: {C1: object, C2: object} ---``Ensemble``---> object.
+You can set the ensembles you want in the ``Collector``'s process_list.
+Common ensembles include ``AverageEnsemble`` and ``RollingEnsemble``. Average ensemble is used to ensemble the results of different models in the same time period. Rollingensemble is used to ensemble the results of different models in the same time period
So the hierarchy is ``Collector``'s second step corresponds to ``Group``. And ``Group``'s second step correspond to ``Ensemble``.
-For more information, please see `Collector <../reference/api.html#Collector>`_, `Group <../reference/api.html#Group>`_ and `Ensemble <../reference/api.html#Ensemble>`_, or the `example `_.
\ No newline at end of file
+For more information, please see `Collector <../reference/api.html#Collector>`_, `Group <../reference/api.html#Group>`_ and `Ensemble <../reference/api.html#Ensemble>`_, or the `example `_.
+