Fast operations on arrays of structured data.
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%.
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.dy = 100
Or we could assign all four values to an index:
>>> particles = (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-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
You can find the StructArray reference documentation here
It’s also included when you download the source distribution.
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|