feat(experimental): Add Data Sonification Module (Listen to the Market)

[sjhddh]

Summary

• Introduces a new experimental module that converts stock market data into MIDI sequences
• Maps Close price to musical pitch via quantized scales (pentatonic, blues, chromatic, dorian, minor)
• Maps Volume to note velocity (loudness) for dynamic expression
• Optional volatility-to-duration mapping for more expressive output

Motivation

This module enables users to "listen" to market trends, creating an auditory display of financial data. Useful for:

• Auditory pattern recognition (hear trends your eyes might miss)
• Algorithmic art and creative data visualization
• Accessibility for visually impaired traders

Example Usage

from finrobot.modules.sonification import MarketSynth, generate_melody

# Generate a melody from NVDA stock data
synth = generate_melody("NVDA", "2024-01-01", "2024-12-31", scale="pentatonic")
synth.save_midi("NVDA_2024.mid")

# With custom settings
synth = generate_melody(
    "AAPL", "2024-01-01", "2024-06-30",
    scale="blues",
    tempo=90,
    variable_duration=True,  # Volatility affects note length
    save_path="AAPL_blues.mid"
)

Test Plan

• Verify midiutil dependency installs correctly
• Test generate_melody() with various tickers and date ranges
• Validate MIDI output opens in standard MIDI players
• Test all 6 scale presets produce valid output