aurallusion
Science Score: 44.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
○Academic publication links
-
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (11.1%) to scientific vocabulary
Repository
Basic Info
- Host: GitHub
- Owner: CordetG
- License: mit
- Language: Python
- Default Branch: main
- Size: 67 MB
Statistics
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
- Releases: 0
Metadata Files
README.md
Aurallusion

♪ Aural - Illusion by Cordet Gula ♭
' ... children's schools, when they play [out of tune] it's perfect! It's so much more colorful than a perfectly tuned orchestra. That orchestra will usually play the same 12 colors whereas the school will play maybe 60 more colors.'
- Quote from Neil Harbisson in the Interview on Hearing Colors Part 2
Table of Contents
1. Project Description
+ [Outcome](#outcome)2. Design
+ [Project Planning](#project-planning) + [Dataset Model](#dataset-model) + [Decision Tree Model](#decision-tree-model)Demonstration
https://github.com/user-attachments/assets/21e6cf97-6356-4b5e-9a3f-00b679fd664c
Description
Aurallusion is an audio visualization tool that incorporates multiple functionalites. In effort to use different components of sound data, the program has implemented methods to extract and evaluate audio data, such as pitch. Foundationally, Aurallusion is using frequency and pitch as audio components extracted from .wav files. The heart of aurallusion uses a decision tree machine learning algorithm to take in audio data.
In an attempt to keep the data as objective as possible, the data was used relative to absolutes on the visible light spectrum and common notes. Red has low frequency waves on the visible light spectrum and so red is associated most strongly with the bass range in octave 0 as the lowest frequency range. Violet, on the other hand, has the highest frequency on the visible light spectrum and is associated with the 8th ocatave in the treble range. The colors are measured using RGB values to allow the machine learning algorithm to make a decision from a spectrum.
To add more sound analysis, audio pitch plays a role relative to the luminous intensity of light. Note C has a low intensity pitch and is coorelated with low luminous intensity of light, whereas high luminous intensity is coorelated with the high intensity pitch of note of note B. In this project, black and white are not explicitely used but rather the lightest or darkest shade of a cooresponding color to represent the high or low pitch relative to the frequency.
:information_source: Disclaimer: While awerallusion was created with the intention of being objective by using scientific measurements and calculations, it is important to note that synesthesia experiences are highly subjective and vary depending on a synesthete's own personal perception. With chromesthesia, for example, a C note can be represent violet to one person and green to another. In addition, color naming conventions vary between different cultures and languages.
The author does not claim the color naming schemes or the experience of chromesthesia used with awerallusion as a fact, but rather to be used with a fun tool that creates an association between sound and color and can be used to help visual thinkers learn basic music theory.
Outcome
Once completed, Aurallusion will take an audio input and output a visual association.
Design
Project Planning
For the list of goals and plan for the project, see the Docs directory.
Dataset Model
- Data Collection for color
- Determining the values to use from the visible light spectrum
- Greyscale values
- How to calculate additional RGB to Hz values
From the visible light spectrum, a predetermined chart was used for a value of wavelengths in nanometers and a nanometer-to-RGB calculator was used to determine the base color values.
The visible light spectrum luminosity value represented 50% luminosity and was located at the mean Hz sound frequency between notes F and F#.
Greyscale values represented to notes of a single octave. The greyscale was determined by a pre-set value of RGB(20, 20, 20), (40, 40, 40), ... , (240,240,240), repctively.
The formula used for the mapping all other color data was through linear interpolation where x = ∑ $ri, gi, b_i$.
```text Example: max = RGB(255,255,255)
For luminsity with RGB = (20,20,20) x = 20 + 20 + 20 x = 60 max = 255 + 255 + 255 max = 765 luminosity = 60/765 = 7.8%
For red hue = 19% at 7.8% luminosity (7.8%/50%)*19% = 3.0% of dark red (780nm) where the default dark red at 100% saturation and 50% luminosity is represented as HSL (0,1,0.19) -- hue = 0 degrees, 1 = 100% saturation, 0.19 = 19% lightness
Note: Values are rounded to the nearest 10th. ```

Decision Tree Model

Languages
- Python includes useful libraries for working with visual data and machine learning algorithms.
Rust has a great integrated module system that is useful for encapsulation and is a useful language for safe coding practices.
For simplicity, the program development will focus on python first and integrate rust later if possible.
License
Aurallusion is licensed under the MIT License. See LICENSE for more information.
Owner
- Name: Cordet
- Login: CordetG
- Kind: user
- Repositories: 1
- Profile: https://github.com/CordetG
Volunteer at Computer Action Team | Technical Laboratory Assistant | CS Grad Student | Security Club Member
Citation (CITATION.cff)
cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "Gula"
given-names: "Cordet"
orcid: "https://orcid.org/0009-0003-9518-7022"
title: "Aurallusion"
version: 0.1.0
date-released: 2025-01-19
url: "https://github.com/CordetG/aurallusion"
references:
- type: "text"
title: "Full list of references"
url: "https://github.com/CordetG/aurallusion/docs/REFERENCES.md"
GitHub Events
Total
- Issues event: 14
- Watch event: 1
- Delete event: 7
- Member event: 2
- Push event: 95
- Pull request event: 47
- Create event: 10
Last Year
- Issues event: 14
- Watch event: 1
- Delete event: 7
- Member event: 2
- Push event: 95
- Pull request event: 47
- Create event: 10
Issues and Pull Requests
Last synced: 6 months ago
All Time
- Total issues: 4
- Total pull requests: 23
- Average time to close issues: about 2 months
- Average time to close pull requests: about 4 hours
- Total issue authors: 1
- Total pull request authors: 1
- Average comments per issue: 0.0
- Average comments per pull request: 0.0
- Merged pull requests: 18
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 4
- Pull requests: 23
- Average time to close issues: about 2 months
- Average time to close pull requests: about 4 hours
- Issue authors: 1
- Pull request authors: 1
- Average comments per issue: 0.0
- Average comments per pull request: 0.0
- Merged pull requests: 18
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- CordetG (4)
Pull Request Authors
- CordetG (22)