STScI Logo

gkimosaic plot



gkimosaic -- condense metacode frames to fit on one page


gkimosaic input


The metacode input, which can be redirected from STDIN or read from one or more binary metacode files.
output = ""
If output is specified, the mosaiced metacode is spooled to this file for later plotting.
device = "stdgraph"
Output plotting device.
nx = 2
The number of plots to draw in the x direction.
ny = 2
The number of plots to draw in the y direction.
fill = no
The plots are reduced by equal factors in x and y when fill = no.
rotate = no
Output the mosaiced plots rotated by 90 degrees.
interactive = yes
If plotting to stdgraph , interactively examine each page of plots.
cursor = "stdgcur"
Source of cursor input.


Task gkimosaic condenses the plots in a metacode file to fit on a single page. The plots can be examined interactively after each pageful. The number of plots in x and y can be specified. This task is useful for browsing through a large metacode file, and for compactly plotting a large number of metacode frames.

When fill = no, the plots will be reduced by equal factors in x and y; the aspect ratio of the original plot is preserved. When fill = yes, the transformations in x and y are handled separately, meaning that the reduction factors will not be equal unless nx = ny .

The mosaiced plots are drawn on the page rotated by 90 degrees when rotate = yes. This means the x axis of the plots can be placed along either the page width or length. The plots can be output to a plotting device , or spooled in file output for later plotting.

If plotting to stdgraph , the plot can be interactively examined after each page of output by setting interactive = yes. The world coordinate system information of the individual plots has been retained for cursor readback. Standard cursor mode keystroke commands are available as well as the gkimosaic specific commands listed below. Colon commands :nx, :ny, :fill and :rotate take effect on the next page of output. Command :skip allows you to browse through a metacode file, skipping either forward or backward by N input plots.

	q				quit
	return				quit
	spacebar			continue
	?				print help information

	:nx N				change value of nx to N
	:ny N				change value of ny to N
	:fill yes, :fill+, :fill	sets fill = yes
	:fill no, :fill-		sets fill = no
	:rotate yes, :rotate+, :rotate	sets rotate = yes
	:rotate no, :rotate-		sets rotate = no
	:skip +/-N			skip forward/backward N plots


1. Plot every frame in the metacode file "oned.plots". There will be 4 plots to the page originally, but this can be overridden interactively.

cl> gkimosaic oned.plots

2. Extract every third plot from the metacode file "oned.plots" with task gkiextract and plot them four to a page.

cl> gkiextract oned.plots 1-99x3 | gkimosaic

3. Plot all frames in every metacode file beginning with "mcode." and condense them so 16 fit on a page. The metacode is being spooled; it will be plotted, perhaps, when the computer isn't so busy. Interactive mode is automatically disabled when not plotting to a graphics terminal.

cl> gkimosaic mcode.* nx=4 ny=4 output=plt.spool


Setting device to "stdvdm" does not work. To produce an output file of mosaiced metacode, use the output parameter or the ">G" graphics stream redirection feature of the cl.


gkidir, gkiextract

Source Code · Search Form · STSDAS