<sect1 id='tilt-synthesis-manual'>
	<title><command>tilt_synthesis</command> <emphasis>Generate F0 contours from Tilt descriptions</emphasis></title>

    <toc depth='1'></toc>
    <para>
    </para>
    <sect2>
      <title>Synopsis</title>
      <para>
      </para>
        <!-- /amd/projects/festival/versions/v_mpiro/speech_tools_linux/bin/tilt_synthesis -sgml_synopsis -->
        <para>
<cmdsynopsis><command>tilt_synthesis</command>[input label file] -o [output file] [options]Summary: generate F0 file from tilt or RFC label file<arg>-h </arg>
<arg>-noconn </arg>
<arg>-o <replaceable>ofile</replaceable></arg>
<arg>-otype <replaceable>string</replaceable></arg>
<arg>-event_names <replaceable>string</replaceable></arg>
<arg>-s <replaceable>float</replaceable></arg>
</cmdsynopsis>
        </para>
        <!-- DONE /amd/projects/festival/versions/v_mpiro/speech_tools_linux/bin/tilt_synthesis -sgml_synopsis -->
      <para>

tilt_synthesis generates a F0 contour, given a label file containing
parameteriszed Tilt or RFC events.
A detailed description of the Tilt intonation model can be found in the
<link linkend="tilt-overview">Tilt model overview</link> section.
      </para>
    </sect2>
    <sect2>
      <title>OPTIONS</title>
      <para>
      </para>
        <!-- /amd/projects/festival/versions/v_mpiro/speech_tools_linux/bin/tilt_synthesis -sgml_options -->
        <para>
<variablelist>
<varlistentry><term>-h</term>
<LISTITEM><PARA>

Options help 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-noconn</term>
<LISTITEM><PARA>

Synthesize events only - no connections in output 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-o</term>
<LISTITEM><PARA>
<replaceable>ofile</replaceable>

Output F0 file 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-otype</term>
<LISTITEM><PARA>
<replaceable>string</replaceable>

File type for output label file 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-event_names</term>
<LISTITEM><PARA>
<replaceable>string</replaceable>

List of labels to be classed as events. 
Lists are specified as quoted strings with spaces 
separating each item, e.g.: "a b c d" 
</PARA></LISTITEM>
</varlistentry>

<varlistentry><term>-s</term>
<LISTITEM><PARA>
<replaceable>float</replaceable>

Frame spacing of generated contour in seconds </PARA></LISTITEM>
</varlistentry>
</variablelist>
        </para>
        <!-- DONE /amd/projects/festival/versions/v_mpiro/speech_tools_linux/bin/tilt_synthesis -sgml_options -->
    </sect2>
    <sect2>
      <title>Input Intonation Files</title>
      <para>
The input should be a label file containing the tilt parameters for the
events in feature format. An example, in xlabel format, is shown below:
</para>
<para>
<screen>
intonation_style tilt
#
0.29 26     phrase_start ; ev.f0 115.234 ; position 0.29 ; 
0.53 26     a ; int_event 1 ; ev.f0 118.171 ; position 0.53 ; tilt.amp 21.8602 ; 
tilt.dur 0.26 ; tilt.tilt -0.163727 ; 
0.77 26     a ; int_event 1 ; ev.f0 112.694 ; position 0.77 ; tilt.amp 27.0315 ; 
tilt.dur 0.32 ; tilt.tilt -0.446791 ; 
1.53 26     a ; int_event 1 ; ev.f0 100.83 ; position 1.53 ; tilt.amp 7.507 ; 
tilt.dur 0.22 ; tilt.tilt -0.296317 ; 
1.79 26     phrase_end ; ev.f0 92.9785 ; position 1.79 ; 
</screen>
</para>
<para>
tilt_synthesis can also generate F0 contours from RFC parameters:
</para>
<para>
<screen>
intonation_style rfc
#
0.29 26     phrase_start ; ev.f0 115.234 ; position 0.29 ; 
0.53 26     a ; ev.f0 118.171 ; rfc.rise_amp 8.19178 ; rfc.rise_dur 0.12 ; 
rfc.fall_amp -13.6684 ; rfc.fall_dur 0.14 ; position 0.53 ;
0.77 26     a ; ev.f0 112.694 ; rfc.rise_amp 6.50673 ; rfc.rise_dur 0.1 ;
rfc.fall_amp -20.5248 ; rfc.fall_dur 0.22 ; position 0.77 ; 
1.53 26     a ; ev.f0 100.83 ; rfc.rise_amp 1.55832 ; rfc.rise_dur 0.11 ; 
rfc.fall_amp -6.09238 ; rfc.fall_dur 0.11 ; position 1.53 ; 
1.79 26     phrase_end ; ev.f0 92.9785 ; position 1.79 ; 
</screen>
</para>
<para>
The feature in the header, "intonation_style tilt" or
"intonation_style rfc" is needed for the tilt_synthesis program to know which
type of synthesis to perform.
      </para>
    </sect2>
  </sect1>