Utilities API

Custom exception hierarchy for pgsi_analyzer.

exception pgsi_analyzer.utils.errors.PGSIAnalyzerError[source]

Bases: Exception

Base exception for all pgsi_analyzer errors.

exception pgsi_analyzer.utils.errors.MeasurementError[source]

Raised for measurement-related failures (energy/time).

exception pgsi_analyzer.utils.errors.AnalysisError[source]

Raised for analysis/data processing failures.

exception pgsi_analyzer.utils.errors.PlatformError[source]

Raised when the current platform is unsupported or misconfigured.

exception pgsi_analyzer.utils.errors.ConfigurationError[source]

Raised for configuration or missing resource issues.

exception pgsi_analyzer.utils.errors.AuditError[source]

Raised when audit validation fails (e.g. data in unregistered directory/method).

Validation helpers for pgsi_analyzer.

pgsi_analyzer.utils.validation.validate_file_path(path: Path | str, must_exist: bool = True) → Path[source]: Ensure a path is a Path and (optionally) exists.

pgsi_analyzer.utils.validation.validate_dataframe(df: DataFrame, required_columns: Sequence[str]) → None[source]

pgsi_analyzer.utils.validation.validate_weights(alpha: float, beta: float, gamma: float) → None[source]

pgsi_analyzer.utils.validation.validate_platform(require_linux_intel: bool = False) → None[source]

pgsi_analyzer.utils.validation.require_columns(df: DataFrame, columns: Iterable[str]) → None[source]: Alias for validate_dataframe for convenience.