https://github.com/suddi/3dslantrelief

3D slant visual stereoscopic perception experiment, developed using Python, C, C++, OpenGL and GLSL
https://github.com/suddi/3dslantrelief

c-plus-plus cpp glsl inclinometer opengl perception psychophysics python relief texture

Last synced: 2 months ago
JSON representation

3D slant visual stereoscopic perception experiment, developed using Python, C, C++, OpenGL and GLSL

• Host: GitHub
• URL: https://github.com/suddi/3dslantrelief
• Owner: suddi
• License: apache-2.0
• Created: 2015-02-08T06:51:27.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2017-03-18T15:17:41.000Z (over 9 years ago)
• Last Synced: 2025-06-24T04:06:04.440Z (about 1 year ago)
• Topics: c-plus-plus, cpp, glsl, inclinometer, opengl, perception, psychophysics, python, relief, texture
• Language: Python
• Homepage:
• Size: 4.83 MB
• Stars: 0
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 3D Slant Relief

[![Codacy Badge](https://api.codacy.com/project/badge/Grade/503fb689d2b5435ab5a40388d6577557)](https://www.codacy.com/app/Suddi/3DSlantRelief?utm_source=github.com&utm_medium=referral&utm_content=suddi/3DSlantRelief&utm_campaign=badger)

[![license](https://img.shields.io/github/license/suddi/3DSlantRelief.svg?maxAge=2592000)](https://github.com/suddi/3DSlantRelief/blob/master/LICENSE)

A vision experiment engine in Python and OpenGL 3.3 to measure slant perception on surfaces with varying relief. 

Participants would evaluate relief on slanted surfaces with relief rendered from texture and directional lighting, and relay their data using an inclinometer.

## Installation

The experiment was created for Windows with Eclipse PyDev.

If not provided, please install the following dependencies not provided by `pip`:

````

Tkinter

````

All other dependencies can be installed with `pip`:

````sh

pip install -r requirements.txt

````

## Usage

The experiment can operate in 2 modes:

- `STIMULI_ONLY = True`

    - This will not collect any participant data, it will only render a randomized variation of the stimuli

- `STIMULI_ONLY = False`

    - This will run the experiment collecting participant data.

## Demo

When launching the experiment under the condition `STIMULI_ONLY = False`, it will open the Tkinter input window:

![Tkinter Input Window](img/demo/input.jpg)

Once the engine has the participant data necessary, it will render the textured surfaces, see below for example of initial and rendered surfaces:

![Colormap](img/stimuli/colormaps/1.png)

![Rendered Image on Screen](img/demo/sample.png)