jackhumbert / vpype-explorations

My generative/plotter art explorations, packaged as vpype plug-ins.

vpype explorations

My generative/plotter art explorations, packaged as vpype plug-ins.

Examples

Section in construction.

COVID in complex module

Made with the msimage command (Generative Design book's "complex modules" approach). Although it looks random, the background is based on the SARS-CoV-2 genome.

mdgrid

Random grid with random types of fills.

Wheels of wheels of wheels

Random 3-wheel spirograph patterns generated with the whlrandom command. Here, we focus on 2- to 5-fold rotationally symmetric curves, filtering for 'simple' ones (based on their total length).

Installation

See vpype's installation instructions for information on how to install vpype.

Existing vpype installation

Use this method if you have an existing vpype installation (typically in an existing virtual environment) and you want to make this plug-in available. You must activate your virtual environment beforehand.

$ pip install git+https://github.com/abey79/vpype-explorations.git#egg=vpype-explorations

Check that your install is successful:

$ vpype --help
Usage: vpype [OPTIONS] COMMAND1 [ARGS]... [COMMAND2 [ARGS]...]...

Options:
  -v, --verbose
  -I, --include PATH  Load commands from a command file.
  --help              Show this message and exit.

Commands:
[...]
  Plugins:
    alien
[...]

Stand-alone installation

Use this method if you need to edit this project. First, clone the project:

$ git clone https://github.com/abey79/vpype-explorations.git
$ cd vpype-pixelart

Create a virtual environment:

$ python3 -m venv venv
$ source venv/bin/activate
$ pip install --upgrade pip

Install vpype-explorations and its dependencies (including vpype):

$ pip install -e .

Check that your install is successful:

$ vpype --help
Usage: vpype [OPTIONS] COMMAND1 [ARGS]... [COMMAND2 [ARGS]...]...

Options:
  -v, --verbose
  -I, --include PATH  Load commands from a command file.
  --help              Show this message and exit.

Commands:
[...]
  Plugins:
    alien
[...]

Documentation

The complete plug-in documentation is available directly in the CLI help:

$ vpype alien --help

License

The code is available under the MIT License. The rest (images, etc.) is CC Attribution-NonCommercial-ShareAlike 4.0. See the LICENSE file for details.