\documentstyle[color,epsfig]{article}
\pagestyle{plain}
\textheight=24cm
\leftmargin=0cm
\textwidth=15cm
\parskip=1em
\parindent=0em
\topmargin=-3cm
\pagecolor{white}

\begin{document}

\title{Visual Tochnog users manual \\
       (under development)}
\author{Dennis Roddeman}

\maketitle

\clearpage
\tableofcontents

\clearpage
\section{Basic information}

\subsection{Introduction}

Visual Tochnog is the visual layer on top of Tochnog.
Presently, we have tested Visual Tochnog on linux, hp, sgi and Microsoft Window systems.
It is reported to run also on Digital Unix 4.0.

\underline{Warning}: Visual Tochnog is still heavily under development.
The installation procedure and usage still need to be improved.

You need to have TclTk also.
See the links at our homepage where to get TclTk; version 8.* is strongly recommended,
because it is much more fast then the older versions.

Optionally, you can use Visual Toolkit (vtk) graphics. 
See the links at our homepage.
When compiling vtk, you need to configure with --with-tcl and --with-tkwidget and
in case you use Mesa as replacement for OpenGL also with --with-mesa.

\subsection{License} 

The GNU GENERAL PUBLIC LICENSE applies.
It specifies COPYING conditions and a NO WARRANTY statement.
It is included in the Tochnog users manual,
and furthermore as a separate LICENSE.txt file in each distribution.

\subsection{Distribution files and installation}

After installation of the Tochnog source distribution file 
from the homepage you will find in the tn directory the following:

\begin{itemize}
 \item {\bf vtn/vtnvtk.bat}
  \linebreak
 This is the script for starting Visual Tochnog with Visual Toolkit graphics in Unix.
 \item {\bf vtn/vtnnovtk.bat}
  \linebreak
 This is the script for starting Visual Tochnog without Visual Toolkit graphics
 in Unix. 
 \item {\bf vtn/*.tcl}
  \linebreak
 These are the tcl files for Visual Tochnog.
\end{itemize}

Visual Tochnog takes some of its help texts from
the html distribution of the manuals.
So consider also installing the html distribution file;
see the download section at our homepage.
After installation of the html distribution file 
from the homepage you will find in the tn directory the following:
\begin{itemize}
 \item doc/vtn/*
  \linebreak
 Visual Tochnog User's documentation in html format. 
 The entry file is vtn.html.
\end{itemize}

\underline{Unix installation}

Set in the {\bf vtnvtk.bat} or {\bf vtnnovtk.bat} script file 
the absolute path to the {\bf vtochnog.tcl} file (so something like
{\bf /home/dennis/tn/vtn/vtochnog.tcl}).

Set in the {\bf vtochnog.tcl} file the correct {\bf tnpath} variable.
Default the {\bf tnpath} variable is set to the tn directory in your home directory,
which is ok if you perform a normal installation.

To create a soft link on Unix to the start script you can use:
\begin{itemize}
 \item ln -s  {\bf \${HOME}/tn/src/vtnvtk.bat \${HOME}/bin/vtochnog }
\end{itemize}
or
\begin{itemize} 
 \item ln -s  {\bf \${HOME}/tn/src/vtnnovtk.bat \${HOME}/bin/vtochnog }
\end{itemize}
depending if you want to use vtk graphics.
If you put your bin directory in your PATH, you can use the {\bf vtochnog} everywhere.
As an alternative, you can move the .bat file that you need 
to any directory which is part of your PATH.

\underline{Microsoft Windows installation}

Set in the {\bf vtochnog.tcl} file the {\bf tnpath} variable
to the absolute path of your tn installation directory.
Default the {\bf tnpath} variable is set to the tn directory in your home directory,
which is ok if you perform a normal installation.

Copy the {\bf vtochnog.tcl} file to the directory where you want to use vtn.

Click on {\bf vtochnog.tcl} in the file manager.

\clearpage
\section{Running Visual Tochnog}

Type {\bf vtochnog} to start.
In the example below, we show how to create a rectangular mesh
for a two-dimensional heat analysis.

\begin{quotation}
  \mbox{ } \\
  \\
  (initialise) \\
  \\
  click {\bf Edit} \\
  click {\bf Edit Initia} \\
  click {\bf condif\_temperature} \\
  click {\bf 2D} \\
  click {\bf Ready} \\
  \\
  (create mesh) \\
  \\
  click {\bf Edit} \\
  click {\bf Edit Data} \\
  click {\bf control\_*} \\
  click {\bf control\_mesh\_*} \\
  click {\bf control\_mesh\_macro\_*} \\
  click {\bf Edit by name} \\
  enter {\bf control\_mesh\_macro 10  -rectangle -quad4 0 -nothing 10 5} \\
  press {\bf return} \\
  enter {\bf control\_mesh\_macro\_parameters 10  1. 0.5 2. 1.} \\
  press {\bf return} \\
  click {\bf Ready} \\
  click {\bf Ready} \\
  \\
  (run with mesh) \\
  \\
  click {\bf Run} \\
  click {\bf Run in foreground} \\
  \\
  (view output file) \\
  \\
  click {\bf File} \\
  click {\bf File Open/Save/View} \\
  enter {\bf vtn.out} in 'select a file to view' \\
  press {\bf return} \\
  click {\bf Ready} \\
  \\
  (plot mesh) \\
  \\
  click {\bf View} \\
  click {\bf vtnvtk} \\
\end{quotation}

\clearpage
\section{Acknowledgements}

For the graphical part, we use the very nice Visual Toolkit library (vtk).
See the links at our homepage.

For actually using vtk, you need a wrapper (a program that calls vtk routines).
The wrapper of vtn is, with kind permission, based on the Melati wrapper 
for vtk by Jos Runarko at the 'Forschungszentrum Strangpressen' in Berlin.
See the links at our homepage for Melati.

\end{document}
