HolisticTraceAnalysis

0.6.1 verified Fri May 01 auth: no python

A library for analyzing PyTorch Profiler traces to identify performance bottlenecks in GPU-accelerated workloads. Current version 0.6.1, release cadence irregular.

pip install holistictraceanalysis

Common errors

error ModuleNotFoundError: No module named 'holistictraceanalysis' ↓

cause Trying to import the package by its full name instead of 'hta'.

fix

Use 'from hta.trace_analysis import TraceAnalysis'.

error KeyError: 'dur' ↓

cause Trace contains metadata-only events without 'dur' column; old parser assumed it exists. Affects v0.5.0.

fix

Upgrade to v0.6.0+ or set ParserConfig(enable_duration_filter=False).

error AttributeError: module 'hta' has no attribute 'TraceAnalysis' ↓

cause Attempting to import TraceAnalysis directly from the top-level 'hta' module instead of 'hta.trace_analysis'.

fix

Use 'from hta.trace_analysis import TraceAnalysis'.

Warnings

breaking In v0.5.0, the default parser configuration changed; traces with missing 'dur' or 'cat' columns (metadata-only) now raise a KeyError. To handle gracefully, set ParserConfig(enable_duration_filter=False) or upgrade to v0.6.0+. ↓

fix Upgrade to >=0.6.0 or configure parser to tolerate missing columns.

gotcha The top-level import is 'hta' not 'holistictraceanalysis'. Many users mistakenly import from the long name. ↓

fix Use 'from hta.trace_analysis import TraceAnalysis'.

deprecated The 'get_model_ids' method was deprecated in v0.6.0 in favor of 'list_traces'. ↓

fix Replace calls to get_model_ids() with list_traces().

Imports

TraceAnalysis

wrong

from holistictraceanalysis import TraceAnalysis

correct

from hta.trace_analysis import TraceAnalysis

Package uses 'hta' as top-level module, not the long name

Quickstart

Minimal example loading a trace directory and printing summary statistics.

from hta.trace_analysis import TraceAnalysis

# Analyze a trace directory (e.g., from PyTorch Profiler)
analyzer = TraceAnalysis(trace_dir="/path/to/trace")
# Get overall summary statistics
summary = analyzer.get_overall_summary()
print(summary)