Guide to Installing SDDS and OAG Simulation Software on Windows Computers
M. Borland, R. Soliday
Step 1 - Download the required files
A. Download OAG software:|
SDDS Toolkit.msi REQUIRED
Microsoft Visual C++ 2010 SP1 Redistributable Package REQUIRED if not already installed
SDDS Epics Toolkit.msi optional (control system programs)
Elegant.msi optional (accelerator simulation)
Spiffe.msi optional (rf gun simulation)
Shower.msi optional (electron-gamma shower simulation)
Java SDDS.exe optional (editor for SDDS files)
B. Download OAG software manuals. This is optional, but provides a handy
local copy of the manuals, particularly useful for laptop users who
don't have an internet connection all the time.
An easy introduction to SDDS is available in "Getting Started with SDDS,"
You can also download sample
so you can work
along with the examples in this document.
C. Download example simulation files:
These are available from the manuals page,
Look for the links in the sections for each of the programs
that you are interested in.
Save these files to disk. We'll unpack them below.
D. Download the CYGWIN UNIX shell, from
Download and execute the setup.exe. From the dialog box that appears,
select "Install from Internet", and follow directions. If you do not already have ActiveTcl and OAGTclTk installed you may opt to install the Cygwin Tcl/Tk package. You can do this from the "Select Package" screen. Just search for tcltk.
E. If you are planning on using any Java software download
the Java Runtime Environment, from
Install the downloaded software. This will require rebooting your
computer numerous times.
Set up CYGWIN. Open a CYGWIN shell (Start > Programs > Cygnus Solutions > Cygwin Bash Shell) and type the following:|
ln -s C:/cygwin/bin/sh.exe sh.exe
ln -s C:/cygwin/bin/tclsh.exe tclsh.exe
Using the TAB key for automatic filename completion can make typing
in long paths and filenames quicker.
Next, create a .bashrc file in the toplevel on your C drive, with the
These steps will make it easier to set up and run your own sh and
tclsh scripts. The .bashrc file can also be used for other
customizations of the CYGWIN shell.
Unpack the example files for the programs you are interested in.
To do this, open a CYGWIN shell. For any files that have the .gz
extension, use "gzip -d [filename]" to uncompress the file. Then, use
the tar utility to unpack the library, e.g., "tar xvf
Once you've unpacked the files, cd to the directory and start looking
around. There are usually "README" or "Notebook" files that guide you
through the examples. Typically, you'll find one or more scripts that
you can run to execute the example.