Thank you for downloading the Blender Benchmark Launcher CLI! Before proceeding
it is important to know that there is both an interactive and a non-interactive
interface. The interactive CLI is preferred if you are running benchmarks
manually, the non-interactive CLI is to be used if you are running benchmarks
in an automated fashion.
# Interactive CLI
To use the interactive interface simply issue:
```
>>> ./benchmark-launcher-cli
```
# Non-interactive CLI
A non-interactive flow looks roughly like the following:
```
# If you want to submit your results to https://opendata.blender.org you need to
# run the following step once, manually.
>>> ./benchmark-launcher-cli authenticate
# Next you need to determine which Blender version and which scenes you want to
# benchmark:
>>> ./benchmark-launcher-cli blender list
2.81 173238584 # The first column is the label and the second column the
2.81a 168730314 # number of bytes to be downloaded.
# Let's say we pick Blender version 2.81a. To list the scenes compatible with
# this version of Blender we issue:
>>> ./benchmark-launcher-cli scenes --blender-version 2.81a list
bmw27 3637007
classroom 91506626
barbershop_interior 131506030
fishy_cat 33079579
koro 61246985
pavillon_barcelona 16435632
victor 243604112
# Next we need to download the Blender versions and the required scenes:
>>> ./benchmark-launcher-cli blender download 2.81a
>>> ./benchmark-launcher-cli scenes download --blender-version 2.81a bmw27
# We also need to decide on which device to run the benchmark:
>>> ./benchmark-launcher-cli devices --blender-version 2.81a
AMD Ryzen 7 1800X Eight-Core Processor CPU # The first column is the device
# name and the second column is the
# device type.
# Now we can finally run our benchmark:
>>> ./benchmark-launcher-cli benchmark --blender-version 2.81a --device-type CPU --json --submit bmw27
[
{
"timestamp": "2020-01-15T14:07:44.254378+00:00",
"blender_version": {
"version": "2.81 (sub 16)",
"build_date": "2019-12-04",
"build_time": "13:48:07",
"build_commit_date": "2019-12-04",
"build_commit_time": "11:32",
"build_hash": "f1aa4d18d49d",
"label": "2.81a",
"checksum": "08d718505d1eb1d261efba96b0787220a76d357ce5b94aca108fc9e0c339d6c6"
},
"benchmark_launcher": {
"label": "2.0.4",
"checksum": "37c9687e041fa0a94a89914618f80d5213a556bba3822c58c09086e9c8d48944"
},
"benchmark_script": {
"label": "2.0.0",
"checksum": "e38921ff7a2959d5e47a83501a2dde3f7f166a4f46b65fac272eec38ae9e5f27"
},
"scene": {
"label": "bmw27",
"checksum": "bc4fd79cbd85a1cc47926e848ec8f322872f5c170ef33c21e0d0ce303c0ec9ea"
},
"system_info": {
"bitness": "64bit",
"machine": "x86_64",
"system": "Linux",
"dist_name": "Pop!_OS",
"dist_version": "19.10",
"devices": [
{
"type": "CPU",
"name": "AMD Ryzen 7 1800X Eight-Core Processor"
}
],
"num_cpu_sockets": 1,
"num_cpu_cores": 8,
"num_cpu_threads": 16
},
"device_info": {
"device_type": "CPU",
"compute_devices": [
{
"type": "CPU",
"name": "AMD Ryzen 7 1800X Eight-Core Processor"
}
],
"num_cpu_threads": 16
},
"stats": {
"device_peak_memory": 140.85,
"total_render_time": 229.737,
"render_time_no_sync": 228.057
}
}
]
Submitting results
Submission successful! View your results at:
https://opendata.blender.org/benchmarks/eb34412f-90e0-44ec-b8dc-7ad87f84d19f/
```
