Iocatalyst_CatalystManager.h

Go to the documentation of this file.

// Copyright(C) 1999-2021 National Technology & Engineering Solutions
// of Sandia, LLC (NTESS).  Under the terms of Contract DE-NA0003525 with
// NTESS, the U.S. Government retains certain rights in this software.
//
// See packages/seacas/LICENSE for details
 
#ifndef IOSS_IOVS_CATALYST_MANAGER_H
#define IOSS_IOVS_CATALYST_MANAGER_H
 
#include "iocatalyst_export.h"
#include <Ioss_ParallelUtils.h>
#include <catalyst.hpp>
 
namespace Iocatalyst {
 
  class IOCATALYST_EXPORT CatalystManager
  {
  public:
    using CatalystPipelineID = unsigned int;
 
    enum mState { mInit, mExecute, mFinalize };
    enum pState { pWaitExecute, pExecute, pFinalize };
 
    inline static const std::string ARGS     = "args";
    inline static const std::string CATALYST = "catalyst";
    inline static const std::string CATALYST_BLOCK_PARSE_INPUT_DECK_NAME =
        "CATALYST_BLOCK_PARSE_INPUT_DECK_NAME";
    inline static const std::string CATALYST_BLOCK_PARSE_JSON_STRING =
        "CATALYST_BLOCK_PARSE_JSON_STRING";
    inline static const std::string CATALYST_DEBUG_LEVEL      = "CATALYST_DEBUG_LEVEL";
    inline static const std::string CATALYST_ENABLE_LOGGING   = "CATALYST_ENABLE_LOGGING";
    inline static const std::string CATALYST_OUTPUT_DIRECTORY = "CATALYST_OUTPUT_DIRECTORY";
    inline static const std::string CATALYST_OUTPUT_DEFAULT   = "CatalystOutput";
    inline static const std::string CATALYST_INPUT_NAME       = "CATALYST_INPUT_NAME";
    inline static const std::string CATALYST_INPUT_DEFAULT    = "input";
    inline static const std::string CATALYST_MULTI_INPUT_PIPELINE_NAME =
        "CATALYST_MULTI_INPUT_PIPELINE_NAME";
    inline static const std::string CATALYST_SCRIPT             = "CATALYST_SCRIPT";
    inline static const std::string CATALYST_SCRIPT_EXTRA_FILE  = "CATALYST_SCRIPT_EXTRA_FILE";
    inline static const std::string CHANNELS                    = "channels";
    inline static const std::string CYCLE                       = "cycle";
    inline static const std::string DATA                        = "data";
    inline static const std::string PHACTORI_JSON_SCRIPT        = "PHACTORI_JSON_SCRIPT";
    inline static const std::string PIPELINES                   = "pipelines";
    inline static const std::string FILENAME                    = "filename";
    inline static const std::string FS                          = "/";
    inline static const std::string IOSS                        = "ioss";
    inline static const std::string SCRIPTS                     = "scripts";
    inline static const std::string STATE                       = "state";
    inline static const std::string TIME                        = "time";
    inline static const std::string TIMESTEP                    = "timestep";
    inline static const std::string TYPE                        = "type";
    inline static const std::string PHACTORI_DRIVER_SCRIPT_PATH = "PHACTORI_DRIVER_SCRIPT_PATH";
 
    static CatalystManager &getInstance()
    {
      static CatalystManager instance;
      return instance;
    }
    static CatalystManager &getInstance() {…}
 
    std::string getCatalystPythonDriverPath();
 
    conduit_cpp::Node getInitializeConduit();
 
    mState getManagerState() { return managerState; }
 
    pState getPipelineState(CatalystPipelineID id);
 
    void writeToCatalystLogFile(const Ioss::ParallelUtils   &putils,
                                const Ioss::PropertyManager &props);
 
    struct CatalystProps
    {
      CatalystProps()
      {
        catalystPipelineID               = 0;
        enableLogging                    = false;
        debugLevel                       = 0;
        catalystOutputDirectory          = CATALYST_OUTPUT_DEFAULT;
        catalystInputName                = CATALYST_INPUT_DEFAULT;
        enableCatalystMultiInputPipeline = false;
        pipelineState                    = pExecute;
        state                            = 0;
        time                             = 0.0;
      }
      CatalystProps() {…}
 
      CatalystPipelineID catalystPipelineID;
      pState             pipelineState;
      bool               enableCatalystMultiInputPipeline;
      std::string        catalystMultiInputPipelineName;
      std::string        catalystPythonFilename;
      conduit_cpp::Node  data;
      int                state;
      double             time;
 
      std::string catalystInputName;
      std::string catalystBlockJSON;
      std::string catalystScriptExtraFile;
      std::string catalystInputDeckName;
      std::string catalystOutputDirectory;
      bool        enableLogging;
      int         debugLevel;
    };
    struct CatalystProps {…};
 
    CatalystPipelineID initialize(const Ioss::PropertyManager &props,
                                  const Ioss::ParallelUtils   &putils);
    void execute(CatalystPipelineID id, int state, double time, conduit_cpp::Node &data);
    void finalize(CatalystPipelineID id);
    void addScriptProps(conduit_cpp::Node &n, const CatalystProps &p);
    void addExecuteProps(conduit_cpp::Node &n, const CatalystProps &p, int state, double time);
    void addExecuteData(conduit_cpp::Node &n, const std::string &channelName, int state,
                        double time, conduit_cpp::Node &data);
    CatalystProps &getCatalystProps(CatalystPipelineID id);
    std::string    getCatDataPath(const Ioss::PropertyManager &props);
    void           setMultiInputWaitState(CatalystPipelineID id, int state, double time,
                                          conduit_cpp::Node &data);
    bool           canExecuteMultiInputScript(CatalystPipelineID id);
    void           clearAllMultiInputWaitStates(CatalystPipelineID id);
    void           reset()
    {
      catalystOutputIDNumber = 0;
      catPipes.clear();
      managerState = mInit;
    }
    void           reset() {…}
 
    std::string getCatScriptFnamePath(const CatalystProps &p)
    {
      return getCatScriptPath(p) + FILENAME;
    }
    std::string getCatScriptFnamePath(const CatalystProps &p) {…}
 
    std::string getCatScriptArgsPath(const CatalystProps &p) { return getCatScriptPath(p) + ARGS; }
 
    std::string getCatScriptPath(const CatalystProps &p)
    {
      return CATALYST + FS + SCRIPTS + FS + std::to_string(p.catalystPipelineID) + FS;
    }
    std::string getCatScriptPath(const CatalystProps &p) {…}
 
    std::string getCatStatePath() { return CATALYST + FS + STATE + FS; }
 
    std::string getCatChannelsPath() { return CATALYST + FS + CHANNELS + FS; }
 
  private:
    CatalystManager();
    ~CatalystManager();
    CatalystManager(const CatalystManager &)            = delete;
    CatalystManager &operator=(const CatalystManager &) = delete;
 
    void broadCastString(std::string &s, const Ioss::ParallelUtils &putils);
    void broadCastStatusCode(bool &statusCode, const Ioss::ParallelUtils &putils);
 
    void incrementOutputCounts();
 
    CatalystPipelineID                          catalystOutputIDNumber;
    std::map<CatalystPipelineID, CatalystProps> catPipes;
    mState                                      managerState;
  };
  class IOCATALYST_EXPORT CatalystManager {…};
} // namespace Iocatalyst
 
#endif