rob-luke / auditorystimuli.jl

Generate audiory stimuli

AuditoryStimuli.jl goes beep and ssshhh

Generate auditory stimuli for real-time applications. Specifically, stimuli that are used in auditory research.

Stimuli

This package provides low levels tools to build any stimulus. It also provides high level convenience functions and examples for common stimuli such as:

• Amplitude modulated noise
• Harmonic stacks or harmonic complexes
• Binaural stimuli with user specified interaural correlation
• Frequency following response stimuli
• and more...

Documentation

https://rob-luke.github.io/AuditoryStimuli.jl

Community guidelines

I warmly welcome any contributions from the community. This may take the form of feedback via the issues list, bug reports (also via the issues list), code submission (via pull requests). Please feel free to suggest features, or additional stimuli you are interested in. Or if you just want to show support, click the star button at the top of the page.

Acknowledgements

This package is built on top of the excellent packages:

• SampledSignals
• Unitful
• Plots

If you use this package please cite:

Luke, R., (2021). AuditoryStimuli.jl: A Julia package for generating real-time auditory stimuli.
Journal of Open Source Software, 6(65), 3613, https://doi.org/10.21105/joss.03613

auditorystimuli.jl's Issues

Improve automation of function generators

Currently the functions are generated for every combination of input by hand. This is not very Julian and its ugly.

For example:

AuditoryStimuli.jl/src/SignalModifiers/Modulation.jl

Lines 32 to 43 in 0ee6b0d

	# TODO: Must be cleaner way to set defaults
	AmplitudeModulation(a, b, c) = AmplitudeModulation(a, b, c, true, 0)
	AmplitudeModulation(a, b) = AmplitudeModulation(a, b, 1, true, 0)
	AmplitudeModulation(a) = AmplitudeModulation(a, π, 1, true, 0)
	# TODO: Must be a nicer way to handle units than this
	AmplitudeModulation(a::typeof(1.0u"Hz"), b, c) = AmplitudeModulation(a |> u"Hz" |> ustrip, b, c)
	AmplitudeModulation(a::typeof(1u"Hz"), b, c) = AmplitudeModulation(a |> u"Hz" |> ustrip, b, c)
	AmplitudeModulation(a::typeof(1.0u"Hz"), b) = AmplitudeModulation(a |> u"Hz" |> ustrip, b)
	AmplitudeModulation(a::typeof(1u"Hz"), b) = AmplitudeModulation(a |> u"Hz" |> ustrip, b)
	AmplitudeModulation(a::typeof(1.0u"Hz")) = AmplitudeModulation(a |> u"Hz" |> ustrip)
	AmplitudeModulation(a::typeof(1u"Hz")) = AmplitudeModulation(a |> u"Hz" |> ustrip)

TagBot trigger issue

This issue is used to trigger TagBot; feel free to unsubscribe.

If you haven't already, you should update your TagBot.yml to include issue comment triggers.
Please see this post on Discourse for instructions and more details.

If you'd like for me to do this for you, comment TagBot fix on this issue.
I'll open a PR within a few hours, please be patient!

Rename HarmonicStack to SinusoidSource

Add modulator signal modifier

Make a streaming version of https://rob-luke.github.io/AuditoryStimuli.jl/dev/api/#AuditoryStimuli.amplitude_modulate

Set up tag bot

https://github.com/JuliaDiff/TaylorSeries.jl/blob/master/.github/workflows/TagBot.yml

Add ITD modulation modifier

Only support Julia 1.5 and above

Streaming processing (e.g. amplitude modulation)

Currently I have to ensure that I produce a full modulation cycle because the amplitude modulation function does not keep track of state between calls. It would be better to have a method for modulating the sound that can be called regardless of the amount of samples.

Register package

Switch to SampledSignals

SampledSignals fits better with giving the option of offline or realtime signal generation.

How can triggers be sent with stimuli?

1. As an additional audio channel that gets processed by external hardware (trigger box)
2. https://github.com/JuliaIO/LibSerialPort.jl

Add ITD signal modifier

Set up compat helper

Add a function for plotting cross-correlation

Make unit tests run faster

• Profile current tests and find slowest
• Pick them off one by one

Phase should have radian units

Set up compat

https://github.com/JuliaDiff/TaylorSeries.jl/blob/f6ff951567c442af77521549ecb526f3a40f5733/Project.toml#L13