Skip to content

shizuo-kaji/Kaleidocycle

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

63 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

English | 日本語

Kaleidocycle: Geometry of Closed Linkages

Kaleidocycles are closed linkage mechanisms shaped like discrete Möbius bands. Each unit consists of tetrahedral links that flip inside-out by rotating around hinged joints, producing everting motions reminiscent of bubble rings. This repository gathers asset needed to model, simulate, and fabricate these mechanisms: Python tooling, Maple/Mathematica notebooks, paper templates, and 3D-printable parts.

Repository Tour

  • python/ — Python scripts (package sources under src/kaleidocycle/, notebooks, examples)
  • Kaleidocycle.mw / Kaleidocycle.nb — Maple and Mathematica scripts for symbolic construction, visualization, and template export
  • 3d_model/ — STL for 3D printing (models by Kamagata Design Studio)
  • paper_model/ — printable templates for hand-folded models
  • hexagon/ — hexaflexagon cousin plus a pictorial folding guide for kaleidocycles
  • LICENSE — MIT license for the code (see the patent note below)

Quick Start

Python toolkit

  1. cd python
  2. uv venv .venv && source .venv/bin/activate
  3. pip install -e .[dev]
  4. pytest (or pytest -k geometry) to run the suite
  5. jupyter lab notebooks/FindKaleidocycles.ipynb for interactive exploration

Maple / Mathematica

Open Kaleidocycle.mw (Maple) or Kaleidocycle.nb (Mathematica) to reproduce symbolic computations. Both scripts include visualization helpers and export functions for paper templates and motion studies.

Physical model assets

  • Print STL files from 3d_model/ to fabricate kaleidocycles
  • Use paper_model/ templates for hand-folded prototypes; the hexagon/ folder also contains instructions

References & Further Reading

Technical publications

Japanese-language articles

Patent

The specific shape of the Möbius kaleidocycle is covered by the patent

  • Shizuo Kaji, Johannes Schoenke, Eliot Fried, Michael Grunwald, Moebius Kaleidocycle, JP2018-033395 (Japan), 2019JP007314 (PCT), WO 2019167941, filed 27 Feb 2018.

However, feel free to use the material here for personal and educational projects. For commercial use, contact the Japan Science and Technology Agency.

Some of the results described above are also published in

Gallery

K9 K8 K15 K24div

License

All code and assets in this repository are released under the MIT License (see LICENSE). Cite the references above when using or extending the material in academic work.

About

Geometry of the moduli space of a closed linkage

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors