Import new thorn InitBase.

Thorn InitBase specifis how initial data are to be set up.  It does
not set up any initial data by itself, not does it contain any
routines which are to be called.  It is merely a convenient repository
remembering how initial data are to be set up, so that other thorns
can check their actions against this thorn.


git-svn-id: http://svn.cactuscode.org/arrangements/CactusBase/InitBase/trunk@2 7add7b9e-bd1d-4575-9a9f-c44cbffd177e

6 files changed, 199 insertions, 0 deletions

diff --git a/README b/README
new file mode 100644
index 0000000..669b9c0
--- /dev/null
+++ b/README
@@ -0,0 +1,31 @@
+Cactus Code Thorn InitBase
+Thorn Author(s)     : Erik Schnetter <schnetter@cct.lsu.edu>
+Thorn Maintainer(s) : Erik Schnetter <schnetter@cct.lsu.edu>
+--------------------------------------------------------------------------
+
+Purpose of the thorn:
+
+Thorn InitBase specifis how initial data are to be set up.  It does
+not set up any initial data by itself, not does it contain any
+routines which are to be called.  It is merely a convenient repository
+remembering how initial data are to be set up, so that other thorns
+can check their actions against this thorn.
+
+There are several possibilities:
+
+1. The initial data thorn sets up data on one time level, while other
+   time levels are scratch space.  The time evolution method must
+   start up from a single time level.  (This is the default.)
+
+2. The initial data thorn sets up data on exactly one time level, and
+   is called once for each active time level.  (This means that the
+   initial data thorn can only access the current time level.)
+
+3. The initial data thorn sets up data on exactly two time levels, and
+   is called once for each active time level.  (This means that the
+   initial data thorn can only access the current and the first past
+   time level.)
+
+4. The initial data thorn sets up data on all active time levels.
+   (This makes it necessary that the initial data thorn checks the
+   number of active time levels.)
diff --git a/doc/documentation.tex b/doc/documentation.tex
new file mode 100644
index 0000000..92bcb32
--- /dev/null
+++ b/doc/documentation.tex
@@ -0,0 +1,146 @@
+% *======================================================================*
+%  Cactus Thorn template for ThornGuide documentation
+%  Author: Ian Kelley
+%  Date: Sun Jun 02, 2002
+%  $Header$
+%
+%  Thorn documentation in the latex file doc/documentation.tex
+%  will be included in ThornGuides built with the Cactus make system.
+%  The scripts employed by the make system automatically include
+%  pages about variables, parameters and scheduling parsed from the
+%  relevant thorn CCL files.
+%
+%  This template contains guidelines which help to assure that your
+%  documentation will be correctly added to ThornGuides. More
+%  information is available in the Cactus UsersGuide.
+%
+%  Guidelines:
+%   - Do not change anything before the line
+%       % START CACTUS THORNGUIDE",
+%     except for filling in the title, author, date, etc. fields.
+%        - Each of these fields should only be on ONE line.
+%        - Author names should be separated with a \\ or a comma.
+%   - You can define your own macros, but they must appear after
+%     the START CACTUS THORNGUIDE line, and must not redefine standard
+%     latex commands.
+%   - To avoid name clashes with other thorns, 'labels', 'citations',
+%     'references', and 'image' names should conform to the following
+%     convention:
+%       ARRANGEMENT_THORN_LABEL
+%     For example, an image wave.eps in the arrangement CactusWave and
+%     thorn WaveToyC should be renamed to CactusWave_WaveToyC_wave.eps
+%   - Graphics should only be included using the graphicx package.
+%     More specifically, with the "\includegraphics" command.  Do
+%     not specify any graphic file extensions in your .tex file. This
+%     will allow us to create a PDF version of the ThornGuide
+%     via pdflatex.
+%   - References should be included with the latex "\bibitem" command.
+%   - Use \begin{abstract}...\end{abstract} instead of \abstract{...}
+%   - Do not use \appendix, instead include any appendices you need as
+%     standard sections.
+%   - For the benefit of our Perl scripts, and for future extensions,
+%     please use simple latex.
+%
+% *======================================================================*
+%
+% Example of including a graphic image:
+%    \begin{figure}[ht]
+% 	\begin{center}
+%    	   \includegraphics[width=6cm]{MyArrangement_MyThorn_MyFigure}
+% 	\end{center}
+% 	\caption{Illustration of this and that}
+% 	\label{MyArrangement_MyThorn_MyLabel}
+%    \end{figure}
+%
+% Example of using a label:
+%   \label{MyArrangement_MyThorn_MyLabel}
+%
+% Example of a citation:
+%    \cite{MyArrangement_MyThorn_Author99}
+%
+% Example of including a reference
+%   \bibitem{MyArrangement_MyThorn_Author99}
+%   {J. Author, {\em The Title of the Book, Journal, or periodical}, 1 (1999),
+%   1--16. {\tt http://www.nowhere.com/}}
+%
+% *======================================================================*
+
+% If you are using CVS use this line to give version information
+% $Header$
+
+\documentclass{article}
+
+% Use the Cactus ThornGuide style file
+% (Automatically used from Cactus distribution, if you have a
+%  thorn without the Cactus Flesh download this from the Cactus
+%  homepage at www.cactuscode.org)
+\usepackage{../../../../doc/latex/cactus}
+
+\begin{document}
+
+% The author of the documentation
+\author{Erik Schnetter \textless schnetter@cct.lsu.edu\textgreater}
+
+% The title of the document (not necessarily the name of the Thorn)
+\title{InitBase}
+
+% the date your document was last changed, if your document is in CVS,
+% please use:
+%    \date{$ $Date$ $}
+\date{July 06 2007}
+
+\maketitle
+
+% Do not delete next line
+% START CACTUS THORNGUIDE
+
+% Add all definitions used in this documentation here
+%   \def\mydef etc
+
+% Add an abstract for this thorn's documentation
+\begin{abstract}
+  Thorn \texttt{InitBase} specifis how initial data are to be set up.
+  It does not set up any initial data by itself, not does it contain
+  any routines which are to be called.  It is merely a convenient
+  repository remembering how initial data are to be set up, so that
+  other thorns can check their actions against this thorn.
+  
+  There are several possibilities:
+  \begin{enumerate}
+  \item The initial data thorn sets up data on one time level, while
+    other time levels are scratch space.  The time evolution method
+    must start up from a single time level.  (This is the default.)
+  \item The initial data thorn sets up data on exactly one time level,
+    and is called once for each active time level.  (This means that
+    the initial data thorn can only access the current time level.)
+  \item The initial data thorn sets up data on exactly two time
+    levels, and is called once for each active time level.  (This
+    means that the initial data thorn can only access the current and
+    the first past time level.)
+  \item The initial data thorn sets up data on all active time levels.
+    (This makes it necessary that the initial data thorn checks the
+    number of active time levels.)
+  \end{enumerate}
+  
+  This thorn does not set up any initial data by itself.  It only
+  selects the mechanism; it is the responsibility of other thorns to
+  follow this specification.  If all other thorns follow this
+  specification, then they are guaranteed to interact nicely.  If
+  other thorns ignore this specification, then end-users may be
+  surprised and may have difficulties setting up parameter files which
+  work correctly.
+\end{abstract}
+
+% The following sections are suggestive only.
+% Remove them or add your own.
+
+
+
+%\begin{thebibliography}{9}
+%
+%\end{thebibliography}
+
+% Do not delete next line
+% END CACTUS THORNGUIDE
+
+\end{document}
diff --git a/interface.ccl b/interface.ccl
new file mode 100644
index 0000000..84b5c88
--- /dev/null
+++ b/interface.ccl
@@ -0,0 +1,3 @@
+# Interface definition for thorn InitBase
+
+IMPLEMENTS: InitBase
diff --git a/param.ccl b/param.ccl
new file mode 100644
index 0000000..a9604ef
--- /dev/null
+++ b/param.ccl
@@ -0,0 +1,11 @@
+# Parameter definitions for thorn InitBase
+
+RESTRICTED:
+
+KEYWORD initial_data_setup_method "Procedure for setting up initial data"
+{
+  "init_some_levels"  :: "Set up at least one time level; other time levels are scratch space"
+  "init_single_level" :: "Set up exactly one time level; other time levels are not acessed"
+  "init_two_levels"   :: "Set up exactly two time levels; other time levels are not acessed"
+  "init_all_levels"   :: "Set up all active time levels"
+} "init_some_levels"
diff --git a/schedule.ccl b/schedule.ccl
new file mode 100644
index 0000000..7c0725f
--- /dev/null
+++ b/schedule.ccl
@@ -0,0 +1 @@
+# Schedule definitions for thorn InitBase
diff --git a/src/make.code.defn b/src/make.code.defn
new file mode 100644
index 0000000..4fc6b3b
--- /dev/null
+++ b/src/make.code.defn
@@ -0,0 +1,7 @@
+# Main make.code.defn file for thorn InitBase
+
+# Source files in this directory
+SRCS = 
+
+# Subdirectories containing source files
+SUBDIRS =