ipycc

A Python package for creative coding in Jupyter

This package makes it easy to explore creative coding in Python using Jupyter notebooks. Its design is heavily inspired by p5.js and Turtle graphics from the Python standard library.

Turtles

A dark blue square with a sprial pattern drawn in white. The spiral is drawn one side at a time.

from ipycc import Turtle


ted = Turtle()
ted.draw()
ted.bgcolor("midnightblue")
ted.pencolor("ghostwhite")
for side in range(40):
    length = side * 5
    ted.fd(length)
    await ted.delay(0.1)
    ted.lt(123)
    await ted.delay(0.1)

Sketches

A light blue square with a circle in its center. The circle is drawn with a white center and black edge.

from ipycc import Sketch


p5 = Sketch(400, 400)
p5.background("dodgerblue")
p5.circle(200, 200, 50)
p5.run_sketch()

Ten white circles moving like fireflies on a dark blue background.

import math
from random import uniform
from ipycc import Sketch


p5 = Sketch(400, 400)
coupling = 1
num_bugs = 10
k_n = coupling / num_bugs

class Bug:
    def __init__(self):
        self.x = p5.width * 0.5
        self.y = p5.height * 0.5
        self.r = 5
        self.angle = uniform(0, math.tau)
        self.freq = uniform(5, 10)
        self.da_dt = 0
        self.dt = 0.01
    
    def render(self):
        p5.fill("ghostwhite")
        p5.no_stroke()
        p5.circle(self.x, self.y, 2 * self.r)
    
    def update(self):
        self.angle += self.da_dt * self.dt
        dx = math.cos(self.angle)
        dy = math.sin(self.angle)
        self.x += dx
        self.y += dy
    
    def sync(self, bugs):
        self.da_dt = self.freq
        for bug in bugs:
            self.da_dt += k_n * math.sin(bug.angle - self.angle)

bugs = [Bug() for _ in range(num_bugs)]

def draw():
    p5.background("#1919706F")
    for bug in bugs:
        bug.sync(bugs)
    
    for bug in bugs:
        bug.update()
        bug.render()

# Loop for 10 seconds.
p5.run_sketch(draw, 10) 

ipycc provides a simplified interface to the HTML canvas by wrapping ipycanvas in a beginner-friendly API.

Acknowledgements

• Portions of the Sketch class are lovingly borrowed from their p5.js and proceso counterparts.
• Portions of the Turtle class are lovingly borrowed from their standard library counterparts.