Contents

BSD-Based License

The complete RavenClaw/Olympus distribution falls under the following BSD-based free and open-source software license. Some parts of the distribution may fall under different copyright holders, but their licenses are in a similar class as this license.

Copyright (c) 1998-2015 Carnegie Mellon University. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

This work was supported in part by funding from the Defense Advanced Research Projects Agency and the National Science Foundation of the United States of America, and the CMU Sphinx Speech Consortium.

THIS SOFTWARE IS PROVIDED BY CARNEGIE MELLON UNIVERSITY "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY NOR ITS EMPLOYEES BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Prerequisites

You need the following software as part of your installation. As a rule you should install the most recent versions, irrespective of those indicated below (which should be considered as the minimum version required). Olympus is maintained relative to the most recent versions of these application, but sometimes we miss something that's changed. Please let us know if you encounter a compatibility problem.

Click "TTYRecognitionServer" and then type init_session into the input box.

The system should greet you by voice (well, assuming that you have a speaker and the level is set right).

You can then either type into the input box or speak into a connected microphone.

If you are using a microphone be sure that it is in fact connected and that the levels are reasonable. You can do this by first recording and playing back an utterance. Adjust the audio so that it's not too loud or too soft. If you hear significant noise or static, the system may not understand you; you should investigate and fix.

The documentation page is under construction but contains or will contain soon a complete tutorial on how to build systems with Olympus, as well as a number of reference pages for different parts of the architecture and pages on advanced topics for experienced developers. See Documentation.

Questions and Problems

Depending on details of your system configuration, you may need to build from an "administrator" cmd window. To get one, right-click on the cmd icon and select the "Run as administrator" option.

If a build is interrupted, file handles may remain open and the next build attempt is likely to fail. This a Windows thing. To start clean close the cmd window and open a new one.

Occasionally problems crop up that have to do with differences between 32bit and 64bit architectures. Olympus is configured to create 32bit binaries. However you might already have installed a 64bit version of a prerequisite application which may introduce incompatible binaries. Check whether reinstalling its 32bit version fixes things.

Be careful if you have multiple Visual Studios installed on your machine. Although they are supposed to peacefully coexist, we've found that VS 10 will sometimes stop building correctly if you also have VS 11, 12, 13 on your machine.

Note that while the system can build with earlier versions of VS (5, 8), these are no longer actively supported. Remember that Visual Studio Express is available for free and will correctly build Olympus. If possible, we recommend that you install it. Olympus support takes it into account.

For additional information, as well as answers to specific questions, e-mail the developers mailing list (olympus-developers@cs.cmu.edu). You may want to attach a (ZIPPED!) copy of your build.log file in the email. You should probably examine the log file first and see if you can figure out what's wrong on your own. There should a summary of errors at the bottom of the log, but also search for the word FAILED to get at the details.