Metropoli BBS
VIEWER: chemlb20.doc MODE: TEXT (ASCII)
ChemLab v2.0
============
Chemistry periodic table by Arnold Moy (c)1997.



CONTENTS
========

        1. Introduction
                1.1 Copyright and Disclaimer
                1.2 The ChemLab Library
                        1.2.1 Features

        2. Installing and Removing the ChemLab Library  
                2.1 Installing the Library
                2.2 Universal Font Library (UFL)
                2.3 Bytes and Checksum
                2.4 Removing the Library
                
        3. Usage
                3.1 Commands
                3.2 Periodic Table Menu Functions
                        3.2.1 Periodic Table Keys  
                3.3 Property Viewer Menu Functions
                        3.3.1 Property Viewer Keys
                3.4 chemlabPAR        
                        
        4. Acknowledgments
        
        5. History
        
        6. Resources and References
        


1. Introduction
---------------

1.1  Copyright and Disclaimer
-----------------------------
All files in the ChemLab package are copyrighted(c) by Arnold Moy
unless otherwise noted.

The software contained in this package is provided as free of charge
and therefore contains no warranty of any kind.  Should the Software 
prove defective, you and not the author assume the entire cost of any 
service and repair.  This disclaimer of warranty constitutes an 
essential part of the agreement. 


1.2 The ChemLab Library
-----------------------
The ChemLab library uses a graphical periodic table front-end to
display various properties for 109 elements.  A total of 22 properties
are listed for each element and are fully accessible to external programs 
requiring access to the internal database.  Other features include a 
molecular weight calculator.



1.2.1 Features
--------------
     o graphical periodic table with element symbols
     o fast property browser with 22 properties 
     o stack placeable properties via property browser
     o internal database accessible by external programs
     o compressed database      
     o last position preserved upon exit
     o fast molecular weight calculator
     o uses the UFL (Universal Font Library)
     o works on all HP48 models (S,G,SX,GX)
     o works from any port
     


2. Installing and Removing the ChemLab Library
---------------------------------------------
The ChemLab library requires at least 16.5k to install and an auxiliary
library called the Universal Font Library (UFL) must be present.


2.1 Installing
--------------
a) send the library to the HP48
b) put a copy of the library on the stack
c) enter the port number to store the library (0-33 GX, 0-2 SX)
d) here is an example of the stack setup so far:

   --------------------------
   4:
   3:
   2:   Library 1014: CHE...
   1:                      0
   |   |   |   |   |   |   |
   
e) at this point, press [STO]
f) perform a warmstart with [ON][C] or turn on and off the HP48
g) erase the variable containing the library.  eg. 'CHEMLB20.LIB' PURGE
h) read the next section for the Universal Font Library (UFL)
   requirements


2.2 Universal Font Library (UFL)
--------------------------------
The ChemLab library requires the UFL to be present.  Read the UFL
documentation from the UFL package(included) for more information.
From the UFL package, ufl3.lib must be installed because FNT1 and
FNT2 are required.

If you have not installed the UFL library, install it now:

a) send the library(ufl3.lib) to the HP48
b) put a copy of the library on the stack
c) enter the port number to store the library (0-33 GX, 0-2 SX)
d) here is an example of the stack setup so far:

   --------------------------
   4:
   3:
   2:    Library 257: UFL...
   1:                      0
   |   |   |   |   |   |   |
   
e) at this point, press [STO]
f) perform a warmstart with [ON][C] or turn on and off the HP48
g) erase the variable containing the library.   
h) The ChemLab library is ready for use.


2.3 Bytes and Checksum 
----------------------
Placing the library on the stack and executing the BYTES command:

Bytes: 16245
Checksum: # B20Eh


2.4  Removing the Library
-------------------------
a) :0: 1014 DETACH
b) :0: 1014 PURGE

Depending on which port number the ChemLab library was stored, :0: in 
the above example can be replaced by the appropriate port number.



3. Usage
--------

3.1 Commands
------------
CHEMLAB - starts ChemLab
        - always displays the periodic table at the last preserved position
        
        
GETPROP - command to access the internal database
        - requires 2 arguments        
        
          2: "Ca"       <- symbol name
          1: 1          <- property number
          
          OR
          
          2: 20         <- atomic number
          1: 1          <- property number
          
          
          Property                      Property number
          ---------------------------------------------
          Atomic Number                 1
          Atomic Weight                 2
          Density                       3
          Oxidation States              4
          Electron Configuration        5
          Physical State                6
          Melting Point                 7
          Boiling Point                 8
          Heat of Fusion                9
          Heat of Vaporization          10
          Specific Heat                 11
          Group                         12
          Family                        13
          Crystal Structure             14
          Atomic Volume                 15
          Atomic Radius                 16
          Covalent Radius               17
          Thermal Conductivity          18
          Electric Conductivity         19
          1st Ion Potential             20
          Electronegativity             21
          Oxide                         22


MOW     - calculates the molecular weight of a chemical formula 
        - requires a string representing a chemical formula
        
          eg. "Ca2Fe(OH)5"


ERSECLP - erases chemlabPAR from the hidden directory.
        - see section  3.4 chemlabPAR
                 

3.2 Periodic Table Menu Functions
---------------------------------

PROP
----
o starts property viewer
o always displays from the last preserved position


