================================================================================
Title: Testing a Predictive Theoretical Model for the Mass Loss Rates 
       of Cool Stars  
Authors: Cranmer S. R., Saar S. H.
================================================================================

Code names: 

boreas.pro:  IDL procedure (which needs to be called with 11 arguments)
that computes the mass loss rate of a cool, late-type star using the
models of Cranmer & Saar (2011).

figure_10a.pro:  Example IDL routine that calls boreas.pro for a
database of 47 observed stars and compares the observed versus
theoretical mass loss rates.  It generates a plot similar to that
in Figure 10a of Cranmer & Saar (2011).

figure_13.pro:  Example IDL routine that calls boreas.pro for a
theoretical grid of zero-age main sequence (ZAMS) stars with varying
effective temperatures and rotation periods.  It plots their predicted
mass loss rates in a plot similar to that in Figure 13 of Cranmer &
Saar (2011).

figure_14b.pro:  Example IDL routine that calls boreas.pro for a
theoretical evolutionary track of a one solar mass star.  It plots the
predicted mass loss rates in a plot similar to that in Figure 14b of
Cranmer & Saar (2011).

Language: Interactive Data Language (IDL)

Code tested under the following compilers/operating systems: Sun Ultra 20,
Linux CentOS release 5.6, running IDL version 7.0 (linux x86_64 m64).

Description of input data: Three example input files are provided:

mdot_obs_table2.dat:  Tabular data file read by figure_10a.pro

zams_girardi_grid.dat:  Tabular data file read by figure_13.pro

evol_track_1Msun.dat:  Tabular data file read by figure_14b.pro

Description of output data: boreas.pro passes back values for mass loss
rates, flux tube filling factor, Rossby number, and Alfvenic Mach number
to the routine that called it (see the calling sequence in comments at
the beginning of the procedure).  The other IDL procedures (figure_10a.pro,
figure_13.pro, figure_14b.pro) create plots on the current default output
device and do not return or print any data.

System requirements:  Any system that runs a reasonably recent version
of IDL.  No special IDL add-ons or packages are needed.

Calls to external routines:  boreas.pro should be completely self-contained.
The other procedures (figure_10a.pro, figure_13.pro, figure_14b.pro) require
boreas.pro to be present.

Additional comments: All files are in simple ASCII format.

================================================================================
The AAS gives permission to anyone who wishes to use these subroutines
to run their own calculations.  Permission to republish or reuse these
routines should be directed to the Executive Officer of the AAS.

Note that the AAS does not take responsibility for the content of the 
source code.  Potential users should be wary of applying the code
to conditions that the code was not written to model and the accuracy of
the code may be affected when compiled and executed on different systems.
================================================================================