*****************************************************************
Titrate! v1.2
Author: Anthony Loven
Date: 2-16-05
Email: greenorange5656@gmail.com
*****************************************************************
     This program can be modified at will.  However, my name
(Anthony Loven) must be referenced in documentation, and I must
be listed as a co-author.  This file should not be removed from
the original program.
---------------

Introduction:

    This program will give you the pH and pOH of a acid-base solution while
being titrated.  The user enters information about the solutions, and then
is free to enter any volume of solution being used to titrate a substance,
and the pH and pOH will be shown.  Also, the user can do multiple values
for the same solution.  This program has compatibility for the following:

Strong Acid / Strong Base titrations
Strong Base / Strong Acid titrations
Weak Acid / Strong Base titrations
Weak Base / Strong Acid titrations

Also, Titrate! can graph all your values, with pH on the y-axis and volume
of solution added on the x-axis.  All this in only 2220 bytes.

---------------

Contents and installation:

     The contents of this ZIP are:

titrate.86p - The main program for the calculator.
titrate*.gif - screenshots
titrate.txt - This file :)

To install, simply send titrate.86p to your calculator using some type of
linking software.  The file was extracted from my calc using TiLP, which
is recommended.

---------------

Usage:

     This program was designed to operate perfectly on a shell.  Basically,
you can use IShell, Rascall, ASE, Seklorean Warrior, or any other shell
with it, and still see the results, and return safely to the shell.  It
even has a shell description :)  If you do not use the shell, you can edit
the program, and remove the first line, which is useless.  It will not
change the program one way or another, but it will save space.

When you run this program, the title screen will appear.  Hit enter to continue.
Now, you will be asked whether you want your calculations graphed after.  Type
1 for yes, or 0 for no.  If you type a different number, it will assume no.
Now, you are given 4 choices.  The first one actually works both for Strong Acid /
Strong Base, and Strong Base / Strong Acid.  Let's do an example using it.

Strong Acid - Strong Base titration:

     Titration of 50.0 ml of 0.200 M HNO3  with 0.100M NaOH.

To set up this solution, hit F1 at the function menu.  You will be asked
the M of the acid.  Type 0.2, because its for HNO3.  Now the base, you enter
0.1, for NaOH.  Now, since you are titrating the acid, this means you
are adding base.  So type 2 on the next prompt.  The volume is 50.0ml,
so enter 50.

A:  No NaOH added

Enter 0 for V added.  The pH should be 0.69897 and the pOH 13.30103.  To
do another volume, enter 1.

B:  10.0ml of 0.100 M NaOH added

Since you already specified what M is, forget it.  Type 10 for the volume.
pH:  0.82391
pOH:  13.17609

Enter 1 if you want to go again.

C:  20.0ml (total) of 0.100 M NaOH added

Type 20 for the volume.

pH:  0.94201
pOH:  13.05799

Enter 1.

D:  50.0ml (total) of 0.100 M NaOH added

pH:  1.30103
pOH:  12.69897

E:  100.0ml (total) of 0.100 M NaOH added

pH:  7
pOH:  7

This is the equivalence point, so the pH would be neutral.

F:  150.0ml (total) of 0.100 M NaOH added

pH:  12.39794
pOH:  1.60206

G:  200.0ml (total) of 0.100 M NaOH added

pH:  12.60206
pOH:  1.39794

Now, hit 0 to stop.  You could hit 1 to enter some more, but it doesnt matter.
Bear in mind that you can enter smaller volumes after larger ones.  Order does
not matter.

You should see a plot if you turned graphing on.  Hit enter to exit.  If you
did not see a plot, it will exit automatically.

The values you entered are saved in xStat and yStat lists, so you can have them
on data after :)

This procedure is similiar for weak acids and bases.  You just need to supply an
additional Ka or Kb value.

---------------

Disclaimer:

     This program is designed for use for your own purposes.  I will not
be responsible if this program gives you wrong data, and causes you to fail
chemistry class, or blow up your face in an experiment.  This program is
not recommended for professional use.  It merely gives estimates, and will
not work on ALL solutions.  Having said that, I hope you find this program
useful.

---------------

History:

2-16-05  Version 1.2

 - Fixed bug:  It just didn't work :)
 - Fixed bug:  invalid format...
 - Fixed readme for NotePad users.  USE EMACS!!!

1-30-05  Version 1.1

 - Fixed bug:  Plot kept old values
 - Cut code size: 2146 bytes from 2220

1-29-05  Version 1.0

 - First public release.
 - 2.2 Kb

---------------

Credits:

Anthony Loven - design and programming

---------------

This file should always accompany the program it came with.  This program can
be distributed freely, but this file should always be with it.
