Department of Organismal Animal Physiology

CHELATOR Users Manual

version 1.00
20/02/1992

Theo J.M. Schoenmakers




General


PLEASE READ THE README FILE (CHELREAD.ME) ON THE DISKETTE!


CHELATOR is intended to be freeware (public domain). You may freely copy and distribute it, but I urge you to include all the files (or, as a failsafe alternative, copy only PACKCHEL.EXE and run it).

Although I've done my best to include only well-established stability constants and double-checked all constants in the default datafile, I cannot guarantee that what this program calculates is the absolute truth under all imaginable conditions. A fact is that the default datafile primarily contains constants measured near 37 degrees C. In such a way I do not have to extrapolate constants determined at 25 degrees C too much for my own experiments. If you mainly perform experiments at 20 degrees C or so, you are probably better off changing the stability constants in your personal datafile (more on this later).

At run-time, you need CHELATOR.EXE and your datafile .DAT (default: CHELDFLT.DAT) in the current directory.

An introductory explanation about the program may be obtained by typing a question mark after the program name (separated by a space) at the DOS prompt. In order to obtain the requested information, the CHELATOR.TXT file must be present in the current directory.

The terms 'metal' and 'chelator' should be self-explanatory to the users of this program. The term '(pH )buffer' might need some elaboration: if a compound acts as a pH buffer, BUT BINDS METAL IONS AS WELL, it should be entered as a 'chelator'. The H+ binding action of such compounds will be accounted for when stability constants for binding of H+ have been entered (which, by the way, is obligatory!). Only when a compound has no known affinity for the metal ions in the system should it be entered as 'pH buffer'.

NOTE: CHELATOR was implemented in Borland Turbo Pascal 5.5.


Introduction

CHELATOR is a menu-driven calculation program written in Turbo Pascal 5.5þ for use on IBM-PC compatible computers.
CHELATOR is a greatly enhanced version of a previous program for calculating free metal cation concentrations based on the method used by van Heeswijk, Geertsen and van Os, J. Membrane Biol. 79, 19-31 (1984). Some errors in this routine have now been corrected. Also, ten other possilbe equilibria can be considered per metal-chelator pair. We reported on this program in Biotechniques.
The program automatically recalculates metal-chelator stability constants for effects of ionic strength, temperature, and pH. All ion activities are converted to their respective concentrations using the activity coefficient derived for the ionic strength. Where possible, temperature effects are calculated by Van 't Hoff's Isochore. A detailed description of the methods used can be found in Biotechniques.


Menu's

CHELATOR uses a menu-based structure much like that of popular programs such as PC SHELLþ6 or Borland Turbo Pascalþ5.5. The menus may be operated by cursor keys or a Microsoftþ compatible mouse. When you use a mouse, please remember that the left button is confirmative (ENTER), while the right button cancels (ESC). You may drag the menus (i.e. moving through the menus with the left mouse button pressed), but double-clicking is not supported (and not necessary). Note that dragging is not supported in any of the dialog boxes! Dialog boxes only support cursor keys, or simple mouse clicks.
When you use CHELATOR, you generally should proceed through the main menu from left to right.


File

The option 'Load' in the 'File' menu will give you a listing of .DAT files in the CURRENT directory from which you may pick one file. The datafile will be read. This file contains information on metals, chelators, stability constants, pH buffers, media composition and special program options. Once you are familiar with the program you can save your personal named datafile with the 'Save' option in the 'File' menu. It is not allowed to overwrite the default datafile. The 'Edit' option further expands this flexibility.


Edit

The 'Edit' option of the main menu should NOT be used until you are thoroughly familiar with CHELATOR. You normally skip this menu item. It serves to configure datafiles. You may add, delete or change metals, chelators, pH buffers, or specify stability constants regarding a specific combination of metals and chelators. In this way, you may formulate a datafile containing only those data you are concerned with. Please be familiar with the theoretic background of stability constants before changing any constants!
The maximum number of entries for chelators, metals and pH-buffers is 15. You may freely delete entries you will never use from your personal datafile. However, CHELATOR will not permit you to delete H+. Also, you MUST enter K1 and K2 for binding of H+ when you add a new chelator to the list.
When you add a chelator, you are asked for its name (maximally 5 characters long), the stability constant for self-association (C + C <-> C2), and its valence (usually negative). Then, the program proceeds through the list of available metals to allow you to enter stability constants for several equilibria. You must add the first two constants K1 and K2 for H+. If you do not do this, 'Prepare calculations' will abort with an error. You proceed to the next metal by pressing F9 (Accept) or clicking the left mouse button when the mouse cursor is on the Accept-field.
Metals are added in a similar way. You are asked to enter a name (maximally 4 characters; I suggest you use 'Xx?+', where 'Xx' is the commonly used mnemonic for this metal and '?' is its valence). Next, CHELATOR asks for the valence of the metal. After this, the program proceeds through the list of chelators in order to let you provide stability constants.
When adding a pH-buffer to the datafile, one must enter its name (up to 15 characters), its kind (see below), its pKa at 25 degrees C, and its delta pKa at 25 degrees C. We describe the kind by two terms: Cationic is used when the pH-buffer is positively charged at pH<pKa, and anionic when the pH-buffer is not charged at pH<pKa.
Please remember that changes made in the datafile are only made in the computer's memory. They are not saved automatically! You must use 'Save' in the 'File' menu to save the modified datafile to disk.


Media

