PURE DATA

PureData: PureGlossary

Glossary

(Names of other glossary entries are in bold when they first appear in an entry, while the names of Pd objects appear in [square brackets].)

Glossary Terms

Abstraction

A reusable block of code saved as a separate Pd patch and used as if it were an object. Any abstraction to be used must either be saved in the same working directory as the Pd patch it is used in, or the directory it is saved in must be included in the path section of the Pd settings. Abstractions can be opened by clicking on them, and the GUI elements inside can be displayed even when closed by setting their properties to Graph on Parent. Inlets and outlets can be used to send and receive information to and from an abstraction, as well as send and receive pairs.

ADC

Analog to Digital Converter - the line into Pd from the sound card. The Pd object for this is [adc~].

ADSR

(Attack, Decay, Sustain and Release) the common points of change (or breakpoints) in the envelope of a note.

Aliasing

whenever a sound is replayed or synthesized whose frequency is over the Nyquist number (half the current sampling rate), a second frequency will be heard "reflecting" off the Nyquist number downwards at the same increment in Herz. Example: if the sampling rate is 44,100 Hz, the Nyquist number would be 22,050. If one attempted to play a sound at 23,050 Hz, an additional tone at 21,050 Hz (the difference between the two frequencies subtracted from the Nyquist number) would be heard.

ALSA

Advanced Linux Sound Architecture - the default set of audio drivers for the Linux operating system.

AM Synthesis

See Amplitude Modulation Synthesis.

Amplitude Modulation Synthesis

A type of sound synthesis where the gain of one signal is controlled, or modulated, by the gain of another signal. The signal whose gain is being modulated is called the "carrier", and the signal responsible for the modulation is called the "modulator". In classical Amplitude Modulation, or AM Synthesis, both the modulator and the carrier are oscillators, however the carrier can also be another kind of signal, such as an instrument or vocal input. Amplitude Modulation using a very low frequency modulator is known as Tremolo, and the use of one audio signal to Amplitude Modulate another audio signal is known as Ring Modulation.

Anything

A keyword in certain objects which matches an atom or series, sometimes written as "a" or "any".

Argument

A piece of information sent to an object which sets a parameter of that object. Arguments can be sent as messages, or taken from creation arguments. Arguments are also used to replace variables (often represented by dollar signs) in messages and objects. By using the [pack] object, multiple arguments can be sent in a message.

Array

A way of graphically saving and manipulating numbers. It works in an X/Y format, meaning you can ask the array for information by sending it a value representing a location on the X (horizontal) axis, and it will return the value of that position value on the Y (vertical) axis. Arrays are often used to load soundfiles in Pd, and are displayed on screen in graphs.

ASIO

Audio Stream Input/Output - an audio driver for low latency audio input and output developed by the Steinberg audio software company and available for many soundcards using the Windows operating system.

Attack

The beginning of a note, which is usually triggered by pressing a key on a keyboard or by a sequencer. A slow attack means the sound takes longer to reach full volume than a faster attack. See also envelope.

Atom

A keyword meaning the most basic element of data.

Audio Driver

Provides a system of input and output between the soundcard and applications using the soundcard. The more efficient the audio driver, the lower the latency of an audio system will be. Examples include MME and ASIO for Windows, CoreAudio for Mac OS X and OSS, ALSA and JACK for Linux.

Bandlimited

When the waveform used by an oscillator has been constructed with a limited number of harmonics in order to reduce aliasing, then it is said to be bandlimited.

Bang

is special message in Pd, which many objects interpret as "do something now!", meaning do the operation the object is supposed to do with the information it already has received in its inlets. Bang can be sent via a GUI element, the [bang] object or a message box. [bang] can also be abbreviated to just [b].

Bit Depth

Refers to the number of bits used to write a sample. Each sample of 16-bit audio, which is the CD standard, is made from 16 bits which can either be 0 or 1. This gives 2₁₆ (or 2x2x2x2x2x2x2x2x2x2x2x2x2x2x2x2 = 65,536) number of possible values that sample can have. A higher bit depth means a greater dynamic range. In contrast to 16 bit audio for CDs, studio recordings are first made at 24 (or even 32) bit to preserve the most detail before transfer to CD, and DVDs are made at 24 bit, while video games from the 1980s remain famous for their distinctively rough "8 bit sound". Bit depth is also referred to as word length.

