STRAIGHT/README.html at master · gaoyiyeah/STRAIGHT · GitHub

1
<HTML><!--  Date 2005/8/26  --><HEAD>	<META HTTP-EQUIV="Content-Type" CONTENT="text/html;CHARSET=iso-8859-1">	<link rel="stylesheet" href="index_style.css" type="text/css" />	<META NAME="GENERATOR" CONTENT="mi"><TITLE>Read me first for STRAIGHT</TITLE></HEAD><BODY><H1>STRAIGHT for program development</H1><p>This page consists of the latest m-files of STRAIGHT.The four new m-files were designed to provide an easy means forusing STRAIGHT in command mode and/or batch mode.It provides (hopefully) readable access to analysis and synthesisparameters.It also allows you to use other F0 extraction programs instead of usingthe STRAIGHT F0 extractor based on a fixed-point analysis.Please check the <A HREF="http://www.wakayama-u.ac.jp/~kawahara/puzzlet/STRAIGHTtipse/">STRAIGHT support page</A>for the latest information and useful links.</p><p>17 September, 2005.<br><A HREF="http://www.wakayama-u.ac.jp/~kawahara/index-e.html">Hideki Kawahara</A></p><H2>Installation</H2><p>Please add this directory to your Matlab path.</p><H2>Usage of four wrapper m files</H2><p>Usually, the following four wrapper m-files are sufficient for your ownprogram development.</p><DL><DT>exstraightsource<DD><PRE>   Source information extraction for STRAIGHT   [f0raw,ap,analysisParams]=exstraightsource(x,fs,optionalParams)   Input parameters   x   : input signal. if it is multi channel, only the first channel is used   fs  : sampling frequency (Hz)   optionalParams : Optional parameters for analysis   Output parameters   f0raw   : fundamental frequency (Hz)   ap  : amount of aperiodic component in the time frequency representation       : represented in dB   analysisParams : Analysis parameters actually used   Usage:   Case 1: The simplest method   [f0raw,ap]=exstraightsource(x,fs);    Case 2: You can get to know what parameters were used.   [f0raw,ap,analysisParams]=exstraightsource(x,fs);   CAse 3: You can have full control of STRAIGHT synthesis.       Please use case 2 to find desired parameters to modify.   [f0raw,ap,analysisParams]=exstraightsource(x,fs,optionalParams);</PRE><DT>exstraightspec<DD><PRE>   Spectral information extraction for STRAIGHT   [n3sgram,nalysisParamsSp]=exstraightspec(x,f0raw,fs,optionalParamsSP)   Input parameters   x   : input signal. only the first channel is analyzed   f0raw   : fundamental frequency (Hz) in 1 ms temporal resolution           : set 0 for aperiodic part   fs  : sampling frequency (Hz)   optionalParamsSP : spectrum analysis parameters   Output parameters   n3sgram : Smoothed time frequency representation (spectrogram)   analysisParamsSp :  Actually used parameters   Usage:   Case 1: The simplest method   n3sgram = exstraightspec(x,f0raw,fs);    Case 2: You can get to know what parameters were used.   [n3sgram,analysisParamsSp]=exstraightspec(x,f0raw,fs);   CAse 3: You can have full control of STRAIGHT synthesis.       Please use case 2 to find desired parameters to modify.   [n3sgram,analysisParamsSp]=exstraightspec(x,f0raw,fs,optionalParamsSP);</PRE><DT>exstraightsynth<DD><PRE>   Synthesis using STRAIGHT parameters   [sy,prmS] = exstraightsynth(f0raw,n3sgram,ap,fs,optionalParamsS)   Input parameters   f0raw   : fundamental frequency (Hz)    n3sgram : STRAIGHT spectrogram (in absolute value)   ap      : aperiodic component (dB re. to total power)   fs      : sampling frequency (Hz)   optionalParamsS : optional synthesis parameters   Output parameters   sy      : synthesized speech   prmS    : Actually used synthesis parameters   Usage:   Case 1: The simplest method   sy = exstraightsynth(f0raw,n3sgram,ap,fs);    Case 2: You can get to know what parameters were used.   [sy,prmS] = exstraightsynth(f0raw,n3sgram,ap,fs);   CAse 3: You can have full control of STRAIGHT synthesis.       Please use case 2 to find desired parameters to modify.   [sy,prmS] = exstraightsynth(f0raw,n3sgram,ap,fs,optionalParamsS);</PRE><DT>exstraightAPind (for use with other F0 extractors)<DD>Pleause use this routine to calculate aperiodicity index when you use other F0 extractors.<PRE>Aperiodicity index extraction for STRAIGHT[ap,analysisParams]=exstraightAPind(x,fs,f0,optionalParams) Input parameters   x   : input signal. if it is multi channel, only the first channel is used   fs  : sampling frequency (Hz)   f0  : fundamental frequency (Hz)   optionalParams : Optional parameters for analysisOutput parameters   ap  : amount of aperiodic component in the time frequency represntation       : represented in dB  analysisParams : Analysis parameters actually used   Usage:   Case 1: The simplest method   ap=exstraightAPind(x,fs,f0);    Case 2: You can get to know what parameters were used.   [ap,analysisParams]=exstraightAPind(x,fs,f0);   CAse 3: You can have full control of STRAIGHT synthesis.       Please use case 2 to find desired parameters to modify.   [ap,analysisParams]=exstraightAPind(x,fs,f0,optionalParams);</PRE></DL><H2>Notes on intellectual properties</H2><p>The procedures and data, so-called STRAIGHT-suite, in this directoryare under the copyright of ATR Human Information Processing Researchlaboratories, Wakayama University, JST and Prof. Hideki Kawahara. Noprograms (except for trivial ones; such as HzToErbRate and smax)and data in this directory should be distributed without thepermission by Prof. Hideki Kawahara, <A HREF="mailto:kawahara@sys.wakayama-u.ac.jp">the author ofSTRAIGHT.</A>.However, the copyright holders do not wish to restrict the use ofSTRAIGHT-suite for research purpose. Permission for research useis provided without any problem, if requested. If you wish toapply STRAIGHT-suite for commercial use, please contact their agents to get permission to access those items.(Please contact <A HREF="mailto:ymatsuda@jst.go.jp">the JST office</A>for details.) </p><H2>No warranty</H2><p>STRAIGHT-suite is always under construction. Thecopyright holders and patent ownersdo not have any responsibilities for possible damageor loss of assets which may be caused by improper or proper use ofSTRAIGHT-suite. Please use it at your own risk andplease let me know when something strange happened.Your comments, suggestions and/or bug reports areappreciated.However, please also understand thatit does not necessarily mean that they are adopted inthe future release.</p><H2>Outdated files</H2><p>The following files are outdated.They will not be updated.They were not removed only for keeping backward compatibility.Please do not depend on these outdated files.It is strongly recommended to develop your own programs using the command mode interface routines.</p><pre>defaultparamsorg.mmktstr.mplotcpower.mpowerchk.mstraight.mstraightCIv1.mstraightPanel98bak.mstraightpanel98.matstraightsound.msyncgui.m</pre><HR ALIGN=LEFT><ADDRESS>Contents of this page are not for general public. Pleasedo not re-distribute materials on this page.</ADDRESS><P><HR ALIGN=LEFT>This page is supported by <A HREF="http://www.sys.wakayama-u.ac.jp/%7Ekawahara/index-e.html">HidekiKawahara</A><BR><BR><A HREF="mailto:kawahara@sys.wakayama-u.ac.jp">kawahara@sys.wakayama-u.ac.jp</A></BODY></HTML>