Pysound simple sine waves
In this example, we will create a simple sine wave.
Here is the code:
from pysound.buffer import BufferParams from pysound.oscillators import sine_wave from pysound import soundfile from pysound.graphs import Plotter params = BufferParams() out = sine_wave(params, frequency=500) soundfile.save(params, 'sine-500.wav', out)
After importing several modules, there are just 3 lines of code.
First, we create a
BufferParams object. This object controls the length of the sound, and also the sample rate. The default constructor specifies a sound that is 1 second long, and has a sample rate of 44,100 samples per second (this is the sample rate used by an audio CD):
params = BufferParams()
Next, we call the
sine_wave function, which creates a sine wave tone.
out = sine_wave(params, frequency=500)
We pass in the
params object to tell the function how long the sound should last, and what sample rate to use.
We also pass in a
frequency of 500, to set the wave frequency to 500 Hz.
sine_wave function takes several other parameters too, but we will use the default values. This creates a sine wave tone with an audio frequency of 500 Hz and an amplitude of 1.0.
The function returns a NumPy array, that we store in
Finally, we write the data out to a WAV file:
soundfile.save(params, 'sine-500.wav', out)
This takes the data and converts it to WAV format. It is stored as sine-500.wav in the current folder.
Listening to the sound
You should be able to play the wav file using your system media player.
You can also use Audacity, an open-source audio editor. This is a very useful program that can be used to play, view and edit sound files, it is well worth installing.
Plotting the wave
graphs module allows us to create a plot of a sound buffer.
We use the
Plotter object to create a graph of the first part of the wave:
## Plot a graph of the first part of the previous sine wave Plotter(params, 'sine-500.png', out).with_timerange(0, 0.01)\ .with_title("500 Hz sine wave")\ .in_milliseconds()\ .plot()
Plotter constructor accepts
out from the previous code, and also the string 'sine-500.png' which tell Pysound where to store the image file.
We also set the time range, so that the plot only includes the first 0.01 seconds of the wave.
Since the wave has a frequency of 500 Hz, one cycle of the wave takes 0.002 seconds (ie, one 500th of a second). This means that the first 0.01 seconds of the waveform contains 5 full cycles of the wave. Here is the graph:
The graph is scaled in milliseconds (ms) as this is easier than dealing with small fractions. 0.01 seconds is 10 ms, 0.002 seconds is 2 ms.
If we tried to plot the whole one second of the wave, we wouldn't be able to see the individual waves, they would be far too close together. By plotting a 10 ms section of the wave, the waveform can be seen easily.
For a full description, see the later tutorial on the
Sign up to the Creative Coding Newletter
Join my newsletter to receive occasional emails when new content is added, using the form below: