Command-Line Arguments for the PVRTune GUI

The PVRTune GUI also has a range of command-line arguments available to it which allow users some additional features or control over their data analysis. The command-line interface for the PVRTune GUI is shaped as follows:

./PVRTuneGUI.exe <target> <arguments>

Where target is either a path to the recording in the form of a .PVRTune file or a connection target, which usually takes the form of an IP/network address). All of the command-line arguments are listed below:

Argument

Description

--periodms

Define the sample period. Required for --export-csv-counters. Expects an integer parameter.

--frame

Select the frame for the report. Required for --export-json-reportstats-frame. Expects an integer parameter.

--range-start-us

Select the starting time for the report. Required for --export-json-reportstats-range. Expects an integer parameter in milliseconds.

--range-length-us

Define the length of time for the report. Required for --export-json-reportstats-range. Expects a float parameter in milliseconds.

--save

Either duplicate an input file or save a recording session as the given filename. Expects a string as a filename (file is saved as .pvrtune).

--export-csv-timing

Same function as “File > Export > Export timing data to CSV” in the GUI. Expects a string as a filename (file is saved as .csv).

--export-csv-counters

Same function as “File > Export > Export counters to CSV” in the GUI. Expects a string as a filename (file is saved as .csv).

--export-task-properties

Same function as “File > Export > Export Task Properties” in the GUI. Expects a string as a filename (file is saved as .txt).

--export-json-reportstats-frame

Save the data available in the Stats Report of the Monitor widget, based on frame. Expects a string as a filename (file is saved as .json).

--export-json-reportstats-range

Save the data available in the Stats Report of the Monitor widget, based on time selection. Expects a string as a filename (file is saved as .json).

--graph

Generate an image file of the graph of the entire time range with all counters plotted. Expects a string as a filename (file is saved as .png).

--BasePath

Override the current working directory. Expects a string as a path (relative or absolute).

--CommsBuffSize

PVRTune automatically disconnects from data sources when a particular memory buffer is full. This parameter controls that buffer size. Expects an integer parameter.

--default-clockspeed-hz

Set the clock speed used to display data if the clock speed is unknown. Expects an integer parameter in Hz. Default is 100000000 (100MHz).

Note

Using multiple command line arguments requires them to be served in the right order in order to function properly, which is the order they are listed in above (for example, --frame needs to come before --export-json-reportstats-frame).