| /* |
| * Copyright (c) 2012 The WebRTC project authors. All Rights Reserved. |
| * |
| * Use of this source code is governed by a BSD-style license |
| * that can be found in the LICENSE file in the root of the source |
| * tree. An additional intellectual property rights grant can be found |
| * in the file PATENTS. All contributing project authors may |
| * be found in the AUTHORS file in the root of the source tree. |
| */ |
| |
| // A stripped-down version of Chromium's chrome/test/perf/perf_test.h. |
| // Several functions have been removed; the prototypes of the remainder have |
| // not been changed. |
| |
| #ifndef TEST_TESTSUPPORT_PERF_TEST_H_ |
| #define TEST_TESTSUPPORT_PERF_TEST_H_ |
| |
| #include <sstream> |
| #include <string> |
| |
| namespace webrtc { |
| namespace test { |
| |
| // Prints numerical information to stdout in a controlled format, for |
| // post-processing. |measurement| is a description of the quantity being |
| // measured, e.g. "vm_peak"; |modifier| is provided as a convenience and |
| // will be appended directly to the name of the |measurement|, e.g. |
| // "_browser"; |trace| is a description of the particular data point, e.g. |
| // "reference"; |value| is the measured value; and |units| is a description |
| // of the units of measure, e.g. "bytes". If |important| is true, the output |
| // line will be specially marked, to notify the post-processor. The strings |
| // may be empty. They should not contain any colons (:) or equals signs (=). |
| // A typical post-processing step would be to produce graphs of the data |
| // produced for various builds, using the combined |measurement| + |modifier| |
| // string to specify a particular graph and the |trace| to identify a trace |
| // (i.e., data series) on that graph. |
| void PrintResult(const std::string& measurement, |
| const std::string& modifier, |
| const std::string& trace, |
| const double value, |
| const std::string& units, |
| bool important); |
| |
| // Like PrintResult(), but prints a (mean, standard deviation) result pair. |
| // The |<values>| should be two comma-separated numbers, the mean and |
| // standard deviation (or other error metric) of the measurement. |
| void PrintResultMeanAndError(const std::string& measurement, |
| const std::string& modifier, |
| const std::string& trace, |
| const std::string& mean_and_error, |
| const std::string& units, |
| bool important); |
| |
| // Like PrintResult(), but prints an entire list of results. The |values| |
| // will generally be a list of comma-separated numbers. A typical |
| // post-processing step might produce plots of their mean and standard |
| // deviation. |
| void PrintResultList(const std::string& measurement, |
| const std::string& modifier, |
| const std::string& trace, |
| const std::string& values, |
| const std::string& units, |
| bool important); |
| |
| // Converts list of values into comma-separated string for PrintResultList. |
| template <typename Container> |
| std::string ValuesToString(const Container& container) { |
| if (container.empty()) |
| return ""; |
| |
| std::stringstream ss; |
| auto it = container.begin(); |
| while (true) { |
| ss << *it; |
| if (++it == container.end()) |
| break; |
| ss << ','; |
| } |
| return ss.str(); |
| } |
| |
| } // namespace test |
| } // namespace webrtc |
| |
| #endif // TEST_TESTSUPPORT_PERF_TEST_H_ |