*! version 0.0.1 22may2026

Title

upset_barchart_options -- Options for controlling the display of bar
charts in upset_plot.

Syntax

upset_barchart_options control the appearance of set and intersection bar
charts created through upset_plot; see upset_plot.

upset_barchart_options

off suppress the bar chart

gap(#) control the margin between the grid and bar chart

ytitle(title_options) specify the y-axis title

xscale(scale_options) control the appearance of the x-axis

yscale(scale_options) control the appearance of the y-axis

ylabel(label_rule_or_values) control the y-axis ticks and labels

ysize(#) height of the bar chart

blabel(blabel_rule_or_values) control bar label content and appearance

where title_options is

"string" ["string" [ ...]]
[, title_suboptions]

string must be enclosed in quotation marks and may contain Unicode
characters and SMCL tags to render mathematical symbols, italics, etc.; see
text.

title_suboptions

placement:(compassdirstyle) where to place the title

orientation:(orientationstyle) whether to display title vertically or horizontally

titlegap:(#) margin between axis and title

scale_options

off suppress display of axis line

range(numlist) expand the axis range

lstyle:(linestyle) overall style of axis line

lcolor:(colorstyle) color and opacity of axis line

lwidth:(linewidthstyle) thickness of axis line

lpattern:(linepatternstyle) pattern of axis line (solid, dashed, etc.)

where label_rule_or_values is defined as:

[label_rule] [numlist]
[, label_suboptions]

You may not specify both label_rule and numlist.

label_rule

## approximately # nice values

#(#)# specified range with uniform steps

minmax minimum and maximum values

none suppress labels

label_suboptions

[no]ticks display or suppress ticks

[no]labels display or suppress labels

format(%fmt) format values per %fmt

angle(anglestyle) angle the labels

labgap(size) labels: margin between tick and label

labstyle(textstyle) labels: overall style

labsize:(#) labels: text size

labcolor:(colorstyle) labels: color and opacity of text

tlength:(#) ticks: length

tposition:(outside|crossing|inside:) ticks: position/direction

tlstyle:(linestyle) ticks: overall line style

tlwidth:(linewidthstyle) ticks: thickness of line

tlcolor:(colorstyle) ticks: color and opacity of line

[no]grid grid: display or suppress grid lines

glstyle:(linestyle) grid: overall line style

glwidth:(linewidthstyle) grid: line thickness

glcolor:(colorstyle) grid: color and opacity of line

glpattern:(linepatternstyle) grid: line pattern

where blabel_rule_or_values is defined as:

blabel_rule
[, blabel_suboptions]

blabel_rule

total label each bar with its overall frequency

bar label each segment with its frequency

cumbar label each segment with its cumulative frequency

blabel_suboptions

position:(outside|inside|base|center) placement of label relative to bar segment

gap(size) distance from position()

format(%fmt) format labels

orientation:(orientationstyle) display bar labels vertically or horizontally

size:(textsizestyle) size of bar labels

color:(colorstyle) color and opacity of bar labels

percentage display percentages instead of frequencies

Description

upset_barchart_options control the appearance of the intersection and set
bar charts within upset_plot.

upset_barchart_options resembles standard twoway axis and
labeling options (see twoway_options), but is implemented independently
within upset_plot. Due to this, several twoway_options features are not
available in upset_barchart_options, and others have modified syntax (e.g.,
ytitle() titles needing to be enclosed in quotation marks).

Remarks

Remarks are presented under the following headings:

Default values
Tick positioning
Label positioning

Default values

In some instances, options' default values vary by whether the caller was
intopts() or setopts(). The default values in such cases are given
below in #rs (see size):

upset_barchart_options label_suboptions

caller gap(#) ysize(#) labgap(#) tlength(#)

intopts() 0.1 3.0 0.020 0.025

setopts() 0.2 0.5 0.048 0.060

Tick positioning

Within ylabel(), tposition() controls where the ticks will be placed:

tposition(outside), the default, places ticks wholly outside the bar chart region.

tposition(crossing) places ticks half-in, half-out of the bar chart region.

tposition(inside) places ticks wholly inside the bar chart region.

Label positioning

Within blabel(), position() controls where the bar labels will be placed:

position(outside), the default, places labels just above the bar.

position(inside) places labels inside the bar at the top.

position(base) places labels inside the bar at the bar's base.

position(center) places labels inside the bar at the bar's center.

Authors

Dylan Taylor, London School of Hygiene and Tropical Medicine, London

dylanjamestaylor00@gmail.com