home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / rasmol / scipts / bilayer / !Bilayer / BILAYER1 < prev    next >
Text File  |  1996-04-11  |  8KB  |  185 lines

  1. This document has the following sections:
  2.  
  3. INSTALLATION OF RASMOL SCRIPT
  4. OPERATION OF SCRIPT
  5. SCRIPT SPEED/PACING/TIMING
  6. SCRIPT REVISION HISTORY
  7.  
  8. This script is distributed from the RasMol Home Page,
  9. http://www.umass.edu/microbio/rasmol.
  10. Look there for updates and other scripts.
  11.  
  12. Most scripts are available in two versions.  One runs
  13. unattended, continuously.  The other contains pauses
  14. ('press any key to continue') and is intended to
  15. illustrate a lecture.
  16.  
  17. Installing and running a script is really quite simple.
  18. However, the first time you do it, there are a few
  19. details which might not be obvious.  This document will
  20. help to make your first script-running experience
  21. smooth and easy.  Once you have run a script, you'll
  22. be able to re-run it or run other scripts quite easily.
  23.  
  24. - - - - - - - - - - - - - - - - - - - - - - - - - - - 
  25. INSTALLATION OF RASMOL SCRIPT
  26.  
  27. MACINTOSH, UNIX
  28.  
  29. Detailed, optimized installation instructions for these
  30. operating systems are not available at this time.  If
  31. you can provide such instructions, please send them to
  32. emartz@microbio.umass.edu.
  33.  
  34. For the MacIntosh, you can either download the
  35. self-extracting archive BILAYER1.SEA.HQX (if
  36. available), or use ftp to 'mget *' all the files of the
  37. script.  (Precede the ftp command 'mget *' with
  38. 'prompt' to toggle off interactive prompting; that is,
  39. so ftp won't ask you to confirm the transfer of each
  40. and every script file.)  If the script files are put in
  41. the same folder as the RasMac program, the script will
  42. run.  This works, but may not be ideal because multiple
  43. scripts will mix hundreds of files on one folder.  If
  44. you know how to get RasMac to run a script in a different
  45. folder, please email details to emartz@microbio.umass.edu.
  46.  
  47. WINDOWS/DOS
  48.  
  49. Each script consists of a top level script plus many
  50. subscripts and some PDB files.  It is therefore
  51. advisable to install each script in a separate
  52. subdirectory. For example, assuming you have installed
  53. the RasWin program files in C:\RASWIN, the script BILAYER1
  54. could be installed in C:\RASWIN\BILAYER1.
  55.  
  56. To do this, copy the packed file BIL1ZIP.EXE into the
  57. desired subdirectory, and then run it as a DOS program
  58. at the DOS prompt (which will unpack it).
  59.  
  60. Now, in Windows, with the RasWin icon selected, select
  61. File, Preferences, and change the Working Directory to
  62. the one containing the unpacked script files.  (If you
  63. want access to RasWin's built-in help, you must also
  64. copy RASWIN.HLP into the working directory.)
  65.  
  66. If you have several scripts, you may wish to create a
  67. separate RasWin icon for each.  This would enable you
  68. to change scripts smoothly during a lecture, without
  69. repeatedly reconfiguring one icon's working directory. 
  70. With the RasWin icon highlighted, select File, Copy. 
  71. Now use File, Properties to change the working
  72. directory to the one for the script, and the
  73. Description (which will appear under the icon) to the
  74. script name.  Thus you will end up with a
  75. script-name-labeled RasWin icon for each script.
  76.  
  77. If you wish, you can even configure the Properties to
  78. run the script automatically when the icon is
  79. double-clicked.  To do this, put '-script bilayer1.top'
  80. after RASWIN.EXE in the Command Line slot of the
  81. Properties box.  [WARNING: there is a bug in RasWin
  82. beta 2.6. Scripts started in this way terminate at the
  83. first pause, returning the RasMol> prompt.  Therefore,
  84. scripts will have to be run manually, with a 'script
  85. bilayer1.top' command in the command window, until this is
  86. fixed.]
  87.  
  88. - - - - - - - - - - - - - - - - - - - - - - - - - - - 
  89. OPERATION OF SCRIPT
  90.  
  91. If you can provide details for Macintosh or Unix, please
  92. send them to emartz@microbio.umass.edu.  However, the
  93. principles are very similar in all operating systems.
  94.  
  95. Run RasMol.  (Under Windows, double-click on the RasWin
  96. icon.)  If the black RasMol graphics window extends to
  97. the bottom of the screen, move and reshape it so that
  98. it fills the top 5/6 of the screen, leaving the bottom
  99. 1/6 uncovered.
  100.  
  101. The major problem beginners have is not being able to
  102. find the RasMol Command Line window.  When you run
  103. RasMol, a black window will open entitled "RasMol
  104. Version N.N", with pull-down menus named File, Edit,
  105. Display, Colours, Options, Export, Help.  This is the
  106. graphics window.  (For a tutorial on how to use RasMol,
  107. see the web site http://www.umass.edu/microbio/rasmol,
  108. and look under classroom/education.)
  109.  
  110. A separate, second window, the Command Line Window, is
  111. also opened when you run RasMol.  Under Windows, the
  112. Command Line Window starts out minimized to an icon
  113. near the bottom of the screen. If you can see the icon,
  114. click on it to open it.  If you cannot see it, under
  115. Windows, use Alt-Tab to cycle through all the windows
  116. until you find one titled "RasMol Command Line" --
  117. then release the Alt key to open the window.  The
  118. Command Line Window is white.
  119.  
  120. Once you have the Command Line Window open, move it so
  121. that its bottom lines up with the bottom of the screen.
  122. Press Enter until the 'RasMol>' prompt is repeated all
  123. the way to the bottom of the Command Line Window.
  124. Arrange the two RasMol windows so that when the black
  125. graphics window is in the foreground, exactly seven lines
  126. of 'RasMol>' prompt are visible in the portion of the
  127. white Command Line Window which shows below the black
  128. graphics window.  These 7 lines will display the script
  129. captions when the script is running. (The 7th line will
  130. always be blank, so there are actually a maximum of
  131. 6 lines of caption text.)
  132.  
  133. BILAYER1.TOP is the top-level script. Start it by typing
  134. 'script bilayer1.top' in the RasMol command line window,
  135. then pressing Enter/Return.
  136.  
  137. This script is designed to run unattended.  See below
  138. for tips on how to adjust the speed/timing.
  139.  
  140. - - - - - - - - - - - - - - - - - - - - - - - - - - - 
  141. SCRIPT SPEED/PACING/TIMING
  142.  
  143. Script execution speed is affected by the speed of your
  144. computer, the speed of your graphics card, the screen
  145. resolution, and the size of the RasMol graphics window. 
  146. Starting with a full-screen graphics window, you can
  147. speed up execution by reducing the resolution from 1024
  148. x 768 to 800 x 600 to 640 x 480 pixels.  Under Windows,
  149. this is usually done with a SetRes (or related) icon in
  150. the Windows Control Panel.  Further increases in speed
  151. can be obtained by reducing the size of the graphics
  152. window (to less than full-screen).  Quick previewing of
  153. scripts can be done very quickly in a tiny graphics
  154. window.
  155.  
  156. This script was designed to run unattended. Since
  157. RasMol does not yet have a delay command, it took a
  158. while to hit upon a mechanism to insert delays (see
  159. file delay1.scr).  Unfortunately the lengths of these
  160. delays are entirely dependent on the speed of the
  161. computer running the script. The delays work well on an
  162. 80486DX/66 megaherz PC running RasWin-32bit 2.6-beta,
  163. using a 640 x 480 pixel screen resolution. On faster or
  164. slower computers the delays may need to be tinkered
  165. with by editing the script files (but also consider the
  166. strategies mentioned above for fine tuning the overall
  167. pace).
  168.  
  169. Windows: RasWin32 beta 2.6 (the 32 bit program) is
  170. several times faster than RasWin 2.6 (the 16 bit
  171. program).  To run RASWIN32 you may need a Windows
  172. accessory package which is provided free by MicroSoft. 
  173. For details see:
  174.  
  175. http://www.umass.edu/microbio/rasmol/getras.htm
  176.  
  177. - - - - - - - - - - - - - - - - - - - - - - - - - - - 
  178. SCRIPT REVISION HISTORY
  179.  
  180. BILAYER1.TOP first released April 11, 1996.
  181.  
  182. - - - - - - - - - - - - - - - - - - - - - - - - - - - 
  183. -Eric Martz
  184. emartz@microbio.umass.edu
  185.