|
| 1 | +This is the source code of the Linux/Unix version of David Radford's Data Analysis Software. |
| 2 | + |
| 3 | +Latest update: 7 Dec 2020 |
| 4 | + |
| 5 | +This release is portable between linux, Mac OS X, and many unix variants. |
| 6 | +For more details on installing in Mac OS X you may wish to look at README.macosx. |
| 7 | + |
| 8 | +A brief description of what each program does is in the file doc/aa_radware.lis. |
| 9 | +More documentation can also be found at http://radware.phy.ornl.gov/ and in other files in the doc directory. |
| 10 | +You can find demonstration data files in the demo directory. |
| 11 | + |
| 12 | +To compile rw05, you should be able to use almost any C compiler. |
| 13 | + |
| 14 | +================================== |
| 15 | +== To download the source code: == |
| 16 | +================================== |
| 17 | + |
| 18 | +From github: |
| 19 | +============ |
| 20 | + |
| 21 | +The rw05 git repository is on |
| 22 | + https://github.com/dcr-radware/rw05 |
| 23 | + |
| 24 | + |
| 25 | +By svn: |
| 26 | +======= |
| 27 | + |
| 28 | +An less-frequently-updated version is available using Subversion (svn). |
| 29 | +If you have svn installed, you can use the command |
| 30 | + svn co https://radware.phy.ornl.gov/rw05 |
| 31 | +to check out the latest rw05 source tree. |
| 32 | + |
| 33 | +============================================= |
| 34 | +== Required Software Development Packages: == |
| 35 | +============================================= |
| 36 | + |
| 37 | +Radware will be compiled from scratch. That means that you need to have |
| 38 | +some "development packages" installed on your system, or the compile will |
| 39 | +fail. |
| 40 | + |
| 41 | +You will always want to have readline and X11 installed. If you want to use |
| 42 | +GUI versions of gls, escl8r, levit8r and 4dg8r, then you will also need |
| 43 | +GTK2 and/or lesstif (or openmotif) packages installed. |
| 44 | +On some modern linux distributions, you will also need to install X11 fonts. |
| 45 | + |
| 46 | +On my Kubuntu system, I need at least to install the following: |
| 47 | +gcc (C compiler) |
| 48 | +make (to build the programs) |
| 49 | +libreadline-dev |
| 50 | +libgtk2.0-dev |
| 51 | +lesstif2-dev |
| 52 | + |
| 53 | +================== |
| 54 | +== To Compile: == |
| 55 | +================== |
| 56 | + |
| 57 | +There is a separate README files for Mac OS X, namely README.macosx. |
| 58 | +If you are installing on a mac, read that file too. |
| 59 | + |
| 60 | +1) Type: |
| 61 | + cd rw05/src |
| 62 | + cp Makefile.sys Makefile |
| 63 | + |
| 64 | + where "sys" corresponds tpo your system, namely "linux", "macosx", "solaris", etc. |
| 65 | + Edit the top level Makefile (the one you just made with the cp command). |
| 66 | + If needed, change any of the lines that depend specifically on your local |
| 67 | + filesystem, for example the definitions of X_WIN_TOP and MOTIF_TOP. |
| 68 | + Change INSTALL_DIR, INSTALL and INSTALL_BIN if you wish to install the |
| 69 | + files in a separate directory (see step 4). |
| 70 | + |
| 71 | +2) RadWare can read spectra from ORNL-format .his histogram files. |
| 72 | + Most users will not be interested in this feature; if this includes you, |
| 73 | + skip to step 3. |
| 74 | + If you want to be able to read .his files, your system needs to have the |
| 75 | + ORPHLIB library installed, and you need to change your Makefile to link |
| 76 | + some of the programs with orphlib.a and some FORTRAN run-time libraries. |
| 77 | + Here is what you need to do: |
| 78 | + Edit your top level Makefile, and uncomment the line that defines HISLIBS, |
| 79 | + changing the FORTRAN libraries and the location of orphlib.a as needed. |
| 80 | + If (and only if) orphlib.a was compiled with g77, you also need to |
| 81 | + uncomment the line redefining FC = g77 |
| 82 | + |
| 83 | +3) To make the standard (non-GUI) codes, type: |
| 84 | + make all |
| 85 | + |
| 86 | + If your system is missing development libraries, such as X11 or |
| 87 | + readline, the make will fail. There will be compile errors, usually |
| 88 | + beginning with something like |
| 89 | + "error: readline/readline.h: No such file or directory" |
| 90 | + If this happens, speak to your system administrator, and/or try to |
| 91 | + find out whcih packages to install, and how to do it. |
| 92 | + |
| 93 | + GTK versions: If your system has the GTK2 development libraries installed, |
| 94 | + and you wish to use the GTK versions of gls, escl8r, etc., then type: |
| 95 | + make GTK |
| 96 | + |
| 97 | + Motif versions If your system has the Motif development libraries installed, |
| 98 | + and you wish to use the Motif versions of gf3, gls, escl8r, etc., then type: |
| 99 | + make XM |
| 100 | + |
| 101 | + |
| 102 | +4) You can install the executables and data files in a separate directory. |
| 103 | + THIS IS NOT NECESSARY to run the programs; if you choose not to do the |
| 104 | + install, you can just run them directly from the src directory of steps |
| 105 | + 1) and 3). |
| 106 | + |
| 107 | + To install, check the definition of INSTALL_DIR, INSTALL and INSTALL_BIN |
| 108 | + in the Makefile and type: |
| 109 | + make install |
| 110 | + |
| 111 | + If the install fails for some reason, try editing your top level Makefile, |
| 112 | + to replace the line near the end: |
| 113 | + include Makefile.install_sysv |
| 114 | + or |
| 115 | + include Makefile.install_ucb |
| 116 | + by: |
| 117 | + include Makefile.install_cp |
| 118 | + and try again. |
| 119 | + |
| 120 | +5) Edit the .radwarerc file so that the pathname variables |
| 121 | + are properly defined to $(INSTALL_DIR)/font, etc., or whatever. |
| 122 | + These definitions will allow the various programs to find files that |
| 123 | + they need, such as icc/icctbl.dat, font/font.dat, and doc/gfonline.hlp. |
| 124 | + There are some other environment variables in there, too, that you |
| 125 | + might like to play with. See WHATS_NEW for details. |
| 126 | + |
| 127 | + .radwarerc can be found in either the src directory, or in $(INSTALL_DIR). |
| 128 | + There is also a bash version, .radware.bashrc, for those who prefer bash |
| 129 | + to tcsh or csh. |
| 130 | + |
| 131 | +6) Make sure that your .login, .bashrc, or .cshrc, or the system .login, includes |
| 132 | + source $(INSTALL_DIR)/.radwarerc |
| 133 | + or copy the .radwarerc to your home directory and have it executed |
| 134 | + from there. |
| 135 | + Also make sure that $(INSTALL_DIR)/bin (or the src directory, if you |
| 136 | + didn't do the install) is in your path. |
| 137 | + Then you are set to go; try gf3, gtkgls etc. |
| 138 | + Have a look in the demo directory for sample files. |
| 139 | + You should also copy demo/gfinit.dat into your home directory. |
| 140 | + |
| 141 | +7) To clean up the source directory: |
| 142 | + make clean |
| 143 | + To clean up the source and all subdirectories, leaving only the source code: |
| 144 | + make very-clean |
| 145 | + |
| 146 | +------------------------------------------------------------------- |
| 147 | +Please send any bug reports and suggestions to [email protected] |
| 148 | +------------------------------------------------------------------- |
| 149 | + |
| 150 | +D.C. Radford Dec 2020 |
0 commit comments