home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 430.lha / Paws_v0.17 / PAWSDisp < prev    next >
Encoding:
Internet Message Format  |  1990-10-01  |  8.9 KB
  1. Xref: altitude comp.sys.amiga:852 comp.sys.amiga.tech:144
  2. Path: altitude!clyde.concordia.ca!uunet!munnari.oz.au!csc.anu.oz.au!myb100
  3. From: myb100@csc.anu.oz.au
  4. Newsgroups: comp.sys.amiga,comp.sys.amiga.tech
  5. Subject: Image displays: Mainframe->Amiga: PAWSDisp
  6. Message-ID: <1990Sep21.160213.2884@csc.anu.oz.au>
  7. Date: 21 Sep 90 06:02:13 GMT
  8. Organization: Computer Services, Australian National University
  9. Lines: 201
  10.  
  11.  
  12. [What follows is an edited version of the PAWSDisp readme file]
  13.  
  14. Do you have images on your mainframe computer (Sun or Vax), an Amiga
  15. sitting on your desk, and a serial line connecting the two ? Or, instead
  16. of images, any two-dimensional data/model, whatever. If you would like
  17. to be able to display these images on your Amiga, read on. 
  18.  
  19. Announcing the first external release of:
  20.  
  21. PAWSDisp 1.40 : 18 September 1990 - Markus Buchhorn
  22.  
  23.  
  24. What is PAWS ?
  25. ==============
  26.  
  27. PAWS = Personal Astronomical WorkStation.
  28.  
  29. PAWS is a terminal emulation program for Commodore Amigas. It runs on all
  30. models (A500/A1000/A2000/A2500 - and we have no reason to believe it
  31. shouldn't run on the A3000) It was written by Dr Ken J. Mighell, who is
  32. (at time of writing this) a Post Doc at Mount Stromlo Observatory, Canberra,
  33. Australia. The PAWS executable is freely distributable. The PAWS source
  34. and PAWS-Language documentation is available for (some quantity of money)-
  35. contact Ken at mighell@mso.anu.oz.au 
  36.  
  37. PAWS provides a three screen device: A VT100, A Tek4010 and an image display 
  38. screen, (no particular emulation) programmable with Tek4010 commands. The VT100
  39. is Dave Wecker's VT100 2.4. The Tek4010 is a fixed two-colour 640x400 screen.
  40. The Image display screen is 320x200 , 32 colours, 4 of which are used by the
  41. system, leaving 28 for the actual image. PAWS provides 3 colour tables you
  42. can choose from, swapping at any time you like, also flipping and rotating of
  43. the colour table is possible.
  44.  
  45. PAWS is a programmable emulator. It uses the PAWS Language to move between
  46. screens, clear screens, display a row of pixel data, draw lines, etc. Much of
  47. this is based on TEK4010 codes. All data transfer is done over the serial line.
  48. This means that PAWS can be run over a modem. It uses a clever compression 
  49. technique to send data over the serial line, and the Amiga decompresses this
  50. and displays it. This means that PAWS runs at quite a respectable rate over
  51. 9600 baud lines, and you can cope quite well with just 2400 baud. Unless you
  52. have Ethernet/etc., you'll be stepping up ! :-)
  53.  
  54. Anybody can write programs in Fortran/C/Pascal/whatever that program PAWS,
  55. using the PAWS_LIB library. You can thus tailor your programs to do whatever
  56. you want.
  57.  
  58. What is PAWSDisp ?
  59. ==================
  60.  
  61. PAWSDisp provides a standard interface for PAWS image displays. It provides a
  62. large number of image manipulation/analysis features, together with a very
  63. flexible usage: The user provides the header program to read data in, and then 
  64. calls PAWSDisp as outlined below. PAWS and PAWSDisp were written with Astronomy
  65. in mind. Hence, it provides features to speed up data reduction. For the
  66. Astronomers out there, we currently have headers for 
  67.  
  68. (1) FIGARO, (VAX and Sun)
  69. (2) Mike Cawson's GASP, (VAX)
  70. (3) IRAF (Sun)
  71. (4) Starlink BDF (VAX)
  72. (5) Diskfits (Sun)
  73.  
  74. [Still to come: STSDAS, MIDAS .bdf, PANDORA .sad, NCSA .hdf, Poskanzer's PBM,
  75. anything else that comes along...?]
  76.  
  77. But PAWSDisp is not just for Astronomers. Anybody with images on a mainframe
  78. that they want to look at can use PAWS. And not just images. If you have
  79. a scientific model, say, with three parameters: Put two of them as coordinates
  80. on a grid, and make the third one an intensity. Treat that as an image and
  81. display it/print it. This is a *very* effective way of presenting data/models.
  82.  
  83. Installing and using PAWSDisp:
  84. ==============================
  85.  
  86. Given that you have some image data, you need to write a small program to
  87. do the following: 
  88.  
  89. Read your data (nx,ny) into a real*4 2D array, of size xlim,ylim. 
  90. [...]
  91. The name of the file is 'frame' which is used as the root for files generated
  92. by PAWSDisp (NB This can include the path! Take care!). You can define a PAL 
  93. or NTSC display on the subroutine call.
  94.  
  95. Hence:
  96.  
  97. integer xlim,ylim,nx,ny
  98. real*4 image(xlim,ylim)
  99. character frame
  100.  
  101. [...]
  102.  
  103.          CALL pawsdisp(image,xlim,ylim,nx,ny,frame,'PAL','ERASE')
  104. [...]
  105.     end 
  106.  
  107. simple, really.... :-) (the 'ERASE' indicates the screen should be wiped
  108. when PAWSDisp first starts up)
  109.  
  110. --------------------------------------------------------------------------
  111.                     A very brief description of the commands
  112. --------------------------------------------------------------------------
  113. The standard PAWS commands - all implemented (LUT=Look-up table)
  114.  
  115.     ALT 1 = go to vt100 window     ALT ! = erase vt100 window
  116.     ALT 2 = go to tek window       ALT @ = erase tek window
  117.     ALT 3 = go to image window     ALT # = erase image window
  118.     ALT F = flip color table       ALT L = change color table
  119.     ALT R = toggle LUT rotation    ALT W = display color table
  120.     ALT T = toggle window title
  121.  
  122. PAWSDisp commands. Note that (except where given) most of these commands
  123. are case-insensitive. Any keystroke not listed here will just measure the
  124. data value wherever the cursor currently is. (I recommend using the
  125. space-bar for this.) 
  126.  
  127.     ?-/  = Type the help menu           Q   = Quit
  128.     C    = Clip LUT                     F   = Fold LUT
  129.     S    = Set LUT limits by hand       R   = Auto-set LUT
  130.     T    = Toggle data header           L   = Toggle log. scale
  131.     X    = Flip image in X              Y   = Flip image in Y
  132.     Z    = Zoom onto image              A   = Display whole image
  133.     d-D  = Zoom out by 1-3             i-I  = Zoom in by 1-3
  134.      G   = Zoom in or out by a factor of 2
  135.      \   = List info of image           N   = Refresh the screen
  136.  
  137.     h-H  = horizontal spectrum         v-V  = vertical spectrum
  138.  
  139. These produce binned spectra of the image, sliced in x (h/H) or in y (v/V).
  140. The Tektronix screen has three options: q-to quit,|-for PS output (see below)
  141. and any other key will measure the point, with the output going to the VT100
  142. screen. 
  143.  
  144.     |   = Screen -> PostScript 
  145.  
  146. '|' (the UNIX pipe symbol) will produce a file of the image you can print on
  147. laserwriters. It only contains that part of the image that is currently on
  148. screen, in the same orientation, same greyscale (+/- laserwriter quality).
  149. Also includes the icon (if up) along with the 'you are here' box, and 
  150. writes up a header line, plus any comments you might like to add.
  151.  
  152. The same command given on the Tektronix (spectrum) display will produce a
  153. PostScript file of the plot. It allows you to add your own labels for the
  154. axes and the main label, in addition to the information header. It's fairly
  155. simple PS (witness who wrote it :-) ) so if you want to rearrange stuff
  156. afterwards, change labels, etc., it's very easy. 
  157.  
  158.         W   = Write points to file
  159.     P   = pan / finder chart           O  = set panscreen LUT
  160.  
  161. Produces an iconic form of the image, indicating current screen. If you select
  162. a point *on* the icon, that becomes the new center - shifts the image to there,
  163. while conserving the zoom. This allows you to move around very quickly. 
  164. 'P' again removes the panscreen. The greyscale on the panscreen is the default
  165. one it starts with, which is sometimes wrong - the 'O' command will let you set
  166. it interactively. 
  167.  
  168.        B    = histogram plot of pixel values
  169.        U    = change icon size
  170.        E   = expand the image in y
  171.  
  172. -----------------------------------------------------------------------------
  173.  
  174. To Do Yet:
  175.  
  176. - Allow arrays for conversion of pixel values to other values, 
  177.   e.g. wavelength scale, intensity scale...
  178. - Allow for batch-mode operation...
  179. - Arbitrary direction slices, with input slit width.
  180. - More ILASER-ish like output for the Postscript image output. (i.e. tickmarks.)
  181. - Flip the Tek(and TPS)-spectrum in x or y if the image itself is flipped.
  182. - Improve the label positioning on the Tek/TPS output - still kinda screwy now.
  183. -   Suggestions ????
  184.  
  185. -----------------------------------------------------------------------------
  186.  
  187. So, where do I get it ?
  188. =======================
  189.  
  190. Anonymous ftp from merlin.anu.oz.au [130.56.4.215] in the directory
  191. pub/PAWS_Sun or pub/PAWS_Vax
  192.  
  193. There are differences between the two machines that I won't go into. Take the
  194. one appropriate to your machine. 
  195.  
  196. There is also a header program for IRAF images in the PAWS_Sun directory.
  197. Others are available - mail me if you want them, or need help writing your own.
  198.  
  199. Please remember that we are GMT+10hrs here at the moment - keep your ftp'ing
  200. to a quiet time of our day please, if possible.
  201.  
  202. Have fun !
  203. Cheers,
  204.     Markus
  205.  
  206. ===============================================================================
  207.  Markus Buchhorn                                           ///  | This space
  208.  Mt Stromlo and Siding Spring Observatories, Canberra     ///   | 
  209.  PMB Weston Ck. P.O. A.C.T. 2611, Australia           \\\///    | intentionally
  210.  markus@mso.anu.oz.au  -or-  nssdca::psi%mssso::markus \XX/     | left blank
  211. ===============================================================================
  212.