Moving Sound with Csound's HRTFMOVE2, Basic
My current project involves sounds moving in space around a listener’s head. This post explores one way to make it seem like sound is moving.
As I am most comfortable coding in python, and can generate text files using it,
I decided to figure out the mathematical formulas,
create a Csound
.csd file that uses this spatial information,
and render the audio file. To do all this, I needed to investigate how to make it appear like sounds are coming from where I want to them to in Csound. Enter HRTFMOVE2.
Csound has a few models that can be used to spatially locate sound. HRTFMOVE2 is a model that places a unit sphere around the listener’s head. You can make sound appear to come from anywhere on that sphere.
General Csound Background info
If you know Csound, great! Skip this section. If not, read it. Knowing the organization will help.
Csound is “a sound and music computing system” that has been open source since the 90s.
; are comments.
All Csound code starts and ends with opening and closing statements, given below.
This is similar to how HTML starts with
<!Doctype HTML><html> and ends with
Between this, in Csound there are 3 sections,
CsOptions, we declare processing options and information related to playing back or saving the file.
CsInstruments, we define which instruments will be used.
CsScore, we tell which instrument when to play.
.csd file is structured like the file below.
Let’s look at what went into each section, and made it possible to use HRTFMOVE2.
Using HRTFMOVE2 in Csound
I began with a sample
.csd file from Csound’s documentation, linked to above.
With Michael Gogin’s help, I modified it to the following excerpts.
I will break down the code piece by piece.
A simple use of HRTFMOVE2
sample1.csd, takes a simple melody and plays it using
a sine wave instrument who’s sound is mapped to different places by an
HRTFMOVE2 instrument. The sound rotates laterally around the listener’s head, starting on the right, fully circling, then ending on the left.
This section uses 3 command line flags:
- Play the music from your computer after the score is compiled.
- Show note amplitude messages and samples out of range. Select a 32dB note amplitude format.
- Run the file whether or not the orchestra is empty or doesn’t compile.
With Mr. Gogin’s help, I settled upon the following code.
Now that we have decided how the music will be compiled and played back,
we define what we need to know to make instruments.
Generally, we need to know the
- The audio sample rate used. It should be supported by your computer’s sound card. The higher the sample rate, the smoother the transitions will sound in spatial dependent music performances, so I chose the highest sample rate compatible with my audio card and HRTFMOVE2, a rate of 96000Hz.
- The number of samples in a control period. If your computer processes quickly, you might as well choose as low a natural number as possible, and get the best sound you can out. I chose 1.
- Sets the number of channels of sound that will be used. I’m working with the goal of having the music played over headsets, so this is 2, one for each ear.
Next, we make two instruments, instrument 1 to produce the sound we hear, and instrument 10 to take the sounds we hear and make them sound like they’re coming from specific places. I received lots of help when building both instruments.
Instrument 1 has many components.
It is a simple sine oscillator, but it takes in information from the score,
Since the notes are input as midi numbers, and this oscillator,
poscil, runs off of frequency defined pitches, we need to convert to frequency from midi with
It also has a slight attack and decay envelope,
adeclick, (encouraged by Mr. Gogins),
which is necessary for clear note attacks and releases without clipping,
especially when there are successive notes.
Lastly, to pass the sound to the next instrument, we add the signal,
to a placeholder channel,
Instrument 10, the MVP of this process of creating a 3d experience, is a bit confusing.
First, we construct two line segments,
kaz (the azimuth direction) and
kel (the elevation direction), that tell us how far the sound will rotate around the unit sphere when instrument 10 plays.
Instead of passing in these numbers from the score and varying them, I set
kaz to rotate from the right side of the head, around a full 360 degress,
then rotate another 180 to land on the left side.
No elevation changes occured, because
kel starts and ends at 0.
Both rotations take
p3 time, which is given in the score.
Next, we retrieve the information we stored in the channel
We place it in
hrtfmove2, along with
HRTF spectral data for specific sample rates given in
a number of overlaps for SRTF processing (4), a head’s radius in centimeters,
and the sample rate of the piece.
We get two outputs,
aright, one for each ear.
We clear the channel so that we can reuse the channel and instrument as necessary.
Last but not least, we create a score section of the
First, we generate the points of the sign wave in our function table statement,
Next, we set a tempo, with tempo statment
Lastly, we tell csound which notes to play when, using which instrument, and for how long. The line
lets us know that instrument 1 plays midi note 79 for 1.49 seconds at an amplitude of 8000, at time 0.0.
When you have an instrument
i1.2, etc., this means that you have a chord.
Instrument 10 plays from time 0 to time 20. So the entire time that instrument 1 plays, instrument 10 will also be playing.
The score ends with
The code, as written above, gives us the following sound file. Listen using earphones.
Now we change it. Instead of coding for lateral motion, we code for a change in elevation. We replace the beginning of instrument 10 with the below.
This gives us the following, which should also be listened to with earphones.
It’s easier to hear a change in lateral motion than a change in the angle of elevation!
More To Do
Phew! We’ve covered the basics. The next post on this topic will explore using multiple HRTFMOVE2 instruments simultaneously.