plotSetYticLabel¶

Purpose¶

Controls the formatting and angle of Y-axis tick labels for 2-D graphs.

Format¶

plotSetYticLabel(&myPlot, fmt[, angle])¶

Parameters:

&myPlot (struct pointer) – A plotControl structure pointer.
fmt (string or 2x1 string array) – the desired formatting for the Y-axis tick labels. If a 2x1 string array is passed in, the first element of fmt will control the left Y-axis and the second element will control the right Y-axis. sprintf() style formatting strings are supported. See Remarks below for more information.
angle (Scalar) – Optional argument, the angle in degrees at which to display the Y-axis tick labels.

Examples¶

Basic usage¶

// Declare and initialize plotControl structure
struct plotControl myPlot;
myPlot = plotGetDefaults("scatter");

x = seqa(0, 0.005, 33);
y = exp(x);

// Set the Y-tick format to be decimal
// with three places after the decimal point,
// i.e. 1.050, 1.010, etc, for all tick labels
plotSetYticLabel(&myPlot, "%.3f");

// Draw the scatter plot
plotScatter(myPlot, x, y);

The code above produces a graph with Y-tick labels like the image below:

Y-tick labels¶

Changing to format string to "%g" will change the labels to appear like this:

Changing to format string to "%.3e" will change the labels to appear like this:

175e+00
150e+00
125e+00
100e+00
075e+00
050e+00
025e+00

Left and right Y-axis formatting.¶

// Create 2 vectors to plot
temperature = { 14,
                31,
                27,
                19,
                22 };

pct = { 6.3,
        10.4,
        13.2,
        80.7,
        28.5 };

X = seqa(1, 1, 5);

// Declare plotControl structure and fill
// with default values for 'xy' plots
struct plotControl myPlot;
myPlot = plotGetDefaults("xy");

// Use the left Y-axis for the first line
// and the right Y-axis for the second line
plotSetWhichYAxis(&myPlot, "left" $| "right");

/*
** Set the format for the tick labels
** of each Y-axis
**
** "%d°" - Print the numbers as integers, followed by
**             the degree symbol (° is HTML).
**
** "%.1f%%" - Print one number after the decimal, followed by
**            a percent sign.
*/

fmt =  "%d°" $| /* format for left Y-axis */
      "%.1f%%";     /* format for right Y-axis */

plotSetYTicLabel(&myPlot, fmt);

// Draw the plot using the settings applied above
plotXY(myPlot, X, temperature ~ pct);

This will give axes labels which look similar to below:

Left Y-axis 32°    Right Y-axis 90.0%
            28°                 80.0%

Remarks¶

The parameters of a sprintf() style format string are:

precision - a literal scalar numeral, the number of digits after the decimal point
format type - one of the following letters:

d integer

e scientific notation

f floating point/decimal

g either scientific or decimal, whichever is most compact

The format of the format string is:

"%.<precision><format type>"

Below are some examples of different format strings and how they would represent \(\pi\)

“%.2f”	3.14
“%.4f”	3.1415
“%.2e”	3.14e+00
“%.2g”	3.14
“%d”	3

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.

d	integer
e	scientific notation
f	floating point/decimal
g	either scientific or decimal, whichever is most compact