cython Handledning
Komma igång med cython

Anmärkningar

Installera Cython

För att använda Cython behövs två saker. Själva Cython-paketet, som innehåller cython källan-till-källkompileraren och Cython-gränssnitt till flera C- och Python-bibliotek (till exempel numpy). För att sammanställa C-koden genererad av cython kompilatorn cython en C-kompilator.

Steg 1: Installera Cython

System Agnostic

Cython kan installeras med flera systemagnostiska pakethanteringssystem. Dessa inkluderar:

1. PyPI via pip eller easy_install:

   $ pip install cython
   $ easy_install cython
   

2. anaconda med conda:

   $ conda install cython
   

3. Tänkte kapell med enpkg-pakethanteraren:

   $ enpkg cython
   

Källkoden kan också laddas ner från github och installeras manuellt med:

$ python setup.py install

Ubuntu, Debian

För Ubuntu är paketen cython och cython3 tillgängliga. Observera att dessa ger en äldre version än de ovan angivna installationsalternativen.

$ apt-get install cython cython3

Windows

För Windows tillhandahålls en .whl-fil som kan installeras med pip från en tredje part. Detaljer om installation av en .whl-fil på Windows kan hittas här .

Steg 2: Installera en C-kompilator

För att kompilera C-filer som genereras av Cython behövs en kompilator för C och C ++. Gcc-kompilatorn rekommenderas och kan installeras enligt följande.

Ubuntu, Debian

Det build-essential paketet innehåller allt som behövs. Det kan installeras från förvaren med:

$ sudo apt-get install build-essential

MAC

XCode-utvecklarverktygen innehåller en gcc-liknande kompilator.

Windows

MinGW (Minimalistisk GNU för Windows) innehåller en Windows-version av gcc. Kompilatorn från Visual Studio kan också användas.

Hej världen

En Cython pyx-fil måste översättas till C-kod ( cytoniserad ) och sammanställas innan den kan användas från Python. En vanlig metod är att skapa en tilläggsmodul som sedan importeras i ett Python-program.

Koda

För det här exemplet skapar vi tre filer:

• hello.pyx innehåller Cython-koden.
• test.py är ett Python-skript som använder hejtillägget.
• setup.py används för att sammanställa Cython-koden.

hello.pyx

from libc.math cimport pow

cdef double square_and_add (double x):
    """Compute x^2 + x as double.

    This is a cdef function that can be called from within
    a Cython program, but not from Python.
    """
    return pow(x, 2.0) + x

cpdef print_result (double x):
    """This is a cpdef function that can be called from Python."""
    print("({} ^ 2) + {} = {}".format(x, x, square_and_add(x)))

test.py

# Import the extension module hello.
import hello

# Call the print_result method 
hello.print_result(23.0)

setup.py

from distutils.core import Extension, setup
from Cython.Build import cythonize

# define an extension that will be cythonized and compiled
ext = Extension(name="hello", sources=["hello.pyx"])
setup(ext_modules=cythonize(ext))

sammanställa

Detta kan göras genom att använda cython hello.pyx att översätta koden till C och sedan kompilera den med gcc . Ett enklare sätt är att låta distutiler hantera detta:

$ ls
hello.pyx  setup.py  test.py
$ python setup.py build_ext --inplace
$ ls
build  hello.c  hello.cpython-34m.so  hello.pyx  setup.py  test.py

Den delade objekt (.so) -filen kan importeras och användas från Python, så nu kan vi köra test.py :

$ python test.py
(23.0 ^ 2) + 23.0 = 552.0