The 'Media' option of the main menu is used to inform the program about the composition of your assay media and the experimental conditions. Here you may enter which chelators, metals and pH buffers you choose to use in your experiment. The program will ask for the total concentrations of the chelators and pH buffers. Furthermore, you are asked to enter pH, temperature and final ionic strength of your media.
The latter option requires some explanation: the figure is entered in ionic equivalents.

Total ionic strength = summation(c*|z|)/2;

where c = concentration and z = valence of anion or cation. So CHELATOR wants you to add up concentration times valence, not concentration times valence2, as in 'classical' ionic strength. The figure you enter in 'ionic strength' represents the total ionic strength of the media. The program then computes the contribution to ionic strength of pH buffers, free chelators, free metals and all complexes. In calculating the contribution to ionic strength of the added metal salts involved in the calculation, the program assumes that these salts have MONOVALENT counter-anions!!
The program calculates the degree of ionization of pH buffers by (re)calculating their pKa's as a function of temperature (according to Good et al. Biochemistry 5: 467-477 (1966), correction for ionic strength in the physiological range is semi-absent), and thereby the buffers' contribution to the final ionic strength.
When calculating free metal cation concentrations, the program will subtract contributions of complexes, free metal cations, ionized pH buffers, etc. from the figure of 'total ionic strength' and will end up with a 'medium ionic strength', representing the actual ionic strength of the monovalent ions in your assay medium. E.g. for a typical assay medium with 150 mM NaCl, some 1 mM of chelating substances, about 1 mM total CaCl2 and 1 mM total MgCl2, plus some 25 mM pH buffers, your final ionic strength would be around 160 ionic equivalents. So, you should enter this figure in the final ionic strength box, and modify it when the metal calculations yield medium ionic strengths differing from 150. Usually, you only need one iteration to come to a value that is valid for all media you want to test. An iterative procedure would solve this of course, but calculation times would increase.


Calculate

The 'Calculate' option of the main menu contains the actual computing of the program. After you have selected a media composition, the program first needs to calculate a number of coefficient arrays and the effects of the experimental conditions on the stability constants. Therefore, you have to choose 'Prepare calculations'.
Once the preliminary calculations have been performed, the program offers the possibilities to calculate total metal cation concentrations from wanted free concentrations, and the other way around. The latter procedure is iterative and you may enter a precision in the 'Special' option of the main menu. Please note that CHELATOR also gives a medium ionic strength, which has to be equal to the ionic strength of the monovalent cations in your solutions (see above).


Special

The 'Special' option of the main menu offers four items. Two of these ("Complex conc.'s shown" and "Beeping") are toggles (ON/OFF). 'Printer' can also be toggled ON and you will have to specify whether you are using an Epson-type printer or a HP-type. If you activate this option and then prepare calculations, a listing of stability constants and medium conditions will be printed. Otherwise, only calculation results will be printed. Note: the program tries to perform a page feed if you toggle the printer option OFF. If the printer is not connected to the computer at that moment, this may lead to a 'semi-hangup' of the computer lasting several seconds (depending on the type and speed of the computer)! "Complex conc.'s shown" (if ON) results in the display of concentrations of the metal-chelator complexes. 'Iteration tolerance' allows you to specify a tolerance for the calculation of free from total metal cation concentrations. 'Beeping' may be toggled OFF if you are not amused by a musical PC.


The default datafile, CHELDFLT.DAT

Some peculiarities might need further explanation.
- Beware of metals with many water molecules in their hydration shell (e.g. Al3+ or Cu2+). CHELATOR offers some ways to account for the equilibria involved, but these might be inadequate. Look up as many stability constants as you can and try to reduce some equilibria to those included in CHELATOR.
- Citrate is listed as having a charge of -3. This represents citrate with one bound proton. All constants listed refer to binding of ions to the H+-citrate form. The reason is that citrate binds its first proton with a K around 16. This first proton will always be bound under normal physiological conditions. Care should be observed when multivalent metal ions are to be used: such ions (e.g. Cu2+) might be able to remove this bound proton, in which case you have to deal with completely different binding characteristics.
- Amino acids (e.g. aspartate or glutamate) are included in the default file, but should not be used at high concentrations. Free metal ion concentrations should be controlled by more specific chelators. Apart from their non-selectiveness these compounds suffer from a tendency to form a double complex (MC + C <-> MC2) when their concentration is high. Since CHELATOR does not account for such reactions yet, calculations regarding the above conditions may yield incorrect results.
- Some stability constants of the reaction M + HC <-> MHC (Kd) are listed as "calculated" in the stability constant table. These had to be computed from the tabulated stability constants for C + H <-> HC (Ka), for C + M <-> MC (Kb) and for MC + H <-> MHC (Kc) by the formula Kd = Kb + Kc - Ka. Note that (as everywhere else in the program) logarithms of the actual stability constants are used; this is why the constants are added, not multiplied.


Last remarks

This should cover most of the operation of CHELATOR. If you have questions or suggestions, do not hesitate to contact me. An update with suggested changes will become available to registered users (please remember: no fees are involved in registering!) in about one year. Apart from the suggested improvements it will certainly implement much improved windowing (it will be implemented in Turbo Pascalþ 6.0 using Turbo Vision).


DISCLAIMER

I seem to have to write the following lines in order to avoid any unwanted consequences of distributing my little creation.
I will not be liable for any damages, including lost profits, lost savings, lost time, lost data, wrong experiments, or other incidental or consequential damages arising out of the use of or inability to use CHELATOR, even if I have been advised of the possibility of such damages, of for any claim by any other party.


Th. Schoenmakers