Skip to main content

Fast operations on arrays of structured data.

Project description

StructArray allows you to perform fast arithmetic operations on arrays of structured (or unstructured) data.

This library is useful for performing the same operation on every item in an array.

I’ve included an example showing a simple particle engine. It animates 10,000 particles without much trouble.

This is the “release early” part of the “release early, release often” equation. It’s 80% done. I just need to finish the other 80%.

Quick Introduction

Here’s a quick introduction to what you can do with it:

>>> import structarray, random

First, create a StructArray with attributes for position and velocity, starting with a length of 1000.

>>> particles = structarray.StructArray(('x', 'y', 'dx', 'dy'), size=10000)

Let’s give the particles a little random motion. We can loop through each item and assign attributes.

>>> for p in particles:
...     p.dx = random.random() * 20 - 10
...     p.dy = random.random() * 50

We can also assign values by index like this:

>>> particles[0].dy = 100

Or we could assign all four values to an index:

>>> particles[0] = (0, 20, 5, 100)             # (x, y, dx, dy)

We can assign a value to every item by assigning it directly to an attribute of the array:

>>> particles.x = 0          # set x to zero for every item

We can also copy the values of one attribute into another:

>>> particles.y = particles.x

We can also do arithmetic while we are at it:

>>> particles.y = particles.x + 10

So now, how would we go about a simulation loop?

>>> particles.x += particles.dx
>>> particles.y += particles.dy
>>> particles.dy -= 9.81

What’s important here is that each of these three operations is applied to every item in the array. And it all happens in a tight loop in C, so it’s very fast. Even for 10,000 particles.

Sending the data off to the video card is pretty easy:

>>> glVertexPointer(2, GL_FLOAT,
...     particles.get_data_stride(),
...     particles.get_data_addr())

Of course there’s more to it than that to get it to display. Check out the source distribution for a working example

Download

I always upload the latest version to the StructArray page on PyPI.

Installation

Run this command to download and install a precompiled binary.:

sudo easy_install StructArray

To compile StructArray from source, you need the python development headers installed. (This is named python-dev in debian and ubuntu distributions. I think rpm distros name it python-devel.)

The C files are included, so you don’t need Pyrex installed. However, if you do have Pyrex, I’ve only tested it with Pyrex-0.9.6.3. Results may vary with older versions.

Installing is just like most any other python module:

python setup.py build
sudo python setup.py install

Documentation

You can find the StructArray reference documentation here

It’s also included when you download the source distribution.

Project details


Release history Release notifications | RSS feed

This version

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

StructArray-0.1.tar.gz (54.1 kB view hashes)

Uploaded Source

Built Distributions

StructArray-0.1.win32-py2.5.exe (100.5 kB view hashes)

Uploaded Source

StructArray-0.1-py2.5-win32.egg (35.7 kB view hashes)

Uploaded Source

StructArray-0.1-py2.5-linux-i686.egg (94.0 kB view hashes)

Uploaded Source

StructArray-0.1-py2.4-linux-i686.egg (93.5 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page