{"id":23854,"library":"holistictraceanalysis","title":"HolisticTraceAnalysis","description":"A library for analyzing PyTorch Profiler traces to identify performance bottlenecks in GPU-accelerated workloads. Current version 0.6.1, release cadence irregular.","status":"active","version":"0.6.1","language":"python","source_language":"en","source_url":"https://github.com/facebookresearch/HolisticTraceAnalysis","tags":["profiling","pytorch","gpu","performance","trace analysis"],"install":[{"cmd":"pip install holistictraceanalysis","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Required for profiler trace generation and analysis of PyTorch models","package":"torch","optional":true}],"imports":[{"note":"Package uses 'hta' as top-level module, not the long name","wrong":"from holistictraceanalysis import TraceAnalysis","symbol":"TraceAnalysis","correct":"from hta.trace_analysis import TraceAnalysis"}],"quickstart":{"code":"from hta.trace_analysis import TraceAnalysis\n\n# Analyze a trace directory (e.g., from PyTorch Profiler)\nanalyzer = TraceAnalysis(trace_dir=\"/path/to/trace\")\n# Get overall summary statistics\nsummary = analyzer.get_overall_summary()\nprint(summary)","lang":"python","description":"Minimal example loading a trace directory and printing summary statistics."},"warnings":[{"fix":"Upgrade to >=0.6.0 or configure parser to tolerate missing columns.","message":"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+.","severity":"breaking","affected_versions":"0.5.0"},{"fix":"Use 'from hta.trace_analysis import TraceAnalysis'.","message":"The top-level import is 'hta' not 'holistictraceanalysis'. Many users mistakenly import from the long name.","severity":"gotcha","affected_versions":"all"},{"fix":"Replace calls to get_model_ids() with list_traces().","message":"The 'get_model_ids' method was deprecated in v0.6.0 in favor of 'list_traces'.","severity":"deprecated","affected_versions":">=0.6.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use 'from hta.trace_analysis import TraceAnalysis'.","cause":"Trying to import the package by its full name instead of 'hta'.","error":"ModuleNotFoundError: No module named 'holistictraceanalysis'"},{"fix":"Upgrade to v0.6.0+ or set ParserConfig(enable_duration_filter=False).","cause":"Trace contains metadata-only events without 'dur' column; old parser assumed it exists. Affects v0.5.0.","error":"KeyError: 'dur'"},{"fix":"Use 'from hta.trace_analysis import TraceAnalysis'.","cause":"Attempting to import TraceAnalysis directly from the top-level 'hta' module instead of 'hta.trace_analysis'.","error":"AttributeError: module 'hta' has no attribute 'TraceAnalysis'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}