LaDIVA

DIVA connected to BCM Zañartu 2014

V007 - Hardcorded for Pitch Reflex : run one iteration, change perturbation magnitude, duration, direction

    * BCMlookuptable.m download from https://drive.google.com/file/d/1Arn8HqNxDIot3IpTC7q68Wmqj7G_--lC/view?usp=sharing
    * Current version upladed to PLOS Comp Bio submission
    
    # LaDIVA sourcecode

The source code of Laryngeal DIVA model, which combines DIVA model of speech motor contorl with extended body cover model for laryngeal biomechanical control.

Installation

1. Download the sourcecode provided to a target location (e.g.: localpath/LaDIVA) in the local machine.
2. Download the mat file 'BCMlookuptable.m' from the link here and add it to the same target folder (localpath/LaDIVA/) the sourcecode was saved to.

Running the simulink model

1. Click on the model file 'diva.slx' under the target folder (localpath/LaDIVA/diva.slx) to open the simulink model and click on the Production 'input' module to open the DIVA Graphic User Interface(GUI).

Figure 1.LaDIVA Simulink Model

2. Select the input and output signals that needs to be observed. In the example below Cricothyroid(CT) muscle activation, Thyroarytenoid(TA) muscle activation, Subglottal pressure, and glottal constriction signals are plotted as input signals, and vocal fundermental frequency (fo), vocal Sound Pressure Level (SPL), and voicing are plotted as output signals.

Figure 2.LaDIVA Graphic User Interface(GUI)

3. Select the target sound that needs to be produced from the drop down menu at the bottom and click Start button to run a simulation.

Introducing perturbations to the model

1. Auditory reflexive or auditory adaptive perturbations of vocal fo can be introduced by navigating to the simulink model and opening the auditory perturbation block.
2. First select the Perturbation type
3. For Auditory Reflexive Perturbation, you can run one reflexive trial simulation. Set perturbation magnitude (in Cents), perturbation duraiton, and perturbation onset as propted. See Fig 3.

Figure 3. For Pitch Reflexive Perturbation: Setting perturbation magnitude, perturbation duration, and perturbation onset in Auditory Perturbation block

4. For Auditory Adaptive Perturbation, you can run multiple trial length simulations. Set maximum perturbation magnitude (in Cents), and number of trials in each phase as propted. See Fig 4. Note: you should select the number of trials as the number of repeatitions in DIVA_GUI

Figure 4. For Pitch Adaptive Perturbation: Setting Phases in adaptation paradigm and max perturbation magnitude in Auditory Perturbation block

Modifying Feedback and Feedforward Gains

1. In the main Simulink model > select 'Articulatory Velocity and Position Map" > and click on Gain blocks to modify feedback and feedforward gains

Figure 5. Artucilatory Velocity and Position Map block

3. You can modify the following gain values

   • Feedback Gain (overall) : This is set to 1 and not modified

   • Feedforwward Gain (overall) : This is set to 1 and not modified

   • Auditory Feedback Gain : Modify to fit auditory reflexive experiment datasets

   • Somatosensory Feedback Gain : This is set to 0 and not modified
     

   • Feedforward Learning Rate : Modify to fit auditory adaptive experiment datasets