taucmdr.cf.software.papi_installation module¶

PAPI software installation management.

PAPI is used to measure hardware performance counters.

class taucmdr.cf.software.papi_installation.PapiInstallation(sources, target_arch, target_os, compilers)[source]¶

Encapsulates a PAPI installation.

check_metrics(metrics)[source]¶

Checks compatibility of PAPI metrics.

Extracts all PAPI metrics from metrics and executes papi_event_chooser to check compatibility.

Parameters:	metrics (list) – List of metrics.
Raises:	`ConfigurationError` – PAPI metrics are not compatible on the current host.

configure(flags)[source]¶

Invoke configure.

Parameters:	flags (list) – Command line flags to pass to configure.
Raises:	`SoftwarePackageError` – Configuration failed.

make(flags)[source]¶

Invoke make.

Parameters:	flags (list) – Command line flags to pass to make.
Raises:	`SoftwarePackageError` – Compilation failed.

papi_metrics(event_type='PRESET', include_modifiers=False)[source]¶

List PAPI available metrics.

Returns a list of (name, description) tuples corresponding to the requested PAPI event type and possibly the event modifiers.

Parameters:	event_type (str) – Either “PRESET” or “NATIVE”. include_modifiers (bool) – If True include event modifiers, e.g. BR_INST_EXEC:NONTAKEN_COND as well as BR_INST_EXEC.
Returns:	List of event name/description tuples.
Return type:	list

parse_metrics(metrics)[source]¶: Extracts PAPI metrics from a list of metrics and strips TAU’s metric prefixes.