epicycle-drawer

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

epicycle-drawer

★ 8 Open GitHub ↗

Draws any input drawing or figure using epicycles, based on the concept of Fourier Transforms

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Epicycle Drawer
![epicycle-drawing](https://raw.githubusercontent.com/Ahish9009/epicycle-drawer/master/img/epicycle-drawing.gif)

## Introduction
This is a tool that takes in a drawing as input from the user and draws it using epicycles.
### What are epicycles and epicycle drawings?
An epicycle is a circle, with a small radius, whose center revolves on the circumference of another circle of larger radius. The path traced by a point on the smaller circle can be manipulated to form various different shapes. This is demonstrated in the image below.
 
![epicycle-gif](https://raw.githubusercontent.com/Ahish9009/epicycle-drawer/master/img/epicycles.gif)
 
Multiple circles can be arranged and made to rotate at different speeds and in different phases. The path of a point on the last such circle can be traced, to create a drawing. The aim of this project is to take a desired drawing as input, and arrange circles in such a way that the path of a point on the last circle results in the desired drawing.

## Example

### Input
* The input image is drawn into the drawing board 
 ![drawing-input](https://raw.githubusercontent.com/Ahish9009/epicycle-drawer/master/img/drawing-input.gif)
### Epicycle Drawing
* Epicycles are generated to draw the input drawing 
![epicycle-drawing](https://raw.githubusercontent.com/Ahish9009/epicycle-drawer/master/img/epicycle-drawing.gif)
### Plots
#### 3D Plot of Various Angles of the Drawing
* The transform output seen in 3D 
![3d-epicycle](https://raw.githubusercontent.com/Ahish9009/epicycle-drawer/master/img/epicycle-3d.gif)
#### Output from Fourier Transform
![plot-1](https://raw.githubusercontent.com/Ahish9009/epicycle-drawer/master/img/plot-1.png)
#### Scatterplot of Values from Fourier Transform
![plot-2](https://raw.githubusercontent.com/Ahish9009/epicycle-drawer/master/img/plot-2.png)
#### Comparison of Original Sample Points & Points from Fourier Transform
![plot-3](https://raw.githubusercontent.com/Ahish9009/epicycle-drawer/master/img/plot-3.png)

## Usage

Clone this repo into a local directory.

It is recommended to run this project in a virtual environment, running Python 3(preferably Python 3.6).
Install and create the environment using
```shell
 pip install virtualenv
 virtualenv -p python3.6 newvenv
```
Activate it using
```shell
 source newvenv/bin/activate
```
Install the necessary packages with
```shell
 pip install -r requirements.txt
```
* Run the notebook with ```jupyter notebook``` 
* The settings cell can be changed as required. 
* You can either run the cells manually(use `Shift+Enter` to run a cell and move to the next one) or use the 'Run All Cells' option. 
* When the drawing board appears, draw your figure(preferably a continuous figure/shape, which while can be drawn with multiple strokes, should be possible to draw without lifting a pen). Continous figures ensure best results, however, the drawer works otherwise too(but is forced to add extra lines in regions where the pen would be lifted). 
* Close the drawing board window when you are done drawing and continue executing the following cells
* To run the program again, use the `Restart and Clear Output` option.

###### NOTE
If the `save_anim` option is set to 1, then make sure to allow time for the animation to be saved, before running any other cells.

## To-Do
* [ ] Allow user to trace from a bg image(probably with some point assistance)
* [ ] Generate epicycles for pre-existing image
  * [x] Load image and get contours
  * [ ] Get sample points in order of appearance

## Ideas & Software Used
* Python 
* Fourier Transforms

## Author(s)
[Ahish Deshpande](https://github.com/Ahish9009)

epicycle-drawer

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README