SED navigation bar go to SED home page go to Dataplot home page go to NIST home page SED Home Page SED Staff SED Projects SED Products and Publications Search SED Pages
Dataplot Vol 1 Vol 2

BAR BORDER COLOR

Name:
    BAR BORDER COLOR
Type:
    Plot Control Command
Purpose:
    Specifies the border color for bars on subsequent plots.
Description:
    Dataplot defines the points on a plot by "traces". A trace is a set of points that are drawn with the same attributes. For example,

      PLOT Y1 X1 AND
      PLOT Y2 X2

    has two traces. The first is the points defined by Y1 and X1 and the second is the points defined by Y2 and X2. Attributes can be set for up to 100 traces.

    Dataplot provides two methods for specifying colors.

    1. Colors can be defined by name (or by the corresponding index). Dataplot adopted it's named colors from the X11 project. Currently, 162 named colors and 100 levels of grayscale are supported. Grayscale can be specified with either G0, G1, ..., G100 (or -1, -2, ..., -100). Many older devices support only a limited number of colors. For these devices, unsupported colors will be mapped to one of the available colors. To specify a named color, see Syntax 1.

    2. Most modern graphics devices support full RGB (RedBlueGreen) color. You can alternatively specify RGB colors by entering three integer values to represent the Red, Green and Blue components, respectively. These values should be in the range 0 to 255.

    When setting the bar border color, Dataplot first checks if the device supports RGB colors. If not, the named color will be used. If the device does support RGB color, Dataplot will check if an RGB color has been specified. If yes, then that RGB color is used. If not, the named color will be used.

    To see the list of supported named colors (with the associated index number), see

    https://www.itl.nist.gov/div898/software/dataplot/refman1/ch11/homepage.htm

Syntax 1:
    BAR BORDER COLORS <color 1> <color 2> ... <color n>
    where <color 1>, ..., <color n> specify the desired line colors.

    Up to 100 such bar border colors may be specified.

Syntax 2:
    BAR BORDER RGB COLORS <red-1> <green-1> <blue-1> ...
                            <red-n> <green-n> <red-n>
    where <red-1>, <green-1>, <blue-1>, ..., <red-n>, <green-n>, <blue-n> is a list of integer values that specify the desired RGB bar border colors.

    Up to 100 such triplets of color values can be specified.

    To turn off the RGB color, set the values to -1 (any negative value will work). Values greater than 255 will be set to 255.

Examples:
    BAR BORDER COLOR BLACK RED BLUE
    BAR BORDER COLOR GREEN GREEN GREEN
    BAR BORDER COLOR BLACK ALL
    BAR BORDER COLOR ALL BLACK
    BAR BORDER COLOR
    BAR BORDER RGB COLOR 220 109 88 240 220 160
    BAR BORDER RGB COLOR 220 109 88 ALL
Note:
    The BAR BORDER COLOR command with no arguments sets the bar border color to default for all traces. The BAR BORDER COLOR command with the word ALL before or after the specified color assigns that bar border color to all traces; thus BAR BORDER COLOR BLACK ALL or BAR BORDER COLOR ALL BLACK plots bar borders as black for all traces.
Note:
    The BAR, SPIKE, CHARACTER, and LINE switch all work independently of each other. That is, a plot point can be a line, a character, a spike or a bar or any combination of the above.
Default:
    All bar borders are set to black and RGB colors are off
Synonyms:
    None
Related Commands: Applications:
    Presentation Graphics
Implementation Date:
    Pre-1987
    2020/11: Support for RGB color
Program:
     
    LET CARTER = DATA 66 30 11 43 44 41 35 82 54 36
    LET REAGAN = DATA 26 54 84 47 51 51 52 14 36 55
    LET X = DATA 1 2 3 5 6 7 8 10 11 12
    LET X1 = X - 0.22
    LET X2 = X + 0.22
    .
    XLIMITS 1 12
    XTIC OFFSET 1 1
    MAJOR XTIC MARK NUMBER 12
    MINOR XTIC MARK NUMBER 0
    Y1LABEL PERCENT
    YLIMITS 0 100
    MAJOR YTIC MARK NUMBER 11
    MINOR YTIC MARK NUMBER 1
    .
    LINE BLANK BLANK
    BAR ON ON
    BAR WIDTH 0.2 ALL
    BAR BORDER THICKNESS 0.3 ALL
    .
    BAR BORDER COLOR G20 G80
    TITLE DEMONSTRATE BAR BORDER GREYSCALE COLOR
    PLOT CARTER X1 AND
    PLOT REAGAN X2
        

    .
    BAR BORDER COLOR RED BLUE
    TITLE DEMONSTRATE BAR BORDER COLOR
    PLOT CARTER X1 AND
    PLOT REAGAN X2
        

    .
    BAR BORDER COLOR 220 109 88 240 220 160
    TITLE DEMONSTRATE BAR BORDER RGB COLOR
    PLOT CARTER X1 AND
    PLOT REAGAN X2
        

Date created: 01/28/2021
Last updated: 12/11/2023

Please email comments on this WWW page to alan.heckert@nist.gov.