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
Last synced: 6 months ago · JSON representation ·

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
Created about 1 year ago · Last pushed 11 months ago
Metadata Files
Readme License Citation

README.md

Aurallusion

Project logo

♪  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

[1]

Table of Contents

1. Project Description + [Outcome](#outcome)
2. Design + [Project Planning](#project-planning) + [Dataset Model](#dataset-model) + [Decision Tree Model](#decision-tree-model)

3. Languages

4. LICENSE

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. ```

Table showing color and sound association

Decision Tree Model

Decision tree logic example

Languages

Python Rust

  • 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

License: MIT

Aurallusion is licensed under the MIT License. See LICENSE for more information.


Back to Top

Owner

  • Name: Cordet
  • Login: CordetG
  • Kind: user

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)
Top Labels
Issue Labels
enhancement (4)
Pull Request Labels