7. Developer Manual

• 7.1. Contributing to Numba
  • 7.1.1. Communication
    • 7.1.1.1. Mailing-list
    • 7.1.1.2. Bug tracker
  • 7.1.2. Getting set up
    • 7.1.2.1. Build environment
    • 7.1.2.2. Building Numba
    • 7.1.2.3. Running tests
  • 7.1.3. Development rules
    • 7.1.3.1. Code reviews
    • 7.1.3.2. Coding conventions
    • 7.1.3.3. Stability
    • 7.1.3.4. Platform support
  • 7.1.4. Documentation
    • 7.1.4.1. Main documentation
    • 7.1.4.2. Web site homepage
• 7.2. Numba architecture
  • 7.2.1. Introduction
  • 7.2.2. Compiler architecture
  • 7.2.3. Contexts
  • 7.2.4. Compiler stages
    • 7.2.4.1. Stage 1: Analyze bytecode
    • 7.2.4.2. Stage 2: Generate the Numba IR
    • 7.2.4.3. Stage 3: Macro expansion
    • 7.2.4.4. Stage 4: Rewrite untyped IR
    • 7.2.4.5. Stage 5: Infer types
    • 7.2.4.6. Stage 6: Rewrite typed IR
    • 7.2.4.7. Stage 7a: Generate nopython LLVM IR
    • 7.2.4.8. Stage 7b: Generate object mode LLVM IR
    • 7.2.4.9. Stage 8: Compile LLVM IR to machine code
• 7.3. Polymorphic dispatching
  • 7.3.1. Requirements
    • 7.3.1.1. Compile-time vs. run-time
  • 7.3.2. Type resolution
    • 7.3.2.1. Typecodes
    • 7.3.2.2. Hard-coded fast paths
    • 7.3.2.3. Fingerprint-based typecode cache
    • 7.3.2.4. Summary
  • 7.3.3. Specialization selection
    • 7.3.3.1. Implicit conversion rules
    • 7.3.3.2. Candidates and best match
    • 7.3.3.3. Implementation
    • 7.3.3.4. Summary
  • 7.3.4. Miscellaneous
• 7.4. Notes on generators
  • 7.4.1. Terminology
  • 7.4.2. Function analysis
  • 7.4.3. The generator structure
    • 7.4.3.1. Layout
    • 7.4.3.2. Allocation
  • 7.4.4. Compiling to native code
    • 7.4.4.1. The next() function
• 7.5. Notes on Numba Runtime
  • 7.5.1. Memory Management
    • 7.5.1.1. Cooperating with CPython
    • 7.5.1.2. Compiler-side Cooperation
    • 7.5.1.3. Optimizations
    • 7.5.1.4. Quirks
    • 7.5.1.5. Debugging Leaks
    • 7.5.1.6. Debugging Leaks in C
  • 7.5.2. Future Plan
• 7.6. Using the Numba Rewrite Pass for Fun and Optimization
  • 7.6.1. Overview
  • 7.6.2. Rewriting Passes
    • 7.6.2.1. The Rewrite Base Class
    • 7.6.2.2. Subclassing Rewrite
    • 7.6.2.3. Overloading Rewrite.match()
    • 7.6.2.4. Overloading Rewrite.apply()
  • 7.6.3. The Rewrite Registry
  • 7.6.4. Case study: Array Expressions
    • 7.6.4.1. The RewriteArrayExprs.match() method
    • 7.6.4.2. The RewriteArrayExprs.apply() method
    • 7.6.4.3. The _lower_array_expr() function
  • 7.6.5. Conclusions and Caveats
• 7.7. Live Variable Analysis
  • 7.7.1. Notes on behavior of the live variable analysis
    • 7.7.1.1. Variable deleted before definition