HEBench
hebench_genericwl_l.cpp
Go to the documentation of this file.
1 
2 // Copyright (C) 2021 Intel Corporation
3 // SPDX-License-Identifier: Apache-2.0
4 
5 #include <bitset>
6 #include <cassert>
7 #include <cstring>
8 #include <iomanip>
9 #include <iostream>
10 #include <sstream>
11 #include <stdexcept>
12 #include <utility>
13 
14 #include "hebench/modules/timer/include/timer.h"
15 
16 #include "hebench/api_bridge/api.h"
17 #include "hebench/modules/general/include/hebench_math_utils.h"
18 #include "include/hebench_engine.h"
19 
20 #include "../include/hebench_genericwl_l.h"
21 
22 namespace hebench {
23 namespace TestHarness {
24 namespace GenericWL {
25 namespace Latency {
26 
27 //----------------------------
28 // class BenchmarkDescription
29 //----------------------------
30 
31 bool BenchmarkDescriptor::m_b_registered = // register the benchmark with the factory
32  hebench::TestHarness::BenchmarkFactory::registerSupportedBenchmark(std::make_shared<BenchmarkDescriptor>());
33 
35  const std::vector<hebench::APIBridge::WorkloadParam> &w_params) const
36 {
37  assert(m_b_registered);
38 
39  // return true if benchmark is supported
40 
41  bool retval =
44 
45  return retval;
46 }
47 
49  const Engine &engine,
50  const BenchmarkDescription::Backend &backend_desc,
51  const BenchmarkDescription::Configuration &config) const
52 {
53  // finish describing workload
54  assert(DefaultBatchSize == 1);
55 
56  BenchmarkDescriptorCategory::completeWorkloadDescription(output, engine, backend_desc, config);
57 
58  auto op_info = fetchIOVectorSizes(config.w_params);
59  const std::vector<std::uint64_t> &input_sizes = op_info.first;
60  const std::vector<std::uint64_t> &output_sizes = op_info.second;
61 
62  assert(input_sizes.size() == output.operation_params_count);
63 
64  // finish benchmark header description
65 
66  std::stringstream ss;
67  std::vector<uint64_t> batch_sizes(output.operation_params_count);
68 
69  std::uint64_t result_batch_size = 1;
70  for (std::size_t param_i = 0; param_i < batch_sizes.size(); ++param_i)
71  {
72  batch_sizes[param_i] = DefaultBatchSize;
73  result_batch_size *= batch_sizes[param_i];
74  } // end for
75  // complete header with workload specifics
76  ss << ", , (C[0]";
77  for (std::size_t i = 1; i < output_sizes.size(); ++i)
78  ss << "; C[" << i << "]";
79  ss << ") = op(V[0]";
80  for (std::size_t i = 1; i < input_sizes.size(); ++i)
81  ss << "; V[" << i << "]";
82  ss << ")" << std::endl
83  << ", , , Elements, Batch size" << std::endl;
84  for (std::size_t i = 0; i < output.operation_params_count; ++i)
85  {
86  ss << ", , V[" << i << "], " << input_sizes[i] << ", " << batch_sizes[i] << std::endl;
87  } // end for
88  for (std::size_t i = 0; i < output_sizes.size(); ++i)
89  {
90  ss << ", , C[" << i << "], " << output_sizes[i] << ", " << result_batch_size << std::endl;
91  } // end for
92 
93  output.workload_header = ss.str();
94 }
95 
97  const DescriptionToken &description_token)
98 {
99  assert(m_b_registered);
100  Benchmark *retval = nullptr;
101 
102  try
103  {
104  retval = new Benchmark(p_engine, description_token);
105  }
106  catch (...)
107  {
108  if (retval)
109  delete retval;
110  throw;
111  }
112 
113  return retval;
114 }
115 
117 {
118  assert(m_b_registered);
119  if (p_bench)
120  delete p_bench;
121 }
122 
123 //-----------------
124 // class Benchmark
125 //-----------------
126 
127 Benchmark::Benchmark(std::shared_ptr<Engine> p_engine,
128  const IBenchmarkDescriptor::DescriptionToken &description_token) :
129  BenchmarkLatency(p_engine, description_token),
130  m_op_input_count(0),
131  m_op_output_count(0)
132 {
133 }
134 
136 {
137  hebench::Common::EventTimer timer;
138  hebench::Common::TimingReportEvent::Ptr p_timing_event;
139  std::vector<std::uint64_t> batch_sizes;
140  std::stringstream ss;
142  const std::vector<std::uint64_t> &input_sizes = op_info.first;
143  const std::vector<std::uint64_t> &output_sizes = op_info.second;
144 
145  m_op_input_count = input_sizes.size();
146  m_op_output_count = output_sizes.size();
147  batch_sizes.resize(m_op_input_count);
148 
149  for (std::size_t param_i = 0; param_i < batch_sizes.size(); ++param_i)
150  batch_sizes[param_i] = BenchmarkDescriptor::DefaultBatchSize;
151 
152  std::cout << IOS_MSG_INFO << hebench::Logging::GlobalLogger::log("Preparing workload.") << std::endl;
153 
154  if (this->getBenchmarkConfiguration().dataset_filename.empty())
155  // cannot generate data for generic workload
156  throw std::invalid_argument(IL_LOG_MSG_CLASS("Dataset file is required for generic workload benchmarking, but none was provided."));
157 
158  ss = std::stringstream();
159  ss << "Loading data from external dataset: " << std::endl
160  << "\"" << this->getBenchmarkConfiguration().dataset_filename << "\"";
161  std::cout << IOS_MSG_INFO << hebench::Logging::GlobalLogger::log(ss.str()) << std::endl;
162  timer.start();
163  // load vectors for input and ground truth from file
164  m_data = DataLoader::create(input_sizes,
165  batch_sizes,
166  output_sizes,
167  this->getBackendDescription().descriptor.data_type,
168  this->getBenchmarkConfiguration().dataset_filename);
169  p_timing_event = timer.stop<std::milli>();
170 
171  ss = std::stringstream();
172  ss << "Total data loaded: " << m_data->getTotalDataLoaded() << " bytes";
173  std::cout << IOS_MSG_DONE << hebench::Logging::GlobalLogger::log(ss.str()) << std::endl;
174  ss = std::stringstream();
175  ss << "Elapsed wall time: " << p_timing_event->elapsedWallTime<std::milli>() << " ms";
176  std::cout << IOS_MSG_INFO << hebench::Logging::GlobalLogger::log(ss.str()) << std::endl;
177  ss = std::stringstream();
178  ss << "Elapsed CPU time: " << p_timing_event->elapsedCPUTime<std::milli>() << " ms";
179  std::cout << IOS_MSG_INFO << hebench::Logging::GlobalLogger::log(ss.str()) << std::endl;
180 }
181 
183  const std::uint64_t *param_data_pack_indices,
184  const std::vector<hebench::APIBridge::NativeDataBuffer *> &outputs,
185  hebench::APIBridge::DataType data_type) const
186 {
187  assert(dataset->getParameterCount() == m_op_input_count
188  && dataset->getResultCount() == m_op_output_count);
189 
190  return BenchmarkLatency::validateResult(dataset, param_data_pack_indices, outputs, data_type);
191 }
192 
193 } // namespace Latency
194 } // namespace GenericWL
195 } // namespace TestHarness
196 } // namespace hebench
std::vector< hebench::APIBridge::WorkloadParam > w_params
Set of arguments for workload parameters.
std::string dataset_filename
File containing data for the benchmark. If empty string, benchmarks that can auto generate the datase...
static bool registerSupportedBenchmark(std::shared_ptr< IBenchmarkDescriptor > p_desc_obj)
Registers a benchmark description object that represents one of the supported workloads.
Base class for workload benchmarks in the latency category.
void completeWorkloadDescription(WorkloadDescriptionOutput &output, const Engine &engine, const BenchmarkDescription::Backend &backend_desc, const BenchmarkDescription::Configuration &config) const override
Completes the description for the matched benchmark.
static std::pair< std::vector< std::uint64_t >, std::vector< std::uint64_t > > fetchIOVectorSizes(const std::vector< hebench::APIBridge::WorkloadParam > &w_params)
Retrieves details about the input parameters and results of the generic operation based on the specif...
bool matchBenchmarkDescriptor(const hebench::APIBridge::BenchmarkDescriptor &bench_desc, const std::vector< hebench::APIBridge::WorkloadParam > &w_params) const override
Determines if the represented benchmark can perform the workload described by a specified HEBench ben...
static DataLoader::Ptr create(const std::vector< std::uint64_t > &input_sizes, const std::vector< std::uint64_t > &max_batch_sizes, const std::vector< std::uint64_t > &output_sizes, hebench::APIBridge::DataType data_type, const std::string &dataset_filename)
hebench::TestHarness::PartialBenchmark * createBenchmark(std::shared_ptr< Engine > p_engine, const DescriptionToken &description_token) override
Creates the represented IBenchmark object that can perform the workload specified by the HEBench benc...
void destroyBenchmark(hebench::TestHarness::PartialBenchmark *p_bench) override
Destroys an object returned by createBenchmark().
void completeWorkloadDescription(WorkloadDescriptionOutput &output, const Engine &engine, const BenchmarkDescription::Backend &backend_desc, const BenchmarkDescription::Configuration &config) const override
Completes the description for the matched benchmark.
bool matchBenchmarkDescriptor(const hebench::APIBridge::BenchmarkDescriptor &bench_desc, const std::vector< hebench::APIBridge::WorkloadParam > &w_params) const override
Determines if the represented benchmark can perform the workload described by a specified HEBench ben...
bool validateResult(IDataLoader::Ptr dataset, const std::uint64_t *param_data_pack_indices, const std::vector< hebench::APIBridge::NativeDataBuffer * > &p_outputs, hebench::APIBridge::DataType data_type) const override
Validates the result of an operation against the ground truth.
void init() override
Initializes the partial benchmark members.
Token returned by a successful call to IBenchmarkDescriptor::matchBenchmarkDescriptor().
std::shared_ptr< IDataLoader > Ptr
virtual bool validateResult(IDataLoader::Ptr dataset, const std::uint64_t *param_data_pack_indices, const std::vector< hebench::APIBridge::NativeDataBuffer * > &outputs, hebench::APIBridge::DataType data_type) const
Validates the result of an operation against the ground truth.
std::string workload_header
Workload specific information to be added to the report header.
std::size_t operation_params_count
Number of parameters for the represented workload operation.
Bundles values that need to be filled by a workload during completeWorkloadDescription().
const BenchmarkDescription::Backend & getBackendDescription() const
Allows read-only access to this benchmark backend description.
const BenchmarkDescription::Configuration & getBenchmarkConfiguration() const
Allows read-only access to this benchmark configuration.
#define IOS_MSG_DONE
#define IOS_MSG_INFO
DataType
Defines data types for a workload.
Definition: types.h:379
Category category
Category for the benchmark.
Definition: types.h:531
Defines a benchmark test.
Definition: types.h:527