Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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


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


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- Results may vary with older versions.

Installing is just like most any other python module:

python build
sudo python install


You can find the StructArray reference documentation here

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

Release History

Release History

This version
History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
StructArray-0.1-py2.4-linux-i686.egg (93.5 kB) Copy SHA256 Checksum SHA256 2.4 Egg Nov 22, 2007
StructArray-0.1-py2.5-linux-i686.egg (94.0 kB) Copy SHA256 Checksum SHA256 2.5 Egg Nov 22, 2007
StructArray-0.1-py2.5-win32.egg (35.7 kB) Copy SHA256 Checksum SHA256 2.5 Egg Nov 22, 2007
StructArray-0.1.tar.gz (54.1 kB) Copy SHA256 Checksum SHA256 Source Nov 22, 2007
StructArray-0.1.win32-py2.5.exe (100.5 kB) Copy SHA256 Checksum SHA256 2.5 Windows Installer Nov 22, 2007

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting