%:wrap=soft:maxLineLen=78:

 \section{List of terms used in the \isac-project}\label{terms}

 %============================================================================

 This list follows the original one in \cite[Appendix D]{isac:all}. It is a 

 selection concerning the specify-phase. In particular, the terms used for this 

 phase underwent a considerable development since 2002 and are updated to the 

 current, more convenient notions.

 \begin{description}

 \item{\bf Calculation} is the document for interactive construction of a 

 result from given items according to some \see Problem definition. It is a 

 variant of ``structured derivations''~\cite{Back-SD09}.

 \item{\bf Descriptor} is the heading constant of a \see Model-Item in the 

 fields "Given", "Find" and "Relate" (and not in pre-conditions). It indicates 

 the kind of item and constrains the respective type.

 \item{\bf Example} specifies a particular \see Calculation. It comprises text 

 and/or figure for the student and a \see Formalisation.

 \item{\bf Formalisation} is the formal part of an \see Example and contains 

 data to complete a \see Specification as a prerequisite for automated 

 generation of user-guidance in a \see Calculation.

 \item{\bf \sisac-Knowledge} comprises collections of three kinds of knowledge:

   \begin{compactitem}

   \item {\bf RTheory}, an Isabelle theory

   \item {\bf RProblem} is a \see Model-Pattern.

   \item {\bf RMethod}: a program guarded by a \see Model serving 

     ``Lucas-Interpre-tation''~\cite{EPTCS-wn-20}.

   \end{compactitem}

   For simplicity reasons, a collection of \see Examples is subsumed to  

     \sisac-Knowledge, too.

 \item{\bf Method} is a program for a class of Problems. It consists of a   

 program to be exploited by Lucas-Interpretation \cite{EPTCS-wn-20} and a guard   

 with the structure of a \see Model.

 \item{\bf Model} comprises four fields of \see Model-Items in the line  

 of~\cite{gries}:

   \begin{compactitem}

   \item {\bf Given} for the input-items

   \item {\bf Where} for the pre-conditions constraining the input-items

   \item {\bf Find} for the output-items

   \item {\bf Relate} for a part of the post-condition capturing the essence of 

     a problem relating input and output

   \end{compactitem}

 \item{\bf Model-Item} is a mathematical term in a \see Model.

 \item{\bf Model-Pattern} comprises the same fields as a \see Model, but these 

 contain variables to be instanted by the \see Formalisation of an \see Example 

 in order to give \see Model.

 \item{\bf Problem} is the head of a \see Calculation. Calculations can 

 comprise several sub-problems, arbitrarily nested, with exactly the same 

 structure. A Problem consists of a \see Specification and a \see Solution.

 \item{\bf References} refer to three kinds of items in the \see 

 \sisac-Knowledge.

 \item{\bf Solution} are the steps form a \see Specification to a \see 

 Solution, where each step is justified by a \see Tactic. The final step 

 fulfills the post-condition of the \see Model.

 \item{\bf Specification} comprises data to specify a problem in the \see Model 

 and gives \see References into the \see \sisac-Knowledge.

 \item{\bf Tactic} transforms a term into another, frequently a rewrite-rule. 

 Since a \see Problem can occur recusively in a Solution as a sub-problem, this 

 is also a particular Tactic.

 \item{\bf User-Guide} supports a student during interactive \see Calculations. 

 This support is only possible if a \see Formalisation has been transferred 

 (invisibly for a student) from an \see Example.

 %\item{\bf TODO} xxx

 \end{description}

 \section{User Requirements}

 %============================================================================

 The User Requirements ({\bf UR}s) do not follow the lines of the original ones 

 in \cite[Part I]{isac:all}, but limit themselves to a student in the 

 specify-phase and use the updated terms from \S\ref{terms} (which are 

 indicated by initial capital letters).

 {\bf\UR{Examples are selected from 

 collections\label{example-coll}}}\footnote{The present test setup bypasses 

 this UR.}

 implemented on web-pages, which look like a text book. A specific link at an 

 Example starts an interactive Calculation for that Example. See 

 \url{http://www.ist.tugraz.at/projects/isac/www/kbase/exp/exp_Statics_Biegel_Timischl.html}.

 {\bf\UR{A Calculation is headed by the keyword Problem\label{yyy}}} and in 

 case of standard problems from Computer Algebra with a respective command like 

 ${\it simplify} (x + 1 + 2)$ or ${\it solve} (x + 1 = 2, \,x)$. An example is 

 Expl.\ref{tab:ca}. A Calculation can have sub-Problems with exactly the same 

 structure.

 {\bf\UR{A Calculation can be completed with one keystroke\label{yyy}}} and 

 sub-Problems as well, when allowed by the User-Guide. See 

 Exp.\ref{tab:calc-coll}.

 {\bf\UR{Switching between survey and detail\label{yyy}}} is supported by 

 collapsing and expanding a Calculation, see Expl.\ref{tab:calc-exp} \dots 

 Expl.\ref{tab:model-sub}

 {\bf\UR{A Calculation can be started from scratch\label{yyy}}}, that means 

 without a preceding Example. In this case an empty Specification is generated 

 by the system (see Expl.\ref{tab:mod-empty}) and the User-Guide cannot help 

 the student completing the Specification.

 {\bf\UR{Input to the Model is guided by Descriptors\label{yyy}}}, see 

 Expl.\ref{tab:model}, which are given by the Model-Pattern for the specific 

 kind of Problem.

 {\bf\UR{Feedback during input to the Model\label{yyy}}} is given as

 \begin{compactitem}

 \item ``correct''

 \item ``syntax-error'' or type error

 \item ``superfluous''

 \item ``incomplete'' in case of lists, sets, etc.

 \item ``missing''

 \item ``true'' or ``false'' for predicates in the field Where.

 \end{compactitem}

 {\bf\UR{Feedback during input to References\label{yyy}}} is given in the 

 Model:

 \begin{compactitem}

 \item Update RTheory: might cause ``syntax-error''

 \item Update RProblem: might cause ``superfluous'' or ``missing''

 \item Update RMethod: in this case the Model shows the guard with 

 ``superfluous'' or ``missing'' and the keyword Model is annotated with 

 ``(RMethod)''.

 \end{compactitem}

 {\bf\UR{The Model can be switched between RProblem and RMethod,\label{yyy}}} 

 where the latter is indicated by ``Model (RMethod)''< see Expl.\ref{tab:refs}.

 %{\bf\UR{xxx.\label{yyy}}}

 \section{Example Calculations}

 %============================================================================

 Calculations at different stages of interactive steps towards a Solution and 

 with variants of collapsing and expanding.\\

 {\bf\Expl{Complete Calculation expanded (sub-Problems 

 collapsed).\label{tab:calc-exp}}}

 {\tiny \begin{tabbing}

 12\=12\=12\=12\=\kill

 Example $<$7.70 a$>$              \\

 Problem ("Biegelinie", \dots)     \\

 .\>Specification:                 \\

 .\>.\>Model:                      \\

 .\>.\>.\>Given: "Traeger L",      \\

 .\>.\>.\>Where: "q\_0 ist\dots    \\

 .\>.\>.\>Find: "Biegelinie y"     \\

 .\>.\>.\>Relate: "Rand\dots       \\

 .\>.\>References:                 \\

 .\>.\>.\>RTheory: "Bie\dots"      \\

 .\>.\>.\>RProblem: ["\dots]       \\

 .\>.\>.\>RMethod: ["Int\dots]     \\

 .\>Solution:                      \\

 .\>.\>Problem ("\dots")           \\

 .\>.\>"[Q x = c + -1 * \dots"     \\

 .\>\vdots                         \\

 .\>."y x = $-6 * q\_0 * *$\dots"  \\

 "y x = $-6 * q\_0 * L ^ 2 /$\dots"\\

 \end{tabbing}}

 {\bf\Expl{Complete Calculation collapsed.\label{tab:calc-coll}}}

 {\tiny \begin{tabbing}

 12\=12\=12\=12\=\kill

 Example $<$7.70 a$>$              \\

 Problem ("Biegelinie", \dots)     \\

 "y x = $-6 * q\_0 * L ^ 2 /$\dots"\\

 \end{tabbing}}

 \newpage %~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 {\bf\Expl{Interactive Specification editing the Model\label{tab:model}}}, the 

 inital state with Descriptors, if given by the Example:

 {\tiny \begin{tabbing}

 12\=12\=12\=12\=\kill

 Example $<$7.70 a$>$                        \\

 Problem ("Biegelinie", \dots)               \\

 .\>Specification:                           \\

 .\>.\>Model:                                \\

 .\>.\>.\>Given: "Traeger ", "Streckenlast " \\

 .\>.\>.\>Where:                             \\

 .\>.\>.\>Find: "Biegelinie "                \\

 .\>.\>.\>Relate: "Randbedingungen [ ]"      \\

 .\>.\>References:                           \\

 .\>Solution:

 \end{tabbing}}

 {\bf\Expl{Interactive Specification from scratch\label{tab:mod-empty}}}, the 

 system presents an empty Specification:

 {\tiny \begin{tabbing}

 12\=12\=12\=12\=\kill

 Problem ("", [])            \\

 .\>Specification:           \\

 .\>.\>Model:                \\

 .\>.\>.\>Given: "", ""      \\

 .\>.\>.\>Where: "", ""      \\

 .\>.\>.\>Find:  ""          \\

 .\>.\>.\>Relate: "", ""     \\

 .\>.\>References:           \\

 .\>.\>.\>RTheory: ""        \\

 .\>.\>.\>RProblem: ["", ""] \\

 .\>.\>.\>RMethod: ["", ""]  \\

 .\>Solution:

 \end{tabbing}}

 {\bf\Expl{Interactive Specification editing References\label{tab:refs}}}, here 

 shown for RTheory and for RProblem; such editing is usually done after some 

 input to the Model:

 {\tiny \begin{tabbing}

 12\=12\=12\=12\=\kill

 Example $<$7.70 a$>$                        \\

 Problem ("Biegelinie", \dots)               \\

 .\>Specification:                           \\

 .\>.\>Model:                                \\

 .\>.\>.\>Given: "Traegerlaenge L", "Streckenlast $q_0$"                 \\

 .\>.\>.\>Where: "$q_0$ ist\_integrierbar\_auf $\{| 0, L |\}$", "$0 < L"$\\

 .\>.\>.\>Find: "Biegelinie y"               \\

 .\>.\>.\>Relate: "Randbedingungen $[ Q_0 = q_0 * L, M_b L = 0, y_0 = 0, d_d x 

                     y_0 = 0 ]$"             \\

 .\>.\>References:                           \\

 .\>.\>.\>RTheory: {\bf"Biegelinie"}         \\

 .\>.\>.\>RProblem: ["Biegelinien"]          \\

 .\>.\>.\>RMethod: ["Integrieren", "KonstanteBestimmen2"]             \\

 .\>Solution:

 \end{tabbing}}

 {\bf\Expl{Interactive Specification editing RMethod\label{tab:refs-met}}}. The 

 additional Given item "FunktionsVariable $x$" is usually provided behind the 

 scenes; but in case of editing RMethod the "Model (RMethod)" is shown and can 

 be edited as well.

 {\tiny \begin{tabbing}

 12\=12\=12\=12\=\kill

 Example $<$7.70 a$>$                        \\

 Problem ("Biegelinie", \dots)               \\

 .\>Specification:                           \\

 .\>.\>Model (RMethod):                      \\

 .\>.\>.\>Given: "Traegerlaenge L", "Streckenlast $q_0$", "FunktionsVariable 

                    $x$" \\

 .\>.\>.\>Where: "$q_0$ ist\_integrierbar\_auf $\{| 0, L |\}$", "$0 < L"$\\

 .\>.\>.\>Find: "Biegelinie y"               \\

 .\>.\>.\>Relate: "Randbedingungen $[ Q_0 = q_0 * L, M_b L = 0, y_0 = 0, d_d x 

                     y_0 = 0 ]$"             \\

 .\>.\>References:                           \\

 .\>.\>.\>RTheory: {\bf"Biegelinie"}         \\

 .\>.\>.\>RProblem: ["Biegelinien"]          \\

 .\>.\>.\>RMethod: ["Integrieren", "KonstanteBestimmen2"]             \\

 .\>Solution:

 \end{tabbing}}

 {\bf\Expl{Interactively solving the sub-Problem.\label{tab:model-sub}}}

 {\tiny \begin{tabbing}

 12\=12\=12\=12\=12\=\kill

 Example $<$7.70 a$>$             \\

 Problem ("Biegelinie", \dots)    \\

 .\>Specification:                \\

 .\>Solution:                     \\

 .\>.\>Problem ("\dots")          \\

 .\>.\>.\>Specification:          \\

 .\>.\>.\>.\>Model:               \\

 .\>.\>.\>.\>.\>Given: "\dots"    \\

 .\>.\>.\>.\>.\>Where: "\dots"    \\

 .\>.\>.\>.\>.\>Find: "\dots"     \\

 .\>.\>.\>.\>.\>Relate: "\dots    \\

 .\>.\>.\>.\>References:          \\

 .\>.\>.\>Solution:               \\

 \end{tabbing}}

 {\bf\Expl{Calculation like in Computer Algebra.\label{tab:ca}}}

 {\tiny \begin{tabbing}

 12\=12\=12\=12\=\kill

 Example $<$123 d$>$             \\

 ${\it solve} (x + 1 = 2, \,x)$  \\

 .\>Specification:               \\

 .\>Solution:                    \\

 .\>.\>"$x + 1 = 2$"             \\

 .\>.\>"$x = 2 - 1$"             \\

 .\>.\>"$x = 1$"                 \\

 "$x = 1$"

 \end{tabbing}}

 %\subsection{TODO}

 %\subsubsection{TODO}