// doc/tutorial_prereqs.dox

// Copyright 2009-2011 Microsoft Corporation

// See ../../COPYING for clarification regarding multiple authors
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at

//  http://www.apache.org/licenses/LICENSE-2.0

// THIS CODE IS PROVIDED *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
// KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
// WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
// MERCHANTABLITY OR NON-INFRINGEMENT.
// See the Apache 2 License for the specific language governing permissions and
// limitations under the License.

/**
 \page tutorial_prereqs Kaldi tutorial: Prerequisites

   \ref tutorial "Up: Kaldi tutorial" <BR>
   \ref tutorial_setup "Next: Getting started" <BR>

  This tutorial assumes that you know the basics of speech recognition using the
  HMM-GMM approach.  One brief introduction that is available online
  is: M. Gales and S. Young (2007). ``The Application of Hidden Markov
  Models in Speech Recognition." Foundations and Trends in Signal Processing
  1(3): 195-304.  The HTK Book is also a good resource.  However, unless you
  have a strong mathematical background and are extremely dedicated, we
  discourage trying to learn about speech recognition outside an institutional
  setting.  The intended audience for this tutorial is either speech recognition
  researchers, or graduates or advanced undergraduates who are studying this
  area anyway.

  We assume that you know C++, and have at least some familiarity with shell
  scripting, preferably using bash or a similar shell.  This tutorial assumes you
  are using a UNIX-like environment or Cygwin (although Kaldi will not
  necessarily compile and run in all such environments).

  Also, importantly, the tutorial assumes you have access to the data on the Resource
  Management (RM) CDs from the Linguistic Data Consortium (LDC), in the original form
  as distributed by the LDC.  That is, we assume this data is sitting on your system
  somewhere.  We obtained this as catalog number LDC93S3A.   It is
  also available in two separate pieces.  Be careful because there was previously
  a different distribution of the RM data with a different layout.

  The system requirements are fairly basic.  We assume that you have tools
  including wget, git, svn, awk, perl and so on, or that you know how to install them.
  The most difficult part of the installation process relates to the math library
  ATLAS; if this is not already installed as a library on your system you will
  have to compile it, and this requires that CPU throttling be turned off, which
  may require root privileges.  We provide scripts and detailed instructions for
  all installation steps.  When scripts fail, read the output carefully because
  it tries to provide guidance as to how to fix problems.  Please inform us if there
  are problems at any point, however minor; see \ref other.

  We try to provide some idea how long it should take to execute each step of the tutorial.
  If there is a limited amount of time available to complete the tutorial, we recommend
  to try to keep to the posted schedule, if necessary by skipping steps and avoiding
  following links to more information that we provide in the text.  This will help ensure
  that you get a balanced overview.  You can always review the material in more
  detail later on.  If this tutorial is to be given in a classroom setting, it is
  important that someone run through the tutorial on the relevant system beforehand in order
  to verify that all the prerequisites are installed.

   \ref tutorial "Up: Kaldi tutorial" <BR>
   \ref tutorial_setup "Next: Getting started" <BR>
<P>
*/