Registry / ai-ml / holistictraceanalysis

holistictraceanalysis

library0.5.0pypypi✓ verified 83d ago

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

ai-ml

pip install holistictraceanalysis

github ↗package ↗

INSTALL

IMPORT

SIG · HOLISTICTRACEANALY

holistictraceanalysis

ai-mlpythonv0.5.0

Install

24.7s avg

Import

1957ms

Disk

450MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.5.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 1.988s · 454.3MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 24.7s · import 1.926s · 431MB

450MB installed

● package 450MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

TraceAnalysis

✓ from hta.trace_analysis import TraceAnalysis

✗ from holistictraceanalysis import TraceAnalysis

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

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)

Debug

Known issues

breakingIn 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.

affects: 0.5.0

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

fix

Use 'from hta.trace_analysis import TraceAnalysis'.

affects: all

deprecatedThe '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().

affects: >=0.6.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'holistictraceanalysis'

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

fix

Use 'from hta.trace_analysis import TraceAnalysis'.

KeyError: 'dur'

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).

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

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

fix

Use 'from hta.trace_analysis import TraceAnalysis'.

Upgrade

Version history

0.5.0latest on PyPI · released May 29, 2025

Audit

Dependencies

torchoptionalRequired for profiler trace generation and analysis of PyTorch models

Agent activity

10 hits · last 30 days

node

Resources

githubhttps://github.com/facebookresearch/HolisticTraceAnalysis ↗

packagehttps://pypi.org/project/holistictraceanalysis/ ↗