home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / education / help_view / !Help_View / Help / Spectro < prev    next >
Encoding:
Text File  |  1995-12-06  |  14.4 KB  |  363 lines
  1. Help on Spectro
  2.    !Spectro  v 1.22   © <Richard Sharpe>=Author>   1994,95
  3.   
  4.                       ----------------------------                      
  5.                        *     <Introduction>      *
  6.                        *     <Display>=The Main Display Window>           *
  7.                        *     <Database>=Edit Database>          *
  8.                        *     <Options>           *
  9.                        *     <Menus>             *
  10.                        *     <RISCOS Versions>   *
  11.                        *     <Licence>           *
  12.                       ----------------------------
  13.   Click on the words in red on any of the pages for more help.
  14. !@#
  15. Introduction
  16. This is a simulation of a Mass Spectrometer.
  17. It comes in two parts: a fully <configurable>=Choices> ossiloscope <display>=The Main Display Window> and a fully
  18. editable <database>=Edit Database>.
  19.   
  20. Whilst !Spectro is loading it scans a directory inside the application and
  21. depending on what it finds will open one of three possible windows when
  22. you click \<Select>| on the icon bar icon.
  23.   
  24. 1.   <New Database> if no database files are found.
  25. 2.   <Choose Database> if several are found.
  26. 3.   <The Main Display Window> if only one is found.
  27. !@#
  28. New Database
  29. This window consists of a writable icon and an \<OK>| button.  You should
  30. write in the name of the new database file and either press \<Return>| or
  31. press the \<OK>| button which will create a new file of that name  (eg.
  32. Organic, Inorganic  etc.) and open an <Edit Database> window ready for you
  33. to begin to input data.
  34. !@#
  35. Choose Database
  36. If there is more than one database defined then you must tell Spectro which
  37. one you want to use. A window is opened.
  38.   
  39. The choices from the window are as follows:
  40.   
  41. 1.  The menu button entitled Databases, which allows you to choose your
  42.     database.
  43. 2.  \<Delete Database>| which does just that though this is a bit drastic.
  44. 3.  \<Cancel>| which removes the window from view.
  45. 4.  \<OK>| which loads the appropriate database.
  46. 5.  Create Database which enables you to do just that.
  47. !@#
  48. The Main Display Window
  49. Clicking on the Spectro icon on the icon bar will open the main window
  50. which by default has a blue background and a white foreground.
  51. The <colours>=Colours> can be changed quite easily according to taste. 
  52.   
  53. At the top of the main window is a <pane>=Pane>, showing various options.
  54.   
  55. On the top right of the <pane>=Pane> there is a pair of radio icons called
  56. data and test.  These enable you either to test your knowledge of Mass
  57. Spectra which the program will select for you (Test) or to examine a Mass
  58. Spectrum of your choosing (Data).
  59.   
  60. On the top left is a pop-up menu icon.  When you click \<SELECT>| on
  61. this icon, you will see a menu contain all of the chemicals in the
  62. database.
  63.   
  64. Clicking on one of the entries in this menu will paste the name into
  65. the icon to the right.
  66.   
  67. Having made your selection you should click \<SELECT>| on the \<OK>| button.
  68.   
  69. The \<NEXT>| button is only used when !Spectro is in test mode, otherwise
  70. it does nothing.  It is used when you have fully examined the Mass
  71. Spectrum and said what you think it is and you now want another one to
  72. look at.
  73. !@#
  74. Choices
  75. The choices window enables the user to configure the system so that the data
  76. appears according to your particular needs and not the programmer's
  77. preferences.
  78. I hope I have covered most of the things people will need but if I have
  79. missed anything out.  Please REGISTER and I will try to accomodate your
  80. wishes.
  81.  
  82. There are five option areas.
  83.   
  84.     1.    <Options for abundance axis>
  85.     2.    <Options for m/e axis>
  86.     3.    <Gas Pressure>
  87.     4.    <Colours>
  88.     5.    <Resolution>
  89. !@#
  90. Options for abundance axis
  91. The radio icons 'Curves/Sticks' tells the program to <display> the peaks
  92. as straight lines or as the slighly more realistic peaks that an
  93. ossiloscope would show.  This is because 'A' level papers often just use
  94. sticks so the students will be prepared for exams as well as reality.
  95.   
  96. Print peak heights is an On/Off button which allows or not, as the case
  97. may be, the printing of the abundance above the peaks.
  98.   
  99. The radio icons 'Raw Data' and the standardize ones determine how the data
  100. is displayed.  Raw data is the actual abundance; Standardize from 100
  101. makes the highest peak 100 and scales the rest accordingly; Standardize
  102. as percentages adds up the total 'raw' abundance and percentages each
  103. total.  The result is displayed only when the 'Print peak heights' button
  104. is on.
  105. !@#
  106. Options for m/e axis
  107. The radio icons 'regular' and 'logarithmic' determine the nature of the
  108. horizontal axis.  Often on 'A' level papers the scale is presented as
  109. regular but in reality the scale is logarithmic.  The regular axis is often
  110. easier to read.  You can take your pick.
  111.  
  112. You can also change the axis scale, so that more of the spectrum can be
  113. seen at one time, using the bump icons marked 'Axis Scale'.
  114. !@#
  115. Gas Pressure
  116. This slider icon determines the height of the peaks on the display.  This
  117. can be useful if there a lot of tiny peaks which are indistinguishable
  118. from one another.
  119. !@#
  120. Colours
  121. These two menu icons allow you to set both the background and foreground
  122. colours to whatever you wish.  Point the mouse over the menu icon, press
  123. the middle button on the mouse and choose the desired colour.
  124. !@#
  125. Resolution
  126. This is an on/off switch which allows the teacher to edit out information
  127. which may be of a higher level than you may wish to address at this level
  128. of work.
  129. For example you may wish to exclude certain isotopes.
  130. Instructions on how to implement this, is in the <Edit Database> instructions.
  131. !@#
  132. Edit Database
  133. You can enter the database either by clicking the menu button over the
  134. !Spectro icon on the icon bar or by doing the same over the main window, and
  135. moving across from database to Edit Database.  You will be presented with a
  136. window with a large number of icons which will contain the Mass Spec data.
  137.    
  138. At the top you will see Chemical Name and Chemical Formula and in the body
  139. of the window, icons which contain the data for mass/electron charge and
  140. abundance.
  141.   
  142. The Chemical Name icon will only accept lower case letters but it will
  143. convert the first letter of the first word to upper case in the the
  144. Chemicals Menu.
  145.   
  146. If you click in any of the writable icons you will be able to change the
  147. data (if it's wrong!) or add extra data (if it is incomplete!) Pressing
  148. \<TAB>| or \<RETURN>| will take the cursor on to the next writable icon.
  149.   
  150. If there is any data which you want to exclude for some students you can
  151. precede the number with a lower case aitch "h" and this can be displayed or
  152. not depending on the settings in the <Choices> window.
  153.   
  154. At the bottom of the window there is a row of buttons which perform the
  155. following functions.
  156.   
  157. \<|\<|               See previous record.
  158. >>               See next record.
  159. New Record       Prepare for a new record to be entered.
  160. Clear Record     Clear all of the fields in that record.
  161. Search           Opens a window allowing you to type in a chemical
  162.                  you want to find. !Spectro will try to find it.
  163.                  Typing the first few letters of the name is often
  164.                  enough.
  165. Cancel           Closes the database returning you to the main window.
  166.                  If any data has been changed, you will be given the
  167.                  chance to save or not as you wish.
  168. Delete Record    This deletes the record displayed at the time.             
  169. Save Record      This saves the altered or new record to the database.
  170.   
  171. In addition to this you can copy records from one database to another using
  172. the HotKey "Ctrl C" or choosing this option from the database submenu.  This
  173. will open a window with a menu button leading to a menu of all of the
  174. available databases.  Choosing one of these and pressing \<Return>| or the
  175. \<OK>|  button will copy the record presently loaded to the required
  176. destination.
  177. !@#
  178. Menus
  179. There are three menus involved in the application:
  180.  
  181. 1.    <The IconBar menu>
  182. 2.    <The Display window menu>
  183. 3.    <The Edit Database menu>
  184. !@#
  185. The IconBar menu
  186. This is fairly self explanatory:
  187.  
  188. Info does what Info always does.
  189. Help does this!
  190. Choices opens the <Choices> or Options window
  191. Database leads to a <sub menu>=The Edit Database menu>
  192. Quit get you out.
  193. !@#
  194. The Display window menu
  195. Similar to <The IconBar menu> but without Info and Quit but with the
  196. addition of a save as drawfile option.
  197. !@#
  198. The Edit Database menu
  199. This contains four options.
  200.  
  201. 1.   Edit Database opens the edit window allowing you to alter or add to
  202.      your current database.
  203. 2.   Change Database allows you to do just that.
  204. 3.   New database allows the creation of a new file.
  205. 4.   Copy Record allows you to copy records from one database file to
  206.      another.
  207. !@#
  208. Author
  209. Richard Sharpe
  210. 5 Camberwell Terrace
  211. Leamington Spa
  212. Warwickshire
  213. CV31 1LP
  214.   
  215. Tel:  01926 422040
  216. !@#
  217. !Blib
  218. A Basic library linker by Ian Palmer available from various P.D. libraries.
  219. !@#
  220. Colours
  221. The background and foreground colours can be changed by using the Colours
  222. menu icons in the <Choices> window.  This can be opened either from the icon
  223. bar menu or from the main window menu.
  224. !@#
  225. !EventShell
  226. This is the most comprehensive Basic Wimp library available. It is SHAREWARE
  227. so if you do get hold of a copy and find it useful, do pay the registration
  228. fee which for what you get is very little indeed. £10.00 is a lot cheaper
  229. than !WimpGen.
  230. It is written by <Paul Hobbs> and is available from most P.D. libraries or
  231. from the author. (Despite the address he is English but you can write in
  232. English or German.)
  233.   
  234. <Click here>=Author:  !EventShell> for what <Paul Hobbs> wants to say about his very excellent
  235. work.
  236. !@#
  237. Licence
  238. This application is SHAREWARE. If you find it useful you are required to
  239. register. (Within 30 days of first using it)
  240. You may distribute the UNREGISTERED version to whoever you like as long as
  241. you leave the application intact and you make the recipient aware of the
  242. application's Shareware status.
  243.   
  244. ** REGISTRATION IS £5.00 for individuals, £10.00 for a school.**
  245.   
  246. Registration is so that I know who's using the application and hopefully get
  247. some feedback. Also I spent a lot of time on it and want to be appreciated!
  248.   
  249. The advantages of Registering and paying the far from exorbitant fee are as
  250. follows:
  251.   
  252.   1.   You will not be breaking the law.
  253.   2.   You will encourage me to write more educational software
  254.        at low cost.
  255.   3.   You will make me ecstatically happy.
  256.   4.   You will be entitled to free upgrades (for a while at
  257.        least!)
  258.   5.   You will have the opportunity to tell me how to make the
  259.        program better!
  260.   6.   You will have the opportunity to suggest other projects
  261.        that you desire an author for.           
  262. !@#
  263. DISTRIBUTION
  264. You may distribute the UNREGISTERED version of this program to anyone you
  265. like so long as you pass on the whole application including ALL of the files
  266. in the application directory.
  267.   
  268. You may not alter any of the files in any way nor may you claim to have
  269. written any of the code.
  270.   
  271. Send your money, name, address, telephone number, comment, criticisms and
  272. anything else you like to the <Author>.
  273. !@#
  274. CREDITS
  275. The Wimp Procedure Library that I used was written by <Paul Hobbs>
  276. and is part of his excellent <!EventShell>=EventShell> package.  I appended it to
  277. the program using <!Blib>=Blib> which is likewise a very fine piece of work
  278. by <Ian Palmer>=Blib>.  It was then well and truly squashed using <!BasShrink>=Wallace>
  279. by <John Wallace>.
  280. !@#
  281. Pane
  282. A pane is a special window superimposed on the main window which will not
  283. scoll out of view as the main window is scrolled.
  284. !@#
  285. Author: Wimp Shell Library
  286. Paul Hobbs
  287. Rheinpfalzstrasse 2
  288. 85049 Ingolstadt
  289. Germany
  290. !@#
  291. Author:  !EventShell
  292. This program has been written using the routines supplied with the EvntShell
  293. library which is copyright <Paul Hobbs>.
  294.   
  295. EvntShell is a starting point for developing your own applications that run
  296. under the RISC-OS wimp system. The EvntShell library contains code to handle
  297. most of the 'Events' (i.e. opening a menu, closing a window etc) that can
  298. occur, and all your application has to do is inform the library what it
  299. should do when certain events occur. For example a menu can be attached to a
  300. window or to an icon - the library will open the menu for you (in the
  301. correct position!) when the MENU button on the mouse is used.
  302.   
  303. Normally writing a wimp application is a very complex business, involving
  304. much reading of the Programmers Reference Manuals, magazine articles and
  305. examining other applications. The aim of the EvntShell library is to reduce
  306. the need for this and to enable the speedy creation of easily maintained and
  307. robust applications.
  308. !@#
  309. Distribution Licence for EvntShell
  310. You have permission to use any part or the whole library in any Public
  311. Domain/ShareWare project ONCE YOUR COPY HAS BEEN REGISTERED, as long as I am
  312. fully credited (via the inclusion of this file in the program
  313. documentation). If you wish to use these routines in a program that is for
  314. sale (for however much and for whatever reasons) or released as copyright
  315. material then my express permission in writing must be obtained. I maintain
  316. copyright on all the material supplied as part of the EvntShell system
  317. (except where noted below) and reserve the right to amend these conditions in
  318. cases where I deem misuse.
  319.  
  320. The library code is supplied free of charge to everyone 'as is'. There is no
  321. guarantee that it is free from bugs and no warranty is given about its
  322. suitability for use.
  323.   
  324. Further details about EvntShell may be obtained from the author:
  325.  
  326. Paul Hobbs
  327. Rheinpfalzstrasse 2
  328. 85049 Ingolstadt
  329. Germany
  330.  
  331. The heap manager routines used by EvntShell are copyright Risc User and are
  332. used with permission.
  333.  
  334. Copyright for all of the supplied relocatable modules remains with the
  335. original authors.
  336. !@#
  337. RISCOS Versions
  338. I have included three sets of templates. Two are intended for use
  339. mostly in Modes 12-27 and one is more appropriate for use with the
  340. RISC PC which uses an 800x600 screen as default. The RISCOS 3.5
  341. templates will load automatically on a RISC PC and the other sets
  342. will load on machines with RISCOS 2 and RISCOS 3 respectively.
  343. If you have an A5000 that you usually run in Mode 31 then change
  344. the name of TemplRO35 to TemplRO3 and call TemplRO3 something
  345. else.  The RISCOS 2 set use the Interface module exclusively so
  346. if your machine has RISCOS 2 you should always use this set which
  347. should load automatically.
  348.  
  349. If there are any problems please contact the <Author>.
  350. !@#
  351. John Wallace
  352. Supplier of !BasShrink which costs £5.00p. !BasShrink_PD is the 
  353. Public Domain version and is available from various PD libraries.
  354.   
  355. John Wallace,
  356. Architype Software,
  357. 54 Parkes Hall Road,
  358. Woodsetton,
  359. Dudley,
  360. West Midlands,
  361. DY1 3SR
  362. ENGLAND.
  363. !@#