Skip to content

Commit bb5cc27

Browse files
author
Harsh
committed
final readme for v2
1 parent b281222 commit bb5cc27

1 file changed

Lines changed: 33 additions & 4 deletions

File tree

README.md

Lines changed: 33 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -255,8 +255,8 @@ The following options can be passed on to the `benchmark` or `multipleBenchmark`
255255
- `range`(*Object*): Used to create a set of options using a set of rules, for each benchmark. (only one of range or fullOptions can be used)
256256
- `optionName`(*String*): The option for which the range is applied. This has to be of type Number. It can be one of `benchmark` options.
257257
- `interval`(*Array*): The upper and lower limits for the option.
258-
- `step`(*Number*): The common difference between each option value. All the options will be in an AP. (only one of `step` or `commonRatio` can be used, preference given to `step`)
259-
- `commonRatio`(*Number*): The common ratio between each option value. All the options will be in a GP. (only one of `step` or `commonRatio` can be used, preference given to `step`)
258+
- `step`(*Number*): The common difference between each option value. All the options will be in an AP. (only one of `step` or `commonRatio` can be used, preference is given to `step`)
259+
- `commonRatio`(*Number*): The common ratio between each option value. All the options will be in a GP. (only one of `step` or `commonRatio` can be used, preference is given to `step`)
260260
- `fullOptions`(*Array*): An array of options object, each one corresponding to one benchmark. Each object is the same as `benchmark` options. (only one of range or fullOptions can be used)
261261

262262
#### Stats
@@ -280,16 +280,27 @@ The [output](#output) contains a `stats` property which shows the overall stats
280280
- - - `diff`: Same as the diff object in `run_time`
281281

282282
- `score`: The score object is a property of the main output object.
283-
- - `gpu`, `cpu`(*Number*): The score is a number representing the overall normalized averge performance of the GPU or CPU. This score can be directly compared to other benchmarks or hardware.
283+
- - `gpu`, `cpu`(*Number*): A score is a number representing the overall normalized average performance of the GPU or CPU. This score can be directly compared to other benchmarks or hardware.
284284

285285
#### BenchmarkOut
286286
This object stores the output of **Benchmark**.
287287

288+
289+
##### Properties
290+
- `mat_gen`, `mat_pad`(*Number*): Matrix generation and matrix padding times in `ms`.
291+
- `build_time`(*Object*):
292+
- - `mat_mult`, `mat_conv`(*Object*)
293+
- - - `gpu`, `pipe`(*Number*): Compile times for GPU and GPU(pipeline mode) in `ms` for each benchmark.
294+
- `run_time`(*Object*): Run times for each benchmark.
295+
- - `mat_mult`, `mat_conv`, `pipe`(*Object*): Run times for each benchmark.
296+
- - - `gpu`, `cpu`(*Object*): GPU and CPU run times.
297+
- - - - `min`, `max`, `avg`(*Number*): The minimum, maximum and average run times in `ms`.
298+
288299
##### Methods
289300
- `getDataField(field, index = 0)`(returns: ***): Gets any one of the output field(property).
290301
- - `field`(*String*): The name of the field.
291302
- - `index`(Number): The index of the benchmark if multiple benchmarks are run.
292-
- `getPlotlyJSON(compareFields)`, `getChartistJSON(compareFields)`(Returns: *Array*): Returns plotly style JSON for charts. (only for multiple benchmarks)
303+
- `getPlotlyJSON(compareFields)`, `getChartistJSON(compareFields)`(Returns: *Array*): Returns plotly or Chartist style JSON Object for charts. (only for multiple benchmarks)
293304
- - `compareFields`: An array of objects having two properties `x` and `y` representing the data to be plotted on their respective axes.
294305
- - - `x`, `y`(*String*): Can be one of:
295306
- - - - `matrix_size`
@@ -301,6 +312,24 @@ This object stores the output of **Benchmark**.
301312
- - - - `cpu_run_time_mat_conv`: CPU matrix convolution run time
302313
- - - - `pipe_run_time`: GPU pipelining run time
303314

315+
Default value of `compareFields` argument for `getPlotlyJSON` and `getChartistJSON` methods:
316+
```js
317+
[
318+
{
319+
x: 'matrix_size',
320+
y: 'gpu_run_time_mat_mult'
321+
},
322+
{
323+
x: 'matrix_size',
324+
y: 'pipe_run_time'
325+
},
326+
{
327+
x: 'matrix_size',
328+
y: 'gpu_score'
329+
}
330+
]
331+
```
332+
304333

305334
#### Benchmarks
306335

0 commit comments

Comments
 (0)