5. Developer Manual

• 5.1. Contributing to Numba
  • 5.1.1. Communication
    • 5.1.1.1. Mailing-list
    • 5.1.1.2. Bug tracker
  • 5.1.2. Getting set up
    • 5.1.2.1. Build environment
    • 5.1.2.2. Building Numba
    • 5.1.2.3. Running tests
  • 5.1.3. Development rules
    • 5.1.3.1. Code reviews
    • 5.1.3.2. Coding conventions
    • 5.1.3.3. Stability
    • 5.1.3.4. Platform support
  • 5.1.4. Documentation
    • 5.1.4.1. Main documentation
    • 5.1.4.2. Web site homepage
• 5.2. Numba Architecture
  • 5.2.1. Introduction
  • 5.2.2. Contexts
  • 5.2.3. Compiler Stages
    • 5.2.3.1. Stage 1: Analyze Bytecode
    • 5.2.3.2. Stage 2: Generate the Numba IR
    • 5.2.3.3. Stage 3: Macro expansion
    • 5.2.3.4. Stage 4: Infer Types
    • 5.2.3.5. Stage 5: Rewrite Typed IR
    • 5.2.3.6. Stage 6a: Generate No-Python LLVM IR
    • 5.2.3.7. Stage 6b: Generate Object Mode LLVM IR
    • 5.2.3.8. Stage 7: Compile LLVM IR to Machine Code
• 5.3. Extending the Numba Frontend
  • 5.3.1. Overview
    • 5.3.1.1. Numba Types
    • 5.3.1.2. Type Inference Mechanism
  • 5.3.2. Tutorial
    • 5.3.2.1. Creating a New Numba Type
    • 5.3.2.2. Organizing Type Signatures with a Registry
    • 5.3.2.3. Adding an Attribute Value Type Signature
    • 5.3.2.4. Adding a Function Type Signature
    • 5.3.2.5. Overloading Elementary Operations
    • 5.3.2.6. Installing the Registry in a Typing Context
    • 5.3.2.7. Enabling Type Inference for Function Arguments and Globals
  • 5.3.3. Conclusion
• 5.4. Extending the Numba backend
  • 5.4.1. Helper Lib
  • 5.4.2. Python API
  • 5.4.3. Target Interval Objects
  • 5.4.4. Base Target
• 5.5. Notes on generators
  • 5.5.1. Terminology
  • 5.5.2. Function analysis
  • 5.5.3. The generator structure
    • 5.5.3.1. Layout
    • 5.5.3.2. Allocation
  • 5.5.4. Compiling to native code
    • 5.5.4.1. The next() function
• 5.6. Notes on Numba Runtime
  • 5.6.1. Memory Management
    • 5.6.1.1. Cooperating with CPython
    • 5.6.1.2. Compiler-side Cooperation
    • 5.6.1.3. Optimizations
    • 5.6.1.4. Quirks
  • 5.6.2. Future Plan
• 5.7. Using the Numba Rewrite Pass for Fun and Optimization
  • 5.7.1. Overview
  • 5.7.2. Rewriting Passes
    • 5.7.2.1. The Rewrite Base Class
    • 5.7.2.2. Subclassing Rewrite
    • 5.7.2.3. Overloading Rewrite.match()
    • 5.7.2.4. Overloading Rewrite.apply()
  • 5.7.3. The Rewrite Registry
  • 5.7.4. Case study: Array Expressions
    • 5.7.4.1. The RewriteArrayExprs.match() method
    • 5.7.4.2. The RewriteArrayExprs.apply() method
    • 5.7.4.3. The _lower_array_expr() function
  • 5.7.5. Conclusions and Caveats