File: installation.html

package info (click to toggle)
transcriber 1.4-4
links: PTS
area: main
in suites: potato
size: 2,244 kB
ctags: 1,066
sloc: tcl: 9,331; ansic: 2,090; sh: 764; makefile: 85
file content (293 lines) | stat: -rw-r--r-- 7,401 bytes
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD>
   <TITLE>Transcriber's Installation</TITLE>
   <META NAME="GENERATOR" CONTENT="Mozilla/3.01Gold (X11; I; Linux 2.0.33 i686) [Netscape]">
   <META NAME="Author" CONTENT="C. Barras">
</HEAD>
<BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#0000EF" VLINK="#51188E" ALINK="#FF0000">

<H2>Installation</H2>

<H3>Installation from the sources</H3>

<P>Transcriber relies on several softwares or libraries that you need to
install first : Tcl/Tk 8.0-8.2, Snack 1.6, tcLex 1.2 and optionaly NIST/Sphere
2.6 . Step 1-4 are for these modules, step 5-6 is for the content of Transcriber
distribution. </P>

<OL>
<LI>If Tcl/Tk version 8.0 or higher is not already installed on your system,
get it on Scriptic's server :</LI>

<OL>
<PRE><A HREF="http://www.scriptics.com/download/">http://www.scriptics.com/download/</A></PRE>
</OL>

<P>or one of its mirrors and unpack them:</P>

<OL>
<PRE>$ gunzip -c tcl8.2.0.tar.gz | tar xf -</PRE>
</OL>

<P>Choose an installation directory (e.g. <TT>/usr/local</TT>) and follow
instructions found in <TT>tcl8.2.0/README</TT> and <TT>tk8.2.0/README</TT>
(configure with <TT>--enable-shared</TT> option). For Tcl 8.2 under Unix,
it will be something like:</P>

<OL>
<PRE>$ cd tcl8.2.0/unix
$ ./configure --enable-gcc --enable-shared --prefix=/usr/local
$ make
$ make install</PRE>
</OL>

<P>Do the same for Tk. If you choose to install into a different directory,
make sure to set the environnement variables of your system (e.g., <TT>PATH</TT>
and <TT>LD_LIBRARY_PATH</TT>) to the right values.</P>

<LI>This step is needed only if you plan to use Sphere sound file format
with Snack. Get NIST/Sphere archive:</LI>

<UL>
<PRE><A HREF="ftp://jaguar.ncsl.nist.gov/pub/sphere_2.6a.tar.Z">ftp://jaguar.ncsl.nist.gov/pub/sphere_2.6a.tar.Z</A></PRE>
</UL>

<P>Unpack it in a sibling directory of this distribution</P>

<UL>
<PRE>$ zcat sphere_2.6a.tar.Z | tar xf -</PRE>
</UL>

<P>Then install it: </P>

<UL>
<PRE>$ cd nist; sh src/scripts/install.sh </PRE>
</UL>

<P>You will be asked the target platform. For Linux, choose 10 (i.e. custom)
and change following values (the other ones should be OK): </P>

<UL>
<LI>What is/are the Compiler Flags: -O -Wall -fPIC </LI>

<LI>What is/are the Architecture: INTEL</LI>
</UL>

<P>NB - For recent Linux Distributions (i.e. Redhat 5.x or Debian 2.x)
you need to comment the following line inside the file <TT>nist/src/lib/sp/exit.c
</TT>: <TT>extern char *sys_errlist[]; </TT>(thanks to Dafydd Gibbon for
this information) For the courageous ones, a patch is given in the Transcriber
source distribution in <TT>src/patch-sphere</TT> for a dynamic compilation
of Sphere libs under Linux.</P>

<LI>Get Snack 1.6 module:</LI>

<OL>
<PRE><A HREF="http://www.speech.kth.se/snack/">http://www.speech.kth.se/snack/</A></PRE>
</OL>

<P>extract it:</P>

<UL>
<PRE>$ gunzip -c snack1.6.tar.gz | tar xf -</PRE>
</UL>

<P>Then follow the instructions in README and install Snack, e.g. with:</P>

<UL>
<PRE>$ cd snack1.6/src 
$ ./configure --prefix=/usr/local 
$ make 
$ make install </PRE>
</UL>

<P>NB:</P>

<UL>
<LI>If '<TT>./configure</TT>' fails, you have probably Tcl/Tk installed
in a non standard directory; give it with <TT>--with-tcl </TT>and <TT>--with-tk
</TT>options.</LI>

<LI>for use with the old Tcl/Tk 8.0, add the option <TT>--disable-stubs</TT></LI>

<LI>Be sure to get the latest release</LI>

<LI>In order to use Sphere format, configure with <TT>--with-nist=... </TT></LI>

<LI>Test Snack demos!<BR>
</LI>
</UL>

<LI>Get tcLex 1.2 module:</LI>

