Test-CPU-parallel 1.0.5

test_CPU_parallel.py - A basic CPU workload generator.
Luca.Canali@cern.ch - April 2023

Use test_cpu_parallel to generate CPU-intensive load on a system by running single-threaded, or with multiple threads in parallel.
The tool runs a CPU-burning loop concurrently on the system with configurable parallelism.
The output are measurements of the CPU-burning loop execution time as a function of load, printed to terminal, or to a csv file, or returned programmatically when used as a Python library.
Link to the project homepage

How to use test_CPU_parallel.py from the command line

Example:
# Install with pip or clone from GitHub
pip install test-CPU-parallel

# run one-off data collection with 2 concurrent workers
test_CPU_parallel.py --num_workers 2 

# Measure job runtime over a ramp of concurrent workers from 1 to 8, and output the results to a CSV file
test_CPU_parallel.py --num_workers 8 --full --output myout.csv 

Parameters:

--full - Full mode will test all the values of num_workers from 1 to the value 
         set with --num_workers, use this to collect speedup test measurements and create plots, default = False
--output - Optional output file, applies only to the full mode, default = None
--num_workers - Number of parallel threads running concurrently, default = 2
--num_job_execution_loops - number of times the execution loop is run on each worker, default = 3
--worker_inner_loop_size - internal weight of the inner execution loop, default = 100000000

How to use test_CPU_parallel programmatically

You have the ability to employ the test_CPU_parallel function within your Python scripts, including its integration into Continuous Integration (CI) tests. This proves advantageous for tasks like quantifying system performance and assessing how well the CPU adapts to varying workloads. This becomes especially handy when you're comparing test runs conducted on different occasions or on distinct computer setups.
In your code, the process of executing the test and obtaining results is as follows:

pip install test-CPU-parallel
from test_CPU_parallel import test_CPU_parallel

# See also the configuration options in the help
test = test_CPU_parallel()

# Run a test
test.test_one_load()

# Run a full run
test.test_full()

How to run test_CPU_parallel.py using from a container image

• docker run lucacanali/test_cpu_parallel.py test_CPU_parallel.py
• See also Container for more details on how to build and run container images for this tool and on how to run it using Docker or Kubernetes