| 1 |
|
| 2 |
________________________________________________________________________ |
| 3 |
|
| 4 |
*** INSTALLATION instructions for PWgui *** |
| 5 |
________________________________________________________________________ |
| 6 |
|
| 7 |
|
| 8 |
The PWgui package comes in two flavors: |
| 9 |
|
| 10 |
(i) STANDALONE EXECUTABLE, which runs out of the box (but works |
| 11 |
only on the platform for which it has been built) |
| 12 |
|
| 13 |
(ii) SOURCE PACKAGE |
| 14 |
|
| 15 |
N.B.: for the usage of repository version of PWgui see file INSTALL.repository |
| 16 |
|
| 17 |
________________________________________________________________________ |
| 18 |
|
| 19 |
(i) Installation instructions for STANDALONE EXECUTABLE |
| 20 |
________________________________________________________________________ |
| 21 |
|
| 22 |
For zipped pwgui-xxx.zip package do: |
| 23 |
|
| 24 |
* unzip pwgui-xxx.zip |
| 25 |
|
| 26 |
whereas for tar-gzipped pwgui-xxx.tgz package do either: |
| 27 |
|
| 28 |
* tar zxvf pwgui-xxx.tgz |
| 29 |
or: |
| 30 |
* gunzip -c pwgui-xxx.tgz | tar xvf - |
| 31 |
|
| 32 |
To launch the program type either: |
| 33 |
|
| 34 |
* ./pwgui |
| 35 |
or |
| 36 |
* pwgui |
| 37 |
|
| 38 |
|
| 39 |
The standalone executable is always available for Linux platform, and |
| 40 |
occasionally also for Mac and Windows. |
| 41 |
|
| 42 |
|
| 43 |
________________________________________________________________________ |
| 44 |
|
| 45 |
(ii) Installation instructions for SOURCE PACKAGE |
| 46 |
________________________________________________________________________ |
| 47 |
|
| 48 |
|
| 49 |
To use the source package you need required Tcl software, in |
| 50 |
particular Tcl + Tk + Itcl + Itk + Iwidgets. PWgui requires the Tcl/Tk |
| 51 |
version 8.4 or later. You may install the software from your OS |
| 52 |
distribution. |
| 53 |
|
| 54 |
For example, for GNU/Linux Debian-based distributions, execute as root |
| 55 |
(or sudo): |
| 56 |
|
| 57 |
* apt-get update; apt-get install iwidgets4 |
| 58 |
|
| 59 |
(this will install also tcl/tk/itcl/itk, because iwidgets depend on them). |
| 60 |
On RedHat-based distributions, the analogous command is "yum". Hence: |
| 61 |
|
| 62 |
* yum install iwidgets |
| 63 |
|
| 64 |
As for the Archlinux consider the following installation instructions |
| 65 |
(due to Gonzalo Aguirre): neither itk nor iwidgets are in the official |
| 66 |
repositories, so they should be obtained from the AUR using the |
| 67 |
following recipe: |
| 68 |
|
| 69 |
* yaourt -S itk-cvs |
| 70 |
* yaourt -S iwidgets |
| 71 |
|
| 72 |
If an issue arises during the iwidgets installation, check where the |
| 73 |
itk-cvs is installed (pacman -Ql itk-cvs) and specify the directory |
| 74 |
explicitly while building the iwidgets package (e.g.: |
| 75 |
--with-itk=/usr/lib/itk3.4) |
| 76 |
|
| 77 |
|
| 78 |
Alternatively you may install ActiveTcl8.4 (which has all the required |
| 79 |
software built-in) from: |
| 80 |
|
| 81 |
http://www.activestate.com/activetcl/downloads/ |
| 82 |
|
| 83 |
BEWARE: do not install the newer 8.5 or 8.6 version of ActiveTcl, |
| 84 |
because they do not contain all the needed software. The |
| 85 |
version 8.4 is mandatory !!! |
| 86 |
|
| 87 |
|
| 88 |
Once your computer has all the needed software, your source package is |
| 89 |
ready to run. You only need to untar the PWgui source tarball, i.e.: |
| 90 |
|
| 91 |
* gunzip -c PWgui-<version>.tgz | tar xvf - |
| 92 |
or |
| 93 |
* tar zxvf PWgui-<version>.tgz |
| 94 |
|
| 95 |
where <version> stands for version number. To launch the PWgui |
| 96 |
program, type: pwgui. |
| 97 |
|
| 98 |
You may add the PWgui root directory to your PATH. |
| 99 |
|
| 100 |
If you would like to copy "pwgui" launcher to some common place, such |
| 101 |
as /usr/local/bin, then you need either to define PWGUI environmental |
| 102 |
variable so that "pwgui" will be able to locate its root directory |
| 103 |
(i.e. source files) or alternatively hardcode it into pwgui lanucher |
| 104 |
itself. |
| 105 |
|