<OL>
<PRE><A HREF="http://www.multimania.com/fbonnet/Tcl/tcLex/">http://www.multimania.com/fbonnet/Tcl/tcLex/</A> </PRE>
</OL>

<P>extract it:</P>

<UL>
<PRE>$ gunzip -c tcLex1.2a1.tar.gz | tar xf - </PRE>
</UL>

<P>Then follow the instructions in README.txt and install tcLex, e.g. with:
</P>

<UL>
<PRE>$ cd tcLex1.2a1/src 
$ chmod a+x configure install-sh
$ ./configure --prefix=/usr/local 
$ make 
$ make install</PRE>
</UL>

<P>NB - You need to have the complete sources of Tcl for building this
extension, since it relies on specific header files not installed by standard
Tcl installation. </P>

<LI>Extract the source archive of Transcriber, compile and install it:</LI>

<UL>
<PRE>$ gunzip -c Transcriber-1.4.tar.gz | tar xf -
$ cd Transcriber-1.4/src
$ ./configure --with-snack=... --with-tcl=... --with-tk=... --prefix=...
$ make
$ make install</PRE>
</UL>

<LI>As options to the <TT>./configure </TT>command, you have to give the
directory where Snack archive was extracted (<TT>--with-snack=...</TT>),
the directories where Tcl and Tk were installed (<TT>--with-tcl=...--with-tk=...</TT>),
and the directory where you will install Transcriber (<TT>--prefix=...</TT>).
For use with Tcl/Tk version 8.0, add the option <TT>--disable-stubs.</TT></LI>

<P>NB - If you change the directory structure after installation, you have
to edit 'trans' launcher script and give the right absolute path: TRANSPATH=...
(the lib path where transcriber1.4 sub-dir is to be found) </P>

<LI>Test it !</LI>

<UL>
<PRE>$ trans</PRE>
</UL>

<P>You will be asked to open a sound signal or a transcription; some are
found in the '<TT>demo</TT>' sub-directory</P>
</OL>

<H3>Installation from the binaries</H3>

<UL>
<LI>Make sure you have an installed version of Tcl/Tk 8.0 or higher and
get the binary archive for your system (e.g. Linux, Solaris...) matching
your version of Tcl/Tk (8.0 or 8.2).</LI>

<LI>Switch to the place where you want to install the tool, e.g.:</LI>

<UL>
<PRE>$ cd /usr/local</PRE>
</UL>

<P>If you choose to install into a non-standard directory, make sure to
set the environnement variables of your system (e.g., <TT>PATH</TT> and
<TT>LD_LIBRARY_PATH</TT>) to the right values.</P>

<LI>Extract the files from the archive:</LI>

<UL>
<PRE>$ gunzip -c Transcriber-1.4-Linux.tar.gz | tar xf -</PRE>
</UL>

<LI>Launch the tool:</LI>

<UL>
<PRE>$ trans</PRE>
</UL>

<P>You will be asked to open a transcription or a sound signal to start
a new transcription.</P>

<LI>Look in the Help directory for some hints about Transcriber's use or
view it directly in an HTML&nbsp;browser (in transcriber1.4/doc/Index.html)</LI>
</UL>

<H3>
<HR WIDTH="100%">Distribution structure:</H3>

<UL>
<LI>Structure of the source distribution :</LI>

<UL>
<LI>Transcriber-1.4/</LI>

<UL>
<LI>README</LI>

<LI>COPYING</LI>

<LI>contrib/ . . . external archives</LI>

<UL>
<LI>html_library-0.3/</LI>
</UL>

<LI>src/ . . . sources for new Tcl commands and Tk widgets </LI>

<LI>tcl/ . . . Tcl scripts. </LI>

<LI>img/ . . . bitmap images </LI>

<LI>doc/ . . . help files </LI>

<LI>etc/ . . . default files</LI>

<LI>demo/ . . . for sound and transcription files </LI>
</UL>
</UL>

<LI>Structure of the binary distribution (as a result of a standard installation):
</LI>

<UL>
<LI>lib/ =&gt; </LI>

<UL>
<LI>html_library-0.3/</LI>

<LI>snack1.6/ </LI>

<LI>tcLex1.2/</LI>

<LI>transcriber1.4/ =&gt;</LI>

<UL>
<LI>libtrans.so</LI>

<LI>pkgIndex.tcl</LI>

<LI>tcl/</LI>

<LI>img/</LI>

<LI>etc/</LI>

<LI>doc/ </LI>
</UL>
</UL>

<LI>bin/trans</LI>
</UL>
</UL>

<H3>
<HR WIDTH="100%"><A NAME="problems"></A>Possible problems</H3>

<UL>
<LI>Playback can fail if there is a mismatch between signal format and
soundcard capabilities (e.g., 16 bits signal on audio cards which only
support 8kHz 8 bits mu-law).</LI>
</UL>

</BODY>
</HTML>