Home

Awesome

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.

<p align="center"><img src="examples/covid/1.jpg" width="800px" /></p> <p align="center"> <img src="examples/covid/4.jpg" width="400px" /> <img src="examples/covid/3.jpg" width="400px" /> </p>

mdgrid

Random grid with random types of fills.

<p align="center"> <img src="examples/mdgrid/1.jpg" width="600px" /> </p>

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).

<p align="center"> <img src="examples/wheel_page/wheel_page.jpg" width="600px" /> </p>

Installation

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

Existing vpype installation

If vpype was installed using pipx, use the following command:

$ pipx inject vpype git+https://github.com/abey79/vpype-explorations

If vpype was installed using pip in a virtual environment, activate the virtual environment and use the following command:

$ pip install git+https://github.com/abey79/vpype-explorations#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-explorations

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.