sorceress 1.8.2

Python package for creating optical illusions

sorceress 1.8

Purpose of package

This package's purpose is to create optical illusions in a simple way. The package is written in Python. however, the repo also includes JavaScript. In explanations section, you can find the explanations of the illusions.

If you find visual illusions fascinating this package is for you. You can reproduce the illusions in the literature with a few lines of code.

More importantly, we shouldn't take optical illusions as just fun. Optical illusions help us to research how the visual system of the brain ,which is the most complex mechanism, processes such cues. Most of the optical illusions in this package are seriously researched in the neuroscience literature. And I must say that the "causation" of the most of effects is still debated in the literature according to my humble knowledge. Optical illusions are researching not only in human vision but in other animals. So we can get a lot of insights from an evolutionary perspective.

In summary, I think this topic is very important, especially in vision studies.

For all optical illusions check this documentation: altunenes.github.io/sorceress/

Getting started🚀️

The package can be found on PyPI hence you can install it via pip.

pip install sorceress

#importing
from sorceress import sorceress

Features

For the API, click here

• Illusions in Python
  • chromatic
  • dotill
  • realtimegrid
  • addlines
  • eyecolour
  • dakinPex
  • bruno
  • dolboeuf
  • kanizsa
  • tAki2001
  • cafewall
  • ccob
  • ebbinghaus
  • whiteill
  • enigma
  • blackhole
  • colorgrids
  • munker

Illusions in JavaScript

• footsteps
• thelilac
• EyeMovements
• spatialmotion
• Motion Induced Blindness (2 versions)
• Depth Perception

Examples

In this page, you can find all illusions, explanations, code, and how to use it. I show just a few examples on this page.

from sorceress import sorceress
sorceress.chromatic("myimage.jpg",circle=False, method="CMCCAT2000", gif=True, Gifduration=7)
sorceress.addlines("myimage.png",linecolour1=(0,255,0),linecolour2=(0,255,255),linecolour3=(255,0,0))

As you can see above, you can use the package in a very simple way. You will need to install the following packages to use the package. You will not need to import them, the package will do it for you.

pip install opencv-python
pip install numpy
pip install matplotlib
pip install imageio
pip install Pillow
pip install colour-science

Contribution

Any contribution, bug report, or suggestion is always welcome.

##Author

• Main Maintainer: Enes Altun