Skip to content
forked from numba/numba

NumPy aware dynamic Python compiler using LLVM

License

Notifications You must be signed in to change notification settings

martinfiers/numba

 
 

Repository files navigation

Numba

Numba is an Open Source NumPy-aware optimizing compiler for Python sponsored by Continuum Analytics, Inc. It uses the remarkable LLVM compiler infrastructure to compile Python syntax to machine code.

It is aware of NumPy arrays as typed memory regions and so can speed-up code using NumPy arrays. Other, less well-typed code will be translated to Python C-API calls effectively removing the "interpreter" but not removing the dynamic indirection.

Numba is also not a tracing jit. It compiles your code before it gets run either using run-time type information or type information you provide in the decorator.

Numba is a mechanism for producing machine code from Python syntax and typed data structures such as those that exist in NumPy.

Dependencies

  • LLVM 3.1 or 3.2
  • llvmpy (from llvmpy/llvmpy fork)
  • llvmmath
  • numpy (version 1.6 or higher)
  • Meta (from numba/Meta fork (optional))
  • Cython (build dependency only)
  • nose (for unit tests)
  • argparse (for pycc)

Installing

The easiest way to install numba and get updates is by using the Anaconda Distribution: http://continuum.io/anacondace.html

Custom Python Environments

If you're not using anaconda, you will need LLVM with RTTI enabled:

  • Compile LLVM 3.2

See https://github.com/llvmpy/llvmpy for the most up-to-date instructions.

    $ wget http://llvm.org/releases/3.2/llvm-3.2.src.tar.gz
    $ tar zxvf llvm-3.2.src.tar.gz
    $ ./configure --enable-optimized --prefix=LLVM_BUILD_DIR
    $ # It is recommended to separate the custom build from the default system
    $ # package.
    $ # Be sure your compiler architecture is same as version of Python you will use
    $ #  e.g. -arch i386 or -arch x86_64.  It might be best to be explicit about this.
    $ REQUIRES_RTTI=1 make install
  • Install llvmpy
    $ git clone https://github.com/llvmpy/llvmpy
    $ cd llvmpy
    $ LLVM_CONFIG_PATH=LLVM_BUILD_DIR/bin/llvm-config python setup.py install
  • Installing Numba
    $ git clone https://github.com/numba/numba.git
    $ cd numba
    $ pip install -r requirements.txt
    $ python setup.py build_ext --inplace
    $ python setup.py install

or simply

    $ pip install numba

NOTE: Make sure you install distribute instead of setuptools. Using setuptools may mean that source files do not get cythonized and may result in an error during installation.

Documentation

http://numba.pydata.org/numba-doc/dev/index.html

Mailing Lists

Join the numba mailing list numba-users@continuum.io :

https://groups.google.com/a/continuum.io/d/forum/numba-users

Some old archives are at: http://librelist.com/browser/numba/

Website

See if our sponsor can help you (which can help this project): http://www.continuum.io

http://numba.pydata.org

Continuous Integration

https://travis-ci.org/numba/numba

About

NumPy aware dynamic Python compiler using LLVM

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 96.6%
  • C 3.2%
  • Other 0.2%