Changes

When using audio in your experiment, especially when presenting time-critical stimuli, special care should be taken to optimize the audio settings on multiple levels (hardware, OS, script), as many things can go wrong along the way.  

When using video in your experiment, especially when presenting time-critical stimuli, special care should be taken to optimize the video and audio settings on multiple levels (hardware, OS, script), as many things can go wrong along the way.

This page outlines some best practices, however we advise to always consult a TSG member if you plan to run an audio experiment in the labs.

This page outlines some best practices; however, we advise to always consult a TSG member if you plan to run a video experiment in the labs.

==Recording==

==Recording==

When recording audio for stimuli material or as input for your experiment, please:

When recording video for stimulus material or as input for your experiment, please:

* Use a high quality microphone, with a [https://www.audio-technica.com/en-us/support/a-brief-guide-to-microphones-whats-the-pattern/ polar pattern] suitable for your application.

Use a high-quality camera, with settings appropriate for your application (e.g., frame rate, resolution).

* Use a high quality recorder or audio interface, capable of recording at 24bit and 48kHz or higher.  

Use a high-quality recorder or capture device, capable of recording at 1080p (1920×1080) and 60fps or higher.

* Place the microphone at an appropriate distance from your subject. Set the levels so the audio does not clip (exceeding maximum volume).

Stabilize the camera and avoid automatic exposure, white balance, or focus during recording to prevent inconsistencies.

* Record in a quiet environment.

Record in a controlled environment with consistent lighting and minimal background distractions.

 

You can use the facecam for high quality video recording.

You can use our [[Sound Recording Lab]]s for high quality voice recording.

==Editing==

==Editing==

We recommend using Audacity for editing and converting audio files. Audacity is open-source and fairly easy to use, available here: https://www.audacityteam.org/

We recommend using DaVinci Resolve for editing and converting video files. DaVinci Resolve is a free, professional-grade editing program, available here: https://www.blackmagicdesign.com/products/davinciresolve

Alternatively, you can use Shotcut, a simple open-source editor, available here: https://shotcut.org/

We recommend using the following export settings:

* File format: .wav (PCM).

The [[Lab Computer]] audio output is also set to 16 bit, 48kHz. We found that this is good enough for most applications; higher settings will increase file size with limited perceivable quality gains.

File format: .mp4 (H.264 codec(libx264))

Bitrate: 10-20 Mbps for Full HD video

  Example: -vsync cfr in ffmpeg.

In Audacity, you can set up Macros to automate processing and exporting your audio files: https://manual.audacityteam.org/man/macros.html

The [[Lab Computer]] displays are typically set to 1920×1080 at 120Hz. We found that this is sufficient for most applications. There are possibilities to go higher.

==Windows Settings==

==Windows Settings==

Windows 10 has a habit of automatically enabling '''audio enhancements''' when connecting new speakers or headphones. These "enhancements" can distort your audio and cause timing issues. Therefore, please make sure they are turned off:

Windows 10 has a habit of automatically enabling '''video enhancements''' or unnecessary processing features, which can interfere with smooth playback. Therefore, please make sure these are disabled:

==Playback==

==Playback==

=== Psychopy ===

=== PsychoPy ===

This is an example of a Python script that plays a .wav file with high time accuracy.

This is an example of a Python script that plays a .mp4 video file with high time accuracy. <syntaxhighlight lang="python" line> from psychopy import visual, core, prefs prefs.hardware['videoLib'] = ['avbin', 'ffpyplayer'] # Choose based on installed libraries

<syntaxhighlight lang="python" line>

from psychopy import sound, core

from psychopy import prefs

prefs.hardware['audioLib'] = ['PTB']

audio_file = "voice.wav"

win = visual.Window(fullscr=True, monitor="testMonitor", units="pix")

Path to video file

# preBuffer – integer to control streaming/buffering -1 means store all

video_file = "stimulus.mp4"

audio = sound.Sound(audio_file,preBuffer=-1)

audio.play()

movie = visual.MovieStim3(win, video_file, size=(1920, 1080), flipVert=False, flipHoriz=False, loop=False)

core.wait(audio.getDuration())

while movie.status != visual.FINISHED: movie.draw() win.flip()

# Close audio

Close window

audio.stop()

win.close() core.quit() </syntaxhighlight>

audio.close()

</syntaxhighlight>