SST  8.0.0
StructuralSimulationToolkit
config.h
1 // Copyright 2009-2018 NTESS. Under the terms
2 // of Contract DE-NA0003525 with NTESS, the U.S.
3 // Government retains certain rights in this software.
4 //
5 // Copyright (c) 2009-2018, NTESS
6 // All rights reserved.
7 //
8 // This file is part of the SST software package. For license
9 // information, see the LICENSE file in the top level directory of the
10 // distribution.
11 
12 #ifndef SST_CORE_CONFIG_H
13 #define SST_CORE_CONFIG_H
14 
15 #include <sst/core/sst_types.h>
16 #include <sst/core/simulation.h>
17 #include <sst/core/rankInfo.h>
18 #include <sst/core/env/envquery.h>
19 #include <sst/core/env/envconfig.h>
20 
21 #include <sst/core/serialization/serializable.h>
22 
23 #include <string>
24 
25 
26 namespace SST {
27 
28 /**
29  * Class to contain SST Simulation Configuration variables
30  */
32 public:
33 
34  /** Create a new Config object.
35  * @param my_rank - parallel rank of this instance
36  * @param world_size - number of parallel ranks in the simulation
37  */
39  Config () {} // For serialization
40  ~Config();
41 
42  /** Parse command-line arguments to update configuration values */
43  int parseCmdLine( int argc, char* argv[] );
44  /** Set a configuration string to update configuration values */
45  bool setConfigEntryFromModel( const std::string &entryName, const std::string &value );
46  /** Return the current Verbosity level */
47  uint32_t getVerboseLevel();
48 
49  /** Print the SST core timing information */
50  bool printTimingInfo();
51 
52  /** Set the cycle at which to stop the simulation */
53  void setStopAt(std::string stopAtStr);
54  /** Sets the default timebase of the simulation */
55  void setTimeBase(std::string timeBase);
56  /** Print the current configuration to stdout */
57  void Print();
58 
59  std::string debugFile; /*!< File to which debug information should be written */
60  Simulation::Mode_t runMode; /*!< Run Mode (Init, Both, Run-only) */
61  std::string configFile; /*!< Graph generation file */
62  std::string stopAtCycle; /*!< When to stop the simulation */
63  uint32_t stopAfterSec; /*!< When (wall-time) to stop the simulation */
64  std::string heartbeatPeriod; /*!< Sets the heartbeat period for the simulation */
65  std::string timeBase; /*!< Timebase of simulation */
66  std::string partitioner; /*!< Partitioner to use */
67  std::string generator; /*!< Generator to use */
68  std::string generator_options; /*!< Options to pass to the generator */
69  std::string timeVortex; /*!< TimeVortex implementation to use */
70  std::string output_config_graph; /*!< File to dump configuration graph */
71  std::string output_dot; /*!< File to dump dot output */
72  std::string output_xml; /*!< File to dump XML output */
73  std::string output_json; /*!< File to dump JSON output */
74  std::string output_directory; /*!< Output directory to dump all files to */
75  std::string model_options; /*!< Options to pass to Python Model generator */
76  std::string dump_component_graph_file; /*!< File to dump component graph */
77  std::string output_core_prefix; /*!< Set the SST::Output prefix for the core */
78 
79  RankInfo world_size; /*!< Number of ranks, threads which should be invoked per rank */
80  uint32_t verbose; /*!< Verbosity */
81  bool no_env_config; /*!< Bypass compile-time environmental configuration */
82  bool enable_sig_handling; /*!< Enable signal handling */
83  bool print_timing; /*!< Print SST timing information */
84 
85 #ifdef USE_MEMPOOL
86  std::string event_dump_file; /*!< File to dump undeleted events to */
87 #endif
88 
89 
90  typedef bool (Config::*flagFunction)(void);
91  typedef bool (Config::*argFunction)(const std::string &arg);
92 
93  bool usage();
94  bool printVersion();
95  bool incrVerbose() { verbose++; return true;}
96  bool setVerbosity(const std::string &arg);
97  bool disableSigHandlers() { enable_sig_handling = false; return true;}
98  bool disableEnvConfig() { no_env_config = true; return true;}
99  bool enablePrintTiming() { print_timing = true; return true;}
100 
101  bool setConfigFile(const std::string &arg);
102  bool setDebugFile(const std::string &arg);
103  bool setLibPath(const std::string &arg);
104  bool addLibPath(const std::string &arg);
105  bool setRunMode(const std::string &arg);
106  bool setStopAt(const std::string &arg);
107  bool setStopAfter(const std::string &arg);
108  bool setHeartbeat(const std::string &arg);
109  bool setTimebase(const std::string &arg);
110  bool setPartitioner(const std::string &arg);
111  bool setGenerator(const std::string &arg);
112  bool setGeneratorOptions(const std::string &arg);
113  bool setTimeVortex(const std::string &arg);
114  bool setOutputDir(const std::string &arg);
115  bool setWriteConfig(const std::string &arg);
116  bool setWriteDot(const std::string &arg);
117  bool setWriteXML(const std::string &arg);
118  bool setWriteJSON(const std::string &arg);
119  bool setWritePartition(const std::string &arg);
120  bool setOutputPrefix(const std::string &arg);
121 #ifdef USE_MEMPOOL
122  bool setWriteUndeleted(const std::string &arg);
123 #endif
124  bool setModelOptions(const std::string &arg);
125  bool setNumThreads(const std::string &arg);
126 
127 
128  Simulation::Mode_t getRunMode() { return runMode; }
129 
130  /** Print to stdout the current configuration */
131  void print() {
132  std::cout << "debugFile = " << debugFile << std::endl;
133  std::cout << "runMode = " << runMode << std::endl;
134  std::cout << "libpath = " << getLibPath() << std::endl;
135  std::cout << "configFile = " << configFile << std::endl;
136  std::cout << "stopAtCycle = " << stopAtCycle << std::endl;
137  std::cout << "stopAfterSec = " << stopAfterSec << std::endl;
138  std::cout << "timeBase = " << timeBase << std::endl;
139  std::cout << "partitioner = " << partitioner << std::endl;
140  std::cout << "generator = " << generator << std::endl;
141  std::cout << "gen_options = " << generator_options << std::endl;
142  std::cout << "output_config_graph = " << output_config_graph << std::endl;
143  std::cout << "output_xml = " << output_xml << std::endl;
144  std::cout << "no_env_config = " << no_env_config << std::endl;
145  std::cout << "output_directory = " << output_directory << std::endl;
146  std::cout << "output_json = " << output_json << std::endl;
147  std::cout << "model_options = " << model_options << std::endl;
148  std::cout << "num_threads = " << world_size.thread << std::endl;
149  std::cout << "enable_sig_handling = " << enable_sig_handling << std::endl;
150  std::cout << "output_core_prefix = " << output_core_prefix << std::endl;
151  std::cout << "print_timing=" << print_timing << std::endl;
152  }
153 
154 
155  /** Return the library search path */
156  std::string getLibPath(void) const;
157 
158  uint32_t getNumRanks() { return world_size.rank; }
159  uint32_t getNumThreads() { return world_size.thread; }
160  uint32_t setNumThreads(uint32_t nthr) {
161  uint32_t old = world_size.thread;
162  world_size.thread = nthr;
163  return old;
164  }
165 
166  void serialize_order(SST::Core::Serialization::serializer &ser) override
167  {
168  ser & debugFile;
169  ser & runMode;
170  ser & libpath;
171  ser & addlLibPath;
172  ser & configFile;
173  ser & stopAtCycle;
174  ser & stopAfterSec;
175  ser & timeBase;
176  ser & partitioner;
177  ser & generator;
178  ser & generator_options;
180  ser & output_config_graph;
181  ser & output_xml;
182  ser & output_json;
183  ser & no_env_config;
184  ser & model_options;
185  ser & world_size;
186  ser & enable_sig_handling;
187  ser & output_core_prefix;
188  ser & print_timing;
189  }
190 
191 private:
192  std::string run_name;
193  std::string libpath;
194  std::string addlLibPath;
195 
196  int rank;
197  int numRanks;
198 
199  bool isFileNameOnly(const std::string name) {
200  bool nameOnly = true;
201 
202  for( size_t i = 0; i < name.size(); ++i ) {
203  if( '/' == name[i] ) {
204  nameOnly = false;
205  break;
206  }
207  }
208 
209  return nameOnly;
210  }
211 
212  ImplementSerializable(SST::Config)
213 };
214 
215 } // namespace SST
216 
217 #endif // SST_CORE_CONFIG_H
RankInfo world_size
Definition: config.h:79
This class is basically a wrapper for objects to declare the order in which their members should be s...
Definition: serializer.h:35
uint32_t stopAfterSec
Definition: config.h:63
std::string generator_options
Definition: config.h:68
std::string partitioner
Definition: config.h:66
std::string timeVortex
Definition: config.h:69
Class to contain SST Simulation Configuration variables.
Definition: config.h:31
std::string heartbeatPeriod
Definition: config.h:64
std::string output_core_prefix
Definition: config.h:77
int parseCmdLine(int argc, char *argv[])
Parse command-line arguments to update configuration values.
Definition: config.cc:223
bool setConfigEntryFromModel(const std::string &entryName, const std::string &value)
Set a configuration string to update configuration values.
Definition: config.cc:327
Simulation::Mode_t runMode
Definition: config.h:60
std::string output_config_graph
Definition: config.h:70
uint32_t getVerboseLevel()
Return the current Verbosity level.
Definition: config.cc:519
std::string output_dot
Definition: config.h:71
Definition: serializable.h:109
void setTimeBase(std::string timeBase)
Sets the default timebase of the simulation.
uint32_t verbose
Definition: config.h:80
std::string timeBase
Definition: config.h:65
bool no_env_config
Definition: config.h:81
std::string model_options
Definition: config.h:75
std::string output_xml
Definition: config.h:72
std::string output_directory
Definition: config.h:74
Definition: rankInfo.h:21
std::string output_json
Definition: config.h:73
void print()
Print to stdout the current configuration.
Definition: config.h:131
bool printTimingInfo()
Print the SST core timing information.
Definition: config.cc:515
std::string debugFile
Definition: config.h:59
std::string generator
Definition: config.h:67
std::string getLibPath(void) const
Return the library search path.
Definition: config.cc:524
std::string dump_component_graph_file
Definition: config.h:76
std::string configFile
Definition: config.h:61
void setStopAt(std::string stopAtStr)
Set the cycle at which to stop the simulation.
std::string stopAtCycle
Definition: config.h:62
bool enable_sig_handling
Definition: config.h:82
Mode_t
Type of Run Modes.
Definition: simulation.h:75
void Print()
Print the current configuration to stdout.
bool print_timing
Definition: config.h:83