Buffer

a chunk of memory inside the computer used to store sound. The soundcard uses a buffer to store audio from the audio applications for playback. If the latency of the system is too low for the soundcard and audio drivers, then the buffer will be too small and the soundcard will use all the audio data in the buffer before getting more from the audio application, resulting in an interruption know as a "dropout", or glitch.

Canvas

An area of pixels in the patch which is used to add color or graphical layout to the patch. Since Pd remembers when things were put in the patch, a canvas is placed in the patch before any other objects which must be seen on top of it. Alternately, objects to be seen on top of the canvas can be Cut and then Pasted over it.

Carrier

In Amplitude Modulation or Frequency Modulation synthesis, the carrier is the oscillator which is affected by the Modulator.

Clipping

Clipping occurs when a signal is too loud for the soundcard to reproduce it. This happens when the samples used to represent the sound go out of the range between -1 and 1 due to amplifying them. Any samples out of this range will be truncated to fit within that range, resulting in distortion, a loss of audio detail and in frequencies which were not present in the original sound. The clipping point of a system is referred to as 0 dB in the gain scale, and the gain of any sound is measured in how far below the clipping point it is (-10 dB, -24 dB, etc).

Cold and Hot

In Pd, the left-most inlet of an object is called "hot", which means that any input to that inlet causes the object to do its function and create output at the outlet. Any other inlet to the right of the left-most inlet is considered "cold", which means that input to these outlets is stored in the object until it receives input on the hot inlet, at which time all the information stored in the object is acted on.

Comment

A line of text in a patch which explains some part of the patch, or is a reminder to the programmer or anyone else who opens the patch later on. Comments have no actual affect on the function of the patch.

Creation Argument

Additional information given when an object is created. Example: making an object called [osc~ 440] would create a cosine oscillator (the name of the object) with a starting frequency of 440 Hz (the creation argument). See also Argument.

Cutoff Frequency

The frequency at which a filter begins to affect a sound.

DAC

Digital to Analog Converter - the line out to the sound card from Pd. The Pd object for this is called [dac~].

DC Offset

DC offset is caused when a waveform doesn't cross the zero line, or has unequal amounts of signal in the positive and negative domains. This means that, in our model speaker, the membrane of the speaker does not return to its resting point during each cycle. This can affect the dynamic range of the sound. While DC offset can be useful for some kinds of synthesis, it is generally considered undesirable in an audio signal.

Decay

The amount of time a sound takes to go from peak volume down to it's sustain level (in the case of an envelope), or to no sound at all (in the case of a delay).

Decibel

Decibel is a scale used to measure the gain or loudness of a sound. Decibel is usually abbreviated to dB and usually denotes how far under 0 dB (the clipping point of a system) a sound is (-10 dB, -24 dB, etc). The Decibel scale is logarithmic.

Delay

The amount of time between one event and another. As an audio effect, a delay takes an incoming sound signal and delays it for a certain length of time. When mixed with the original sound, an "echo" is heard. By using feedback to return the delayed signal back into the delay (usually after lowering its gain), multiple echos with a decay result. The Pd objects to create a delay are named [delwrite~] and [delread~], and the pair must be given the same creation argument in order to communicate (i.e. [delwrite~ rastaman] and [delread~ rastaman]). As a setting in Pd, delay changes the latency of the program to allow for faster response time at the expense of more gliltches or vice versa.

Distortion

Distortion occurs when an audio signal is changed in some way on the level of the samples which produces frequencies not present in the original. Distortion can be deliberate or unwanted, and can be produced by driving the signal to a clipping point, or by using mathematical transformations to alter the shape (or "waveform") of the signal (usually referred to as "waveshaping").

Dollar Sign

A symbol in Pd which is used to represent a variable in either a message or a creation argument. Multiple dollar signs can be used, as in "$1 $2 $3". In such a case, $1 will take the first argument in an incoming message, $2 the second, $3 the third, etc etc. And in the message "set $1", any number sent to this message would replace $1, resulting in "set 1", "set 2", "set 3" etc depending on what number the message received. In the case of a creation argument used in an abstraction, one could create an abstraction named [myniceabs], and call it in a patch as [myniceabs 34], [myniceabs 66] and [myniceabs 88]. In this case, the initial frequency of an [osc~ $1] object in [myniceabs] would be set to 34 Hzin the first abstraction, 66 Hz in the second and 88 Hz in the third, since the creation argument of the [osc~] object sets its starting frequency. $0, however, is a special case, and is set to a unique random number for each abstraction it is used in (but it retains the same value everywhere inside that abstraction).

