plotSetLineSymbol

Purpose

Sets the symbols displayed on the plotted points of a graph.

Format

plotSetLineSymbol(&myPlot, newSymbol[, symbolWidth])
Parameters:
  • &myPlot (struct pointer) – A plotControl structure pointer.
  • newSymbol (matrix) –

    new line symbol settings. Options include:

    -1 None.
    0 Ellipse.
    1 Rectangle.
    2 Diamond.
    3 Upward pointing triangle.
    4 Downward pointing triangle.
    5 Triangle.
    6 Leftward pointing triangle.
    7 Rightward pointing triangle.
    8 Cross.
    9 Diagonal cross.
    10 Horizontal line.
    11 Vertical line.
    12 Star 1.
    13 Star 2.
    14 Hexagon.
  • symbolWidth (scalar) – Optional argument, width to draw line symbols.

Examples

// Declare plotControl structure
struct plotControl myPlot;

// Initialize plotControl structure
myPlot = plotGetDefaults("xy");

// Set line 1 to have no symbol
// Set line 2 to display an ellipse at each plotted point.
newSymbol = { -1, 0 };
symbolWidth = 5;
plotSetLineSymbol(&myPlot, newSymbol, symbolWidth);

// Create data
x = seqa(0.1, 0.1, 50);
y = sin(x)~cos(x);

// Plot the data with the new line symbols
plotXY(myPlot, x, y);

Remarks

This function sets an attribute in a plotControl structure. It does not affect an existing graph, or a new graph drawn using the default settings that are accessible from the Tools > Preferences > Graphics menu. See the GAUSS Graphics chapter for more information on the methods available for customizing your graphs.