getEventsFromCSV
Imports events from a .CSV file.
Description
This function creates an events.mat file from event information stored in a .CSV file. It is a generic function that can be used to import events from different devices using a list of timestamps, states, and eventIDs. The function can automatically search for a .CSV file in the specified RawFolder or use a specific csvFile name if provided. Here is a brief description of the required CSV file format:
- timestamps: A column containing the event timestamps (in seconds) from the beginning of the recording. Data type: single.
- state: A column containing the state of each event. Set 1 for HIGH and 0 for LOW. Data type: uint8.
- eventID: A column containing the unique identifier for each event. In this case, it can be the name of a condition, for example. Data type: string.
Example CSV File Format
| timestamps | state | eventID |
|---|---|---|
| 1.32 | 1 | eventA |
| 1.5 | 0 | eventA |
| 2.3 | 1 | eventB |
| 2.58 | 0 | eventB |
| 6.01 | 1 | eventA |
| 6.29 | 0 | eventA |
Output
This function creates an events.mat file containing the events information from the .CSV file and saves it in the Save folder. The events.mat file includes the processed event data, such as timestamps, state, and event IDs. This file can be used by other functions (e.g. split_data_by_event) to process event-triggered imaging datasets.
Parameters
Name of the .CSV file containing the event information ('timestamps','state' and 'eventID'). If not provided ('auto'), the function will look for a .CSV file in the Raw Folder and use the first one found to create the "events.mat" file.