A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
file-helper.h
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2013 University of Washington
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License version 2 as
7  * published by the Free Software Foundation;
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17  *
18  * Author: Mitch Watrous (watrous@u.washington.edu)
19  */
20 
21 #ifndef FILE_HELPER_H
22 #define FILE_HELPER_H
23 
24 #include <map>
25 #include <string>
26 #include "ns3/object-factory.h"
27 #include "ns3/ptr.h"
28 #include "ns3/probe.h"
29 #include "ns3/file-aggregator.h"
30 #include "ns3/time-series-adaptor.h"
31 
32 namespace ns3 {
33 
38 {
39 public:
44  FileHelper ();
45 
56  FileHelper (const std::string &outputFileNameWithoutExtension,
58 
59  virtual ~FileHelper ();
60 
72  void ConfigureFile (const std::string &outputFileNameWithoutExtension,
74 
100  void WriteProbe (const std::string &typeId,
101  const std::string &path,
102  const std::string &probeTraceSource);
103 
111  void AddProbe (const std::string &typeId,
112  const std::string &probeName,
113  const std::string &path);
114 
120  void AddTimeSeriesAdaptor (const std::string &adaptorName);
121 
130  void AddAggregator (const std::string &aggregatorName,
131  const std::string &outputFileName,
132  bool onlyOneAggregator);
133 
139  Ptr<Probe> GetProbe (std::string probeName) const;
140 
148 
158  Ptr<FileAggregator> GetAggregatorMultiple (const std::string &aggregatorName,
159  const std::string &outputFileName);
160 
170  void SetHeading (const std::string &heading);
171 
178  void Set1dFormat (const std::string &format);
179 
186  void Set2dFormat (const std::string &format);
187 
194  void Set3dFormat (const std::string &format);
195 
202  void Set4dFormat (const std::string &format);
203 
210  void Set5dFormat (const std::string &format);
211 
218  void Set6dFormat (const std::string &format);
219 
226  void Set7dFormat (const std::string &format);
227 
234  void Set8dFormat (const std::string &format);
235 
242  void Set9dFormat (const std::string &format);
243 
250  void Set10dFormat (const std::string &format);
251 
252 private:
268  void ConnectProbeToAggregator (const std::string &typeId,
269  const std::string &matchIdentifier,
270  const std::string &path,
271  const std::string &probeTraceSource,
272  const std::string &outputFileNameWithoutExtension,
273  bool onlyOneAggregator);
274 
277 
280 
283  std::map<std::string, Ptr<FileAggregator> > m_aggregatorMap;
284 
286  std::map<std::string, std::pair <Ptr<Probe>, std::string> > m_probeMap;
287 
289  std::map<std::string, Ptr<TimeSeriesAdaptor> > m_timeSeriesAdaptorMap;
290 
293 
296 
299 
302 
304  std::string m_heading;
305 
307  std::string m_1dFormat;
308  std::string m_2dFormat;
309  std::string m_3dFormat;
310  std::string m_4dFormat;
311  std::string m_5dFormat;
312  std::string m_6dFormat;
313  std::string m_7dFormat;
314  std::string m_8dFormat;
315  std::string m_9dFormat;
316  std::string m_10dFormat;
317 
318 }; // class FileHelper
319 
320 
321 } // namespace ns3
322 
323 #endif // FILE_HELPER_H
smart pointer class similar to boost::intrusive_ptr
Definition: ptr.h:59
std::string m_3dFormat
Definition: file-helper.h:309
std::string m_6dFormat
Definition: file-helper.h:312
std::string m_9dFormat
Definition: file-helper.h:315
void Set4dFormat(const std::string &format)
Sets the 4D format string for the C-style sprintf() function.
Definition: file-helper.cc:395
std::string m_4dFormat
Definition: file-helper.h:310
Ptr< FileAggregator > m_aggregator
The single aggregator that is always created in the constructor.
Definition: file-helper.h:279
void Set8dFormat(const std::string &format)
Sets the 8D format string for the C-style sprintf() function.
Definition: file-helper.cc:427
void Set6dFormat(const std::string &format)
Sets the 6D format string for the C-style sprintf() function.
Definition: file-helper.cc:411
void Set5dFormat(const std::string &format)
Sets the 5D format string for the C-style sprintf() function.
Definition: file-helper.cc:403
void Set10dFormat(const std::string &format)
Sets the 10D format string for the C-style sprintf() function.
Definition: file-helper.cc:443
std::string m_7dFormat
Definition: file-helper.h:313
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:180
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:237
Ptr< Probe > GetProbe(std::string probeName) const
Gets the specified probe.
Definition: file-helper.cc:287
void Set9dFormat(const std::string &format)
Sets the 9D format string for the C-style sprintf() function.
Definition: file-helper.cc:435
uint32_t m_fileProbeCount
Number of file probes that have been created.
Definition: file-helper.h:292
std::string m_10dFormat
Definition: file-helper.h:316
std::string m_8dFormat
Definition: file-helper.h:314
FileType
The type of file written by the aggregator.
std::string m_heading
Heading line for the outputfile.
Definition: file-helper.h:304
Ptr< FileAggregator > GetAggregatorSingle()
Gets the single aggregator that is always constructed.
Definition: file-helper.cc:306
Helper class used to put data values into a file.
Definition: file-helper.h:37
void AddTimeSeriesAdaptor(const std::string &adaptorName)
Adds a time series adaptor to be used to write the file.
Definition: file-helper.cc:216
ObjectFactory m_factory
Used to create the probes and collectors as they are added.
Definition: file-helper.h:276
void Set7dFormat(const std::string &format)
Sets the 7D format string for the C-style sprintf() function.
Definition: file-helper.cc:419
std::map< std::string, std::pair< Ptr< Probe >, std::string > > m_probeMap
Maps probe names to probes.
Definition: file-helper.h:286
virtual ~FileHelper()
Definition: file-helper.cc:62
std::map< std::string, Ptr< FileAggregator > > m_aggregatorMap
Definition: file-helper.h:283
enum FileAggregator::FileType m_fileType
Determines the kind of file written by the aggregator.
Definition: file-helper.h:295
Ptr< FileAggregator > GetAggregatorMultiple(const std::string &aggregatorName, const std::string &outputFileName)
Gets one of the multiple aggregators from the map.
Definition: file-helper.cc:340
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:362
void ConfigureFile(const std::string &outputFileNameWithoutExtension, enum FileAggregator::FileType fileType=FileAggregator::SPACE_SEPARATED)
Definition: file-helper.cc:68
void Set1dFormat(const std::string &format)
Sets the 1D format string for the C-style sprintf() function.
Definition: file-helper.cc:371
std::string m_1dFormat
Format strings for C-style sprintf() function.
Definition: file-helper.h:307
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:451
std::string m_2dFormat
Definition: file-helper.h:308
instantiate subclasses of ns3::Object.
void Set3dFormat(const std::string &format)
Sets the 3D format string for the C-style sprintf() function.
Definition: file-helper.cc:387
bool m_hasHeadingBeenSet
Indicates if the heading line for the file has been set.
Definition: file-helper.h:301
std::string m_5dFormat
Definition: file-helper.h:311
std::map< std::string, Ptr< TimeSeriesAdaptor > > m_timeSeriesAdaptorMap
Maps time series adaptor names to time series adaptors.
Definition: file-helper.h:289
void WriteProbe(const std::string &typeId, const std::string &path, const std::string &probeTraceSource)
Definition: file-helper.cc:90
std::string m_outputFileNameWithoutExtension
The name of the output file to created without its extension.
Definition: file-helper.h:298
void Set2dFormat(const std::string &format)
Sets the 2D format string for the C-style sprintf() function.
Definition: file-helper.cc:379