home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / MISC / PERIODC / PERIODIC.TXT < prev   
Encoding:
Text File  |  1995-02-06  |  10.1 KB  |  244 lines
  1.                      P E R I O D I C
  2.                      ===============
  3.  
  4. A  program  to display the periodic table and information
  5. about the elements for the Psion 3a. Version 1.414...
  6.  
  7. (c) Anthony Kucernak, February 1995.
  8. [ark1000@cus.cam.ac.uk]
  9.  
  10. This  software is provided free of charge  on  the  basis
  11. that  it  may only be distributed provided that  this  is
  12. done  for free. Any distribution must include all of  the
  13. files listed below in their original form.
  14.  
  15. Filename       Size
  16. Periodic.opa   11652
  17. Periodic.dbf   23580
  18. Periodic.pic   9620
  19. Periodic.txt   10328
  20.  
  21.                        WHAT'S NEW
  22.                        ==========
  23. The following changes have been made to this version of
  24. Periodic:
  25.  
  26.       o Improved display of information on the
  27.          elements.
  28.       o Better editing within the section devoted to
  29.          molecular weight calculation
  30.       o Changes to the information on some of the
  31.          elements.
  32.       o A bug which stopped the program running off
  33.          some SSDs has been fixed.
  34.       
  35.                       INSTALLATION
  36.                       ============
  37. NOTE:
  38. This  installation  procedure differs from  the  previous
  39. version of this program. The data files are now stored in
  40. a  subdirectory  of  the APP directory  in  keeping  with
  41. common practices.
  42.  
  43. The OPA for this software, PERIODIC.OPA, should be copied
  44. into  the  \APP\  directory of any drive. A  subdirectory
  45. should   be  created  in  this  \APP\  directory   called
  46. PERIODIC,   i.e.   \APP\PERIODIC\.  The  database   file,
  47. PERIODIC.DBF, should then be copied into this  directory.
  48. If  you wish the program to start up quickly then you can
  49. also  copy the screen image file, PERIODIC.PIC, into this
  50. directory as well. If you are short of space then you can
  51. omit  this  file.  It can be re-created from  within  the
  52. program at any time.
  53.  
  54. The information relating to where the files are stored is
  55. summarised below.
  56.  
  57. \APP\
  58.      periodic.opa
  59. \APP\PERIODIC\
  60.               periodic.dbf
  61.               periodic.pic    (optional)
  62.  
  63. The OPA file should be installed from the main screen  as
  64. for other applications (using psion-I).
  65.  
  66.                         START UP
  67.                         ========
  68. On start-up the program should display the periodic table
  69. followed by an information screen detailing creation date
  70. etc. The program requires cA. 34K of memory to run.
  71.  
  72.                    FINDING AN ELEMENT
  73.                    ==================
  74. Elements may be selected either by using the cursor  keys
  75. or typing the symbol for that element.
  76.  
  77. Using Cursor Keys
  78. ~~~~~~~~~~~~~~~~~
  79. The  up/down/left/right arrow keys changes the  currently
  80. selected element; similarly, pressing the PSION-key along
  81. with  one  of  the arrow keys moves to the  edge  of  the
  82. table. If an element remains selected for more than about
  83. one   second,  then  information  for  that  element   is
  84. displayed in a window.
  85.  
  86. Typing the symbol for an element
  87. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  88. By  typing the characters that make up an elements symbol
  89. (e.g.  Ru for ruthenium) it is possible to directly  jump
  90. to  an  element.  As there are a number of elements which
  91. have as there symbol only one letter (e.g. O, oxygen;  F,
  92. fluorine), you must be fairly quick about typing  in  the
  93. two  characters otherwise the cursor will lock  onto  the
  94. element  which  has  as its symbol the  single  character
  95. which  you have typed. For instance, If you wish to  jump
  96. to iron (Fe) and press F, but wait a little too long, the
  97. cursor  will  remain  on  F and display  information  for
  98. fluorine.  If this happens you must start again.  If  you
  99. type  a  wrong character, press ESCAPE or SPACE to cancel
  100. the  character typed. Once you have found the element you
  101. want,  information on that element will be  displayed  in
  102. the  window  above the table.  Accessing  information  in
  103. this window is described in the following section.
  104.  
  105.          DISPLAYING INFORMATION ABOUT AN ELEMENT
  106.          =======================================
  107. Once an element has been selected, information about that
  108. element  will be displayed in a window above the periodic
  109. table.  By  default  the information displayed  is  about
  110. radioactive  isotopes. Information about the  element  is
  111. stored  as  a  scrollable list. Pressing the DIAMOND  key
  112. will  select  the next item, pressing SHIFT-DIAMOND  will
  113. select  the previous item (SHIFT-right arrow, and  SHIFT-
  114. left  arrow may also be used). The current selection type
  115. will  lock so that you can move across the periodic table
  116. and  compare the selected characteristic across different
  117. elements.
  118.  
  119.                        MENU ITEMS
  120.                        ==========
  121. The different menu items are accessed by pressing the
  122. menu key. There are two pull down menus. The first is
  123. COMPOUND, and at the moment only contains one component:
  124. MOLECULAR WEIGHT, this item is further discussed below.
  125. The second menu is labelled SPECIAL and contains three
  126. items: VERSION, SAVE IMAGE, and EXIT. VERSION shows the
  127. startup screen produced on entering the program, SAVE
  128. IMAGE is discussed below, and EXIT is obvious. Each of
  129. these items may be accessed without going through the
  130. menu system by pressing the Psion key and a letter at the
  131. same time. The mappings for these are given below:
  132.           Key                 Menu Item
  133.           ~~~                 ~~~~~~~~~
  134.           Psion-M             Molecular Weight
  135.           Psion-V             Version
  136.           Psion-I             Save Image
  137.           Psion-X             Exit
  138.  
  139. MOLECULAR WEIGHTS
  140. ~~~~~~~~~~~~~~~~~
  141. This  program  will  determine the molecular  weights  of
  142. compounds  typed  in.   This  option  is  invoked  either
  143. through invoking the menu system or pressing Psion-M.
  144. When entering molecular formulae you should type them  in
  145. the  same  way  as  you write them.  The following  notes
  146. should be observed:
  147.      -You  must  type  the characters as they  appear  in
  148.        the   periodic  table.  i.e.  you  must  type  the
  149.        correct  case of the letters. e.g. Fe and  not  FE
  150.        or fe for iron
  151.      -Numbers  always  follow what they  refer  to.  e.g.
  152.        K2PtCl6
  153.      -You   may  use  brackets  (all  of  ({[<>]})  )  to
  154.        include sub-units e.g. Fe3(CN)6
  155.      -Fractional   stoichiometries   are   allowed   e.g.
  156.        WO3.33
  157. The  cursor keys may be used to move through the  formula
  158. to  edit  it.  The delete key may be used to  delete  the
  159. character to the left of the cursor. Psion-left arrow and
  160. Psion-right arrow move to the beginning and  end  of  the
  161. formula;  Psion-Delete  clears the  entire  formula;  ESC
  162. exits  the  formula  calculator;  ENTER  calculates   the
  163. molecular weight for the current formula.
  164.  
  165. FAST START-UP (SAVE-IMAGE)
  166. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  167. On  start-up  the  program checks to  see  if   the  file
  168. 'periodic.pic'  exists  in the \APP\PERIODIC\  directory,
  169. and  if  it  does,  it  uses it to  quickly  display  the
  170. periodic  table.  If it does not find this file  then  it
  171. generates  the  image of the periodic table  (this  takes
  172. slightly longer).  It is possible to save this image  for
  173. fast start-up by using PSION-I (save image).
  174.  
  175.                       THE DATABASE
  176.                       ============
  177. The  information for the periodic table is stored in a  a
  178. database  (periodic.dbf) in the \APP\PERIODIC\ directory.
  179. To  my  knowledge  the information is  correct,  although
  180. there may be some mistakes.  You can update or change the
  181. database by using the standard database application.  The
  182. fourth  field  containing the atomic  weight  information
  183. should  not  be  moved as the program will complain  (the
  184. molecular weight routine assumes that the atomic  weights
  185. occur in the fourth field of the database).
  186. The  program will accept up to 20 fields in the database.
  187. I  have filled in 17. Units for items in the database are
  188. assumed to be bracketed and stored with the field  labels
  189. e.g.  if  you look at the field labels you will see  that
  190. the fourth field is:
  191.      Atomic weight(g/mol)
  192. The  program splits out the (g/mol) and places  it  after
  193. the units when it displays them.
  194. If you find any errors/holes in the database please email
  195. me with the correct data so that I can correct it for the
  196. next release.
  197.  
  198.                      TROUBLESHOOTING
  199.                      ===============
  200. Problem:      Program   issues  an  alert   "Can't   find
  201.        periodic.dbf" on startup and then shuts down.
  202. Cause: On  startup  the program cannot find the  database
  203.        file,     PERIODIC.DBF,    in    the     directory
  204.        \APP\PERIODIC\ on any drive.
  205. Solution:    Make a directory called PERIODIC in the \APP
  206.        directory  of  any drive and copy the PERIODIC.DBF
  207.        file into it.
  208.  
  209. Problem:     Program  issues an alert "The Atomic  weight
  210.        field  must  be the fourth field in the  database"
  211.        on  startup.  The program continues but  will  not
  212.        correctly calculate molecular masses.
  213. Cause: Due  to  a  limitation in the program, the  atomic
  214.        weight  mass  must be the fourth  field  and  must
  215.        contain "(g/mol)" in the label field.
  216. Solution:    Reload the PERIODIC.DBF or undo any  changes
  217.        that have affected the atomic weight field in  the
  218.        database
  219.  
  220.                        KNOWN BUGS
  221.                        ==========
  222. Currently  the  radioactive isotope information  for  the
  223. elements  Ca,  Au,  Bi, U, Pu, Cm exceeds  the  available
  224. space for printing this information.
  225.  
  226.                     ACKNOWLEDGEMENTS
  227.                     ================
  228.  
  229. I  would like to thank those people who pointed out minor
  230. problems  with  the program. I would also like  to  thank
  231. Alan  Roberts  for pointing out a critical  bug  in  this
  232. program and offering a solution.
  233.  
  234.               DONATIONS, BUGS, SUGGESTIONS
  235.               ============================
  236. If the program is of real use to you, then I suggest that
  237. you donate the equivalent of ten pounds sterling ($US 15)
  238. to  Amnesty International. I would be interested to  hear
  239. about any suggestions for improvements to the program  as
  240. well as any bugs which you may find.
  241.  
  242. My address:    ark1000@cus.cam.ac.uk
  243.           Anthony Kucernak
  244.