plotSetXLabel

Purpose

Controls the settings for the X-axis label on a graph.

Format

plotSetXLabel(&myPlot, label[, font[, fontSize[, fontColor]]])
Parameters:
  • &myPlot (struct pointer) – A plotControl structure pointer.
  • label (string) – the new label. This may contain HTML for the creation of Greek letters, mathematical symbols and text formatting.
  • font (string) – Optional argument, font or font family name.
  • fontSize (scalar) – Optional argument, font size in points.
  • fontColor (string) – Optional argument, named color or RGB value.

Examples

Example 1: Basic usage

// Declare plotControl structure
struct plotControl myPlot;

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

// Set the X-axis label, label font, label font size, and
// label color
plotSetXLabel(&myPlot, "Time (sec)", "verdana", 10, "black");

// Create data
x = rndn(1e5,1);

// Plot a histogram of the x data spread over 50 bins
plotHist(myPlot, x, 50);

Example 2: HTML

You may add Greek letters, mathematical symbols, subscript and superscript to your axis labels using HTML. To add HTML to a label, you need to wrap the text to be interpreted as HTML in HTML tags.

label_string = "<html>&beta;</html>";
plotSetXLabel(&myPlot, label_string);

The code above will add the letter \(\beta\) to the x-axis label. The HTML 'sup' tag will create superscript and the 'sub' tag will create subscript. For example:

label_string = "<html>&sigma;<sup>2</sup></html>";
plotSetXLabel(&myPlot, label_string);

will add \(\sigma^2\) to your x-axis label. While,

label_string = "<html>Y<sub>t-1</sub></html>";
plotSetXLabel(&myPlot, label_string);

will create \(Y_{t-1}\)

Example 3: Latex

You can use Latex to add equations to axis labels. Note that double-backslashes must be used as shown below.

// Tell GAUSS to interpret the axis label text as Latex
plotSetTextInterpreter(&myPlot, "Latex", "axes");

// Add Latex axis label.
plotSetXLabel(&myPlot, "\\sqrt{\\lambda}");

The code above will add \(\sqrt{\lambda}\) to your x-axis label.

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.