I. Copyleft ----------- Copyleft (C) 1990 - 1993 Rainer Kowallik. This file is part of LISE. LISE is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY. No author or distributor accepts responsibility to anyone for the consequences of using it or for whether it serves any particular purpose or works at all, unless he says so in writing. Refer to the LISE General Public License for full details. Everyone is granted permission to copy, modify and redistribute LISE, but only under the conditions described in the LISE General Public License. A copy of this license is supposed to have been given to you along with LISE so you can know your rights and responsibilities. It should be in a file named COPYING. Among other things, the copyright notice and this notice must be preserved on all copies. II. What for ? -------------- LISE stands for on Line Interactive Spectra Examination. It is a relatively complete collection of routins to display, modify, and fit one dimensional spectra. There is virtually no limit on the size of the spectra. LISE is intended to work on commandline oriented multitasking machines, such as UNIX Workstations and the AMIGA series of computers. There is also a Graphical User Interface available for LISE applications. This GUI is based on my Menu Description Language Interpreter MDL. MDL itself is not part oft this distribution, but is available as Public Domain Programm too. The UNIX MDL needs the OSF Motif toolkit to be installed properly. (The Amiga Version runs on any Amiga, even with WB 1.3) All Distributed MDL scripts have names "*.mdl" III. Files in this Distribution ------------------------------- 1. Graphical primitives ash.c cur.c hco.c rmtek.c pag.c point.c tekamiga.c tekdaemon.c tpo.c tsf.c vect.c 2. spectra manipulation cio.c genspc.c lbn.c mspc.c scalc.c stype.c tcal.c 3. spectra analysis / fitting b_hf.c expfit.c four.c fpeak.c fprompt.c linFIT.c linfit2.c nmrrvt.c rvt.c rvt2.c pacsplit.c fit/ExampleFn.c fit/fit.c fit/FitFnWkk.c fit/read_table.c fit/Example.prm fit/fit.prm fit/FitFnWkk.prm fit/test.prm 4. string handling str/getline.c str/instr.c str/line.c str/midstr.c str/param.c str/strhead.c str/strlen.c str/strtail.c 5. Menu files (for MDL) ExpFit.mdl lise.mdl lisemod.mdl LisePrompt.mdl LiseRvt.mdl specdef.mdl xfit.mdl 6. make files mklise | mklise.sh compile individual files mkall | mkall.sh compile all files 7. miscellaneaous auxcfg.h gfx.h gfxamiga.h spec.h strings.h ccalc.c COPYING Read_Me_First,Really lise.doc IV. Installation ---------------- a. What do you need for a first example ? UNIX version Amiga Version - The minimum consists of the following programms: Cshell (not part of the package) tekdaemon TekAmiga ash ash scalc scalc tekon tekon rmtek rmtek - and the following settings: LISEPRG=/src/lise Assign LISE: sys:lise - the following datafiles: $LISEPRG/Aux_Config LISE:Aux_Config $LISEPRG/fonts/sans.chr LISE:fonts/sans.chr $LISEPRG/fonts/trip.chr LISE:fonts/trip.chr $LISEPRG/fonts/symb.chr LISE:fonts/symb.chr - and the execution path should contain the lise binaries PATH=$PATH:$LISEPRG PATH ADD LISE: b. compiling for the first examples, you can use the script "mklise" to compile individual files. (e.g. "mklise ash") To compile the whole package use the script "mkall". In the Amiga Version the "Tekamiga" needs to be compiled using "mktek" and you will need to have the "mdllib.*" from my MDL package for the Amiga. Since most of my Amiga scripts are using the CShell, the scripts are named "mklise.sh" and "mkall.sh". c. installing binaries you should copy the binaries from $LISEPRG/str to /usr/bin (AMIGA: "LISE:str" to "c:") and the binaries from $LISEPRG/fit to $LISEPRG. (AMIGA: "LISE:fit" to "LISE:") d. testing graphics On UNIX systems you should first try to open a tektronix screen with "(xterm -t)&". Then try to start the "tekdaemon" from within this tektronix window. Now you can go back to your ASCII terminal emulation and try to generate a test spectrum with scalc "s1[0:127]=sin(0.1*lin)" NOTE: the double quotes are essential and do not surround the "=" operator with blanks ! After this try to display this spectrum with ash s1 -pag -v If this fails, try to compile "vect" and "point". Try to draw a vector with vect 100 100 2000 2000 Normally, all graphic routines should open the Tektronix emulation automatically. Use "rmtek" to close the Tektronix window. Try to use "ash" again. If this fails, you must modify the file "gfx.h" e. environmental settings As mentioned above, the variable $LISEPRG must be set to the lise executable path and this Path must also be included in the normal PATH variable. There is one optional environment variable: MAXSPCLEN contains the maximum spectra array length On Amiga Computers this variable should be set using the supplied LISESET command (LISESET MAXSPCLEN=32768) since programs compiled under MANX are looking for the ARP/MANX style variables and those compiled under SAS or GNU are looking for the Amiga style ENV: variables ! You should modify the ".login" and ".profile" files and also the X11 startup files ! The Vectorbuffer size should be adjusted in Aux_Config ! f. cleaning up pipes Sometimes it may happen, that no Tekwindow opens up after an "ash" command. In this case try to remove the graphics communication channels "/tmp/tek.pipe*" The exact name is defined in your "Aux_Config" file. g. getting help All LISE functions will return a small help message about the available options if you specify the "-h" or "-help" option V. about Amiga Compilers ------------------------ I am using Aztec (MANX) C 5.0 for most of the programms, except for the multiparameter fits. The multiparameter fit routines (fit.c, fitfn*.c) are compiled using Lattice C 5.0 In general, all Programms can be compiled under both compilers, but you should supply the #defines SAS or MANX. You can mix executables from both compilers without problems. In general there are two handicaps: 1. MANX is not able to handle large static arrays ! 2. SAS generates instable code in some cases ! (even worse with SAS 6.0 !) In Future I want to switch over to GnuC. VI. Update info 2.0 ------------------- 1. Reason for this Update This Update is mainly a "graphics" update. I included the Hershey vectorfonts and increased the internal Vector resolution. There are also some minor changes to the ASH command (options -rx -ry -cn -y% -x%). The entries in Aux_Config have been changed drastic. The JCAMPIO command has been added. 2. What has not been done (even if stated in LISE.DOC !) I have not had the time to switch over to GNU C (shame on me !) The LISE portable floating point format must be tested and is not included in this version ! Color and line style support are left for the next release. The JCAMP support is just a quick hack VII. mini LISE -------------- the mini LISE is specially compiled for small Amigas and must be considered as a DEMO Version. Restrictions: 1. Spectralength is limited to 2048 data points (may be adjusted using "LISESET MAXSPCLEN=4096") 2. The vector buffer is reduced to 128k and the primary font is set to litt.chr (may be adjusted in Aux_Config) 3. the general multiparameter fit is not included 4. sources are not included Generating the demo Disk: put a blank, formatted Disk in drive df0: find the LHA or LHARC or LZ command type CD df0: LZ e MINILISE.LHA or LHARC e MINILISE.LHA or LHA e MINILISE.LHA (If you have a Harddisk and enough free space you should create a directory on this Harddisk for LISE and make the installation there) Starting the demo: Boot from a normal Workbench Disk Insert the MINILISE Disk in a second drive if possible open the Disk icon. open the MINILISE Drawer Double click on the Demo icon DO NOT EXPECT THE SPECTRA DISPLAY TO RUN IN ONLY 1MB RAM ! If you are really low on memory, try to avoid all residents, do not LOADWB, Open a new shell instead. Uncomment the line ; lise:LISESET MAXSPCLEN=1024 in DEMO.BAT Edit Aux_Config and set the Vectorbuffer to 0 (now 128000) Use only NTSC HIRES NOLACE (640x200) mode type FROM A SHELL: > stack 32000 > cd df1:MINILISE > execute demo.bat On 68000 Systems with WB 1.3 you may have trouble (=GURU) to start the TekAmiga window from the script after using LISESET (Don't know why...) Open a shell and try to start Tekamiga separately first. If this went well, close the TekAmiga window and try to execute the batch file again. The funny thing is, that this only happens in the combination 68000 + WB 1.3 (Don't come up with WB 1.2 !) 68030/40 + WB 1.3 or 68000 + WB 3.0 works perfectly ! May be this is a bug in MANX C, but TekAmiga compiled under SAS didn't display any characters... VIII. Post Scriptum ------------------ If you hear about a vacant permanent position for a Physicist (PHD) and Computerfreak, preferably in Europe, please let me know. Rainer Kowallik Eisackstr. 14 1000 Berlin 62 Germany EAN: kowallik@vax.hmi.dbp.de