next up previous contents
Next: Example: template program Up: GRASP Routines: Template Bank Previous: Function: template_grid()   Contents

Function: plot_template()

0 void plot_template(char *filename, struct Scope Grid, int npages, int number)
This function generates a PostScript (tm) file that draws a set of templates on top of the region of parameter space which they cover.

The arguments are:

filename: Input. Pointer to a character string. This is used as the name of the output file, into which postscript output is written. We suggest that you use ``.ps" as the final three characters of the filename. These files are best viewed using GhostView.
Grid: Input. The mass range specified by Grid is used to draw an outline of the region in $(\tau_0,\tau_1)$ parameter space covered by the mass range, and an ellipse for each template included in Grid is then drawn on top of this outline.
npages: Input. If there are more than a few templates (and there can be thousands, or more) it is impossible to view this graphical output unless it is spread across many pages. npages specifies the number of pages to spread the output across. We suggest at least one page per hundred templates.
number: Input. Each template specified in Grid is numbered by the field Grid.n_tmplt. If number is set to 1, then when each ellipse is drawn in parameter space, the number of the template is placed inside the ellipse so that the particular template associated with each ellipse may be easily identified. If number is set to 0, then the templates are not identified in this way; each template is simply drawn as an empty ellipse.

Figure: Part of some sample output from plot_template().
\begin{figure}\begin{center}
\epsfig{file=Figures/figure6.ps,height=8cm,bbllx=72pt,bblly=72pt,
bburx=576pt,bbury=612pt}\end{center}\end{figure}

Note that the output postscript file is designed to be edited if needed to enable clear viewing of details. Each file is broken into pages. At the beginning of each page are commands that set the magnification scale of each page, and determine if the page will be clipped at the boundaries of the paper or not. You can edit these lines in the postscript file to enable you to ``zoom in" on part of the parameter space, if desired. By turning off the clipping, you can easily move off the boundaries of a given page, if desired. Some sample output from plot_template() is shown in Figure [*]. (In fact, this is part of the output file produced by the example program, showing a small number of the total of 1001 templates required).
Author: Bruce Allen, ballen@dirac.phys.uwm.edu
Comments: Another option should be added, to print out at the center of each template, the mass parameters $m_1$ and $m_2$ associated with the template.


next up previous contents
Next: Example: template program Up: GRASP Routines: Template Bank Previous: Function: template_grid()   Contents
Bruce Allen 2000-11-19