v91release.tex

this file is contain important facts aboute different programming langueges.

!  Make all hardcopy at 60% reduction
hc_scale_factor = 0.6
!  Define default 3D view at radius=8, phi=45 degrees,
!  theta=45 degrees
3d_view = 8 45 45
! Use Courier font for Postscript text
ps_font_id = -109
! Redefine color #2 as light gray
color_2 = 0.7 0.7 0.7
\end{verbatim}
%
The following table lists all valid keywords for the Postmini startup
file {\tt POSTMINI\_DEFAULTS.DAT}.
In the following table, \sstring means any string, \iint means any
integer, and \rreal means any real number.
String values are
taken from the first non-blank character after the equal sign to the
last non-blank character of the line.
The following keywords are recognized:
\begin{leftindent}{\largetableindent}
\begin{center}
\begin{tabular}{llp{3in}}
\hline
\mcm{3}{l}{Postmini default file keywords} \\
\hline
Key & Values & Description \\
\hline
\tt 3D$\_$VIEW   & \rreal \rreal \rreal & 
                 Default 3D viewpoint (radius, phi, theta) \\
\tt AUTOSCALE  & {\tt YES | NO} & If ``{\tt YES}'', always generate new default plot axis \\
             & & limits using an autoscaling algorithm\\
             & & If ``{\tt NO}'', remember the last coordinate axis limits
                 the user specified and use for the next plot (default)\\
\tt COLOR\_nn  & \rreal \rreal \rreal
               & Defines  red/green/blue  components  of color {\tt nn}
                 {\tt nn} ranges from 0 to 15. Postmini normally
                 uses colors 0--11. \\
               & & Color 0 specifies the background color \\
 -- or --      & \sstring
               & Name of color nn \\
\tt FONT\_ID   & \iint & GKS stroke font id for plots to the screen (see DEC GKS manual) \\
\tt HARDCOPY   & {\tt postscript | ln03plus } &  Default hardcopy device \\
               & {\tt | hp7550 | lj250 } & \\
\tt HC\_ORIENTATION      &  {\tt portrait | landscape} & Hardcopy orientation \\
\tt HC\_SCALE\_FACTOR    &  \rreal (0.1 to 1.0) & Hardcopy reduction factor \\
\hline
\end{tabular}
\end{center}
\end{leftindent}
%
\newpage
\begin{leftindent}{\largetableindent}
\begin{center}
\begin{tabular}{llp{3.0in}}
\hline
\mcm{3}{l}{Postmini default file keywords (cont)} \\
\hline
Key & Values & Description \\
\hline
\tt HIDDEN\_LINE\_METHOD &  painter | horizon & 3D hidden line method \\
\tt LENGTH\_UNIT\_NAME\_  & \sstring \rreal
                         & Name of length unit and scale to cm \\
\tt AND\_SCALE & & \\
\tt OXIDE\_FILL          & {\tt YES | NO}
                         & Fill regions of oxide with background color
                           if oxide does not have any data associated with it\\
                       & & For debugging only, default: YES \\
\tt PLOT\_SCALE\_FACTOR  & \rreal (0.1 to 10.0)
                         &  Plot reduction/enlargement factor \\
\tt PS\_FONT\_ID         & \sstring
    & Selects text font to use for Postscript plots (see section~\ref{sec:pmifile}) \\
\tt LINEWIDTH\_SCALE     & \rreal  & Linewidth scale factor \\
\tt SOLID\_CONTOUR\_LINES & No value & Makes all 2D contour lines solid \\
\tt TEXT\_SCALE          & \rreal (0.1 to 10.0)
                         & Text reduction/enlargement factor \\
\tt WRITE\_PMIFILE       & {\tt YES | NO}
                         & If YES, writes .PMI file at end of Postmini run
                           (default: YES) \\
\tt Z\_COLORMAP\_MINIMUM & \rreal & Value of colormap minimum for 3D plots \\
\tt Z\_COLORMAP\_MAXIMUM & \rreal & Value of colormap maximum for 3D plots \\
\hline
\end{tabular}
\end{center}
\end{leftindent}
%
\section{POSTMINI command file syntax \label{sec:pmifile}}
The Postmini command file describes all the data needed to recreate
a Postmini plot from the original data files.
The command file breaks a Postmini plot into several parts,
such as type of plot, axis description, data source, annotations, etc.
In order to use the same code as for reading the Postmini defaults file,
the Postmini command file uses a similar general syntax:
a keyword, an (optional) equal sign, and an (optional) list of arguments.
Certain special keywords called {\it main} keywords introduce each
part of the plot, and tell Postmini what to expect next.
Each main keyword is followed by subkeys which give further
information.

