
                           PerioTable 1.3
                         ===================
                      -+-+-+-+-+-+-+-+-+-+-+-+
                      A graphical interface,
                    small size (less than 7 kb)
                         Periodic Table.
                   (Written entirely in SysRPL)


CONTENTS
========

1. Copyright and Disclaimer
2. How to install and uninstall it.
3. Overview
4. Commands
5. Use of the table
6. Properties
7. Algorithms and programming tips

----------


1. Copyright
================

Copyright (c) Camilo E. Contreras A. 1997 - 1999, all rights reserved.

This version of PerioTable is released primarily as an aid for those
that need a high-accuracy Periodic Table and don't have too much room.

Permission to copy the whole Library is granted provided that the copies
are not made or distributed for resale (excepting nominal copying fees)
and the whole documentation is included.

Anyway, I hope this library will be better than other at the same size,
but although I have done lots and lots of debugging sessions,
I give NO GUARANTEE of any kind over the above mentioned program,
and to make sure it inflicts you no damage, backup your memory before
installing it (nobody is perfect) , and so, if you discover any bug,
feel free to e-mail me and I will try to get it fixed.


My address:
        Camilo E. Contreras A.
        Via principal "La Pedregosa"
        Quinta El Muro, 400 Mts. arriba
        del Hotel "La pedregosa"
        Merida, Estado Merida
        VENEZUELA

        Tel. +58 74 663165

        E-mail: camiloco@geocities.com
                (aka) aeddy@ing.ula.ve


2. Installation and/or Uninstallation
=====================================

PerioTable have been tested on ROM revision M and R HP48G's ;
and because only supported entries are used, it should also
run on later ROM versions and also on 48S's

This Periodic Table is about 6.8 kb,  and can be stored on any
port.


To install PerioTabla 1.3
    1) download the provided TABLE.LIB to your HP48 in binary
       transfer mode
    2) recall TABLE.LIB to the stack and purge the variable
    3) enter the port number where you want it to be stored (0, 1 or 2)
       and press STO
    4) power cycle your HP48 or do a warmstart by pressing [ON]-[C]

Keystrokewise:
{download...} [TABLE.LIB] DUP RCL SWAP PURGE "Port Number" STO [OFF] [ON]

The Library is autoattachable to the HOME directory.

To Uninstall it:
---------------
Type on your HP48:
        :0:1578 DUP DETACH PURGE
But if you get an "Object in use" error message, warmstart
 your HP ([ON]-[C]) and repeat the steps above mentioned



3. Overview
===========
Features:
   * "Lightweight": less than 7 Kb
   *  Accuracy: 6-digit precision for the atomic weight.
   *  Graphical Interface
   *  Properties: Atomic weight, At. Number, Density, possible
                Oxidation states, Electronegativity, Symbol and Name.
   *  Built-in molecular weight calculator.


The first Time you will see this table, you will probably
ask where are the Lanthanoids and Actinoids, but they are in the table,
that look like this:


        #                              #
        ##                        ######
        ##                        ######
        ##              ################
        ##              ################
        ################################
        #######################
        s      f            d       p -----> Outer electronic
                                             shell type.
Instead of:

        #                 #
        ##           ######
        ##           ######
        ## ################
        ## ################
        ## ################
        ## #########
          |\
          ############### ---> Actinoids and Lanthanoids
          ###############

Then, What have I done?  to make the programming algorithms
simpler, and put the table in only one piece, I put the f-orbital
element families (aka Lanthanoids and actinoids) in the place they
belong, starting at the place where Lanthanum and Actinum are located.

That way, elements ARE really sorted according to their atomic
numbers, without any jumps. (look a conventional table at the lanthanum)

I was inspired to do it like that, because of an Old periodic
table I saw about ten years ago, that didn't splitted the table
in two pieces.


4. Commands
============

It is easy: There are only three commands on this library:

TABLE: Runs the Periodic Table program (see #5)
and
ABOUT: You guessed it! It is the about screen (I was thinking on
       not showing it every time the table is open. If you think
       the same way, email me and i will change it. I only need an
       external opinion)
MOLW: Takes a string or an identifier ('%&$') from the stack
and returns its molecular weight.
Rules:
        * Use the following Model: (Aa#B#De#...SymbolNUMBER)
          # can be any integer (1,2,3...100...)
        * Use No Parenthesis on the formula, why? cause I didn't
         figured out a short and easy algorithm to process the
         parenthesis, Sorry this time, maybe in future releases,
         (Any help will be Appreciated)



5. Use Of the Table
====================

Main Screen:
        +---------------------------------+
        |#                               #|
        |##       Sulphur           ######|
        |##                         ### ##|
        |##              #################|
        |##              #################|
        |#################################|
        |#######################          |
        |                         +------+|
        | Electronegativity: 2.5  |   S  ||
        | Oxid. STATES: +2-2+4+6  | 16   ||
        | DENSITY: 2.07           |32.064||
        |-------------------------+======+|
        |SIMBO|NAME |MOLW|ATW->|DEN->|QUIT|
        +-----+-----+----+-----+-----+----+
 Where:
        Electronegativity: Shows the Pauling's Value of E.Neg.
        Oxid. States: Shows the possible oxidation st. of the element
        Density: ...it needs explanation?
        [SIMBO]: Pops up a choose box with the elements sorted alphabetically
        [NAME ]: The same thing, but this time with the names
        [MOLW ]: Opens a Input Line Environment to calculate a Molec. Weight
        [ATW->]: Sends the current element's Atomic weight to the stack
        [DEN->]: The same thing, but this time with the density
        [QUIT ]: I think this is obvious too.. didn't it?
                  (You can exit too with the [ON] key. )

You can browse through the table with the arrow keys, and if you try to
go before the first or after the last column, it cycles and jumps to the
other side.

Also, you can jump to any border pressing [Right-Shift] and the arrow
pointing at the border you want to jump.

Every time you run the table will appear the about screen. I you don't
like that to be so, tell me and I will move it to its own ABOUT command
in the library. (My beta tester and I couldn't agree about this topic)

6. Periodic Properties:
=======================

The Atomic Weight is shown with a 6-digit precision,
The Density with 4 digits, and The electronegativity with two.

All properties have been extracted from Perry's Chemical
Engineer Handbook (Ox. States) and a Periodic table that a
guy from Czeck Republic gave me at the 27th Chemistry Olympiad
(every other property).

7. Tips on programming:
=======================

To save room while storing the molecular weights at a precision
of 6 digits on a 12 digit real number, I made the datafile
consisting of pairs of weights like this:

suppose these are the gold's and the Mercury's atomic weights:

Hg: 200.590 and Au:196.967,

then I made a single real this way:    200590.196967,

And just like that I saved 10.5 bytes! , the multiply this by 108/2
and it is a saving of 567 bytes! Good, isn't it?

In this table, I made the same thing with the density
and electronegativity.

And with the Symbols, I made only a Single string like this:

$ "H HeLiBeB C N O F NeNaMgAl....." (sorted by At#) where the simbol begins
ant position AT#*2 and ends al Pos. (AT#*2)+1 .. Another Kb saved.

There are many other tips, but now it is about 1:00 am and I'm almost
asleep, and if you want to know more about this, feel free to
email me at any of the addresses indicated below.

You want the source code with comments? tell me and I will
email it to you!.

*******    Hope you like it!!!!!    ****************

Camilo Contreras.

9 April 1997 version 1.0
12 March 1998. version 1.3





















