Plot XY VI

Takes a picture and an array of points and appends a picture that represents an XY graph of the data.

To create controls for the cluster inputs in this VI, right-click the cluster terminal and select Create»Control from the shortcut menu.


icon

Inputs/Outputs

  • ccclst.png [user-specified font] —

    [user-specified font] specifies the specific font characteristics for the text to draw.

    The VI ignores this input unless desired font is User-specified Font.

  • cstr.png Font Name: —

    Font Name specifies the font to use for the text.

    If you misspell the font name or specify a font that is not installed on the computer, the operating system selects a font.

  • ci16.png Size —

    Size specifies the size of the font in points.

  • cbool.png Strikeout? —

    Strikeout? specifies if the text appears in strikeout. If Strikeout? is TRUE, the text appears in strikeout.

  • cbool.png Italic? —

    Italic? specifies if the text appears in italics. If Italic? is TRUE, the text appears in italics.

  • cbool.png Underline? —

    Underline? specifies if the text is underlined. If Underline? is TRUE, the text appears underlined.

  • cbool.png Outline? —

    Outline? specifies if the text is outlined. If Outline? is TRUE, the text appears outlined.

  • cbool.png Shadow? —

    Shadow? specifies if the text has a shadow. If Shadow? is TRUE, the text appears in shadow.

  • cbool.png Bold? —

    Bold? specifies if the text is bold. If Bold? is TRUE, the text appears bold.

  • cenum.png desired font(Application) —

    desired font specifies the text font.

    0
    User-specified Font
    1
    Application Font
    (default)
    2
    System Font
    3
    Dialog Font
  • cpict.png picture —

    picture is the picture to which you want to add the graph. The default is an empty picture.

  • c1dnclst.png data —

    data is an array of points, where each point is a cluster of x and y pixel coordinates.

  • cdbl.png x —

    x is the horizontal coordinate that increases to the right.

  • cdbl.png y —

    y is the vertical coordinate that increases to the bottom.

  • cnclst.png dimensions (w,h) —

    dimensions specifies the top left point of the drawn bitmap.

  • ci16.png width —

    width specifies the horizontal coordinate that increases to the right.

  • ci16.png height —

    height specifies the vertical coordinate that increases to the bottom.

  • cnclst.png top left point(0, 0) —

    top left point specifies in coordinates where to place the top-left corner of the image in the new picture.

  • ci16.png x —

    x is the horizontal coordinate that increases to the right.

  • ci16.png y —

    y is the vertical coordinate that increases to the bottom.

  • ccclst.png cartesian axis attributes —

    cartesian axis attributes specifies the range and format for the x- and y- axes.

    If the minimum and maximum values are the same, or if you do not wire the cartesian axis attributes input, the VI calculates the minimum and maximum values from the data.

  • cdbl.png x minimum —

    x minimum is the smallest allowable value in the range of horizontal coordinates.

  • cdbl.png x maximum —

    x maximum is the largest allowable value in the range of horizontal coordinates.

  • cbool.png x log? —

    x log? indicates whether the scale should be logarithmic.

  • cu8.png x precision —

    x precision specifies the precision for the scale numbers on the x-axis.

  • cenum.png x format —

    x format specifies the numeric format for the scale numbers on the x-axis. The default is Decimal.

    0
    Decimal
    1
    Scientific
    2
    Engineering
    3
    Binary
    4
    Octal
    5
    Hex
  • cdbl.png y minimum —

    y minimum is the smallest allowable value in the range of vertical coordinates.

  • cdbl.png y maximum —

    y maximum is the largest allowable value in the range of vertical coordinates.

  • cbool.png y log? —

    y log? indicates whether the scale should be logarithmic.

  • cu8.png y precision —

    y precision specifies the precision for the scale numbers on the y-axis.

  • cenum.png y format —

    y format specifies the numeric format for the scale numbers on the y-axis. The default is Decimal.

    0
    Decimal
    1
    Scientific
    2
    Engineering
    3
    Binary
    4
    Octal
    5
    Hex
  • ccclst.png cartesian grid cosmetics —

    cartesian grid cosmetics specifies the style for the grid of the graph.

  • cu32.png line color —

    line color specifies the color of the line.

    You can wire a color box constant to this input.

  • cu32.png text color —

    text color specifies the color of the text.

    You can wire a color box constant to this input.

  • ci16.png tick length(3) —

    tick length specifies the length of the tick marks on the edge of the scale.

  • cbool.png crossing axes —

    crossing axes specifies if the VI draws the axes at the originating coordinate. If crossing axes is TRUE, the VI draws the axes at the originating coordinate. If crossing axes is FALSE, the VI draws the axes at the bottom left edge of the plot.

  • cbool.png visible grid? —

    visible grid? specifies if the VI displays the grid in the graph. If visible grid? is TRUE, the VI displays the grid in the graph.

  • cnclst.png XY plot cosmetics —

    XY plot cosmetics specifies the plot color, the style for the plot, and the baseline. This VI uses the baseline only if the XY plot type is comb plot.

  • cu32.png plot color —

    plot color specifies the color of the plot.

    The default in RGB is 255, 255, 0.

    You can wire a color box constant to this input.

  • cenum.png XY plot type —

    XY plot type specifies the style of plot to display.

    0points
    1squares
    2circles
    3connected points (default)
    4connected squares
    5connected circles
    6comb plot
    7sized scatter plot
    8sized-colored scatter plot
    9min-max lines
  • cdbl.png baseline —

    baseline specifies the baseline of a plot. The default is 0.

  • ccclst.png [sized scatter plot cosmetics] —

    sized scatter plot cosmetics specifies the range of sizes for frequency distribution points, assuming the xy plot type is sized scatter plot or sized-colored scatter plot.

  • ci16.png min size —

    min size specifies the smallest size to be used for points in a scatter plot.

  • ci16.png max size —

    max size specifies the largest size to be used for points in a scatter plot.

  • ci16.png maps to max size —

    maps to max size defines the maximum size to which the uppermost point in the scatter plot can be mapped.

  • c1du32.png color array —

    color array maps specific colors for points of each size.

  • ipict.png new picture —

    new picture is the picture that contains the plot. You can wire this output to any other picture input to add more drawing instructions to the picture.

    You also can wire this output to the Picture to Pixmap VI to obtain an image data cluster. You then can save the image data to a file using the Graphics Formats VIs.

    • This VI ignores the values of the x minimum, x maximum, y minimum, and y maximum subparameters of the cartesian axis attributes input. The VI ignores the subparameters because it automatically scales the axes. Use the Plot Multi-XY VI if you do not want to use automatic scaling.

    Examples

    Refer to the following example files included with LabVIEW.

    • labview\examples\Graphics and Sound\Picture Plots\Waveform and XY Plots.vi
    • labview\examples\Graphics and Sound\Picture Plots\Artificial Strip Chart.vi