The following table lists all valid main keywords for the Postmini command
file. Note that some keys go together;
for example, a file with a {\tt PLOT 2D} key must have a {\tt CONTOUR} key.
Keywords may be in any case. They must be spelled out completely.
Comments are started by an exclamation point {\tt !} in column 1.
A choice is denoted by the syntax {\tt word1 | word2 | ...}.
Note that new main keywords may be added in later versions of Postmini.
\begin{center}
\begin{tabular}{llp{3.0in}}
Key & Values & Description \\
\hline
{\tt PLOT}   & {\tt 1D | 2D | 3D |}   & Type of plot \\
             & {\tt COMPARE | BARCHART}       & \\
             & {\tt OVERLAY}          & \\
{\tt GLOBAL} & none                   & Global plot parameters \\
{\tt TITLE}  & \sstring               & Titling to appear at top of plot \\
{\tt AXIS}   & {\tt X | Y | Z }       & Axis parameters \\
             & (optional)             & \\
             & {\tt BOTTOM | TOP | }  & \\
             & {\tt LEFT | RIGHT}     & \\
{\tt CURVE}  & none                   & Source of data for a 1D or COMPARE
                                        plot. \\
             &                        & There can be multiple {\tt CURVE}
                                        commands in a COMPARE plot        \\
{\tt CONTOUR} & none                  & Source of data for a 2D contour plot \\
             &                        & There can be multiple {\tt CONTOUR}
                                        commands in an OVERLAY plot        \\
{\tt SURFACE} & none                  & Source of data for a 3D surface plot \\
{\tt ANNOTATE} & {\tt LINE | BOX | TEXT | } & Data for an annotation \\
               & {\tt MARKER | ELLIPSE } & \\
\hline
\end{tabular}
\end{center}

\newpage
The subkeywords for each main keyword are listed in the following tables.
Note that new subkeywords may be added in later versions of Postmini.
In the following table, \sstring means any string, \iint means any
integer, and \rreal means any real number. String values are
taken from the first non-blank character after the equal sign to the
last non-blank character of the line. Quoting is not needed to
maintain the case of strings.

Postmini 7.4-000 and higher supports symbolic names for colors,
line types, marker types and PostScript fonts, as well as integers.
Postmini recognizes the following:
\begin{center}
\begin{tabular}{ll}
\hline
Item & Values \\
\hline
Color & Dependent on plot type \\
      & See tables below \\
      & Also: {\tt invisible, off, none} \\
Line types & {\tt solid, dashed, dotted, dash\_dot } \\
             & {\tt dash\_2\_dot dash\_3\_dot long\_dash } \\
             & {\tt long\_short\_dash spaced\_dash spaced\_dot } \\
             & {\tt double\_dot triple\_dot } \\
             & {\tt none off omit} \\
Marker types & {\tt circle, square, triangle\_up, triangle\_down } \\
             & {\tt solid\_circle, solid\_square } \\
             & {\tt solid\_tri\_up, solid\_tri\_down } \\
             & {\tt dot, plus, asterisk, cross} \\
             & {\tt bowtie, hourglass, diamond} \\
             & {\tt solid\_bowtie, solid\_hourglass, solid\_diamond} \\
             & {\tt none off omit} \\
PostScript   & {\tt times, times\_italic} \\
fonts        & {\tt times\_bold, times\_bold\_italic } \\
             & {\tt helvetica, helvetica\_oblique} \\
             & {\tt helvetica\_bold, helvetica\_bold\_oblique } \\
             & {\tt courier, courier\_olblique } \\
             & {\tt courier\_bold, courier\_bold\_oblique } \\
\hline
\end{tabular}
\end{center}
You can still use integers to specify these items, if you wish.
{\it Note well!} If you have used the {\tt COLOR\_NN} command to change
Postmini's default colors, the color name associated with index {\tt NN} will
no longer be recognized by Postmini. In its place, the name {\tt userdefinednn}
will be recognized. The color names are taken from the list of X11 colors
(on Unix, see: {\tt /usr/lib/X11/rgb.txt}).

