JeVois  1.18
JeVois Smart Embedded Machine Vision Toolkit
Share this page:
PostProcessorPython.H
Go to the documentation of this file.
1 // ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////
2 //
3 // JeVois Smart Embedded Machine Vision Toolkit - Copyright (C) 2021 by Laurent Itti, the University of Southern
4 // California (USC), and iLab at USC. See http://iLab.usc.edu and http://jevois.org for information about this project.
5 //
6 // This file is part of the JeVois Smart Embedded Machine Vision Toolkit. This program is free software; you can
7 // redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software
8 // Foundation, version 2. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
9 // without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
10 // License for more details. You should have received a copy of the GNU General Public License along with this program;
11 // if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
12 //
13 // Contact information: Laurent Itti - 3641 Watt Way, HNB-07A - Los Angeles, CA 90089-2520 - USA.
14 // Tel: +1 213 740 3527 - itti@pollux.usc.edu - http://iLab.usc.edu - http://jevois.org
15 // ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////
16 /*! \file */
17 
18 #pragma once
19 
22 
23 namespace jevois
24 {
25  namespace dnn
26  {
27  class PostProcessorPythonImpl;
28 
29  //! Post-Processor for neural network pipeline
30  /*! This is the last step in a deep neural network processing Pipeline. This post-processor calls a python
31  implementation to do the actual post-processing work. \ingroup dnn */
32  class PostProcessorPython : public PostProcessor, public Parameter<postprocessor::pypost>
33  {
34  public:
35  //! Constructor
36  PostProcessorPython(std::string const & instance);
37 
38  //! Destructor
39  virtual ~PostProcessorPython();
40 
41  //! Freeze/unfreeze parameters that users should not change while running
42  void freeze(bool doit) override;
43 
44  //! Process outputs and draw/send some results
45  /*! Forwards to the python code, with a simplified signature */
46  void process(std::vector<cv::Mat> const & outs, PreProcessor * preproc) override;
47 
48  //! Report what happened in last process() to console/output video/GUI
49  /*! Forwards to the python code, with a simplified signature */
50  void report(jevois::StdModule * mod, jevois::RawImage * outimg = nullptr,
51  jevois::OptGUIhelper * helper = nullptr, bool overlay = true, bool idle = false) override;
52 
53  protected:
54  // Load the python code as soon as the file is set, and call init() on it if defined
55  void onParamChange(postprocessor::pypost const & param, std::string const & newval) override;
56 
57  // Python init() may create new dynamic parameters, but in onParamChange() we are locked up, so we need to use a
58  // sub-Component for our actual implementation, and the sub can get its dynamic parameters created while our own
59  // params are locked up...
60  std::shared_ptr<PostProcessorPythonImpl> itsImpl;
61  };
62 
63  } // namespace dnn
64 } // namespace jevois
jevois::dnn::PostProcessorPython::onParamChange
void onParamChange(postprocessor::pypost const &param, std::string const &newval) override
Definition: PostProcessorPython.C:131
jevois::dnn::PostProcessorPython
Post-Processor for neural network pipeline.
Definition: PostProcessorPython.H:32
jevois::RawImage
A raw image as coming from a V4L2 Camera and/or being sent out to a USB Gadget.
Definition: RawImage.H:110
jevois::dnn::PostProcessorPython::freeze
void freeze(bool doit) override
Freeze/unfreeze parameters that users should not change while running.
Definition: PostProcessorPython.C:121
jevois::dnn::PostProcessorPython::PostProcessorPython
PostProcessorPython(std::string const &instance)
Constructor.
Definition: PostProcessorPython.C:110
jevois::GUIhelper
Helper class to assist modules in creating graphical and GUI elements.
Definition: GUIhelper.H:122
jevois::dnn::PostProcessorPython::itsImpl
std::shared_ptr< PostProcessorPythonImpl > itsImpl
Definition: PostProcessorPython.H:60
jevois
Definition: Concepts.dox:1
jevois::dnn::PreProcessor
Pre-Processor for neural network pipeline.
Definition: PreProcessor.H:102
PostProcessor.H
jevois::dnn::PostProcessorPython::report
void report(jevois::StdModule *mod, jevois::RawImage *outimg=nullptr, jevois::OptGUIhelper *helper=nullptr, bool overlay=true, bool idle=false) override
Report what happened in last process() to console/output video/GUI.
Definition: PostProcessorPython.C:142
jevois::dnn::PostProcessorPython::~PostProcessorPython
virtual ~PostProcessorPython()
Destructor.
Definition: PostProcessorPython.C:117
jevois::dnn::PostProcessorPython::process
void process(std::vector< cv::Mat > const &outs, PreProcessor *preproc) override
Process outputs and draw/send some results.
Definition: PostProcessorPython.C:138
jevois::dnn::PostProcessor
Post-Processor for neural network pipeline.
Definition: PostProcessor.H:146
jevois::StdModule
Base class for a module that supports standardized serial messages.
Definition: Module.H:232
PythonWrapper.H