Added Test script
[TEvoiceconversion.git] / README.TXT
blobe8e5cf1ab3ba205455f2452bc40ed0559400ee1b
1 ########################################################################
3 VoiceConversion.praat
5 Change the input speech to resemble Tracheoesophageal speech.
6 Changes the Pitch (F0) and pitch movements, duration. Filtered noise
7 is added as well as filtered "bubble" sounds.
8 Increase the Jitter and Shimmer of a speech recording to the
9 number given. Cannot reduce Jitter or Shimmer.
10 Note that Jitter and Shimmer are ill-defined in anything but
11 sustained vowels.
13 Uses the To PointProcess (periodic, cc) to calculate the jitter
14 and To PointProcess (periodic, peaks): 60, 300, "yes", "yes"
15 to change the timing of the periods.
17 Periods are moved with Overlap-and-Add
19 Shimmer is adapted using additive noise over an intensity tier and
20 adapting each period individually. Periods are determined with the 
21 To PointProcess (periodic, peaks) pulses.
23 ########################################################################
25 Copyright (C) 2016-2017 NKI-AVL, R. J. J. H. van Son
26 R.v.Son@nki.nl
28 This program is free software: you can redistribute it and/or modify
29 it under the terms of the GNU General Public License as published by
30 the Free Software Foundation, either version 3 of the License, or
31 (at your option) any later version.
33 This program is distributed in the hope that it will be useful,
34 but WITHOUT ANY WARRANTY; without even the implied warranty of
35 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
36 GNU General Public License for more details.
38 You should have received a copy of the GNU General Public License
39 along with this program.  If not, see <http://www.gnu.org/licenses/>.
41 Full license text is available at:
42 http://www.gnu.org/licenses/gpl-3.0.html
44 ########################################################################
46 Input parameters (<=0 means "do not change"):
48 Input file    A file name (with full path). If a Sound object is 
49               selected, that will be used instead
50 Pitch         Average pitch of the new speech in Hz 
51               [F'(t) = Fnew/Fold * F(t)]
52 Pitch SD      Standard deviation of the Pitch of the new speech in Hz 
53               (compresses pitch movements)
54               [SD'(t) = SDnew/SDold * (F(t) - Faverage) + Faverage]
55 Duration      Factor with which to multiply the duration
56 HNR           Signal to Noise ratio of new noise added to obtain the 
57               HNR given
58 Bubbles       Rate of bubble sounds added (per second). Select random 
59               bubbles from bubbles.wav&bubbles.TextGrid
60 Bubbles SNR   Signal to Noise ratio of bubble sounds added 
61               (use bubbles.wav)
62 Jitter        New jitter in %
63 Shimmer       New Shimmer in %
64 Voicing floor Lowest level of sound still considered voiced, in dB 
65               below the maximum
67 Help          Print this text and exit
69 Output:
70 The input sound converted according to the specifications