Loop.hxx

Go to the documentation of this file.

// Copyright (C) 2006-2025  CEA, EDF
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
//
// See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
//
 
#ifndef __LOOP_HXX__
#define __LOOP_HXX__
 
#include "YACSlibEngineExport.hxx"
#include "StaticDefinedComposedNode.hxx"
#include "InputDataStreamPort.hxx"
#include "ElementaryNode.hxx"
#include "OutputPort.hxx"
#include "InputPort.hxx"
 
namespace YACS
{
  namespace ENGINE
  {
    void YACSLIBENGINE_EXPORT NbDoneLoader(Loop* node, int val);
    class Loop;
    class ForLoop;
    class WhileLoop;
    class DFToDSForLoop;
    class DSToDFForLoop;
 
    class YACSLIBENGINE_EXPORT InputPort4DF2DS : public InputPort
    {
    public:
      InputPort4DF2DS(DFToDSForLoop *node, TypeCode* type);
      void getAllRepresentants(std::set<InPort *>& repr) const;
      void releaseData() override;
      void put(const void *data);
      InputPort *clone(Node *newHelder) const;
      void *get() const ;
      void exRestoreInit();
      void exSaveInit();
      void put(Any *data);
      ~InputPort4DF2DS();
    protected:
      Any *_data;
    };
 
    class DFToDSForLoop : public ElementaryNode
    {
      friend class Loop;
    private:
      int _nbOfTimeUsed;
      Loop *_loopArtificiallyBuiltMe;
    private:
      DFToDSForLoop(Loop *loop, const std::string& name, TypeCode* type);
      void loopHasOneMoreRef() { _nbOfTimeUsed++; }
      bool loopHasOneLessRef() { return --_nbOfTimeUsed==0; }
      void getReadyTasks(std::vector<Task *>& tasks);
      InputPort *getInputPort(const std::string& name) const ;
      OutputDataStreamPort *getOutputDataStreamPort(const std::string& name) const ;
      Node *simpleClone(ComposedNode *father, bool editionOnly=true) const;
      //run part
      void execute();
      void load();
    public:
      ~DFToDSForLoop();
    };
 
    class YACSLIBENGINE_EXPORT OutputPort4DS2DF : public OutputPort
    {
    public:
      OutputPort4DS2DF(DSToDFForLoop *node, TypeCode *type);
      void getAllRepresented(std::set<OutPort *>& represented) const;
      void put(const void *data);
      OutputPort *clone(Node *newHelder) const;
      void put(Any *data);
      ~OutputPort4DS2DF();
    protected:
      Any *_data;
    };
    
    class YACSLIBENGINE_EXPORT InputDataStreamPort4DS2DF : public InputDataStreamPort
    {
    public:
      InputDataStreamPort4DS2DF(DSToDFForLoop *node, TypeCode* type);
      void getAllRepresentants(std::set<InPort *>& repr) const;
    };
 
    class DSToDFForLoop : public ElementaryNode
    {
      friend class Loop;
    private:
      int _nbOfTimeUsed;
      Loop *_loopArtificiallyBuiltMe;
    private:
      DSToDFForLoop(Loop *loop, const std::string& name, TypeCode* type);
      Node *simpleClone(ComposedNode *father, bool editionOnly=true) const;
      void loopHasOneMoreRef() { _nbOfTimeUsed++; }
      bool loopHasOneLessRef() { return --_nbOfTimeUsed==0; }
      void getReadyTasks(std::vector<Task *>& tasks);
      OutputPort *getOutputPort(const std::string& name) const ;
      InputDataStreamPort *getInputDataStreamPort(const std::string& name) const ;
      //run part
      void execute();
      void load();
    public:
      ~DSToDFForLoop();
    };
 
    class FakeNodeForLoop : public ElementaryNode
    {
      friend class ForLoop;
      friend class WhileLoop;
    private:
      Loop *_loop;
      bool _normalFinish;
      bool _internalError;
    private:
      FakeNodeForLoop(Loop *loop, bool normalFinish, bool internalError=false);
      FakeNodeForLoop(const FakeNodeForLoop& other);
      Node *simpleClone(ComposedNode *father, bool editionOnly) const;
      void exForwardFailed();
      void exForwardFinished();
      void execute();
      void aborted();
      void finished();
    };
 
