Instructions for wavesynthTune

Click here to toggle highlighting for goal links

This task will help you practice writing basic code and will help you get familiar with the wavesynth library for creating music with Python.

The requirements are very simple, and in fact, there are no restrictions on what notes you create: the only rules are that you must make use of certain functions.

To start, you need to create a new file, named tune.py. This file must be in a folder where wavesynth.py is also present. To create that file, you should:

1. Download the starter code for this task from Potluck.
2. Unzip the downloaded file to create a folder to work in. This folder will include a file called wavesynth.py.
3. In Thonny, create a new file. Immediately use "save" or "save as" and then pick the folder you just created as the destination, with "tune.py" as the filename.

Now you're ready to write code. Your tune.py file must satisfy the following criteria:

1. Your file must start with a triple-quoted string at the top, identifying the names of each author, which classmates and/or tutors and/or instructors you consulted for help, the last date you modified the file, and a brief description of the purpose of the file. We will do this for all files that you submit in this class. Here is an example:

   """
   Authors: Anon & Ymous
   Consulted: T. A.
   Date: 2022-1-21
   Purpose: Wavesynth tune task
   """
   

2. Your file must import the wavesynth module so that you can use functions from it.

3. You must use each of the following basic functions for creating sounds (reference) at least once:
   • addNote
   • addBeat
   • addRest
4. You must use at least one of the functions climbUp, climbDown, halfStepUp, or halfStepDown to change the current pitch between notes. For full credit, you must both use at least one of climbUp or climbDown and use at least one of halfStepUp or halfStepDown, and you must also use setPitch.
5. You must use at least one of the setVolume, quieter, and/or louder functions to manipulate the volume of one or more notes or beats.
6. You must use at least one of the setTime, rewind, and/or fastforward functions to alter the time at which some notes or beats are created.
7. You must use the saveTack function so that your program saves the music to a file. You may name your saved file whatever you wish. As an extra goal, you may also use the printTrack function to print out a record of the notes you created. Calling playTrack is not required, but if simpleaudio can be installed on your system, it's a faster way to hear the audio than opening up the saved file each time.
8. For full credit, you must use at least one of the setDrum and/or setInstrument functions to specify the instrument or drum used to create notes. You can see the list of available beat and note instruments in our quick reference.

You are welcome to use other wavesynth features in addition to the ones listed above, but only the above features are required.

If you want to challenge yourself and read ahead a little bit, consider defining a custom function and using it as part of your tune (but you will not receive any extra credit for this, so don't do it if you're short on time).

Reminder: If you want to hear sounds using playTrack, you must install the simpleaudio module using the Package manager in the Thonny Tools menu (search for simpleaudio, select the result with that name, and then click "install"). This may not work on some machines. If simpleaudio and thus playTrack doesn't work for you, just use saveTrack to save as a .wav file and then open that file after you run your program.