Dynamic Range

Used to refer to the difference between the loudest sound that can possibly recorded and the quietest, as well as the amount of detail which can be heard in between. Sounds which are too quiet to be recorded are said to be below the noise floor of the recording system (microphone, recorder, sound card, audio software, etc). Sounds which are too loud will be clipped. In digital audio, the bit depth used to record the sound determines the dynamic range, while in analog electronics, the self-noise of the equipment also determines the dynamic range.

Edit Mode

The mode in Pd where objects, messages, comments, GUI elements and other parts of the Pd can be placed on the screen and moved around. Edit mode can be switched in and out of by using the Edit menu or the Control (or Apple) and "E" keys. The opposite of Edit mode is Play mode.

Envelope

A term used to describe changes to a sound over time. Traditionally, this is used to synthesize different instrumental sounds with Attack, Decay, Sustain and Release (or ADSR) which are triggered at the beginning of a note. A violin, for example, has a slow attack as the strings begin to vibrate, while a piano has a fast (or "percussive") attack which seperates it's distinctive sound (or "timbre") from that of other instruments.

External

An object in Pd which was not written into the core Pd program by the author, Miller S. Puckette. Externals are created and maintained by the Pure Data development community, and account for many of the additional fucntions of Pd, including the ability to manipulate video and 3D as well as stream MP3s and many other things. Externals are usually loaded as an external library at the start of a Pd session by including them in the startup flags, although some can be loaded as single objects at anytime as long as the location where that external is saved on your system is listed in the path setting of Pd.

External Library

A collection of externals written for Pd. Taken as a library, externals can be loaded at the start of a Pd session by including them in the startup flags.

Filter

An audio effect which lowers the gain of frequencies above and/or below a certain point, called the cutoff frequency. The range it allows through is called the pass band, and the frequencies which are reduced are called the stop band. A High Pass filter [hip~] only allows frequencies above the cutoff frequency through. A Low Pass filter [hip~] allows only frequencies lower than the cutoff frequency through. A Band Pass filter [bp~] only allows frequencies close to the cutoff frequency through. The amount by which the filter lowers the gain of frequencies in the stop band is measured in Decibels per Octave, and is affected by the resonance (or "Q") of the filter, which determines the amount of feedback the filter uses and which frequency is most emphasized by the filter.

Feedback

Feedback occurs in any system where the output is played back into the input. 100% feedback means all of the output is returned to the input. A classic example is holding a microphone in front of a speaker. Less than 100% feedback means that the signal is decreased in some way with each pass through the system. In delays, the amount of feedback determines how many repetitions of the "echo" one hears until the sound decays to zero. In a filter, feedback determines the resonance of the filter, and how much emphasis in given to the filter's cutoff frequency.

Float orFloating Point

A number with a decimal point, which can be positive or negative and represent a range between -8388608 and 8388608. A special notation is used for extremely large or small floating point numbers, since Pd only uses up to 6 characters to represent a floating point number. Therefore, "1e+006" is a floating point number which represents "1000000" (or 1 with 6 decimal places after it), while "1e-006" represents "0.0000001" (or 1 with 6 decimal places in front of it).

FM Synthesis

See Frequency Modulation Synthesis

Foldover

Foldover occurs when a frequency higher than the Nyquist number is played or synthesized. See Aliasing.

Frequency

Refers to number of times in one second a vibration (in many cases a sonic vibration) occurs. Frequency is measured in Herz, and often indicates the pitch of a sound which is heard. Frequency is a linear scale, however, while pitch is logarithmic. This means that a sound which is heard as one octave above another one is twice the frequency in Hz, while two octaves above would be four times the frequency and three octaves above would be eight times.

Frequency Modulation Synthesis

A type of sound synthesis where the frequency of one oscillator is controlled, or modulated, by the gain of another oscillator. The signal whose gain is being modulated is called the "carrier", and the signal responsible for the modulation is called the "modulator". In classical Amplitude Modulation, or AM Synthesis, both the modulator and the carrier are oscillators, however the carrier can also be another kind of signal, such as an instrument or vocal input. Very slow Amplitude Modulation is known as Tremolo.

