Skip to content

MatrixRegressionTestingSetup

TJTrimble edited this page Dec 15, 2014 · 36 revisions

Matrix Regression Testing Setup

This page describes setting up an environment to do Grammar Matrix Regression Testing (See MatrixDevTop, MatrixRegressionTesting). The basic requirements to run the regression tests are:

This page is current as of 12-14-14 - TJT

Setting up a VirtualBox virtual machine

This section describes setting up a VirtualBox virtual machine to run the regression tests. Much of it is also applicable to running Ubuntu natively.

1) Install VirtualBox

2) Download the 64 bit Ubuntu (12.04 and 14.04 are good choices, downloadable here; or you can try the latest version here)

3) Create an Ubuntu VirtualBox machine. Give it as much memory as you can, and you’ll need at least ~10GB of free space to get the right software and run the regression tests. Once you have it ready, it is also advisable to increase the GPU RAM available to the VM (usually you can max this out). (Windows instructions, Mac instructions)

4) Install the VirtualBox Guest Additions: (https://help.ubuntu.com/community/VirtualBox/GuestAdditions)

sudo apt-get update
sudo apt-get install virtualbox-guest-x11

5) Restart you Virtual Machine.

6) Get necessary additions for the LOGON tree (including 32-bit compatibility modules):

sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install libjpeg62 libx11-6:i386 libxext6:i386 libfontconfig1:i386
sudo apt-get install libxpm4 libxt6 libxmu6 libxft2 libjpeg62 libpng12-0
sudo apt-get install subversion
sudo apt-get install emacs

7) Download the LOGON tree (typically into ~/delphin/):

cd ~/delphin/
svn checkout http://svn.emmtee.net/trunk logon

8) Download ACE (AceTop)

9) Download the matrix:

cd ~/delphin/
svn co svn://lemur.ling.washington.edu/shared/matrix/(trunk|branches/my_branch)

10) Set the proper variables in ~/.bashrc (Make sure to customize the variable values to the location where these packages are actually stored on your system, and the proper branch if applicable) (also, make sure to reload your ~/.bashrc by either logging out/in, restarting your terminal, or source ~/.bashrc:

export CUSTOMIZATIONROOT=~/delphin/matrix/trunk/gmcs # gmcs for the branch you’re working on
export ACEROOT=~/delphin/ace/ # directory containing ACE binary
export DELPHINHOME=~/delphin # installation location for DELPHIN stuff
export LUI=yzlui # Set yzlui to be the default LUI for the LKB
# include LOGON-specific settings
export LOGONROOT=~/delphin/logon # installation location for LOGON
if [ -f ${LOGONROOT}/dot.bashrc ]; then
    . ${LOGONROOT}/dot.bashrc
fi
# Add ACE to PATH # Not necessary, but nice
export PATH=$PATH:$ACEROOT

11) reload .bashrc, using either source ~/.bashrc, quitting and re-opening the terminal, or logging out and back in.

12) Add the following to ~/.emacs to configure emacs:

;;; include LOGON-specific settings
(if (getenv "LOGONROOT")
  (let ((logon (substitute-in-file-name "$LOGONROOT")))
   (if (file-exists-p (format "%s/dot.emacs" logon))
    (load (format "%s/dot.emacs" logon) nil t t))))

13) You should now be able to run the regression tests (MatrixRegressionTesting):

cd ~/delphin/matrix/trunk/
python matrix.py -C gmcs/ r
Clone this wiki locally