MOUSE_SCS

For mouse SCS procedures.

Quick Start

Following steps assume you are running an experiment for "Pilot_SCS_N_CEJ_07" on 2024-07-25:

Prepare Procedure Code and Files

1. Open MATLAB R202b and navigate to C:/MyRepos/NML/Mouse_SCS.
2. Copy experiment_2024_07_17.m to experiment_2024_07_25.m. Rename the SUBJECT_NAME from "Pilot_SCS_N_CEJ_06" to "Pilot_SCS_N_CEJ_07".
3. Copy processing_2024_07_17.m to processing_2024_07_25.m. Rename SUBJ from "Pilot_SCS_N_CEJ_06" to "Pilot_SCS_N_CEJ_07". Make sure YYYY, MM, and DD accurately reflect today's date.
4. Copy Pilot_SCS_N_CEJ_06_Channel_Map.txt to Pilot_SCS_N_CEJ_07_Channel_Map.txt. Draw the Picasso Rat on the whiteboard with numbers according to channels in that file.
5. Copy Muscle_Response_Times_Exponential_2024_07_17.xlsx to Muscle_Response_Times_Exponential_2024_07_25.xlsx. Adjust latencies in this file as needed during experiment (make sure the file is otherwise closed).
6. Leave this MATLAB instance open on processing_2024_07_25.m. You will update SWEEP number to reflect any experiment you want to export figures for.

Start Intan

1. Make sure that Intan 512ch RECORDING CONTROLLER is powered on and plugged into the computer via USB.
2. Start Intan RHX software. Select 20kHz for sample rate.
3. In RHX UI, click File > Load Settings and select Mouse_SCS.xml.
4. On the Triggers tab you can toggle "Triggered" mode on and off, which can be helpful to enable during the actual stimulation runs but otherwise should be toggled off.
5. The Spike Scope is accessed from the menu bar at the top. Make sure to toggle Lock to Selected so the scope shows the current channel you click in the main interface.
6. In RHX UI, click Network > Remote TCP Control, set Host to 127.0.0.1 and click Connect.

Start AM4100

1. Get the stimulation leads and plug into the anode/cathode ports on AM4100.
2. Make sure that AM4100 is powered on.
3. Make sure the green ENABLE switch is pressed.

• After depressing the switch, click OK when it gives the high voltage warning.

4. Connect BNC from AM4100 Sync 1 to Intan DIGITAL IN 1, and from AM4100 Sync 2 to Intan DIGITAL IN 2. Connect BNC from AM4100 MONITOR to Intan ANALOG IN 1.

Start MATLAB GUI

1. Right-click MATLAB icon and then click MATLAB R2020b to open a second MATLAB instance.
2. Open experiment_2024_07_25.m and click Run from the Editor tab in the UI.

• This should cause the stim controller GUI to populate. Move that somewhere convenient on-screen.

3. Make this MATLAB instance a small window and minimize it- DO NOT RUN processing...m from this window or you'll need to restart everything. Go back to the other previously opened MATLAB instance.
4. Enter experimental parameters and click RUN from the stimulation controller GUI.
5. After each sweep, update the SWEEP constant at the top of processing_2024_07_25.m and then click Run from the Editor tab in the UI.

• This should generate a new Powerpoint for each sweep with the stimulus response curves, on the Google Drive mapped in parameters.m.

Contents

• Configuration
• Experiments
• Main Experiment Functions
• AM4100 Interface
• TMSi Interface
• Initializers
• Loaders
• Plotting

Important

• parameters - Return parameters struct, which sets default values for things like epoch durations etc.

Experiment Scripts

• example_run_experiment - Script for testing/setup prior to experiment.

Main Experiment Functions

• runStimRecSweep - Returns a table of the stim/rec sweep intensity and block indices.
• runStimRecSweepAllChannels - Returns a table of the stim/rec sweep intensity and block indices, for ALL channels. Requires Raspberry Pi v4b with Relay module to MUX the AM4100 anode to the stimulation channels.

AM4100 Functions

• AM4100_sendCommand - Send message to stimulator and return formatted response message.
• AM4100_setInterPhaseInterval - Sets the interval between the two phases of asymmetric/biphasic pulses.
• AM4100_setStimEventPeriodAndCount - Set the AM4100 stimulation event period and number of stimuli.
• AM4100_setStimParameters - Set the stimulation parameters for AM4100 experiment.
• AM4100_stimulate - Stimulate using the AM4100, while recording this event.

TMSi SAGA Controller Functions

• SAGA_impedances - Measure impedances on HD-EMG array(s).
• SAGA_record - Run and increment the recording for TMSi-SAGAs AND Plexon (do not manually increment Plexon!).
• SAGA_setBufferSize - Updates tmsi client recording buffer samples for the next record.
• SAGA_stop - Stop the current recording/running SAGA state.
• SAGA_updateFileNames - Update filenames for SAGA A and SAGA B devices.

Interface Initializers

• initAM4100 - Initialize TCP interface to AM4100.
• initInterfaces - Initialize interfaces to TMSi and AM4100, plus logging.
• initTMSi - Create UDP client to control SAGA state machine running on some host device over IPv4 + UDP.

Data Loaders

• loadData - Load all data associated with a single sweep.
• loadMultiData - Load multiple sweeps into single sweep table.
• loadSweepSpreadsheet - Load spreadsheet for sweeps based on sweep folder and raw data root folder.

Plotting Functions

• plotRecruitment - Plot recruitment summary figure.
• plotSagaRecruitmentRaw - Plot recruitment for individual SAGA channel data.

Raspberry Pi Stim Channel Switcher

Code that was run on the Raspberry Pi v4b that managed stimulation switching is saved in the following gist.