    class YACSLIBENGINE_EXPORT Loop : public StaticDefinedComposedNode
    {
      friend class DSToDFForLoop;
      friend class FakeNodeForLoop;
      friend void NbDoneLoader(Loop* node, int val);
    protected:
      Node *_node;
      int _nbOfTurns;
      FakeNodeForLoop *_nodeForNullTurnOfLoops;
      std::set<DSToDFForLoop *> _inputsTraducer;
      std::set<DFToDSForLoop *> _outputsTraducer;
    public:
      Loop(const Loop& other, ComposedNode *father, bool editionOnly);
      Loop(const std::string& name);
      ~Loop();
      void init(bool start=true);
      int getNbOfTurns() const { return _nbOfTurns; }
      //Node* DISOWNnode is a SWIG notation to indicate that the ownership of the node is transfered to C++
      Node *edSetNode(Node *DISOWNnode);
      virtual bool edAddChild(Node *DISOWNnode) ;
      bool isLoop() const override { return true; }
      Node *edRemoveNode();
      virtual void checkBasicConsistency() const ;
      virtual InputPort *getDecisionPort() const = 0;
      void getReadyTasks(std::vector<Task *>& tasks);
      void edRemoveChild(Node *node) ;
      bool isRepeatedUnpredictablySeveralTimes() const { return true; }
      std::list<Node *> edGetDirectDescendants() const;
      std::list<InputPort *> getSetOfInputPort() const;
      int getNumberOfInputPorts() const;
      int getMaxLevelOfParallelism() const;
      void getWeightRegardingDPL(ComplexWeight *weight);
      void partitionRegardingDPL(const PartDefinition *pd, std::map<ComposedNode *, YACS::BASES::AutoRefCnt<PartDefinition> >& zeMap);
      Node *getChildByShortName(const std::string& name) const ;
      static TypeCode* MappingDF2DS(TypeCode* type) ;
      static TypeCode* MappingDS2DF(TypeCode* type) ;
      virtual bool edAddDFLink(OutPort *start, InPort *end) ;
      void writeDot(std::ostream &os) const;
      virtual void accept(Visitor *visitor);
      virtual std::string typeName() {return "YACS__ENGINE__Loop";}
    protected:
      void buildDelegateOf(InPort * & port, OutPort *initialStart, const std::list<ComposedNode *>& pointsOfView);
      void buildDelegateOf(std::pair<OutPort *, OutPort *>& port, InPort *finalTarget, const std::list<ComposedNode *>& pointsOfView);
      void getDelegateOf(InPort * & port, OutPort *initialStart, const std::list<ComposedNode *>& pointsOfView) ;
      void getDelegateOf(std::pair<OutPort *, OutPort *>& port, InPort *finalTarget, const std::list<ComposedNode *>& pointsOfView) ;
      void releaseDelegateOf(InPort * & port, OutPort *initialStart, const std::list<ComposedNode *>& pointsOfView) ;
      void releaseDelegateOf(OutPort *portDwn, OutPort *portUp, InPort *finalTarget, const std::list<ComposedNode *>& pointsOfView) ;
      void checkNoCyclePassingThrough(Node *node) ;
      void checkControlDependancy(OutPort *start, InPort *end, bool cross,
                                  std::map < ComposedNode *,  std::list < OutPort * >, SortHierarc >& fw,
                                  std::vector<OutPort *>& fwCross,
                                  std::map< ComposedNode *, std::list < OutPort *>, SortHierarc >& bw,
                                  LinkInfo& info) const;
      void checkCFLinks(const std::list<OutPort *>& starts, InputPort *end, unsigned char& alreadyFed, bool direction, LinkInfo& info) const;
      static bool isNecessaryToBuildSpecificDelegateDF2DS(const std::list<ComposedNode *>& pointsOfView);
    };
 
  }
}
 
#endif