PlotConnected

The PlotConnected method draws points in a new plot window. The points are drawn as markers connected by line segments. The line and marker attributes are set in the "View > Default Properties > Image Plots" dialog. The related Connect method takes its data from x and y tables rather than the CPlotView class data matrix.

Syntax

CPlot = CPlotView:PlotConnected()

CPlot = CPlotView:PlotConnected( sX )

CPlot = CPlotView:PlotConnected( sX, sY )

CPlot = CPlotView:PlotConnected( sX, sY, sTitle )

CPlot = CPlotView:PlotConnected( sX, sY, sTitle, sCaption )

bullet.gif    sX is the optional x axis label. If nil, a default is used.

bullet.gif    sY is the optional y axis label. If nil, a default is used.

bullet.gif    sTitle is the optional window title. If nil, a default is used.

bullet.gif    sCaption is the optional plot caption. If nil, a default is used.

Return value:

bullet.gif    CPlot is a new CPlot object attached to the current plot series. It is nil on failure.

Remarks

The plot below shows a connected plot with markers connected by line secments. To add error bars, specify them in the call to the CPlotView:Add method. To plot the same data using only markers, use PlotScatter. To draw only line segments, use the PlotLine or PlotStepLine method.

Example

The script below created the plot window shown above. The CImageView V was selected from a drop-list of all open image windows, and an image set was chosen. The header keyword AIRMASS was chosen for the x-axis. You could choose any keyword in the headers, or plot against some other value.

 

-- select an image view from open windows

V = attachlist_imageview()

-- Returns a reference V for the CmageView

Assert( V, "No Image views are open")

-- exit if V is nil

 

-- Get the keyword to plot

sKwd = "AIRMASS"

-- default keyword

sKwd, bOK = GetString( sKwd,"Keyword Name:")

 

Assert(bOK)

 

 

-- loop over all images in the CImageView:

nStart = V:GetIndex()

-- save index of top image

for i = 1, V:Count() do

 

 V:SetIndex(i)

-- Change to the i-th image

 I = V:GetImage()

-- get a reference to the image at index i

 if I then

-- if the image is good (it should be!)

  x = i

-- x plot value is the image index.

  y = I:KwdGetNum(sKwd)

-- y plot value is the keyword value

  P:Add(x,y)

-- add the point to the collection

 end

 

end

 

V:SetIndex(nStart)

-- reset the image window to the starting image

 

 

sCap = Sprintf("%s vs Image Index", sKwd )

-- Create caption above the plot for Overplot mode

 

-- plot points with X label, Y label, Title, and Caption

P:PlotConnected( "Image Index", sKwd, "My Plot", sCap )

-- specify the title and other labels

Related Topics

CPlotView class, PlotLine, PlotStepLine, PlotScatter, PlotPoints


Mira Pro x64 Script User's Guide, Copyright Ⓒ 2023 Mirametrics, Inc. All Rights Reserved.