From 0e49b9c449326ce9d9f4e3727def100f70633742 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Zientkiewicz?= Date: Mon, 27 May 2024 20:02:37 +0200 Subject: [PATCH] Add a warning about pipeline definition being executed only once. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Michał Zientkiewicz --- docs/pipeline.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/pipeline.rst b/docs/pipeline.rst index 2bd5d54d10..2c8770d3d0 100644 --- a/docs/pipeline.rst +++ b/docs/pipeline.rst @@ -50,6 +50,13 @@ The resulting graph is: .. _processing_graph_structure: +.. important:: + The pipeline definition function is excuted only once, when the pipeline is built, + and typically returns a ``dali.DataNode`` object or a tuple of thereof. + For convenience, it's possible to return other types, such as NumPy arrays, but those + are treated as constants and evaluated only once. + + Processing Graph Structure ^^^^^^^^^^^^^^^^^^^^^^^^^^