Rigid Origami Folder

This tool is develop for the project Folding Rigid Origami with Closure Constraints. See Project Page for detail.

Introduction

Rigid Origami Folder is a commandline tool developed by ZhonghuaXi, it loads a crease pattern and find the folding path for it. It may take a while, typically several seconds, once done, a window will be popped up to show the origami which user can interact with.

Citing

Please cite our papers in your publication if it helps your research.

Continuous Unfolding of Polyhedra - a Motion Planning Approach, Zhonghua Xi and Jyh-Ming Lien, 2015 IEEE/RSJ International Conference on Intelligent Robots and Systems (IROS), Sep. 2015
Web Site / Paper(pdf) / BibTeX

Folding and Unfolding Origami Tessellation by Reusing Folding Path, Zhonghua Xi and Jyh-Ming Lien, 2015 IEEE International Conference on Robotics and Automation (ICRA), May. 2015
Web Site / Paper (pdf) / BibTeX

Plan Folding Motion for Rigid Origami via Discrete Domain Sampling, Zhonghua Xi and Jyh-Ming Lien, 2015 IEEE International Conference on Robotics and Automation (ICRA), May. 2015
Web Site / Paper (pdf) / BibTeX

Folding Rigid Origami with Closure Constraints, Zhonghua Xi and Jyh-Ming Lien, International Design and Engineering Technical Conferences & Computers and Information in Engineering Conference (IDETC/CIE), ASME, Aug. 2014
Web Site / Paper (pdf) / BibTeX

Features

Find rigid foldable and collision free path
Deformation control
Visualize deformation during folding
Using symmetry property
Re-using folding path
Export intermediate state
Unfold rigid foldable shape to crease pattern

What's New

9/6/2014 Ver:0.1.2 Source code is available now! Fixed rendering and angle inconsistency error.
8/28/2014 Ver:0.1.1 Windows now supported!

Download

origami_src_v0.1.2.zip Source code in C++ (2.4MB 9/6/2014)
origami_bin_v0.1.2.zip Binary and demos for all platforms (Linux64, Mac OS X and Windows) (1.9MB 9/6/2014)

Screenshot

Demos

Enter demo folder, run *.bat on Windows, *.sh on Linux/Mac OS X, here I use Mac OS X.

Path finding run waterbomb.sh press space to animate
Visualize Deformation run resch_3_3.sh press c press q press space
Without Collision Detection waterbomb_flat_without_cd.sh press space fully folded
WIth Collision Detection waterbomb_flat_with_cd.sh press space folded to cylinder

Usage

Mouse:

left button: drag the model
right button: zoom
arrow keys: move the model

Command line options:

./origami [options] *.xml|*.obj|*.ori
Options:
	 -g: disable GUI
	-rs: reverse search
	 -v: verbose mode
	 -q: quiet mode
  -mono: crease angle's trajectories are monotonic
	-ev: only use essential vertex to check foldability
  -mi #: max iterations for NLOPT [default = 1000]
  -ms #: max samples for planner [default = 1000]
   -D #: step size [default = 0.02]
   -n #: number of nodes in graph
   -k #: number of closest neighbour to connect
  -wX #: weights for X, X = 0,1,2
-traj #: load trajectories from file
  -pl #: planners: greedy | rrt [default = rrt]
   -exp: Exploration mode
	-dt: dump trajectories
	-dd: dump deformation
	-us: use symmetry
  -db #: deformation bound
  -md #: maximum deformation [default = 0.08]
  -mt #: materials: paper, mae, de, terpolymer [default = paper]
  -fo #: folding objective: identity | deformation [default = identity]
  -vc #: valid criterion: identity | deformation [default = deformation]
  -bf #: base face id
	-ca: check angles
   -dcd: disable collision detection
 -mae #: maximum angle error [default = 0.0872639rad]
	-np: don't find path on start

GUI Keys

File Format

Origami uses an augmented Wavefront obj format

For a vertex : "v x y z"
Face a face: "f vid1 vid2 vid3"
For a crease line: "c vid1 vid2 type final_folding_angle"
For symmetry: "s cid1 cid2 ..."
example file

Crease Pattern Designer

You can create your own crease pattern using our web-based Origami Pattern Designer

Related Tools

CategoryOrigami

GMU | Motion and Shape Computing Group