Framerate Statistics

Introduction

The GPU PerfStudio server has the ability to collect framerate statistics from a connected application over a specified period of time. Three data files are produced:

1) A file conatining the Minimum, Maximum, and Average framerates observed within the collection period.
2) A file containing the Frame Timings - the CPU times at which each frame started to render.
3) A file containg the Frames Per Second for each second within the collection period.

The filename format names are as follows:

ApplicationFilename YEAR-MM-DD HR-MM-SS-0 minmaxavg.csv
e.g. "D3D12Multithreading 2015-12-17 14-47-45-0 minmaxavg.csv"

ApplicationFilename YEAR-MM-DD HR-MM-SS-0 frametimes.csv
e.g. "D3D12Multithreading 2015-12-17 14-47-45-0 frametimes.csv"

ApplicationFilename YEAR-MM-DD HR-MM-SS-0 fps.csv
e.g. "D3D12Multithreading 2015-12-17 14-47-45-0 fps.csv"

When the collection duration has expired, the statistics files are saved in GPUPerfStudio's temporary directory:

C:\Users\username\AppData\Local\Temp\GPUPerfStudio\D3D12Multithreading 2015-12-17 14-47-45-0 minmaxavg.csv
C:\Users\username\AppData\Local\Temp\GPUPerfStudio\D3D12Multithreading 2015-12-17 14-47-45-0 frametimes.csv
C:\Users\username\AppData\Local\Temp\GPUPerfStudio\D3D12Multithreading 2015-12-17 14-47-45-0 fps.csv

Configuration

Collection of framerate statistics is enabled by altering settings within the "GPUPerfServer.cfg" file.

If you are using the MSI installer version of GPU PerfStudio the "GPUPerfServer.cfg" file will be located at:

C:\Program Files (x86)\AMD\GPU PerfStudio\GPUPerfServer.cfg

If you are using the ZIP file version of GPU PerfStudio the "GPUPerfServer.cfg" file will be in the unzipped directory alongside the client and server exe file.

To enable the framerate statistics collection, comment out (remove the leading '#') from the following configuration file settings:

# framerate-stats-collection=true

To alter the period of time used in collecting framerate statistics, uncomment the following option (remove the leading '#') from the configuration file, and alter the target milliseconds value. By default, framerate statistics collection will occur over a period of 60000 milliseconds:

# framerate-stats-duration=60000

At the end of the duration period, the statistics file will be written to the GPU PerfStudio temporary directory.

Framerate Statistics collection is started by pressing the key specified to be used as the trigger. The trigger key can be any valid Virtual-Key code as specified at the following location: https://msdn.microsoft.com/en-us/library/windows/desktop/dd375731
By default, the collection trigger is the "5" key's Virtual-Key code (e.g. Virtual-Key Code 0x35 is 53 in decimal and is used below).

# framerate-stats-trigger=53

Usage

To collect Framerate Statistics, start your application with GPU PerfStudio normally, as described within the StartingApplication section. After the application has initialized and begins rendering, use the specified trigger key (default key is '5') to begin framerate statistics collection. After the trigger, when the specified duration period has elapsed, the statistics file will be written to the temp directory.