%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% RCS INFORMATION:
%
%       $RCSfile: README++,v $
%       $Author: jyelon $        $Locker:  $                $State: Exp $
%       $Revision: 1.1 $      $Date: 1995/10/20 01:12:19 $
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% DESCRIPTION:
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% REVISION HISTORY:
%
% $Log: README++,v $
% Revision 1.1  1995/10/20 01:12:19  jyelon
% Initial revision
%
# Revision 2.0  1995/06/01  20:21:07  brunner
# Reorganized directory structure
#
% Revision 1.1  1994/10/14  21:04:41  brunner
% Initial revision
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%



This directory contains some small programs whose aim is to
illustrate various features of Charm++. 

Programs, and what they do:
---------------------------

hello:		Simple "hello world" program which prints a message 
		from each processor. Uses a branched chare.

primes:		Computes the number of primes between 1 and a large number,
		using dynamically load balanced chares and an accumulator.
		Uses a parallel Eratosthenes' sieve algorithm.
		Uses read-only variables.
		Suggested input : 500000

fib:		Uses dynamically load balanced chares to compute the 
	 	N'th fibonacci number.	
		Uses distributed tables to avoid duplication of work.
		Also has artificial examples of use of VARSIZE arrays, 
		pack and unpack functions, and function references.
		The program is in two source files (modules) and
		illustrates use of the "module.list" file.
		Suggested input : N=20, GrainSize=5 .

tsp:		Traveling Salesman Problem. The input files are in the
		directory. asi7, asi20 are 7 city and 20 city problems,
		respectively. Uses dynamically load balanced chares, 
		accumulators and monotonic variables.
		Uses integer-prioritized messages and prioritized queueing.
		Suggested input : redirect stdin to asi7

jacobi:		Jacobi method for solving a 5 point stencil problem.
		Illustrates simple inheritance and virtual entry points.
		Uses branched chares.
