Welcome to MarChemSpec (MATLAB function)
---------------------------------------

This is how to get started:


1. When you have extracted the files from this archive the directory (folder) above 
   this one will contains the MCS program library file, with extension .dll (Windows)
   or .so (Linux), and the files Pitzer.par and Pitzer.rcn. It also contains the 
   appropriate MATLAB MEX file for Windows (with extension mexw64) or for Linux
   (with extension mexa64).

2. Read the List_of_files_{version} document, which is in the same directory as this file, 
   so that you understand what the different files are.

3. Open the manual (MCS_MATLAB_manual_{version}), which is in the same directory as this 
   file, and read the section "Installing MARCHEMSPEC for MATLAB", to make sure you have  
   done everything correctly.

4. Read the section "Using the MarChemSpec Function" in the manual to start doing 
   calculations. The results are returned in MATLAB arrays (they are *not* written
   to files. 

5. Instructions on how to use the new features introduced at version 1.1 (equilibrating
   to fixed values of the seawater state parameters) can be found in the 
   MCS_MATLAB_Supplement_{version} document.


IMPORTANT: 

Have you previously downloaded an earlier version of MarChemSpec?

If the answer is "yes", and you added the folder containing the earlier version(s) to 
the MATLAB path, then it is essential that either the old folder is removed from the MATLAB 
path or that you overwrite the old MarChemSpec dll file or shared object library with
the new copy in this distribution. Otherwise you may find that you are running an older 
version of the model despite the new download.

Simon Clegg
(s.clegg@uea.ac.uk)


