railgun 0.1.8

ctypes utilities for faster and easier simulation programming in C and Python

Links:

• Documentation

  • Examples

  • (Japanese version)

• Repository (at GitHub)

• Issue tracker (at GitHub)

• PyPI

• Travis CI

Overview

RailGun is a ctypes utilities for faster and easier simulation programming in C and Python. It automatically creates Python class to call C functions easily and safely. All you need is a few constraints in C code.

RailGun does more than just exporting C functions to Python world [1]. For example, when you write simulation code, you may face situation like this many times:

I am accessing array like x[i][j] and y[j][k], so I want the second axis of the array x and the first axis of the array y to be of the same length.

RailGun solves this problem by keeping shape of all arrays to be consistent. Memory allocation for these arrays is done automatically.

RailGun also provides some value check before passing it to C function. For example, you may want to pass an index of some array to C function. When you do that, you need to check if the index is in a certain range, to avoid segmentation fault. RailGun provides a short hand notation to check that automatically. Also, you can wrap C function to put any kind of complex value check and pre/post-processing.

With these features and other useful utilities provided by RailGun, you can really focus on guts of computation in C code.

[1]

Well, that’s what ctypes does.

Installation

pip install railgun   # using pip
easy_install railgun  # using setuptools (if you must)

Requirement

• Numpy

• (matplotlib for sample code)

License

See LICENSE.