Gain

Expresses the strength of an audio signal, and is expressed in Decibels. The scale of gain is logarithmic, since it expresses the physical ratio of power between one sound and another. Gain is commonly measured in digital audio systems as the amount of Decibels below 0 dB, which is the clipping point (-10 dB, -24 dB, etc). See also loudness.

Glitch

A sonic error occurring when the computer does not have enough time to process the audio coming in or out of an audio application before sending it to the sound card. This is a result of having too low a latency, so that the buffers of the sound card are not filled up as fast as the soundcard is playing them, resulting in an temporary but audible loss of sound. Glitches can occur when other processes interrupt the processor with various tasks (such as refreshing the display on the screen, reading or writing a hard drive, etc etc).

Graph

A graph is a graphical container that can hold several arrays. An array needs a graph to be displayed, so whenever you create an array from the menu, you will be asked whether you want to put it into a newly created graph or into an existing graph.

Graph on Parent

A property of subpatches and abstractions where the GUI elements of the subpatch or abstraction are visible in the main patch even when that subpatch or abstraction is not open. This allows for better graphic design and usability for complicated patches.

GUI element

Graphical User Interface - visible parts of the Pd patch which are used to control it via the mouse or to display information, such as sliders, radio buttons, bangs, toggles, number boxes, VU meters, canvases, graphs, arrays, symbols, etc.

Harmonics

HID

see Human Interface Device

Hot and Cold

Hradio

A horizontal radio button. See also GUI element.

Hslider

A horizontal slider. See also GUI element.

Hertz or Hz

A term used to describe the number of times something occurs in one second. In digital audio, it is used to describe the sampling rate, and in acoustics it is used to describe the frequency of a sound. Thousands of Herz are described as KHz.

Human Interface Device

A Human Interface Device (aka HID) is any device that is meant to allow humans to interact with a computer. Usually, HIDs are mice, keyboards, joysticks, tablets, gamepads, etc. There a number of unusual HIDs, like the Griffin PowerMate on the low end, or the SensAble PHANTOM 6DOF on the high end.

Index number

Index numbers are used to look up values stored in Arrays. If we ask an array what is stored at index number "0", it will return the first value stored there. And if the array has 100 values stored in it, asking it for index number "99" will give the last value stored.

Inlet

The small rectangular boxes at the top of objects, GUI elements, messages, subpatches and abstractions. They receive input from the outlets of the objects, messages, GUI elements, subpatches or abstractions above them. Inlets can be hot or cold.

Integer

In Pd, this is a whole number, without a decimal point, which can be positive or negative. See also floating point.

JACK

JACK Audio Connection Kit - a low latency audio system designed to run on Linux and Mac OSX in combination with various audio drivers such as ALSA and Portaudio. On Linux, the QJackctl application can be used to make audio and MIDI connections between the soundcard, MIDI devices such as keyboards and Pd. On Mac OSX, JACK is referred to as JackOSX, and the JackPilot application functions like QJackCtl, but only for audio connections.

Latency

The amount of time needed to process all the samples coming from sound applications on your computer and send it to the soundcard for playback, or to gather samples from the sound card for recording or processing. A shorter latency means you will hear the results quicker, giving the impression of a more responsive system which musicians tend to appreciate when playing. However, with a shorter latency you run a greater risk of glitches in the audio. This is because the computer might not have enough time to process the sound before sending it to the soundcard. A longer latency means less glitches, but at the cost of a slower response time. Latency is measured in milliseconds.

Linear

A scale of numbers which progresses in an additive fashion, such as by adding one (1, 2, 3, 4...), two (2, 4, 6, 8...) or ten (10, 20, 30, 40...). Another type of scale used in Pd is logarithmic. Multiplying an audio signal, for example, by either a linear or a logarithmic scale will produce very different results. The scale of frequency is linear, while the scales of pitch and gain are logarithmic.

List

