<?php $isip_window_title = "ISIP Homepage"; ?>
<?php include("/data/isip/www/templates/documentation/header/header.html"); ?>

<!--#set var="isip_page_title" value="isip_make_db" -->
<!--#include virtual="/hse/ies/templates/documentation/body/index_utility.html" -->
<?php include("/data/isip/www/templates/documentation/body/bar.html"); ?>

<a name="name">
<b>
name:
<a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_make_db/isip_make_db.cc">isip_make_db</a>
</b>

<br><br>

<a name="synopsis">
<b>synopsis:</b>
<br><br>

<blockquote>

<pre>
isip_make_db [options] [audio_db.sof] [trans_db.sof]
</pre>

</blockquote>

<a name="quick_start">
<b>quick start:</b>
<br><br>

<blockquote>
<pre>

isip_make_db -help;

isip_make_db -db audio -audio audio_list.text -name TIDIGITS -type text audio_db_text.sof

isip_make_db -db transcription -transcription trans.text -level word -name TIDIGITS \
-type text trans_db_text.sof

</pre>
</blockquote>

<a name="description"> 
<b>description:</b>
<br><br>

<ul>

  The isip_make_db utility creates the audio database or/and transcription
  database.

<br><br>

</ul>

<a name="options">
<b>options:</b>
<br><br>

<ul>

  <li> -audio : list of audio files with identifiers in text

  <li> -db: database type (default=audio, transcription, both)

  <li> -debug: debug level (default=NONE, BRIEF, DETAILED, ALL)

  <li> -help: display a help message

  <li> -level: transcription level

  <li> -log_file: log messages

  <li> -name: name of the database

  <li> -transcription: list of transcriptions with identifiers in text

  <li> -type: output database type(default=text, binary)

</ul>       

<a name="arguments">
<b>arguments:</b>
<br><br>

<ul>

  <li> audio_db.sof: output audio database

  <li> trans_db.sof: output transcription database

</ul>       

<a name="formats">
<b>formats:</b>
<br><br>

<ul>   

  <li> audio.text: filename [identifier]

  <li> trans.text: trans or
  
  <br>

  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
       identifier: trans or

  <br>
		      
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
   identifier start_time stop_time: trans or 

   <br> 

     &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
     identifier start_time stop_time channel: trans or 

     <br>

  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
    : trans1 : trans2 :trans3 : trans4

</ul>       


<a name="examples">
<b>examples:</b>
<br><br>

<ul>

  <li> This example shows how to create an audio database using the
  input audio list that contains the audio filenames and the
  corresponding identifiers in the format described above.

<pre>

isip_make_db -db audio -audio <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_make_db/audio_list_0.text">audio_list_0.text</a> -name TIDIGITS -type text \

<a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_make_db/audio_db_text_0.sof">audio_db_text_0.sof</a>

</pre>
       
  <li> If the identifiers are not provided in the input audio list,
  the line number of the audio filenames in the input audio list is
  extracted as the identifiers.

<pre>

isip_make_db -db audio -audio <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_make_db/audio_list_1.text">audio_list_1.text</a> -name TIDIGITS -type text \

<a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_make_db/audio_db_text_1.sof">audio_db_text_1.sof</a>

</pre>
       
  <li> This example shows how to create a transcription database given
  the identifiers, start-time of the utterances in the audio database,
  stop-time of the utterances in the audio database, the channel
  numbers and, the transcription itself, as the input transcription
  file in the format specified above.

<pre>

isip_make_db -db transcription -transcription <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_make_db/trans_0.text">trans_0.text</a> -name TIDIGITS -level word \
-type text <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_make_db/trans_db_text_0.sof">trans_db_text_0.sof</a>

</pre>

  <li> The identifiers, start-time, stop-time and the channel number
  are optional. If the identifiers are not specified in the input
  transcription file, the line number of the transcription in the
  input file is extracted as the identifiers. If the start-time and
  the stop-time are not specified in the input transcription file, the
  anchors on the output transcription database are flagged as
  false.

<pre>

isip_make_db -db transcription -transcription <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_make_db/trans_1.text">trans_1.text</a> -name TIDIGITS -level word \
-type text <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_make_db/trans_db_text_1.sof">trans_db_text_1.sof</a>

</pre>

  <li> The same example shown above without identifiers, start-time,
  stop-time, and, the channel number can also be specified in a
  different format. In this format, all the transcriptions are
  specified in the same line, each beginning with a <b>":"</b>.

<pre>

isip_make_db -db transcription -transcription <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_make_db/trans_2.text">trans_2.text</a> -name TIDIGITS -level word \
-type text <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_make_db/trans_db_text_2.sof">trans_db_text_2.sof</a>

</pre>

  <li> This example shows how to create the audio database and the
  corresponding transcription database.

<pre>

isip_make_db -db both -audio <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_make_db/audio_list_0.text">audio_list_0.text</a> -transcription <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_make_db/trans_0.text">trans_0.text</a> -name TIDIGITS \
-level word -type text <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_make_db/audio_db_text_0.sof">audio_db_text_0.sof</a> <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_make_db/trans_db_text_0.sof">trans_db_text_0.sof</a>

</pre>

</ul>
       
<a name="manuals">
<b>manuals:</b>
<br><br>

<ul>
  None.
</ul>
       
<a name="languages">
<b>languages:</b>
<br><br>

<ul>
  This utility is written entirely in C++.
</ul>
       
<a name="variables">
<b>environment variables:</b>
<br><br>

<ul>
  None.
</ul>

<a name="files">
<b>files:</b>
<br><br>

<ul>
  <li> <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_make_db/isip_make_db.h">./isip_make_db.h</a>: header file

  <br><br>

  <li> <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_make_db/isip_make_db.cc">./isip_make_db.cc</a>: main file
  
  <br><br>

  <li> <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_make_db/usage_message.text">./usage_message.text</a>: usage message

  <br><br>

  <li> <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_make_db/help_message.text">./help_message.text</a>: help message
</ul>
       
<a name="see_also">
<b>see also:</b>
<br><br>

<ul>

<li> <a href="../../../class/mmedia/AudioDatabase/index.html">AudioDatabase</a>

<br><br>

<li> <a href="../../../class/mmedia/TranscriptionDatabase/index.html">TranscriptionDatabase</a>

</ul>

<a name="notes">
<b>notes:</b>
<br><br>

<ul>
<li> none
</ul>

<!--#include virtual="/hse/ies/templates/documentation/footer/footer.html" -->
