Temperament File Generator for Hauptwerk 2
Documentation version 1.00
Jocelyn Druel



Pre-requisites:
1) Download and install Scilab (tested with version 4.0)
http://www.scilab.org
2) You'll need a tool to create .rar archive files


Creating your own temperament file:
1) Launch scilab
2) File > Exec > TemperGeneratorHW2.sce
3) In the first dialog box, fill the fields. The most important is probably "UniqueTemperamentID"
which must be different for each temperament you create.
4) The second dialog box lets you enter the intervals in cents.
For the C, always let 0.
As an example, here are the values of the Kellner temperament:
key / cents / deviation from equal
c   0        0 
C#  90       -10
D   194.4    -5.6
D#  294      -6
E   388.8    -11.2
F   498      -2
F#  588      -12
G   697      -3
G#  792      -8
A   891.6    -8.4
A#  996      -4
B   1090.8   -9.2


5) Next dialog box is to save your new temperament file: enter "PersonalTemp" for example
(don't put any extension to your file name, the script generates it automaticaly).


Installing in HW2:
1) create a direcory named "Temperaments"
2) Put your new temperament file in it.
3) Create an .rar archive of the directory "Temperaments" (ex:"MyTemp.rar")
4) Rename "MyTemp.rar" in "MyTemp.CompPkg.Hauptwerk.rar"
5) In HW2, File > Install organ, temperament...., select your file and install


Passing from unequal to equal temperament
This interested me to be able to play imported v1 organs with other instruments (flute for example)
So let's take an organ tuned with the Kellner temperament.
To pass it in equal, you can create a KellnerToEqual temperament file with the following values:
c   0
C#  100+10=110
D   200+5.6=205.6
D#  300+6=306
E   400+11.2=411.2
F   500+2=502
F#  600+12=612
G   700+3=703
G#  800+8=808
A   900+8.4=908.4
A#  1000+4=1004
B   1100+9.2=1109.2

Passing from unequal to unequal (ex: Kellner to Young)
I suggest you calculate first the cents to pass to equal, then  adjust to pass from equal to unequal


Changing the A3 frequency of an organ:
Of course, you can change the master tuning directly in HW2. But, you can also create a temperament file
to retune the organ.
Here's an example:
you have an organ tuned in 415Hz. You want to pass it in 440Hz.
The number of cents is:
nc=1200*(log(Ff/Fi)/log 2) where Ff is the final frequency and Fi is the initial frequency.
So nc= 1200*log(440/415)/log 2=+101.27062 cents
In the dialog box, enter 440*2^(101.2706/1200)=466.506 for the A3 frequency (instead of 440).

If you want to downtune, the organ (ex: 440 > 415Hz), simply enter:
440/2^(101.2706/1200)=415 (of course) for the A3 frequency (instead of 440).


Conclusion:
I hope you'll enjoy this little tool.
I'm open to suggestions abd criticism.
Feel free to contact me.

Jocelyn Druel