AdaoExchangeLayer.cxx

   1 // Copyright (C) 2019 EDF R&D
   2 //
   3 // This library is free software; you can redistribute it and/or
   4 // modify it under the terms of the GNU Lesser General Public
   5 // License as published by the Free Software Foundation; either
   6 // version 2.1 of the License.
   7 //
   8 // This library is distributed in the hope that it will be useful,
   9 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  10 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  11 // Lesser General Public License for more details.
  12 //
  13 // You should have received a copy of the GNU Lesser General Public
  14 // License along with this library; if not, write to the Free Software
  15 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
  16 //
  17 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
  18 //
  19 // Author: Anthony Geay, anthony.geay@edf.fr, EDF R&D
  20
  21 #include "AdaoExchangeLayer.hxx"
  22 #include "AdaoExchangeLayerException.hxx"
  23 #include "AdaoModelKeyVal.hxx"
  24 #include "PyObjectRAII.hxx"
  25 #include "Python.h"
  26
  27 #include "py2cpp/py2cpp.hxx"
  28
  29 #include <semaphore.h>
  30
  31 #include <iostream>
  32 #include <sstream>
  33 #include <clocale>
  34 #include <cstdlib>
  35 #include <thread>
  36 #include <future>
  37
  38 struct DataExchangedBetweenThreads // data written by subthread and read by calling thread
  39 {
  40 public:
  41   DataExchangedBetweenThreads();
  42   ~DataExchangedBetweenThreads();
  43 public:
  44   sem_t _sem;
  45   sem_t _sem_result_is_here;
  46   volatile bool _finished = false;
  47   volatile PyObject *_data = nullptr;
  48 };
  49
  50 /////////////////////////////////////////////
  51
  52 struct AdaoCallbackSt
  53 {
  54   PyObject_HEAD
  55   DataExchangedBetweenThreads *_data;
  56 };
  57
  58 static PyObject *adaocallback_call(AdaoCallbackSt *self, PyObject *args, PyObject *kw)
  59 {
  60   if(!PyTuple_Check(args))
  61     throw AdaoExchangeLayerException("Input args is not a tuple as expected !");
  62   if(PyTuple_Size(args)!=1)
  63     throw AdaoExchangeLayerException("Input args is not a tuple of size 1 as expected !");
  64   PyObjectRAII zeobj(PyObjectRAII::FromBorrowed(PyTuple_GetItem(args,0)));
  65   if(zeobj.isNull())
  66     throw AdaoExchangeLayerException("Retrieve of elt #0 of input tuple has failed !");
  67   volatile PyObject *ret(nullptr);
  68   PyThreadState *tstate(PyEval_SaveThread());// GIL is acquired (see ExecuteAsync). Before entering into non python section. Release lock
  69   {
  70     self->_data->_finished = false;
  71     self->_data->_data = zeobj;
  72     sem_post(&self->_data->_sem);
  73     sem_wait(&self->_data->_sem_result_is_here);
  74     ret = self->_data->_data;
  75   }
  76   PyEval_RestoreThread(tstate);//End of parallel section. Reaquire the GIL and restore the thread state
  77   return (PyObject *)ret;
  78 }
  79
  80 static int adaocallback___init__(PyObject *self, PyObject *args, PyObject *kwargs) { return 0; }
  81
  82 static PyObject *adaocallback___new__(PyTypeObject *type, PyObject *args, PyObject *kwargs)
  83 {
  84   return (PyObject *)( type->tp_alloc(type, 0) );
  85 }
  86
  87 static void adaocallback_dealloc(PyObject *self)
  88 {
  89   Py_TYPE(self)->tp_free(self);
  90 }
  91
  92 PyTypeObject AdaoCallbackType = {
  93   PyVarObject_HEAD_INIT(&PyType_Type, 0)
  94   "adaocallbacktype",
  95   sizeof(AdaoCallbackSt),
  96   0,
  97   adaocallback_dealloc,       /*tp_dealloc*/
  98   0,                          /*tp_print*/
  99   0,                          /*tp_getattr*/
 100   0,                          /*tp_setattr*/
 101   0,                          /*tp_compare*/
 102   0,                          /*tp_repr*/
 103   0,                          /*tp_as_number*/
 104   0,                          /*tp_as_sequence*/
 105   0,                          /*tp_as_mapping*/
 106   0,                          /*tp_hash*/
 107   (ternaryfunc)adaocallback_call,  /*tp_call*/
 108   0,                          /*tp_str*/
 109   0,                          /*tp_getattro*/
 110   0,                          /*tp_setattro*/
 111   0,                          /*tp_as_buffer*/
 112   Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_GC | Py_TPFLAGS_BASETYPE,  /*tp_flags*/
 113   0,                          /*tp_doc*/
 114   0,                          /*tp_traverse*/
 115   0,                          /*tp_clear*/
 116   0,                          /*tp_richcompare*/
 117   0,                          /*tp_weaklistoffset*/
 118   0,                          /*tp_iter*/
 119   0,                          /*tp_iternext*/
 120   0,                          /*tp_methods*/
 121   0,                          /*tp_members*/
 122   0,                          /*tp_getset*/
 123   0,                          /*tp_base*/
 124   0,                          /*tp_dict*/
 125   0,                          /*tp_descr_get*/
 126   0,                          /*tp_descr_set*/
 127   0,                          /*tp_dictoffset*/
 128   adaocallback___init__,      /*tp_init*/
 129   PyType_GenericAlloc,        /*tp_alloc*/
 130   adaocallback___new__,       /*tp_new*/
 131   PyObject_GC_Del,            /*tp_free*/
 132 };
 133
 134 /////////////////////////////////////////////
 135
 136 DataExchangedBetweenThreads::DataExchangedBetweenThreads()
 137 {
 138   if(sem_init(&_sem,0,0)!=0)// put value to 0 to lock by default
 139     throw AdaoExchangeLayerException("Internal constructor : Error on initialization of semaphore !");
 140   if(sem_init(&_sem_result_is_here,0,0)!=0)// put value to 0 to lock by default
 141     throw AdaoExchangeLayerException("Internal constructor : Error on initialization of semaphore !");
 142 }
 143
 144 DataExchangedBetweenThreads::~DataExchangedBetweenThreads()
 145 {
 146   sem_destroy(&_sem);
 147   sem_destroy(&_sem_result_is_here);
 148 }
 149
 150 class AdaoCallbackKeeper
 151 {
 152 public:
 153   void assign(AdaoCallbackSt *pt, DataExchangedBetweenThreads *data)
 154   {
 155     release();
 156     _pt = pt;
 157     _pt->_data = data;
 158   }
 159   PyObject *getPyObject() const { return reinterpret_cast<PyObject*>(_pt); }
 160   ~AdaoCallbackKeeper() { release(); }
 161 private:
 162   void release() { if(_pt) { Py_XDECREF(_pt); } }
 163 private:
 164   AdaoCallbackSt *_pt = nullptr;
 165 };
 166
 167 class AdaoExchangeLayer::Internal
 168 {
 169 public:
 170   Internal():_context(PyObjectRAII::FromNew(PyDict_New()))
 171   {
 172     AutoGIL agil;
 173     PyObject *mainmod(PyImport_AddModule("__main__"));
 174     PyObject *globals(PyModule_GetDict(mainmod));
 175     PyObject *bltins(PyEval_GetBuiltins());
 176     PyDict_SetItemString(_context,"__builtins__",bltins);
 177   }
 178 public:
 179   PyObjectRAII _context;
 180   PyObjectRAII _generate_case_func;
 181   PyObjectRAII _decorator_func;
 182   PyObjectRAII _adao_case;
 183   PyObjectRAII _execute_func;
 184   AdaoCallbackKeeper _py_call_back;
 185   std::future< void > _fut;
 186   PyThreadState *_tstate = nullptr;
 187   DataExchangedBetweenThreads _data_btw_threads;
 188 };
 189
 190 wchar_t **ConvertToWChar(int argc, const char *argv[])
 191 {
 192   wchar_t **ret(new wchar_t*[argc]);
 193   for(int i=0;i<argc;++i)
 194     {
 195       std::size_t len(strlen(argv[i])+1);
 196       wchar_t *elt(new wchar_t[len]);
 197       ret[i]=elt;
 198       std::mbstowcs(elt, argv[i], len);
 199     }
 200   return ret;
 201 }
 202
 203 void FreeWChar(int argc, wchar_t **tab)
 204 {
 205   for(int i=0;i<argc;++i)
 206     delete [] tab[i];
 207   delete [] tab;
 208 }
 209
 210 AdaoExchangeLayer::AdaoExchangeLayer()
 211 {
 212 }
 213
 214 AdaoExchangeLayer::~AdaoExchangeLayer()
 215 {
 216   delete _internal;
 217 }
 218
 219 void AdaoExchangeLayer::init()
 220 {
 221   initPythonIfNeeded();
 222 }
 223
 224 PyObject *AdaoExchangeLayer::getPythonContext() const
 225 {
 226   if(!_internal)
 227     throw AdaoExchangeLayerException("getPythonContext : not initialized !");
 228   return _internal->_context;
 229 }
 230
 231 std::string AdaoExchangeLayer::printContext() const
 232 {
 233   AutoGIL agil;
 234   PyObject *obj(this->getPythonContext());
 235   if(!PyDict_Check(obj))
 236     throw AdaoExchangeLayerException("printContext : not a dict !");
 237   PyObject *key(nullptr), *value(nullptr);
 238   Py_ssize_t pos(0);
 239   std::ostringstream oss;
 240   while( PyDict_Next(obj, &pos, &key, &value) )
 241     {
 242       if(!PyUnicode_Check(key))
 243         throw AdaoExchangeLayerException("printContext : not a string as key !");
 244       oss << PyUnicode_AsUTF8(key) << " = ";
 245       PyObjectRAII reprOfValue(PyObjectRAII::FromNew(PyObject_Repr(value)));
 246       oss << PyUnicode_AsUTF8(reprOfValue);
 247       oss << std::endl;
 248     }
 249   return oss.str();
 250 }
 251
 252 /*!
 253  * AdaoExchangeLayer is based on multithreaded paradigm.
 254  * Master thread (thread calling this method) and slave thread (thread calling ADAO algo)
 255  * are calling both python interpretor. Consequence all python calls have to be surrounded with AGIL.
 256  *
 257  * User consequence : To avoid deadlocks this method release GIL. The downstream python calls must be with AGIL.
 258  *
 259  * This method initialize python interpretor if not already the case.
 260  * At the end of this method the lock is released to be ready to perform RAII on GIL
 261  * easily.
 262  */
 263 void AdaoExchangeLayer::initPythonIfNeeded()
 264 {
 265   if (!Py_IsInitialized())
 266     {
 267       const char *TAB[]={"AdaoExchangeLayer"};
 268       wchar_t **TABW(ConvertToWChar(1,TAB));
 269       // Python is not initialized
 270       Py_SetProgramName(const_cast<wchar_t *>(TABW[0]));
 271       Py_Initialize(); // Initialize the interpreter
 272       PySys_SetArgv(1,TABW);
 273       FreeWChar(1,TABW);
 274       PyEval_InitThreads();
 275       delete _internal;
 276       _internal = new Internal;
 277       _internal->_tstate=PyEval_SaveThread(); // release the lock acquired in AdaoExchangeLayer::initPythonIfNeeded by PyEval_InitThreads()
 278     }
 279   else
 280     {
 281       delete _internal;
 282       _internal = new Internal;
 283       if( PyGILState_Check() )// is the GIL already acquired (typically by a PyEval_InitThreads) ?
 284         _internal->_tstate=PyEval_SaveThread(); // release the lock acquired upstream
 285     }
 286 }
 287
 288 class Visitor1 : public AdaoModel::PythonLeafVisitor
 289 {
 290 public:
 291   Visitor1(PyObjectRAII func, PyObject *context):_func(func),_context(context)
 292   {
 293   }
 294
 295   void visit(AdaoModel::MainModel *godFather, AdaoModel::PyObjKeyVal *obj) override
 296   {
 297     if(obj->getKey()=="Matrix" || obj->getKey()=="DiagonalSparseMatrix")
 298       {
 299         std::ostringstream oss; oss << "__" << _cnt++;
 300         std::string varname(oss.str());
 301         obj->setVal(Py_None);
 302         PyDict_SetItemString(_context,varname.c_str(),Py_None);
 303         obj->setVarName(varname);
 304         return ;
 305       }
 306     if(obj->getKey()=="OneFunction")
 307       {
 308         std::ostringstream oss; oss << "__" << _cnt++;
 309         std::string varname(oss.str());
 310         obj->setVal(_func);
 311         PyDict_SetItemString(_context,varname.c_str(),_func);
 312         obj->setVarName(varname);
 313         return ;
 314       }
 315   }
 316 private:
 317   unsigned int _cnt = 0;
 318   PyObjectRAII _func;
 319   PyObject *_context = nullptr;
 320 };
 321
 322 void AdaoExchangeLayer::loadTemplate(AdaoModel::MainModel *model)
 323 {
 324   AutoGIL agil;
 325   const char DECORATOR_FUNC[]="def DecoratorAdao(cppFunc):\n"
 326       "    def evaluator( xserie ):\n"
 327       "        import numpy as np\n"
 328       "        yserie = [np.array(elt) for elt in cppFunc(xserie)]\n"
 329       "        return yserie\n"
 330       "    return evaluator\n";
 331   this->_internal->_py_call_back.assign(PyObject_GC_New(AdaoCallbackSt,&AdaoCallbackType),
 332       &this->_internal->_data_btw_threads);
 333   PyObject *callbackPyObj(this->_internal->_py_call_back.getPyObject());
 334   //
 335   {
 336       PyObjectRAII res(PyObjectRAII::FromNew(PyRun_String(DECORATOR_FUNC,Py_file_input,this->_internal->_context,this->_internal->_context)));
 337       PyObjectRAII decoratorGenerator( PyObjectRAII::FromBorrowed(PyDict_GetItemString(this->_internal->_context,"DecoratorAdao")) );
 338       if(decoratorGenerator.isNull())
 339         throw AdaoExchangeLayerException("Fail to locate DecoratorAdao function !");
 340       PyObjectRAII args(PyObjectRAII::FromNew(PyTuple_New(1)));
 341       { PyTuple_SetItem(args,0,callbackPyObj); Py_XINCREF(callbackPyObj); }
 342       this->_internal->_decorator_func = PyObjectRAII::FromNew(PyObject_CallObject(decoratorGenerator,args));
 343       if(this->_internal->_decorator_func.isNull())
 344         throw AdaoExchangeLayerException("Fail to generate result of DecoratorAdao function !");
 345   }
 346   //
 347   Visitor1 visitor(this->_internal->_decorator_func,this->_internal->_context);
 348   model->visitPythonLeaves(&visitor);
 349   //
 350   {
 351     std::string sciptPyOfModelMaker(model->pyStr());
 352     PyObjectRAII res(PyObjectRAII::FromNew(PyRun_String(sciptPyOfModelMaker.c_str(),Py_file_input,this->_internal->_context,this->_internal->_context)));
 353     PyErr_Print();
 354     _internal->_adao_case = PyObjectRAII::FromNew(PyDict_GetItemString(this->_internal->_context,"case"));
 355   }
 356   if(_internal->_adao_case.isNull())
 357     throw AdaoExchangeLayerException("Fail to generate ADAO case object !");
 358   //
 359   _internal->_execute_func=PyObjectRAII::FromNew(PyObject_GetAttrString(_internal->_adao_case,"execute"));
 360   if(_internal->_execute_func.isNull())
 361     throw AdaoExchangeLayerException("Fail to locate execute function of ADAO case object !");
 362 }
 363
 364 void ExecuteAsync(PyObject *pyExecuteFunction, DataExchangedBetweenThreads *data)
 365 {
 366   {
 367     AutoGIL gil; // launched in a separed thread -> protect python calls
 368     PyObjectRAII args(PyObjectRAII::FromNew(PyTuple_New(0)));
 369     PyObjectRAII nullRes(PyObjectRAII::FromNew(PyObject_CallObject(pyExecuteFunction,args)));// go to adaocallback_call
 370     PyErr_Print();
 371   }
 372   data->_finished = true;
 373   data->_data = nullptr;
 374   sem_post(&data->_sem);
 375 }
 376
 377 void AdaoExchangeLayer::execute()
 378 {
 379   _internal->_fut = std::async(std::launch::async,ExecuteAsync,_internal->_execute_func,&_internal->_data_btw_threads);
 380 }
 381
 382 bool AdaoExchangeLayer::next(PyObject *& inputRequested)
 383 {
 384   sem_wait(&_internal->_data_btw_threads._sem);
 385   if(_internal->_data_btw_threads._finished)
 386     {
 387       inputRequested = nullptr;
 388       return false;
 389     }
 390   else
 391     {
 392       inputRequested = (PyObject *)_internal->_data_btw_threads._data;
 393       return true;
 394     }
 395 }
 396
 397 void AdaoExchangeLayer::setResult(PyObject *outputAssociated)
 398 {
 399   _internal->_data_btw_threads._data = outputAssociated;
 400   _internal->_data_btw_threads._finished = false;
 401   sem_post(&_internal->_data_btw_threads._sem_result_is_here);
 402 }
 403
 404 PyObject *AdaoExchangeLayer::getResult()
 405 {
 406   _internal->_fut.wait();
 407   if(_internal->_tstate)
 408     PyEval_RestoreThread(_internal->_tstate);
 409   AutoGIL gil;
 410   // now retrieve case.get("Analysis")[-1]
 411   PyObjectRAII get_func_of_adao_case(PyObjectRAII::FromNew(PyObject_GetAttrString(_internal->_adao_case,"get")));
 412   if(get_func_of_adao_case.isNull())
 413     throw AdaoExchangeLayerException("Fail to locate \"get\" method from ADAO case !");
 414   PyObjectRAII all_intermediate_results;
 415   {// retrieve return data from case.get("Analysis")
 416     PyObjectRAII args(PyObjectRAII::FromNew(PyTuple_New(1)));
 417     PyTuple_SetItem(args,0,PyUnicode_FromString("Analysis"));
 418     all_intermediate_results=PyObjectRAII::FromNew(PyObject_CallObject(get_func_of_adao_case,args));
 419     if(all_intermediate_results.isNull())
 420       throw AdaoExchangeLayerException("Fail to retrieve result of case.get(\"Analysis\") !");
 421   }
 422   PyObjectRAII optimum;
 423   {
 424     PyObjectRAII param(PyObjectRAII::FromNew(PyLong_FromLong(-1)));
 425     optimum=PyObjectRAII::FromNew(PyObject_GetItem(all_intermediate_results,param));
 426     if(optimum.isNull())
 427       throw AdaoExchangeLayerException("Fail to retrieve result of last element of case.get(\"Analysis\") !");
 428   }
 429   /*PyObjectRAII code(PyObjectRAII::FromNew(Py_CompileString("case.get(\"Analysis\")[-1]","retrieve result",Py_file_input)));
 430   if(code.isNull())
 431     throw AdaoExchangeLayerException("Fail to compile code to retrieve result after ADAO computation !");
 432     PyObjectRAII res(PyObjectRAII::FromNew(PyEval_EvalCode(code,_internal->_context,_internal->_context)));*/
 433   return optimum.retn();
 434 }