PopVision User Guide

• 1. Introduction
• 2. Graph Analyser
  • 2.1. Overview
    • 2.1.1. About the IPU
  • 2.2. Capturing IPU reports
    • 2.2.1. Limiting report output
    • 2.2.2. Reloading reports
    • 2.2.3. Poplar report files
      • Application and file versions
      • Binary archive (archive.a)
      • Graph Profile (graph.json or graph.cbor)
      • Execution Profile (execution.json or execution.cbor)
      • GC-Profile Information (profile_info.json)
      • Lowered Vars Information (vars.capnp)
      • Serialized Computation graph (serialized_graph.capnp)
      • Frameworks Information (framework.json & app.json)
      • Debug Information (debug.cbor)
    • 2.2.4. Using Poplar API
    • 2.2.5. Using TensorFlow
    • 2.2.6. Using PopART
  • 2.3. Opening reports
    • 2.3.1. Comparing reports
    • 2.3.2. Local reports
      • Opening local reports
    • 2.3.3. Remote reports
      • Opening a remote report
  • 2.4. Viewing reports
    • 2.4.1. Using the side menu
    • 2.4.2. Adjusting report size
    • 2.4.3. Navigating report graphs
    • 2.4.4. Saving report images to disk
  • 2.5. Viewing a Summary Report
    • 2.5.1. Program Information
      • Target
      • Graph
    • 2.5.2. Host Information
      • Poplar SDK
      • Program
      • System Information
      • Framework and Application JSON files
      • Report files
  • 2.6. Viewing a Memory Report
    • 2.6.1. Navigating memory reports
      • Selecting individual tiles/IPUs
      • Memory Report view options
    • 2.6.2. Total Memory graph
      • Report breakdown
    • 2.6.3. Liveness Memory graph
    • 2.6.4. Variables Memory graph
    • 2.6.5. Tile map Memory graph
      • Changing the colour scale
    • 2.6.6. Tile memory usage
      • Tile memory usage: Details tab
      • Tile memory usage: Vertices tab
      • Tile memory usage: Exchanges tab
      • Tile memory usage: Variables tab
      • Variable types
      • Plot multiple variables
      • Full-screen option
  • 2.7. Viewing a Liveness Report
    • 2.7.1. Navigating Liveness reports
    • 2.7.2. The Liveness graph
      • Selecting a source
      • Filtering steps
      • Viewing options
    • 2.7.3. Liveness stack details
      • Viewing enhanced debug information
      • Always Live Variables
      • Not Always Live Variables
      • Vertices
      • Cycle estimates
  • 2.8. Viewing a Program Tree
    • 2.8.1. Searching for program steps
    • 2.8.2. View options
    • 2.8.3. Viewing Debug Information
  • 2.9. Viewing an Execution Trace
    • 2.9.1. The Execution Trace graph
      • Execution View
      • Selecting IPUs
      • Filtering steps
      • Viewing options
    • 2.9.2. Execution Trace details
      • Summary tab
      • Details tab
  • 2.10. Application preferences
    • 2.10.1. Setting the colour theme
    • 2.10.2. SSH preferences
    • 2.10.3. Help links
    • 2.10.4. Quit after last window is closed
    • 2.10.5. Experimental features
    • 2.10.6. Graph stats
  • 2.11. FAQs
    • 2.11.1. Not Always Live memory discrepancy
  • 2.12. Release notes
  • 2.13. Licensing information
• 3. System Analyser
  • 3.1. Overview
  • 3.2. Capturing execution information
    • 3.2.1. Capturing function entry and exit
    • 3.2.2. Using the libpvti API
  • 3.3. Opening reports
  • 3.4. Viewing reports
    • 3.4.1. Using the sidebar buttons
    • 3.4.2. Timeline information
    • 3.4.3. Panning and zooming
    • 3.4.4. Selecting events
    • 3.4.5. Viewing selected duration
    • 3.4.6. Saving reports
  • 3.5. About System Analyser
• 4. PopVision trace instrumentation library
  • 4.1. Overview
    • 4.1.1. Tracepoints
    • 4.1.2. Channels
    • 4.1.3. Configuring trace options
    • 4.1.4. Enabling and disabling trace
    • 4.1.5. Closing the trace file
    • 4.1.6. Python
    • 4.1.7. C++ API
  • 4.2. API reference
• 5. Trademarks & copyright