1 // Copyright (C) 2006-2015 CEA/DEN, EDF R&D
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, or (at your option) any later version.
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.
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
17 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
21 #include "InputPort.hxx"
22 #include "OutputPort.hxx"
23 #include "InputDataStreamPort.hxx"
24 #include "OutputDataStreamPort.hxx"
25 #include "LinkInfo.hxx"
26 #include "Runtime.hxx"
27 #include "Visitor.hxx"
32 #include "YacsTrace.hxx"
34 using namespace YACS::ENGINE;
37 InputPort4DF2DS::InputPort4DF2DS(DFToDSForLoop *node, TypeCode* type):
38 InputPort("", node, type),
39 DataPort("", node, type),
44 void InputPort4DF2DS::getAllRepresentants(std::set<InPort *>& repr) const
46 set<InPort *> s=_node->getOutputDataStreamPort("")->edSetInPort();
47 repr.insert(s.begin(),s.end());
50 void *InputPort4DF2DS::get() const throw(YACS::Exception)
54 std::string what="InputPort4DF2DS::get : no value currently in input whith name \""; what+=_name; what+="\"";
55 throw Exception(what);
60 void InputPort4DF2DS::exRestoreInit()
70 void InputPort4DF2DS::exSaveInit()
73 _initValue->decrRef();
75 _initValue->incrRef();
78 void InputPort4DF2DS::put(const void *data) throw(ConversionException)
83 InputPort *InputPort4DF2DS::clone(Node *newHelder) const
85 throw Exception("InputPort4DF2DS::clone : internal error");
88 void InputPort4DF2DS::put(Any *data)
96 InputPort4DF2DS::~InputPort4DF2DS()
102 DFToDSForLoop::DFToDSForLoop(Loop *loop, const std::string& name, TypeCode* type):ElementaryNode(""),_nbOfTimeUsed(1)
104 _name="DF2DS For "; _name+=loop->getName(); _name+=" representing port "; _name+=name;
106 _setOfInputPort.push_back(new InputPort4DF2DS(this,type));
107 _setOfOutputDataStreamPort.push_back(new OutputDataStreamPort("",this,Loop::MappingDF2DS(type)));
110 DFToDSForLoop::~DFToDSForLoop()
112 edDisconnectAllLinksWithMe();
115 void DFToDSForLoop::getReadyTasks(std::vector<Task *>& tasks)
119 InputPort *DFToDSForLoop::getInputPort(const std::string& name) const throw(YACS::Exception)
122 return Node::getInputPort(name);
124 catch(Exception& e) {}
126 list<InputPort *>::const_iterator it =_setOfInputPort.begin();
130 OutputDataStreamPort *DFToDSForLoop::getOutputDataStreamPort(const std::string& name) const throw(YACS::Exception)
132 list<OutputDataStreamPort *>::const_iterator it =_setOfOutputDataStreamPort.begin();
136 void DFToDSForLoop::load()
140 void DFToDSForLoop::execute()
145 Node *DFToDSForLoop::simpleClone(ComposedNode *father, bool editionOnly) const
147 throw Exception("DFToDSForLoop::simpleClone : Internal error");
150 OutputPort4DS2DF::OutputPort4DS2DF(DSToDFForLoop *node, TypeCode *type):
151 OutputPort("", node, type),
152 DataPort("", node, type),
157 void OutputPort4DS2DF::getAllRepresented(std::set<OutPort *>& represented) const
159 set<OutPort *> setO=_node->getInputDataStreamPort("")->edSetOutPort();
160 for(set<OutPort *>::iterator iter=setO.begin();iter!=setO.end();iter++)
161 (*iter)->getAllRepresented(represented);
164 void OutputPort4DS2DF::put(const void *data) throw(ConversionException)
167 OutputPort::put(data);
170 OutputPort *OutputPort4DS2DF::clone(Node *newHelder) const
172 throw Exception("OutputPort4DS2DF::clone : Internal error");
175 void OutputPort4DS2DF::put(Any *data)
183 OutputPort4DS2DF::~OutputPort4DS2DF()
189 InputDataStreamPort4DS2DF::InputDataStreamPort4DS2DF(DSToDFForLoop *node, TypeCode* type):
190 InputDataStreamPort("", node, type),
191 DataPort("", node, type),
196 void InputDataStreamPort4DS2DF::getAllRepresentants(std::set<InPort *>& repr) const
198 set<InPort *> s=_node->getOutputPort("")->edSetInPort();
199 repr.insert(s.begin(),s.end());
202 DSToDFForLoop::DSToDFForLoop(Loop *loop, const std::string& name, TypeCode* type):ElementaryNode(""),_nbOfTimeUsed(1)
204 _name="DS2DF For "; _name+=loop->getName(); _name+=" representing port "; _name+=name;
206 _setOfOutputPort.push_back(new OutputPort4DS2DF(this,type));
207 _setOfInputDataStreamPort.push_back(new InputDataStreamPort4DS2DF(this,type));
210 Node *DSToDFForLoop::simpleClone(ComposedNode *father, bool editionOnly) const
212 throw Exception("DSToDFForLoop::simpleClone : Internal error");
215 DSToDFForLoop::~DSToDFForLoop()
217 edDisconnectAllLinksWithMe();
220 void DSToDFForLoop::getReadyTasks(std::vector<Task *>& tasks)
224 OutputPort *DSToDFForLoop::getOutputPort(const std::string& name) const throw(YACS::Exception)
226 list<OutputPort *>::const_iterator it = _setOfOutputPort.begin();
230 InputDataStreamPort *DSToDFForLoop::getInputDataStreamPort(const std::string& name) const throw(YACS::Exception)
232 list<InputDataStreamPort *>::const_iterator it = _setOfInputDataStreamPort.begin();
236 void DSToDFForLoop::load()
240 void DSToDFForLoop::execute()
245 FakeNodeForLoop::FakeNodeForLoop(Loop *loop, bool normalFinish, bool internalError):ElementaryNode("thisIsAFakeNode"),
247 _normalFinish(normalFinish),
248 _internalError(internalError)
250 setState(YACS::TOACTIVATE);
251 _father=_loop->getFather();
254 FakeNodeForLoop::FakeNodeForLoop(const FakeNodeForLoop& other):ElementaryNode(other),_loop(0),
255 _normalFinish(false),_internalError(true)
259 Node *FakeNodeForLoop::simpleClone(ComposedNode *father, bool editionOnly) const
261 return new FakeNodeForLoop(*this);
264 void FakeNodeForLoop::exForwardFailed()
266 _loop->exForwardFailed();
269 void FakeNodeForLoop::exForwardFinished()
271 _loop->exForwardFinished();
274 void FakeNodeForLoop::execute()
277 throw Exception("");//only to trigger ABORT on Executor
280 void FakeNodeForLoop::aborted()
283 _loop->setState(YACS::INTERNALERR);
285 _loop->setState(YACS::ERROR);
288 void FakeNodeForLoop::finished()
290 _loop->setState(YACS::DONE);
293 Loop::Loop(const Loop& other, ComposedNode *father, bool editionOnly):StaticDefinedComposedNode(other,father),_nbOfTurns(0),_nodeForNullTurnOfLoops(0),_node(0)
296 _node=other._node->simpleClone(this,editionOnly);
299 Loop::Loop(const std::string& name):StaticDefinedComposedNode(name),_node(0),_nbOfTurns(0),_nodeForNullTurnOfLoops(0)
306 if(_nodeForNullTurnOfLoops)delete _nodeForNullTurnOfLoops;
307 for(set<DSToDFForLoop *>::iterator iter1=_inputsTraducer.begin();iter1!=_inputsTraducer.end();iter1++)
309 for(set<DFToDSForLoop *>::iterator iter2=_outputsTraducer.begin();iter2!=_outputsTraducer.end();iter2++)
313 void Loop::init(bool start)
315 StaticDefinedComposedNode::init(start);
318 _node->init(start); // if start is true, refresh the internal node
320 throw Exception("Loop::initLoop : no nodes specifies to be repeated ");
321 delete _nodeForNullTurnOfLoops;
322 _nodeForNullTurnOfLoops=0;
325 Node *Loop::edSetNode(Node *node)
333 string what = "Loop::edSetNode: node "; what += node->getName(); what += " is not orphan ! ";
334 throw Exception(what);
337 checkNoCrossHierachyWith(node);
338 StaticDefinedComposedNode::edRemoveChild(_node);
342 //set _modified flag so that edUpdateState() can refresh state
347 bool Loop::edAddChild(Node *node) throw(YACS::Exception)
349 return edSetNode(node);
352 Node *Loop::edRemoveNode()
354 StaticDefinedComposedNode::edRemoveChild(_node);
361 //! Collect all the child nodes that are ready
363 * \param tasks : vector of tasks to collect ready nodes
365 void Loop::getReadyTasks(std::vector<Task *>& tasks)
370 * To change the way ComposedNode state is handled, uncomment the following line
371 * see Bloc::getReadyTasks
373 if(_state==YACS::TOACTIVATE) setState(YACS::ACTIVATED);
374 if(_state==YACS::TOACTIVATE || _state==YACS::ACTIVATED)
375 if(_nodeForNullTurnOfLoops)
376 _nodeForNullTurnOfLoops->getReadyTasks(tasks);
379 _node->getReadyTasks(tasks);
380 for(set<DSToDFForLoop *>::iterator iter1=_inputsTraducer.begin();iter1!=_inputsTraducer.end();iter1++)
381 (*iter1)->getReadyTasks(tasks);
382 for(set<DFToDSForLoop *>::iterator iter2=_outputsTraducer.begin();iter2!=_outputsTraducer.end();iter2++)
383 (*iter2)->getReadyTasks(tasks);
387 void Loop::edRemoveChild(Node *node) throw(YACS::Exception)
389 StaticDefinedComposedNode::edRemoveChild(node);
395 std::list<Node *> Loop::edGetDirectDescendants() const
399 ret.push_back(_node);
403 std::list<InputPort *> Loop::getSetOfInputPort() const
405 list<InputPort *> ret=StaticDefinedComposedNode::getSetOfInputPort();
406 ret.push_back(getDecisionPort());
410 int Loop::getNumberOfInputPorts() const
412 return StaticDefinedComposedNode::getNumberOfInputPorts()+1;
415 int Loop::getMaxLevelOfParallelism() const
419 return _node->getMaxLevelOfParallelism();
422 Node *Loop::getChildByShortName(const std::string& name) const throw(YACS::Exception)
425 if(name==_node->getName())
427 string what("node "); what+= name ; what+=" is not a child of loop node "; what += getName();
428 throw Exception(what);
431 TypeCode* Loop::MappingDF2DS(TypeCode* type) throw(YACS::Exception)
436 TypeCode* Loop::MappingDS2DF(TypeCode* type) throw(YACS::Exception)
441 void Loop::buildDelegateOf(InPort * & port, OutPort *initialStart, const std::list<ComposedNode *>& pointsOfView)
443 string typeOfPortInstance=port->getNameOfTypeOfCurrentInstance();
444 if(typeOfPortInstance!=InputPort::NAME ||
445 (typeOfPortInstance == InputPort::NAME &&
446 initialStart->getNameOfTypeOfCurrentInstance()== OutputPort::NAME &&
447 !isNecessaryToBuildSpecificDelegateDF2DS(pointsOfView)) )
449 InputPort *portCasted=(InputPort *)port;
450 set<DSToDFForLoop*>::iterator iter;
451 //Determinig if a DSToDFForLoop node has already been created for delegation of 'port'
452 for(iter=_inputsTraducer.begin();iter!=_inputsTraducer.end();iter++)
453 if((*iter)->getOutputPort("")->isAlreadyInSet(portCasted))
455 if(iter==_inputsTraducer.end())
456 {//first time that 'port' is delegated on higher level
457 pair<set<DSToDFForLoop*>::iterator, bool> iter2=_inputsTraducer.insert(new DSToDFForLoop(this,portCasted->getName(),Loop::MappingDF2DS(portCasted->edGetType())));
459 (*iter)->getOutputPort("")->addInPort(portCasted);
462 (*iter)->loopHasOneMoreRef();
463 port=(*iter)->getInputDataStreamPort("");
466 void Loop::buildDelegateOf(std::pair<OutPort *, OutPort *>& port, InPort *finalTarget, const std::list<ComposedNode *>& pointsOfView)
468 string typeOfPortInstance=(port.first)->getNameOfTypeOfCurrentInstance();
469 if(typeOfPortInstance!=OutputPort::NAME ||
470 ( typeOfPortInstance == OutputPort::NAME &&
471 finalTarget->getNameOfTypeOfCurrentInstance()== InputPort::NAME &&
472 !isNecessaryToBuildSpecificDelegateDF2DS(pointsOfView)) )
474 OutPort *portCasted=port.first;
475 set<DFToDSForLoop*>::iterator iter;
476 //Determinig if a DFToDSForLoop node has already been created for delegation of 'port'
477 for(iter=_outputsTraducer.begin();iter!=_outputsTraducer.end();iter++)
478 if(portCasted->isAlreadyLinkedWith((*iter)->getInputPort("")))
481 if(iter==_outputsTraducer.end())
482 {//first time that 'port' is delegated on higher level
483 //_outputsTraducer.insert(new DFToDSForLoop(this,portCasted->getName(),portCasted->edGetType()));
484 kl=new DFToDSForLoop(this,portCasted->getName(),portCasted->edGetType());
485 pair<set<DFToDSForLoop*>::iterator, bool> iter2=_outputsTraducer.insert(kl);
487 portCasted->addInPort((*iter)->getInputPort(""));
492 kl->loopHasOneMoreRef();
494 edAddLink(isInMyDescendance((port.first)->getNode())->getOutGate(),kl->getInGate());
495 port.first=(*iter)->getOutputDataStreamPort("");
498 void Loop::getDelegateOf(InPort * & port, OutPort *initialStart, const std::list<ComposedNode *>& pointsOfView) throw(YACS::Exception)
500 string typeOfPortInstance=port->getNameOfTypeOfCurrentInstance();
501 if(typeOfPortInstance!=InputPort::NAME ||
502 (typeOfPortInstance == InputPort::NAME &&
503 initialStart->getNameOfTypeOfCurrentInstance()== OutputPort::NAME &&
504 !isNecessaryToBuildSpecificDelegateDF2DS(pointsOfView)) )
506 InputPort *portCasted=(InputPort *)port;
507 set<DSToDFForLoop*>::iterator iter;
508 for(iter=_inputsTraducer.begin();iter!=_inputsTraducer.end();iter++)
509 if((*iter)->getOutputPort("")->isAlreadyInSet(portCasted))
511 if(iter==_inputsTraducer.end())
513 string what("Loop::getDelegateOf : Port with name "); what+=portCasted->getName(); what+=" not exported by loop "; what+=_name;
514 throw Exception(what);
517 port=(*iter)->getInputDataStreamPort("");
520 void Loop::getDelegateOf(std::pair<OutPort *, OutPort *>& port, InPort *finalTarget,
521 const std::list<ComposedNode *>& pointsOfView) throw(YACS::Exception)
523 string typeOfPortInstance=(port.first)->getNameOfTypeOfCurrentInstance();
524 if(typeOfPortInstance!=OutputPort::NAME ||
525 ( typeOfPortInstance == OutputPort::NAME &&
526 finalTarget->getNameOfTypeOfCurrentInstance()== InputPort::NAME &&
527 !isNecessaryToBuildSpecificDelegateDF2DS(pointsOfView)) )
529 OutPort *portCasted=port.first;
530 set<DFToDSForLoop*>::iterator iter;
531 for(iter=_outputsTraducer.begin();iter!=_outputsTraducer.end();iter++)
532 if(portCasted->isAlreadyLinkedWith((*iter)->getInputPort("")))
534 if(iter==_outputsTraducer.end())
536 string what("Loop::getDelegateOf : Port with name "); what+=portCasted->getName(); what+=" not exported by loop "; what+=_name;
537 throw Exception(what);
540 port.first=(*iter)->getOutputDataStreamPort("");
543 void Loop::releaseDelegateOf(InPort * & port, OutPort *initialStart, const std::list<ComposedNode *>& pointsOfView) throw(YACS::Exception)
545 string typeOfPortInstance=port->getNameOfTypeOfCurrentInstance();
546 if(typeOfPortInstance!=InputPort::NAME ||
547 ( typeOfPortInstance == InputPort::NAME &&
548 initialStart->getNameOfTypeOfCurrentInstance()== OutputPort::NAME &&
549 !isNecessaryToBuildSpecificDelegateDF2DS(pointsOfView)) )
551 InputPort *portCasted=(InputPort *)port;
552 set<DSToDFForLoop*>::iterator iter;
553 for(iter=_inputsTraducer.begin();iter!=_inputsTraducer.end();iter++)
554 if((*iter)->getOutputPort("")->isAlreadyInSet(portCasted))
556 if(iter==_inputsTraducer.end())
558 string what("Loop::releaseDelegateOf Port with name "); what+=portCasted->getName(); what+=" not exported by loop "; what+=_name;
559 throw Exception(what);
563 port=(*iter)->getInputDataStreamPort("");
564 if((*iter)->loopHasOneLessRef())
566 (*iter)->getOutputPort("")->removeInPort(portCasted,false);
568 _inputsTraducer.erase(iter);
573 void Loop::releaseDelegateOf(OutPort *portDwn, OutPort *portUp, InPort *finalTarget, const std::list<ComposedNode *>& pointsOfView) throw(YACS::Exception)
577 set<DFToDSForLoop*>::iterator iter;
578 for(iter=_outputsTraducer.begin();iter!=_outputsTraducer.end();iter++)
579 if((*iter)->getOutputDataStreamPort("")==portUp)
581 if((*iter)->loopHasOneLessRef())
583 portDwn->removeInPort((*iter)->getInputPort(""),false);
585 _outputsTraducer.erase(iter);
589 void Loop::checkNoCyclePassingThrough(Node *node) throw(YACS::Exception)
591 //throw Exception("Loop::checkNoCyclePassingThrough : Internal error occured");
594 void Loop::checkCFLinks(const std::list<OutPort *>& starts, InputPort *end, unsigned char& alreadyFed, bool direction, LinkInfo& info) const
596 Node *nodeEnd=end->getNode();
598 {//In this case 'end' port is a special port of this (for exemple ForLoop::_nbOfTimesPort)
599 //ASSERT(!direction) see Loop::checkControlDependancy (bw only)
600 solveObviousOrDelegateCFLinks(starts,end,alreadyFed,direction,info);
603 StaticDefinedComposedNode::checkCFLinks(starts,end,alreadyFed,direction,info);
607 * \note : States if a DF port must be considered on an upper level in hierarchy as a DS port or not from 'pointsOfView' observers.
609 * - True : a traduction DF->DS has to be done
610 * - False : no traduction needed
612 bool Loop::isNecessaryToBuildSpecificDelegateDF2DS(const std::list<ComposedNode *>& pointsOfView)
615 for(list<ComposedNode *>::const_iterator iter=pointsOfView.begin();iter!=pointsOfView.end() && !ret;iter++)
616 ret=(*iter)->isRepeatedUnpredictablySeveralTimes();
620 //! Connect an OutPort to an InPort and add control link if necessary
622 * Connect the ports with a data link (edAddLink)
623 * In a Loop don't add control flow link : use this only to add data back links
625 * \param start : the OutPort to connect
626 * \param end : the InPort to connect
627 * \return true if a new link has been created, false otherwise.
629 bool Loop::edAddDFLink(OutPort *start, InPort *end) throw(YACS::Exception)
631 return edAddLink(start,end);
634 //! Dump the node state to a stream
636 * \param os : the output stream
638 void Loop::writeDot(std::ostream &os) const
640 os << " subgraph cluster_" << getId() << " {\n" ;
641 //only one node in a loop
645 os << getId() << " -> " << _node->getId() << ";\n";
648 os << getId() << "[fillcolor=\"" ;
649 YACS::StatesForNode state=getEffectiveState();
650 os << getColorState(state);
651 os << "\" label=\"" << "Loop:" ;
652 os << getQualifiedName() <<"\"];\n";
656 void Loop::accept(Visitor *visitor)
658 visitor->visitLoop(this);
661 void Loop::checkControlDependancy(OutPort *start, InPort *end, bool cross,
662 std::map < ComposedNode *, std::list < OutPort * >, SortHierarc >& fw,
663 std::vector<OutPort *>& fwCross,
664 std::map< ComposedNode *, std::list < OutPort *>, SortHierarc >& bw,
665 LinkInfo& info) const
667 //First testing if end==getDecisionPort. This is the only case possible in theory.
668 if(end!=getDecisionPort())
669 return StaticDefinedComposedNode::checkControlDependancy(start,end,cross,fw,fwCross,bw,info);
671 throw Exception("Internal error occured - cross type link detected on decision port of a loop. Forbidden !");
672 fw[(ComposedNode *)this].push_back(start);
675 void Loop::checkBasicConsistency() const throw(YACS::Exception)
677 DEBTRACE("Loop::checkBasicConsistency");
678 ComposedNode::checkBasicConsistency();
680 throw Exception("For a loop, internal node is mandatory");
684 * For use only when loading a previously saved execution
687 void YACS::ENGINE::NbDoneLoader(Loop* node, int val)
689 node->_nbOfTurns = val;