Poplar and PopLibs User Guide

• 1. Introduction
• 2. Programming with Poplar
  • 2.1. Poplar programming model
  • 2.2. The structure of a Poplar program
    • 2.2.1. Program flow control
      • Looping
      • Conditional execution
    • 2.2.2. What happens at run time
  • 2.3. Supported types
    • 2.3.1. Scalar types
    • 2.3.2. Floating point types
      • Half on the IPU
      • Half on the CPU
    • 2.3.3. Vector types
    • 2.3.4. Structure types
    • 2.3.5. Bit fields
  • 2.4. Virtual graphs
  • 2.5. Replicated graphs
    • 2.5.1. Replicating an existing graph
    • 2.5.2. Creating a replicated graph
  • 2.6. Data streams and remote buffers
    • 2.6.1. Data streams
      • Device-side streams
      • Host-side stream access
    • 2.6.2. Remote memory buffers
    • 2.6.3. Stream buffer size limit
    • 2.6.4. Optimising host data transfers
      • Prefetch
  • 2.7. IPU-Link and sync configuration
    • 2.7.1. Link topologies
    • 2.7.2. Sync groups
    • 2.7.3. Software sync
  • 2.8. Device code
    • 2.8.1. Stack allocation
    • 2.8.2. Pre-compiling codelets
• 3. Understanding vertices
  • 3.1. The Vertex class
  • 3.2. Vertex state
    • 3.2.1. Vector and VectorList types
    • 3.2.2. Specifying memory constraints
  • 3.3. MultiVertex worker threads
    • 3.3.1. Thread safety
  • 3.4. Calling conventions
    • 3.4.1. External codelets
    • 3.4.2. Recursion and function pointers
  • 3.5. Vertex name mangling
• 4. Vector types
  • 4.1. Parameters
    • 4.1.1. Types
    • 4.1.2. Layout
    • 4.1.3. Minimum alignment
    • 4.1.4. Interleaved memory
  • 4.2. Memory layout for vectors
    • 4.2.1. Pointer compression
      • SCALED_PTR32
      • SCALED_PTR64
      • SCALED_PTR128
    • 4.2.2. Vector<T> layout
    • 4.2.3. Vector<Input<Vector<T>>> layout
    • 4.2.4. VectorList layout
      • DELTANELEMENTS layout
      • DELTAN layout
      • COMPACT_DELTAN layout
• 5. Using the Poplar library
• 6. The PopLibs libraries
  • 6.1. Using PopLibs
• 7. Writing vertices in assembly
  • 7.1. Instruction set overview
    • 7.1.1. Supervisors and workers
    • 7.1.2. Execution pipelines
  • 7.2. Memory architecture
    • 7.2.1. Getting information about the memory
    • 7.2.2. Mk1 Colossus (GC2)
    • 7.2.3. Mk2 Colossus (GC200)
    • 7.2.4. Load and store instructions
  • 7.3. Worker stack and scratch space
    • 7.3.1. Specifying stack size
    • 7.3.2. Examples
  • 7.4. Vertex pipelines
    • 7.4.1. Memory conflicts
    • 7.4.2. Modified pipeline
    • 7.4.3. Fill and drain
  • 7.5. Assembly hints & tips
    • 7.5.1. Using the assembler
      • Assembler macros
      • Labels
      • Recording the code size of the vertex
      • Place each vertex in a unique section
    • 7.5.2. Architectural tips
      • Aligning repeat bodies
      • Over-reading and over-processing
      • Scratch space
      • Loading constants
    • 7.5.3. Division by 6
      • Division on the IPU
      • Division on the host
    • 7.5.4. General
      • Focus on optimising the vectorised case
      • Testing
      • Bit twiddling
• 8. Profiling
  • 8.1. Generating profiling information
    • 8.1.1. Profiling options
  • 8.2. Profile summary
    • 8.2.1. Printing from a Poplar program
    • 8.2.2. Command line conversion
    • 8.2.3. Summary report format
• 9. Environment variables
  • 9.1. Logging
    • 9.1.1. Logging level
    • 9.1.2. Logging destination
  • 9.2. Profiling output
  • 9.3. Setting options
• 10. Application binary interface (ABI)
  • 10.1. Types
    • 10.1.1. Floating point types
    • 10.1.2. Structure types
    • 10.1.3. Bit fields
  • 10.2. Vertex calling convention
  • 10.3. Function calling convention
    • 10.3.1. Function parameters
    • 10.3.2. Return values
    • 10.3.3. Entry and exit
    • 10.3.4. Register assignments
  • 10.4. Stack frame
• 11. Trademarks & copyright