Update sound

[XX-Yin]

Pull Request instructions:

• Please follow the update protocol
• Answer the questions below in detail. Your responses will be emailed to experimenters.
• If the experimenters must do anything new, provide detailed step by step instructions on the wiki
• If computer maintainers need to manually update anything, provide detailed step by step instructions
• Use markdown syntax in order for your comments to be rendered reliably in the email: "1." instead of "1)", use four spaces for indents.
• If you use the keyword "skip email" in the title, it will skip the email updates
• Merges from "develop" into "production_testing" should use the keyword "production merge" in the title for reliable indexing of updates
• Merges from "production_testing" into "main" should use the keyword "update main"

Describe changes:

Updated the bonsai workflow to load the decibel parameter from the settings_box#.csv. Previous:

Now:

What issues or discussions does this update address?

Set the decibel from the attenuation parameter, which is more flexible and no need to change the sound waveform.

Describe the expected change in behavior from the perspective of the experimenter

No

Describe any manual update steps for task computers

set AttenuationLeft to 0 in the settings_box#.csv. set AttenuationRight to 0 in the settings_box#.csv.

• [x] 447 @XX-Yin
• [ ] 323_EPHYS1 @KanghoonJ
• [ ] 323_EPHYS3 @XX-Yin

  Was this update tested in 446/447?

• [x] 447

[alexpiet]

Is AttenuationLeft required? Or does the workflow have a default value?

If it doesn't have a default value, can you add it to the mandatory fields? (https://github.com/AllenNeuralDynamics/dynamic-foraging-task/pull/503)

Is the process for setting this parameter clearly documented somewhere? Does a positive number mean more attenuation?

[XX-Yin]

Is AttenuationLeft required? Or does the workflow have a default value?

If it doesn't have a default value, can you add it to the mandatory fields? (#503)

Is the process for setting this parameter clearly documented somewhere? Does a positive number mean more attenuation?

It's read by the bonsai. I assume that it's more difficult (we can achieve it but just more difficult) to set a default parameter in bonsai.

Is AttenuationLeft required? Or does the workflow have a default value?

If it doesn't have a default value, can you add it to the mandatory fields? (#503)

Is the process for setting this parameter clearly documented somewhere? Does a positive number mean more attenuation?

Yes, AttenuationLeft is required. It's read by bonsai and the bonsai is more complex to set default value.

I added it to the mandatory fields.

@hagikent was testing this. I assume that the positive number means more attenuation.

[hagikent]

@alexpiet What @XX-Yin writes are all correct, thanks @XX-Yin . (although the value seemingly not linearly- or log- correlated with decibel..)

Is the process for setting this parameter clearly documented somewhere?

For the current 447, where already quiet sound is uploaded, it should be always 0. For 446 (and future 447), where round sound is uploaded and attenuated when being played, setting this value would be basically a calibration process, which we are now working on.

[alexpiet]

Thanks @hagikent, @XX-Yin for getting this figured out and implemented!

[XX-Yin]

@hagikent @alexpiet During testing in 447, I found some rigs are using the right channel of the soundcard instead of the left channel, so I added both AttenuationLeft and AttenuationRight to separately control the left and right channels.

[hagikent]

sounds good. ideally, connections should be made identical, though! (yes, I saw connections from soundcard to amplifier were somewhat random too...)

[alexpiet]

@XX-Yin @hagikent The next step is to make sure all the rigs are calibrated correctly. Perhaps during that process we can also move all the rigs to use the left sound channel?

[hagikent]

@alexpiet sounds like a plan