SNEK is Not an Acronym
This library is specifically written to be useful for a broad range of ways in which I create art using various generative algorithms.
snek is four things:
A simple (graph) data structure for working with vertices and edges The structure is named
snek; the name is explained below. This structure is combined with a programming pattern for applying changes to the structure. The pattern relies on
alterations, see below.
A series of useful data structures and tools. E.g. a 2D vector
vecand a package for generating different kinds of random numbers:
A tool for drawing things called
sandpaintuses random sampling to draw it's primitives. This creates a fairly distinct and gritty look in many cases.
A tool for drawing svg files.
About the Name
A while back someone on twitter suggested that if Python 3 was named "snek" it would avoid naming confusion. I found that amusing at the time, and picked snek as the placeholder name for this project. I've been looking for a better name, but I haven't found one yet.
The pattern depends on the concept of
alterations. In short: an
is a change that will be applied to the structure at the end of a given
alterations are further described in
I have also written about things related to
- https://inconvergent.net/2017/a-propensity-for-mistakes/ (indirectly about
- https://inconvergent.net/2017/grains-of-sand/ (about "sandpainting", see
Here is and example of manipulating a
snek instance called
alterations. Alteration constructors are postfixed with
; context start (snek:with (snk) ; iterate vertices (snek:itr-verts (snk v) ; move alteration (snek:move-vert? v (rnd:in-circ 1d0)) ; w will be an arbitrary ; vertex in snk (snek:with-rnd-vert (snk w) ; join v and w if they are closer than d (if (< (snek:edge-length snk (list v w)) d) ; join vertices alteration (snek:join-verts? v w)))) ; context end ; alterations have been applied
You can define your own arbitrary alterations. There is an example of this in
ex/custom-alt.lisp. I have also written about it here:
There are some examples included. All examples are in the
If you don't provide a filename (with full or relative path) as the first
argument, the resulting file will be named
I use snek for most of the work that I post on twitter (https://twitter.com/inconvergent). Both for generating raster images as well as vector images for plotting.
Here are some plotted examples:
This code requires
The path to quicklisp must be set in
are automatically installed via
There are some tests included, see the
Stability, Changes and Versioning
This code is highly experimental on my part. It is likely to change with no
warning or explanation. I will keep a note of the version number in
- bzspl has lower sample density near the edges in some cases.
I would like to thank
Who have provided me with useful hints and code feedback.