		Program "PolyphAn" help.

This tool simply tries to recognize & plot notes played in a given audiofile mp3,wav,flac are ready by now, other formats supprt coming soon.
The plot contains 640 horizontal lines for each time poimt of analyzed audio up-to-down through time each contains two different types of data:
	1) 6*12*10=720 points of (filtered) probability that particular note (with 1/10semitone step) presents in particular point of time (with apprx 6ms step).
	2) For speech/singing exploring (apprx)restored from sound articulation data i.e. profile of log area of equivalent acoustic tube from lips to glottis.
PolyphAn can load(raw process) source audio file and then play it showing current time point on screen scrolling it if needed.

		HOWTO
Drop audio file to open including calculating raw note data if there is no cache entry for that file.
Mouse Right or ">" = play (proxy of)source from cursor. Mouse Left = play note at cursor(alt+Tab make sound endless;) ).
Upper string shows mouse pos as time + note position on 1/10-semitone plot.
"Goto pos" field accepts time in samples AS in minutes+seconds if entered as XXmYYs.
Press "Recount" to re-count proxy with newly entered fields "slideband compression" & "bass boost".
While re-counting field "note pos" shows progress report.

		Tech data

Time step = (256/44100) (apprx 0.006) seconds.
Pitch resolution = 1/10 of semitone.
Range = 6 octaves from 27.5 Hz base tone to 1760 Hz.
Tested formats: 
	WAV 44,48 KHz, 16,24bps, float 32bps (may be needed 64bps float but it's rarely used),
	FLAC up to 192 Khz 24 bits per channel, 
	MP3 @ 44,48,32 KHz 128-320bps, 
	SPH @ 16 & 32 KHz (used by speech scientists),
other formats coming soon. 
PolyphAn keeps cache for already processed audiofiles. Each cache entry name undoubtely depends on file content by using 12-byte hash, not on file place. Each cache entry contains many *.gfx files of raw note & articulation (if used for voice) data and file cache.wav which is source processed by Slideband Compressor.
Slideband compressor(no typos - exactly sLideband, not sideband!) simply makes sound easier to recognize by routine of.
Bass Boost range is 0..1 use higher values if bass line is not clearly visible. Optimal value depends on features of mixing & instrument thus may vary song by song.
After change slideband compressor depth and|or bass boost press "recount" to process source audiofile with new parameters.
Be careful 'cause *.gfx files in each cache entry apprx 10 times greater in size than that sound @ 44KHz 16bit mono! - So simply delete unused entries to free space.
PolyphAn internally resamples any input audio to 44100 Hz from ANY input frequency if it is whether 
	A) ANY multiple of 4 KHz ( 8, 16, 32, 48, 96, 192 etc ) (in this case resampling ratio is considered 44.1KHz as apprx 44KHz yielding unpercievable speed error)
		OR
	B) ANY multiple of 44.1 KHz 
		OR
	C) integer times lower than 44.1KHz - 11025, 22050 etc.
More commonly speaking PolyphAn each time new file opened calculates resampler's polyphase filter based on ratio of input frequency to 44.1KHz or 44Khz whatever is easier to represent as ratio of 2 integer numbers. Thus if least possible integer numbers needed to represent in-to-out frequencies ratio exceeds filter size limit then PloyphAn could not process such audio file - "sad but true"(c) ;). Fortunately almost nobody use such a weird sampling frequencies in practice ;).