ABOUT
-----
o about information


QUIT
----
o quit Chemlab program


3.2.1 Periodic Table Keys
-------------------------
        +-------+-------+-------+-------+-------+-------+
        |       |       |       |       |       |       |
        |       |       |       |       |       |       |
        |       |       |       |       |       |       |
        +-------+-------+-------+-------+-------+-------+
        |       |       |       |       |UP     |       |
        |       |       |       |       |       |       |
        |       |       |       |       |JMPUP  |       |
        +-------+-------+-------+-------+-------+-------+
        |       |       |       |LEFT   |DOWN   |RIGHT  |
        |       |       |       |       |       |       |
        |       |       |       |JMPLEFT|JMPDOWN|JMPRGHT|
        +-------+-------+-------+-------+-------+-------+
        |       |       |       |       |       |       |
        |       |       |       |       |       |       |
        |       |       |       |       |       |       |
        +-------+-------+-------+-------+-------+-------+
        |PROP           |       |       |       |       |
        |               |       |       |       |       |
        |               |       |       |       |       |
        +-------+---------+---------+---------+---------+
        |       |         |         |         |         |
        |       |         |         |         |         |
        |       |         |         |         |         |
        +-------+---------+---------+---------+---------+
        |       |         |         |         |         |
        |       |         |         |         |         |
        |       |         |         |         |         |
        +-------+---------+---------+---------+---------+
        |rshift |         |         |         |         |
        |       |         |         |         |         |
        |       |         |         |         |         |
        +-------+---------+---------+---------+---------+
        |QUIT   |         |         |         |         |
        |       |         |         |         |         |
        |       |         |         |         |         |
        +-------+---------+---------+---------+---------+


+-------+
|       |  <--- non-shifted/alpha
|       |  <--- left-shift
|       |  <--- right-shift
+-------+

     UP - move highlight cursor up      
   LEFT - move highlight cursor left
   DOWN - move highlight cursor down
  RIGHT - move highlight cursor right
  JMPUP - jump to the extreme top
JMPLEFT - jump to the extreme left
JMPDOWN - jump to the extreme bottom
JMPRGHT - jump to the extreme right
   PROP - property viewer
   QUIT - quit program


3.3 Property Viewer Menu Functions
----------------------------------

->STK
-----
o places the current highlighted property on the stack


EXIT
----
o exit property viewer and returns to the periodic table


3.3.1 Property Viewer Keys
--------------------------
        +-------+-------+-------+-------+-------+-------+
        |       |       |       |       |       |       |
        |       |       |       |       |       |       |
        |       |       |       |       |       |       |
        +-------+-------+-------+-------+-------+-------+
        |       |       |       |       |UP     |       |
        |       |       |       |       |       |       |
        |       |       |       |       |JMPUP  |       |
        +-------+-------+-------+-------+-------+-------+
        |       |       |       |       |DOWN   |       |
        |       |       |       |       |       |       |
        |       |       |       |       |JMPDOWN|       |
        +-------+-------+-------+-------+-------+-------+
        |       |       |       |       |       |       |
        |       |       |       |       |       |       |
        |       |       |       |       |       |       |
        +-------+-------+-------+-------+-------+-------+
        |               |       |       |       |       |
        |               |       |       |       |       |
        |               |       |       |       |       |
        +-------+---------+---------+---------+---------+
        |       |         |         |         |         |
        |       |         |         |         |         |
        |       |         |         |         |         |
        +-------+---------+---------+---------+---------+
        |       |         |         |         |         |
        |       |         |         |         |         |
        |       |         |         |         |         |
        +-------+---------+---------+---------+---------+
        |rshift |         |         |         |         |
        |       |         |         |         |         |
        |       |         |         |         |         |
        +-------+---------+---------+---------+---------+
        |QUIT   |         |         |         |         |
        |       |         |         |         |         |
        |       |         |         |         |         |
        +-------+---------+---------+---------+---------+


+-------+
|       |  <--- non-shifted/alpha
|       |  <--- left-shift
|       |  <--- right-shift
+-------+

     UP - move highlight cursor up      
   DOWN - move highlight cursor down
  JMPUP - jump to the extreme top
JMPDOWN - jump to the extreme bottom
   PROP - property viewer
   QUIT - quit program


3.4 chemlabPAR
--------------
The ChemLab library uses a variable called chemlabPAR to store certain 
parameters such as last preserved positions.  chemlabPAR is stored in the
hidden directory and can be removed by using the ERSECLP command.



4. Acknowledgments
------------------
HP for ptlib.
Mika Heiskanen for real data compression encoding technique.


5. History
----------
ChemLab v2.0
        - official element names for 104-109 
        - added molecular weight calculator
        - real data compression encoding,  ~9k saved
ChemLab v1.0
        - first release



6. Resources and References
---------------------------
HPTools - PC based System RPL and Assembly Language compiler
          ftp://hpcvbbs.external.hp.com/dist/

Jazz - HP48 based System RPL and Assembly Language development Package
       http://www.hut.fi/~mheiskan/
        
UFL - Universal Font Library       
      http://www.engr.uvic.ca/~aschoorl/ufl/
      
Arnold Moy - email: amoy@geog.ubc.ca
             WWW: http://www.geog.ubc.ca/~amoy/
[ RETURN TO DIRECTORY ]