The default colors for 1D and comparison plots are:
\begin{center}
\begin{tabular}{ll}
\hline
Color Index & Name \\
\hline
0   & white \\
1   & black \\
2   & red \\
3   & green \\
4   & blue \\
5   & cyan \\
6   & magenta \\
7   & yellow \\
8   & lightgreen \\
9   & gold \\
10  & lightblue \\
11  & orange \\
12  & purple \\
13  & brown \\
14  & gray \\
15  & violet \\
\hline
\end{tabular}
\end{center}

The default colors for 2D and 3D plots are:
\begin{center}
\begin{tabular}{ll}
\hline
Color Index & Name \\
\hline
0   & white \\
1   & black \\
2   & purple \\
3   & blue \\
4   & deepskyblue \\
5   & cyan \\
6   & green3 \\
7   & green \\
8   & yellow \\
9   & gold \\
10  & orange \\
11  & red \\
12  & undefined1 \\
13  & undefined2 \\
14  & undefined3 \\
15  & undefined4 \\
\hline
\end{tabular}
\end{center}
%
\newpage
\subsection{Keyword PLOT}
\begin{center}
\begin{tabular}{llp{3.0in}}
\hline
Keyword PLOT & &\\
\hline
Subkey & Values & Description \\
\hline
\\
\multicolumn{3}{l}{Does not have any subkeys at this time.} \\
\\
\hline
\end{tabular}
\end{center}
%
\newpage
\subsection{Keyword GLOBAL}
\begin{leftindent}{\largetableindent}
\begin{center}
\begin{tabular}{llp{3.0in}}
\hline
Keyword GLOBAL & & \\
\hline
Subkey & Values & Description \\
\hline
\tt COLOR$\_$nn & \rreal \rreal \rreal & Red,green,blue componens of color\\
              & or \sstring & color name \\
\tt FONT\_ID & \iint & GKS stroke font id\\
\tt HARDCOPY\_DEVICE & \sstring & Default hardcopy device (see section~\ref{sec:startup})\\
\tt HC\_ORIENTATION & {\tt LANDSCAPE | PORTRAIT} & Hardcopy orientation \\
\tt HC\_SCALE\_FACTOR & \rreal & Hardcopy reduction factor, $<$ 1.0 \\
\tt HIDDEN\_LINE\_METHOD & {\tt device | painter | } & Type of hidden line algorithm\\
                         & {\tt horizon } & \\
\tt LENGTH\_UNIT\_NAME\_ & \sstring \rreal & \\
\tt AND\_SCALE & & \\
\tt LINEWIDTH\_SCALE & \rreal & Scales all lines \\
\tt PLOT\_SCALE\_FACTOR & \rreal & Scales plot window, $<$ 1.0 makes window smaller, $>$ 1.0 makes window larger\\
\tt PS\_FONT\_ID & \sstring & PostScript font name (see list of names above) \\
\tt TEXT\_SCALE & \rreal & Scales all text \\
\tt HC\_SCALE\_FACTOR  & \rreal & Scales the hardcopy plot (0.1 $<$ 1.0)\\
\tt HC\_ASPECT\_RATIO  & \rreal & Modifies the aspect ratio of the hardcopy plot (0.1 $<$ 2.0, default=0.77)\\
\tt HC\_XOFFSET & \rreal & Offsets the hardcopy plot in the X direction ($<$ 1.0) \\
\tt HC\_YOFFSET & \rreal & Offsets the hardcopy plot in the Y direction ($<$ 1.0) \\
\hline
\end{tabular}
\end{center}
\end{leftindent}
%
\newpage
\subsection{Keyword TITLE}
\begin{center}
\begin{tabular}{llp{3.0in}}
\hline
Keyword TITLE & \sstring &\\
\hline
Subkey & Values & Description \\
\hline
\\
\multicolumn{3}{l}{Does not have any subkeys at this time.} \\
\\
\hline
\end{tabular}
\end{center}
The {\tt TITLE} command is used to put text labels at the top of plots.
For {\tt 1D}, {\tt 2D}, {\tt 3D} plots, only one title line can be
specified.
For comparison plots, up to five title lines can be specified.
For overlay plots, up to three title lines can be specified.
If you use more than two titles, you should also specify either