Please note that these Trac pages are no longer being updated. Wiki contents/documentation have moved to GitHub.


Seattle Experiment Library

The Experiment Library provides a means of scripting interaction with individual nodes and VMs as well as with the Seattle Clearinghouse. Whereas Seash is for interactive use, the Experiment Library allows for writing Python scripts to acquire VMs, run experiments, download logs, etc.

Getting the Experiment Library

You can obtain the experiment library by running the following commands:

mkdir experimentlibrary
cd experimentlibrary
svn export
svn export
svn export
svn export
svn export
rm -rf seattlelib/test seattlelib/tests portability/tests repy/apps repy/tests repy/winAPItests
mv experimentmanager/* seattlelib/* portability/* repy/* ./
rmdir experimentmanager seattlelib portability repy
cd ..

Running the above commands will give you a directory named experimentlibrary/ that contains the file as well as all necessary supporting files. The file is the Experiment Library that you will use.


At the top of your own Python script add:

import sys
import experimentlib

You can then use the Experiment Library in your script by calling the methods of the experimentlib module you imported.

All of the public constants, variables, and functions in are meant to be used by your script. The private identifiers (the ones beginning with an underscore) should not need to be used by your script.

The comments at the top of contain useful information about the data types and exceptions used by the Experiment Library. All of the public functions have comments to explain their usage. The examples/ directory that is in your experimentlibrary directory (if you performed the steps above) contains a handful of scripts that show different ways to use the Experiment Library.

If you run into problems, find bugs, or feel that some useful functionality is missing, send an email to seattle-devel -at- cs -dot- washington -dot- edu.


The best documentation is just to look at the comments in

Second to that is to look at the examples.