A special type of message that is a collection of data. Specifically, a "list" is a series of 3 or more atoms whose first atom is the selector "list", or, a series of 2 or more atoms whose first atom is numeric, which causes the "list" selector to be implied, i.e. [list one two(, [1 2(, [1 two(.

Logarithmic

A scale of numbers which progresses according to a certain ratio, such as exponentially (2, 4, 8, 16, 256...). Another type of scale used in Pd is linear. Multiplying an audio signal, for example, by either a linear or a logarithmic scale will produce very different results. Both scales of pitch and gain are logarithmic, while the scale of frequency is linear.

Loudness

Unlike gain, which expresses the physical power of a sound, loudness is the perceived strength of a sound. Higher frequencies are perceived as louder than mid-range or lower frequencies with the same amount of gain, and the amount of perceived difference varies from person to person.

Message

A piece of information sent to the objects of a patch, often using the message GUI element. Messages tell objects which functions to perform and how, and can be simply numeric, include text which describes which function to change or even contain other information such as the location of soundfiles on the computer.

MIDI

A system of describing musical information in electronic music using numbers between 0 and 127. There are various types of MIDI messages which can be sent in and out of Pd such as note ([notein], [noteout]), pitchbend ([pitchin], [pitchout]), continuous controller ([ctlin], [ctlout]) and program change ([pgmin], [pgmout]). MIDI messages can be sent to and from external MIDI devices, such as keyboards, slider boxes or hardware sequencers, or they can be exchanged with other MIDI applications inside the computer.

MME

The default set of audio drivers for the Windows operating system. MME drivers do not have as low latency as ASIO drivers.

Modulator

In Amplitude Modulation or Frequency Modulation synthesis, the modulator is the oscillator which affects the Carrier.

Monophonic

A monophonic electronic music instrument has one voice, meaning that only one note can be played at a time. See also polyphonic.

Noise Floor

The part of the dynamic range which represents the quietest sound which can be recorded or played back. Sounds below this level (expressed in Decibels) will not be heard over the background noise of the system. In digital audio, the bit depth used to record the sound determines the noise floor, while in analog electronics, the self-noise of the equipment also determines the noise floor. Typical computer soundcards can have an analog noise floor between approximately -48 dB and -98 dB.

Normalize

To normalize an audio signal means to adjust its gain to peak at the maximum the sound card allows before clipping (i.e. -1 and 1). This is done to maximize the dynamic range of the signal when it is played back.

Note

In electronic and computer music, a note is represented on the MIDI scale by two numbers between 0 and 127 (the amount of keys available on the MIDI keyboard). A note is triggered either by pressing a key on the keyboard or by a sequencer. A MIDI note has two values: it's pitch (the musical note it plays, expressed as a frequency which has been assigned to that note) and it's velocity (how hard the key is pressed, which determines how loud the note is heard). Notes also have an envelope, which determines the change in volume that note has over time.

Number

A GUI element used to display and store numbers. The number2 GUI element can also save numbers when that function is set in its properties.

Nyquist Frequency

A number which is half the sampling rate of the application which is being used, and represents the highest possible frequency which can be played back without aliasing. The Nyquist number is expressed in Herz. Example: if the sampling rate is 44,100 Hz, the Nyquist number would be 22,050. If one attempted to play a sound at 23,050 Hz, an aliased additional sound at 21,050 Hz (the difference between the two frequencies subtracted from the Nyquist number) would be heard.

Object

The most basic building block of a Pd patch. Objects have a names, which could be considered the "vocabulary" of the Pd language, and the name of the object determines its function. Objects can take creation arguments to modify their functions at the time they are created. They receive information via inlets and send output via outlets. Objects with a tilde (~) in their name are audio generating or processing objects, otherwise they are objects to manipulate data (for example, an object named [+] would add two numbers together, and an object named [+~] would add two audio signals together). To see the documentation help file of any object, right click with the mouse, or use the Control (or Apple) key with a mouseclick.

Octave

The interval between one musical note and another with 12 semitones (or 12 notes in the MIDI scale) between them, which is seen in acoustics as half or double the frequency. While frequency is a linear scale, however, while pitch is logarithmic. This means that a sound which is heard as one octave above another one is twice the frequency in Hz, while two octaves above would be four times the frequency, three octaves above would be eight times higher, and one octave below would be half the frequency.

Oscillator

An audio generator which produces a continuous, repeating waveform. A cosine oscillator [osc~] produces a pure sinus wave with no harmonics, while a sawtooth or ramp oscillator [phasor~] produces a richer sound with many harmonics. Other shapes for a waveform include square, pulse or triangle. Each waveform is defined by a mathematical function, and each shape has its own harmonic spectrum.

OpenGL
(Open Graphics Library) is a widely used, industry standard library of 2D and 3D graphics functions.

OSS

An outdated system of audio drivers for the Linux operating system, replaced by ALSA.

Outlet

The small rectangular boxes at the bottom of objects, GUI elements, messages, subpatches and abstractions. They send output to the inlets of the objects, subpatches, abstractions, messages and GUI elements below them.

Oversampling

The process of increasing the sampling rate of digital audio, most often in order to remove aliasing noise with a filter.

Pass Band

The range of frequencies allowed through by a filter.

Patch

The document in which you build structures within Pd. One patch can contain many objects, comments, GUI elements, messages, subpatches and abstractions. If another patch is saved in the same working directory or in another directory listed in the path setting, then it can be used in the main or parent patch as an abstraction. Patches are saved as simple text files with the names and locations of all the contents listed inside. Patches are always saved with the .pd extension.

Path

Is a setting of Pd which determines two things. The first is the directories on your computer which Pd searches to load externals, and the second is the directories where Pd searches to find abstractions used in patches. Path can be set with startup flags, or by entering the directories in the startup settings using the main window of Pd.

Pitch

A part of a note in the MIDI specification which determines what pitch is heard when the note is played. It is represented by a number between 0 and 127, with each number representing a key on the MIDI keyboard. The relation of pitch to frequency is logarithmic. This means that a sound which is heard as one octave (+ 12 MIDI notes) above another one is twice the frequency in Hz, while two octaves (+ 24 MIDI notes) above would be four times the frequency, three octaves (+ 36 MIDI notes) above would be eight times, and one octave below (- 12 MIDI notes) would be half the frequency.

Play Mode

The mode in Pd where the GUI elements and other parts of the Pd can be manipulated with the mouse. This is often when the patch is being played. Play mode can be switched in and out of by using the Edit menu or the Control (or Apple) and "E" keys. The opposite of Play mode is Edit mode.

Pointer

A reference to a position in a scalar used to manipulate and read data from it.

Polyphonic

A polyphonic electronic music instrument is capable of playing multiple notes at a time, allowing for chords and other musical techniques. The number of notes it can play is determined by the number of voices it has. See also monophonic.

Portaudio

A Free and Open Source set of audio drivers for Linux and Mac OS X.

Property

All the GUI elements in Pd have a menu where their properties can be changed. This is accessed by using the right-click mouse button, or the Control (or Apple) key and a mouseclick. Under properties, the graphical appearance and function of the GUI element can be changed.

Radio

A GUI element set of buttons which, when clicked, send the number of the box which was clicked to the outlet, or display numbers received by its inlet. Radio boxes can be vertical or horizontal, and the number of boxes seen can be changed in the properties.

Real-time

A system where changes can be made in the program even as it is running, and the user can see or hear the results immediately. The opposite would be a non-real-time system, where data must be compiled or rendered by the computer in order to hear or see results.

Release

The amount of time it takes for the gain of a note to reach zero after the key on the keyboard has been released. See also envelope.

Resonance

The frequency in a filter or other system of feedback which is most emphasized, resulting in that frequency being the loudest.

Ring Modulation

The use of one audio signal to Amplitude Modulate another audio signal.

Sample

In digital audio, a sample is the smallest possible element of a recorded sound. In CD audio, for example, it takes 44,100 samples to make one second of recorded sound, and so we can say that the sampling rate is 44,100 Herz. Samples also have a bit depth which determines the dynamic range that is possible to record and playback. Common bit depths are 8 (for old video games), 16 (for CD audio), 24 (for studio recording and DVDs) or 32 (for sounds inside the computer). In electronic music, a sample is also a prerecorded piece of sound which is played back by a sampler.

Sampler

An electronic music instrument which plays back a recorded sound (or sample) whenever it is sent a note. The pitch of the note determines how fast or slow the sample is played back, which emulates the pitch changes in other instruments. Samples can be looped (played over and over) and one-shot (played once).

Sampling Rate

The rate at which the computer records and plays back sound, which is measured in Herz representing the number of samples per second. CD audio is recorded and played at 44,100 Hz (or 44.1 KHz), while DVD audio runs at 96,000 Hz (or 96 KHz) and cheap consumer gadgets like voice recorders, video games, mobile phones, toys and some MP3 players often use a rate of 22,050 Hz (22.05 KHz) or even less. The sampling rate determines the highest frequency which can be recorded or played, which is expressed by the Nyquist number, or half the sampling rate. Sounds higher in frequency than the Nyquist rate will be aliased. Playing back sounds at a different sampling rate then they were recorded at will result in hearing that sound at the "wrong speed".

Scalar

A graphical instance of a struct in Pd's graphical data structures.

Sequencer

A MIDI device or application used to store notes which are sent to a synthesizer or sampler. Sequencers often play notes back at a rate specified in Beats per Minute.

Selector

A symbolic atom that serves as an instruction to the receiving object as how to handle the message.

Self-noise

The amount of analog noise a piece of electronic equipment produces without any further input, often due to parts of its circuitry or electromagnetic interference. Self-noise is measured in Decibels. The self noise of the equipment determines the noise floor. Professional or semiprofessional sound equipment often produces less self-noise than cheaper, consumer-grade equipment. Typical computer soundcards have self-noise which results in a noise floor between approximately -48 dB and -98 dB.

Send and Receive

A method of communicating between objects in a patch without the connecting cables. The objects [send] and [receive] are used, with a shared creation argument which sets the "channel" they transmit on, for example [send volume] and [receive volume]. The names of the objects can be abbreviated to [s] and [r], and a pair for audio signals also exists ([send~] and [receive~], or [s~] and [r~]).

Shell

The text-only interface to your computer, where commands are typed in order to start programs and get information. On Linux and Mac OSX, this is often called the "terminal". On Windows, it is referred to as the Command Prompt or as the DOS Prompt (now obsolete).

Slider

A GUI element which sends a number to its outlet when it is moved with the mouse, or display numbers received by its inlet. Sliders can be horizontal or vertical, and when they are created have a typical MIDI range of 0 to 127. This range can be changed under the properties.

Startup Flag

When starting Pd from the shell, the startup flags are used to pass information to Pd about how it should run, what audio drivers it should use, how many channels, what patch to open at startup, which external libraries to load and what paths to use to find externals and abstractions.

Stop Band

The frequencies which are reduced by a filter.

Struct

An object to create templates for data structures.

Subpatch

A graphical enclosure in a patch used to conceal parts of the patch which are not always used. Subpatches can be opened by clicking on them, and the GUI elements inside can be displayed even when closed by setting their properties to Graph on Parent. Inlets and outlets can be used to send and receive information to and from a subpatch, as well as send and receive pairs.

Sustain

The level of gain a note holds after the attack and decay. The note holds this gain level until the key is released. See also envelope.

Symbol

A string of characters, that is not interpreted as a number used in mathematic calculations. Single, "printable" words without (unescaped) whitespace are common symbols, but it's possible to construct unprintable symbols, symbols with escaped whitespace or symbols that look like a number, but consist of only numeric characters with objects like [makefilename] or some externals. Such symbols currently will not be saved properly in a .pd-file and they cannot be created by manually editing a message box. Internally a symbol is defined as an atom of type "t_symbol" in Pd.

Symbol Message

A message that has the symbol "symbol" as selector followed by another symbol atom as its data part.

Truncate

When a number goes out of a certain set of allowed boundaries, it will be truncated. This means that any numbers out of that range will be replaced by the closest number still within that range (either the highest or lowest). In a digital audio signal, this is called clipping.

Variable

A type of "placeholder", often within a message and written as a dollar sign, which is meant to be replaced with other information. For example, in the message "$1 $2 $3", there are three variables to be replaced with actual information.

Vector Based Graphics

The graphical system used by Pd to display patches where every element on the screen is defined by a set of numbers describing their appearance rather than an image, and every change to these elements means that the computer must recalculate that part of the screen.

Velocity

A part of a note in the MIDI specification which says how hard the key of the keyboard was pressed, and in turn determines the gain of that note when it is played. It is represented by a number between 0 and 127.

Voices

A polyphonic electronic music instrument can play as many simultaneous notes as it has voices. A monophonic instrument, on the other had, can only play one note at a time and is said to have one voice.

Vradio

A vertical radio button. See also GUI element.

Vslider

A vertical slider. See also GUI element.

VU

A GUI element in Pd which is used to display the gain of an audio signal in Decibels.

Word Length

See bit depth.

Working Directory

In Pd this is the directory which the patch you are working in has been saved to. Any abstractions used in that patch must either be saved to that directory, or the directory in which those abstractions have been saved must be added to the path setting in the startup preferences.