A Discrete-Event Network Simulator
API
file-helper.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2013 University of Washington
3  *
4  * This program is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License version 2 as
6  * published by the Free Software Foundation;
7  *
8  * This program 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
11  * GNU General Public License for more details.
12  *
13  * You should have received a copy of the GNU General Public License
14  * along with this program; if not, write to the Free Software
15  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
16  *
17  * Author: Mitch Watrous (watrous@u.washington.edu)
18  */
19 
20 #ifndef FILE_HELPER_H
21 #define FILE_HELPER_H
22 
23 #include "ns3/file-aggregator.h"
24 #include "ns3/object-factory.h"
25 #include "ns3/probe.h"
26 #include "ns3/ptr.h"
27 #include "ns3/time-series-adaptor.h"
28 
29 #include <map>
30 #include <string>
31 
32 namespace ns3
33 {
34 
40 {
41  public:
46  FileHelper();
47 
58  FileHelper(const std::string& outputFileNameWithoutExtension,
60 
61  virtual ~FileHelper();
62 
74  void ConfigureFile(const std::string& outputFileNameWithoutExtension,
76 
107  void WriteProbe(const std::string& typeId,
108  const std::string& path,
109  const std::string& probeTraceSource);
110 
116  void AddTimeSeriesAdaptor(const std::string& adaptorName);
117 
126  void AddAggregator(const std::string& aggregatorName,
127  const std::string& outputFileName,
128  bool onlyOneAggregator);
129 
135  Ptr<Probe> GetProbe(std::string probeName) const;
136 
145 
155  Ptr<FileAggregator> GetAggregatorMultiple(const std::string& aggregatorName,
156  const std::string& outputFileName);
157 
167  void SetHeading(const std::string& heading);
168 
175  void Set1dFormat(const std::string& format);
176 
183  void Set2dFormat(const std::string& format);
184 
191  void Set3dFormat(const std::string& format);
192 
199  void Set4dFormat(const std::string& format);
200 
207  void Set5dFormat(const std::string& format);
208 
215  void Set6dFormat(const std::string& format);
216 
223  void Set7dFormat(const std::string& format);
224 
231  void Set8dFormat(const std::string& format);
232 
239  void Set9dFormat(const std::string& format);
240 
247  void Set10dFormat(const std::string& format);
248 
249  private:
257  void AddProbe(const std::string& typeId, const std::string& probeName, const std::string& path);
258 
274  void ConnectProbeToAggregator(const std::string& typeId,
275  const std::string& matchIdentifier,
276  const std::string& path,
277  const std::string& probeTraceSource,
278  const std::string& outputFileNameWithoutExtension,
279  bool onlyOneAggregator);
280 
283 
286 
289  std::map<std::string, Ptr<FileAggregator>> m_aggregatorMap;
290 
292  std::map<std::string, std::pair<Ptr<Probe>, std::string>> m_probeMap;
293 
295  std::map<std::string, Ptr<TimeSeriesAdaptor>> m_timeSeriesAdaptorMap;
296 
299 
302 
305 
308 
310  std::string m_heading;
311 
312  std::string m_1dFormat;
313  std::string m_2dFormat;
314  std::string m_3dFormat;
315  std::string m_4dFormat;
316  std::string m_5dFormat;
317  std::string m_6dFormat;
318  std::string m_7dFormat;
319  std::string m_8dFormat;
320  std::string m_9dFormat;
321  std::string m_10dFormat;
322 
323 }; // class FileHelper
324 
325 } // namespace ns3
326 
327 #endif // FILE_HELPER_H
FileType
The type of file written by the aggregator.
Helper class used to put data values into a file.
Definition: file-helper.h:40
void Set2dFormat(const std::string &format)
Sets the 2D format string for the C-style sprintf() function.
Definition: file-helper.cc:376
void SetHeading(const std::string &heading)
Sets the heading string that will be printed on the first line of the file.
Definition: file-helper.cc:359
void Set5dFormat(const std::string &format)
Sets the 5D format string for the C-style sprintf() function.
Definition: file-helper.cc:400
void AddTimeSeriesAdaptor(const std::string &adaptorName)
Adds a time series adaptor to be used to write the file.
Definition: file-helper.cc:215
Ptr< FileAggregator > GetAggregatorSingle()
Gets the single aggregator that is always constructed.
Definition: file-helper.cc:305
std::string m_6dFormat
Format string for 6D format C-style sprintf() function.
Definition: file-helper.h:317
std::map< std::string, std::pair< Ptr< Probe >, std::string > > m_probeMap
Maps probe names to probes.
Definition: file-helper.h:292
void Set3dFormat(const std::string &format)
Sets the 3D format string for the C-style sprintf() function.
Definition: file-helper.cc:384
Ptr< Probe > GetProbe(std::string probeName) const
Gets the specified probe.
Definition: file-helper.cc:286
std::map< std::string, Ptr< TimeSeriesAdaptor > > m_timeSeriesAdaptorMap
Maps time series adaptor names to time series adaptors.
Definition: file-helper.h:295
void WriteProbe(const std::string &typeId, const std::string &path, const std::string &probeTraceSource)
Definition: file-helper.cc:91
std::map< std::string, Ptr< FileAggregator > > m_aggregatorMap
Maps aggregator names to aggregators when multiple aggregators are needed.
Definition: file-helper.h:289
FileHelper()
Constructs a file helper that will create a space separated file named "file-helper....
Definition: file-helper.cc:36
void Set6dFormat(const std::string &format)
Sets the 6D format string for the C-style sprintf() function.
Definition: file-helper.cc:408
ObjectFactory m_factory
Used to create the probes and collectors as they are added.
Definition: file-helper.h:282
uint32_t m_fileProbeCount
Number of file probes that have been created.
Definition: file-helper.h:298
std::string m_heading
Heading line for the outputfile.
Definition: file-helper.h:310
std::string m_outputFileNameWithoutExtension
The name of the output file to created without its extension.
Definition: file-helper.h:304
std::string m_8dFormat
Format string for 8D format C-style sprintf() function.
Definition: file-helper.h:319
std::string m_9dFormat
Format string for 9D format C-style sprintf() function.
Definition: file-helper.h:320
void ConfigureFile(const std::string &outputFileNameWithoutExtension, FileAggregator::FileType fileType=FileAggregator::SPACE_SEPARATED)
Definition: file-helper.cc:69
bool m_hasHeadingBeenSet
Indicates if the heading line for the file has been set.
Definition: file-helper.h:307
std::string m_2dFormat
Format string for 2D format C-style sprintf() function.
Definition: file-helper.h:313
void AddAggregator(const std::string &aggregatorName, const std::string &outputFileName, bool onlyOneAggregator)
Adds an aggregator to be used to write values to files.
Definition: file-helper.cc:236
void Set1dFormat(const std::string &format)
Sets the 1D format string for the C-style sprintf() function.
Definition: file-helper.cc:368
void AddProbe(const std::string &typeId, const std::string &probeName, const std::string &path)
Adds a probe to be used to write values to files.
Definition: file-helper.cc:179
std::string m_1dFormat
Format string for 1D format C-style sprintf() function.
Definition: file-helper.h:312
std::string m_10dFormat
Format string for 10D format C-style sprintf() function.
Definition: file-helper.h:321
std::string m_4dFormat
Format string for 4D format C-style sprintf() function.
Definition: file-helper.h:315
std::string m_7dFormat
Format string for 7D format C-style sprintf() function.
Definition: file-helper.h:318
void Set4dFormat(const std::string &format)
Sets the 4D format string for the C-style sprintf() function.
Definition: file-helper.cc:392
void Set7dFormat(const std::string &format)
Sets the 7D format string for the C-style sprintf() function.
Definition: file-helper.cc:416
FileAggregator::FileType m_fileType
Determines the kind of file written by the aggregator.
Definition: file-helper.h:301
Ptr< FileAggregator > m_aggregator
The single aggregator that is always created in the constructor.
Definition: file-helper.h:285
virtual ~FileHelper()
Definition: file-helper.cc:63
std::string m_5dFormat
Format string for 5D format C-style sprintf() function.
Definition: file-helper.h:316
std::string m_3dFormat
Format string for 3D format C-style sprintf() function.
Definition: file-helper.h:314
void Set8dFormat(const std::string &format)
Sets the 8D format string for the C-style sprintf() function.
Definition: file-helper.cc:424
Ptr< FileAggregator > GetAggregatorMultiple(const std::string &aggregatorName, const std::string &outputFileName)
Gets one of the multiple aggregators from the map.
Definition: file-helper.cc:339
void Set10dFormat(const std::string &format)
Sets the 10D format string for the C-style sprintf() function.
Definition: file-helper.cc:440
void ConnectProbeToAggregator(const std::string &typeId, const std::string &matchIdentifier, const std::string &path, const std::string &probeTraceSource, const std::string &outputFileNameWithoutExtension, bool onlyOneAggregator)
Connects the probe to the aggregator.
Definition: file-helper.cc:448
void Set9dFormat(const std::string &format)
Sets the 9D format string for the C-style sprintf() function.
Definition: file-helper.cc:432
Instantiate subclasses of ns3::Object.
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:77
Every class exported by the ns3 library is enclosed in the ns3 namespace.