Skip to main content

Python package for creating optical illusions

Project description

sorceress 1.7

PyPI version Jekyll site CI Downloads

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.

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🚀️

Package can be found on pypi hence you can install it via pip.

pip install sorceress==1.7
#importing
import sorceress
#another way to import 
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
  • Illusions in JavaScript
  • footsteps
  • thelilac
  • EyeMovements
  • spatialmotion

Examples

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

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

Contribution

Any contribution, bug report, suggestion is always welcome.

##Author

  • Main Maintainer: Enes Altun

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sorceress-1.7.4.tar.gz (11.8 kB view hashes)

Uploaded Source

Built Distribution

sorceress-1.7.4-py3-none-any.whl (10.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page