This is an early alpha pre-release of SDA. Please do not distribute widely.

Run
===

To run on Linux:

$ cd client

Ensure that the java.library.path property in scisoft.ini points to correct
directory (it should). Then (for Linux),

$ LD_LIBRARY_PATH=./lib ./scisoft

On Windows, just open the client folder and double-click on the scisoft.exe
icon.

Coping with Intel (and ATI?) graphics chipsets - this may longer be necessary
as further checks have been added: add a property to scisoft.ini as
 -Duk.ac.diamond.analysis.rcp.plotting.useSoftware=true

There's a user guide for the scisoft plugin at
http://www.opengda.org/downloads/gda/v8.8/GDAGuides_html/uk.ac.diamond.scisoft.analysis/userguide/index.html 

Go to the Diffraction Viewer perspective and add a console view via
Window > Show View > Other... > General. Then create a pydev console choosing
the jython console.

> # fix to problem caused by lack of import site in set up 
> # which makes pydoc fail
> import sys
> sys.executable = ''
> import scisoftpy as dnp
> help(dnp)

It may be necessary to manually configure Pydev to load up Jython correctly by
going to Window > Preferences > PyDev > Interpreter - Jython then selecting the
Jython2.5.1 interpreter and hitting Apply and Ok.

There is one problem I have encountered on Fedora 12 is that plotting from the
Pydev console fails when there is no network. It is caused by NetworkManager
leaving an IP address for the local hostname in /etc/hosts. Work around:
add -Djava.rmi.server.hostname=127.0.0.1 (or whatever is the correct loopback
address) to scisoft.ini

Build
=====
To build SDA product:

$ python builder/gda-build.py -p scisoft -w sbuild

creates a directory called client with the stand-alone product.

Peter.Chang@diamond.ac.uk
2010-10-27