File: README_UNIX

package info (click to toggle)
transcriber 1.5.1.1-13
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 4,484 kB
  • sloc: tcl: 13,141; ansic: 1,895; sh: 1,193; makefile: 75; xml: 66
file content (230 lines) | stat: -rw-r--r-- 8,198 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230

                    T R A N S C R I B E R
    a free tool for segmenting, labeling and transcribing speech
                 Copyright (C) 1998-2004, DGA

WWW:    	http://trans.sourceforge.net/
		http://sourceforge.net/projects/trans

Authors		Claude Barras, formerly DGA/DCE/CTA/GIP - now LIMSI-CNRS
		Mathieu Manta   - DGA/DCE/CTA/GIP
		Fabien Antoine  - DGA/DCE/CTA/GIP
		Sylvain Galliano - DGA/DCE/CTA/GIP

Coordinators:  Edouard Geoffrois, DGA/DCE/CTA/GIP
               Mark Liberman & Zhibiao Wu, LDC

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

---------------------------------------------------------------------

All online documentation viewable in HTML:
  doc/Index.html

following instructions from doc/en/installation.html:
---------------------------------------------------------------------

Installation from binary distribution for Unix

   * 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 ... 8.4) on Tcl developer website:

	http://www.tcl.tk/software/tcltk/choose.html

   * Switch to the place where you want to install the tool, e.g.:

          $ cd /usr/local

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

   * Extract the files from the archive:

          $ gunzip -c Transcriber-1.XX-Linux.tar.gz | tar xf -

   * Launch the tool:

          $ trans

     You will be asked to open a transcription or a sound signal to start a
     new transcription.

   * Look in the Help directory for some hints about Transcriber's use or
     view it directly in your HTML browser (start with
     lib/transcriber1.XX/doc/Index.html)

Installation from the sources

Transcriber relies on several software or libraries that you need to
install first : Tcl/Tk 8.0 - 8.4, Snack 2.0, tcLex 1.2 and optionally
NIST/Sphere 2.6. Step 1-4 are
for these modules, step 5-6 are for the content of Transcriber
distribution.

  1. If Tcl/Tk version 8.0 or higher is not already installed on your
     system, get it on Scriptics' server :

          http://www.scriptics.com/products/tcltk/choose.html

     or one of its mirrors and unpack them (the version number may change):

          $ gunzip -c tcl8.3.2.tar.gz | tar xf -

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

          $ cd tcl8.3.2/unix
          $ ./configure --enable-gcc --enable-shared --prefix=/usr/local
          $ make
          $ make install

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

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

          ftp://jaguar.ncsl.nist.gov/pub/sphere_2.6a.tar.Z

     Unpack it in a sibling directory of this distribution

          $ zcat sphere_2.6a.tar.Z | tar xf -

     Then install it:

          $ cd nist; sh src/scripts/install.sh

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

        o What is/are the Compiler Flags: -O -Wall -fPIC
        o What is/are the Architecture: INTEL

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

  3. Get Snack 2.0 or higher module:

          http://www.speech.kth.se/snack/

     extract it:

          $ gunzip -c snack2.0.1.tar.gz | tar xf -

     Then follow the instructions in README and install Snack, e.g. with:

          $ cd snack2.0.1/unix
          $ ./configure --prefix=/usr/local
          $ make
          $ make install

     NB:

        o If './configure' fails, you have probably Tcl/Tk installed in a
          non standard directory; give it with --with-tcl and --with-tk
          options.
        o for use with Tcl/Tk version 8.0, add the option --disable-stubs
        o Be sure to get the latest release
        o In order to use Sphere format, configure with --with-nist=...
        o Test Snack demos!
  4. Get tcLex 1.2 module:

          http://www.multimania.com/fbonnet/Tcl/tcLex/

     extract it:

          $ gunzip -c tcLex1.2a1.tar.gz | tar xf -

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

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

     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.

  5. Extract the source archive of Transcriber, compile and install it:

          $ gunzip -c Transcriber-1.XX.tar.gz | tar xf -
          $ cd Transcriber-1.XX/src
          $ ./configure --with-snack=... --with-tcl=... --with-tk=... --prefix=...
          $ make
          $ make install

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

     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.XX sub-dir is to be
     found)

  7. Test it !

          $ trans

     You will be asked to open a sound signal or a transcription; some are
     found in the 'demo' sub-directory

----------------------------------------------------------------------------
Distribution structure:

   * Structure of the source distribution :
        o Transcriber-1.XX/
             + README_WINDOWS . .instructions to install Transcriber on Windows
	     + README_LINUX   . .instructions to install Transcriber on Unix/Linux
             + COPYING
             + contrib/ . . . external archives
             + src/ . . . sources for new Tcl commands and Tk widgets
             + tcl/ . . . Tcl scripts.
             + convert/ . Tcl script modules for format conversion
             + img/ . . . bitmap images
             + doc/ . . . help files
             + etc/ . . . default files
             + demo/ . . .for sound and transcription files
	     
   * Structure of the binary distribution (as a result of a standard
     installation):
        o lib/ =>
             + snack2.0/
             + tcLex1.2/
             + transcriber1.XX/ =>
                  + libtrans.so
                  + pkgIndex.tcl
                  + tcl/
                  + img/
                  + etc/
                  + doc/
        o bin/trans

----------------------------------------------------------------------------
Possible problems

   * 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).