Partial Player
==============
author: winfried ritsch - IEM @ KUG Graz


History
-------

- initially written for Dimitrios Polisoidis, to train playing correct 
overtones and  intonations. 

- Modified as a generic instrument with keyboard to use for lectures.

- Modified to the "overtone organ" for james tenny pieces with harmonium.

Overtone Organ
..............

For the performance of some of James Tenney's pieces, a overtone generating instrument
is needed. For this purpose the overtone hearing training patch has been 
enhanced as the "overtone organ" (german "Obertonorgel") and 
successful played for the piece "In a large, open space (1994)" for 14 musicians
by James Tenney,  based on the overtones of the double base F .

Availability
............

 svn co https://svn.code.sf.net/p/iem/cmtools/partial_player/
 

 (Note: will be placed into github repo after next concert 2015 )

 
 
License
.......

GPL (c) winfried ritsch::

  /*******************************************************************/
  /* GPL - Copyright (C) 2009 winfried ritsch

      This program is free software: you can redistribute it and/or modify
      it under the terms of the GNU General Public License as published by
      the Free Software Foundation, either version 3 of the License, or
      (at your option) any later version.

      This program is distributed in the hope that it will be useful,
      but WITHOUT ANY WARRANTY; without even the implied warranty of
      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      GNU General Public License for more details.

      You should have received a copy of the GNU General Public License
      along with this program.  If not, see <http://www.gnu.org/licenses/>.
      or gpl.txt in this folder. */
  /*******************************************************************/

Overview
--------

Partialplayer is a patch for puredata which 
   
a) let you hear partial tones derived from on base_note,
   analyze your input and play a detuned overtone structure, as well as 
   a kind of accord of partials

b) play the overtones as an overtone organ 
   eg. for James tenney piece "In a large, open space (1994)"

The patch is played by a MIDI-controller, where the overtones are mapped 
to the keys like semitones over 3 octaves.
   
Prerequisites
.............

tested with PD Version 0.42 or higher.

"abs" path needed for PD-patch (use declare)

Start patch under linux with script start.sh

Usage
.....

1. Test if audio out works: 
 
       220_440Hz switch on and master vol 
       now hear a 220Hz left and 440Hz right

2. Play partial:
    choose a base_note in midi notation (see Hz)
    choose a volume for the partials (called oberton) and switch them on/off as needed
    - individually detune partial in Cent

3. Files;

  almost all controls can be stored in files.

  preset <num> store - store to default file "preset_<num>";
  preset <num> load - load and set from default file "preset_<num>";

  save - save to a choosen file;
  open - load from a choosen file;

4. Analyze Input;

   look at midinote and frequency (Note: first two digits afte the comma with MIDInotes are Cents)

5. Play analyzed note;

   - as sine or sawtooth switch and adjust volume

   - send to analyzed note to base_note so switched on partials are played


contact
.......

IEM - Winfried Ritsch ritsch_at_iem.at