Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

tableplot.iterplotstart - Function

	Package	utility
	Module	table
	Tool	tableplot

Initialize plotting with an iteration axis

Synopsis
iterplotstart(poption, labels, datastr, iteraxes)

Description
Begin a series of plots using subtables constructed via an iteration axes. In addition to plotdata parameters, set a vector string of iteration axes (Table column names) and use iterplotnext() to step through. Multi-panel plots are supported with this function. Only forward step through is allowed.

Arguments

poption		Record of plot options
		Allowed:	Record
		Default:	nxpanels=1,nypanels=1,windowsize=6, aspectratio=0.8,fontsize=1.0
labels		List of strings : Title,Xlabel,Ylabel
		Allowed:	Vector of Strings
		Default:	no default
datastr		List of TaQL strings : X,Y
		Allowed:	Vector of Strings
		Default:	no default
iteraxes		List of strings : Iteration axes
		Allowed:	Vector of Strings
		Default:	no default

Returns
0 if plot initialization is successful, -1 otherwise

Example

# create a tableplot tool, set the list of MS tables to plot from, 
# and initialize a plot of Amplitude vs UV distance for 
# channel 1 and stokes 1, iterating over Antenna1, and creating
# two plot panels per iteration page.
  tp := tableplot();
  tp.settables(tabnames=['3c273.ms','3c48.ms']);
  plotopts.nxpanels := 1;
  plotopts.nypanels := 2;
  plotopts.windowsize := 6;
  plotopts.aspectratio := 1.2;
  plotopts.fontsize := 2.0;
  labels := ['Amplitude vs UVdist (iterating over Antenna1)','uvdist','amplitude'];
  xystr := ['SQRT(SUMSQUARE(UVW[1:2]))','AMPLITUDE(DATA[1,1])'];
  iteraxes := ['ANTENNA1'];
  tp.iterplotstart(poption=plotopts,labels=labels,datastr=xystr,iteraxes=iteraxes);

To iterate over baseline and plot Amplitude vs time, for stokes 1, channel 1.

  plotopts.nxpanels := 1;
  plotopts.nypanels := 4;
  labels := ['Amplitude vs UVdist (iterating over Baseline)','uvdist','amplitude'];
  xystr := ['SQRT(SUMSQUARE(UVW[1:2]))','AMPLITUDE(DATA[1,1])'];
  iteraxes := ['ANTENNA1','ANTENNA2'];
  tp.iterplotstart(poption=plotopts,labels=labels,datastr=xystr,iteraxes=iteraxes);