| title | category | tags | redirect_from | ||
|---|---|---|---|---|---|
How should I get started with the FieldTrip realtime buffer? |
faq |
|
|
The fastest and best way to get started is to try out something really simple. This does not require MATLAB.
Navigate to the directory ''fieldtrip/realtime/bin/ARCH'' where ARCH is the architecture of your compute
| Architecture | Description |
|---|---|
| win32 | 32-bit Microsoft Windows |
| mac | 32-bit macOS on PPC hardware |
| maci | 32-bit macOS |
| maci64 | 64-bit macOS |
| glnx86 | 32-bit Linux |
| glnxa64 | 64-bit Linux |
| raspberrypi | Debian Linux on the Raspberry Pi |
Unless otherwise specified, this assumes that you are using an Intel-compatible computer.
- Start the ''buffer'' application.
- Start the ''sine2ft'' application.
- Start the ''viewer'' application.
The buffer application does not show anything, it only starts the buffer, which subsequently starts listening to network requests on port 1972 (the default port). On the DOS or Unix command line you are able to specify another port, but that is not required here.
The sine2ft and viewer initially looks like this:
{% include image src="/assets/img/faq/fieldtripbuffer_gettingstarted/sine2ft.png" width="300" %} {% include image src="/assets/img/faq/fieldtripbuffer_gettingstarted/bufferviewer.png" width="400" %}
If you click "start" in the sine2ft window, and subsequently "connect" in the viewer window, you will see that data starts streaming from sine2ft->buffer->viewer.
{% include image src="/assets/img/faq/fieldtripbuffer_gettingstarted/sine2ft_running.png" width="300" %} {% include image src="/assets/img/faq/fieldtripbuffer_gettingstarted/bufferviewer_running.png" width="400" %}
Subsequently you could start MATLAB, while keeping the three programs running, and run the following:
while true
hdr = ft_read_header('buffer://localhost:1972')
pause(1)
end
which will show something like this, being updated every second.
hdr =
Fs: 2000
nChans: 16
nSamples: 182784
nSamplesPre: 0
nTrials: 1
orig: [1x1 struct]
label: {16x1 cell}
chantype: {16x1 cell}
chanunit: {16x1 cell}
You should see hdr.nSamples increasing over time.
Subsequently you could do
while true
dat = ft_read_data('buffer://localhost:1972', 'begsample', 1, 'endsample', inf);
plot(dat');
pause(1)
end
to see the amount of data in the buffer steadily increasing over time. Note that all channels have exactly the same value, hence you will only see a single sine wave.
{% include image src="/assets/img/faq/fieldtripbuffer_gettingstarted/screen_shot_2013-11-12_at_17.05.01.png" width="400" %}
After a certain amount of time, the ring buffer will fill up and start wrapping around. From that point onward you will not be able to read the data all the way back from sample 1.
You can combine the ft_read_header and ft_read_data calls to plot only the data of interest. You can also use ft_read_event to determine triggers, and based on those process certain pieces of data.
The getting started with realtime analysis documentation provides a more elaborate starting point. You might also want to click on the "realtime" tag at the top of this page, which will show you all other pages that share the same tag.