affylmGUI uses the R package named "tcltk". This is installed with all standard installations of R.
affylmGUI is dependent on the limma, affy, BiocInstaller, affyio, tkrplot, affyPLM, R2HTML,
xtable, gcrma and AnnotationDbi R packages and their dependencies.
The biocLite installation process described above will automatically install all these R packages.

affylmGUI uses Tcl/Tk. It is a programming language separate from R and needs to be on each platform.
affylmGUI uses two packages written in the Tcl/Tk language, namely, BWidget and Tktable, that need to be present also.
affylmGUI uses the X11 windowing system on Mac OS X and on Unix platforms.
affylmGUI uses the built in windowing system on the Microsoft Windows platform.

The standard R install includes the R tcltk package.
The Tcl/Tk language tools are installed in C:\R\R-3.x.y\Tcl, if R is installed in C:\R\R-3.x.y.
The two Tcl/Tk packages, BWidget and Tktable.are installed in C:\R\R-3.x.y\Tcl\lib.
No further installations are necessary.

The standard R install includes the R tcltk package.
The Tcl/Tk language tools are installed in /usr/local/lib,/usr/local/include and /usr/local/bin.
The two Tcl/Tk packages, BWidget and Tktable are installed in /usr/local/lib/tcl8.6.
X11 is needed on Mac OS X. To save duplicating instructions, please refer to the installation notes for the Rcmdr package,
which uses X11 in a similar manner to that required by affylmGUI. The notes on how to install X11 for the Mac
are located in the "Mac OS X" section in the R Commander Installation Notes.
If you encounter problems refer to the "Mac OS X Trouble-shooting" section in the Rcmdr url mentioned above.
If BWidget and/or Tktable are not found, consult the trouble shooting section below.

The standard R install includes the R tcltk package.
It does not include the Tcl/Tk language tools.
It does not include the two Tcl/Tk packages, BWidget and Tktable.
The Tcl/Tk language is normally already installed on Unix platforms. If it is not consult the trouble shooting section below.
If BWidget and/or Tktable are not found, consult the trouble shooting section below.

On MS Windows, the affylmGUI package works best with the single-document Rgui interface (SDI).
Under the default multiple-document interface (MDI), Tk dialog boxes may not stay on top of the main R window.
This is a general issue with applications, such as the affylmGUI and RCmdr, that are based on the tcltk package.

Requirements of R.

First step is to establish whether R has the capability to use Tcl/Tk and X11. To do this issue the capabilities() command at the R prompt.
The output of this function indicates a TRUE or FALSE value for various abilities.

MS Windows
On MS Windows you need a TRUE value for tcltk. The value for X11 is irrelevant for MS Windows.

Mac OS X:
On Mac OS X you need a TRUE value for Tcl/Tk and also for X11.
If either value is FALSE consult the
R Commander Installation Notes, in particular read the notes under the "Mac OS X" heading.

Unix
On Unix you need a TRUE value for Tcl/Tk and also for X11.
If R has been compiled locally, it may not have been compiled with the " --with-x --with-tcltk " switches.
Examine the config.log file to check the switches used when it was compiled. Recompile and reinstall if necessary.
Tcl/Tk is usually installed with a standard Unix installation. If not consult your sytem administrator.
X11 is usually installed with a standard Unix installation. If not consult your sytem administrator.

Before running R, Test X11 by running a common X application like "xclock". For example:xclock
If you do not get a clock showing on your chosen display then your X11 setup needs to be addressed.
Here are some pointers to check on the various platforms.

On MS Windows
test not applicable.

On Mac OS X:
On my Mac, xclock is located in /usr/X11/bin. If necessary, use the locate command to find the xclock file.
You may need to start the X11 application on your Mac, although on my Mac, X11 automatically starts when xclock is run.

On Unix:
On my Linux machine, xclock is located in /usr/bin. If necessary, use the locate command to find the xclock file.
If you receive a response like:X connection to localhost:11.0 broken (explicit kill or server shutdown)
You may need the DISPLAY environment variable set. For example:export DISPLAY=yourpc.domain.com.au:0.0
If, after running xclock again you now get a message like:Error: Can not open display: yourpc.domain.com.au:0.0
You need to start an Xserver on the computer you are hoping to see the display on.
This could be the X11 application on your Unix workstation or Mac. On MS Windows it could be XWin32 or similar.

At an R prompt, load the tcltk package.>library(tcltk)
If there is no error message then the Tcl/Tk language has been found on your system.
If there is an error message, for example:

On MS Windows:error: Tcl/Tk support files were not installed
Re install R for MS Windows as it includes the Tcl/Tk language.

On Mac OS X:error: Tcl/Tk support files were not installed
Re install R for Mac OS X as it includes the Tcl/Tk language.
Note that the Aqua-compatible (but X11-incompatible) Tcl/Tk directories
will generally be in /Library/Tcl/. affylmGUI cannot use these.

On Unix:
Error message re location of tcl libraries.
You will need to install Tcl/Tk on your unix machine.
You may need system manager privileges to do this.

If you wish to add further paths to be searched for tcl/tk packages, use the command:
addTclPath("/Users/keith/lib"), for example.

To install Bwidget download it from http://sourceforge.net/projects/tcllib/
Click the Download button (current version is bwidget-1.9.7.zip), unzip it (Example command is "unzip bwidget-1.9.7.zip") into /usr/lib
or another location on the auto_path. The BWidget package is written entirely in the tcl language and hence only needs to be
placed in an auto_path location.
To install Tktable download from http://tktable.sourceforget.net.
From this site, select "File Distributions, select the "tktable" link, select the latest version (currently 2.10),
then select the tar.gz file (currently "Tktable2.10.tar.gz"). Save it to a suitable location, unzip and untar it
(Example command is "tar zxf Tktable2.10.tar.gz"). look in the Tktable directory and read the README.txt file installation instructions.
If you installed Tktable into a location in your home directory you would put that location into the auto_path value, as explained above.
The Tktable package includes C code and needs compiling and installing.
If the directories, Tktable2.10 and bwidget-1.9.7 were both located in the directory "TkExtensions" in your home directory, then
auto_path need only to contain "your_home_directory/TkExtensions" to allow tcltk functions to find the Tktable and Bwidget packages.