Package: directlabels 2026.8.28

directlabels: Direct Labels for Multicolor Plots

An extensible framework for automatically placing direct labels onto multicolor 'lattice' or 'ggplot2' plots. Label positions are described using Positioning Methods which can be re-used across several different plots. There are heuristics for examining "trellis" and "ggplot" objects and inferring an appropriate Positioning Method.

Authors:Toby Dylan Hocking [aut, cre]

# Install 'directlabels' in R:

install.packages('directlabels', repos = c('https://tdhock.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/tdhock/directlabels/issues

Uses libs:

c++– GNU Standard C++ Library v3

Datasets:

iris.l1.cluster - Clustering of the iris data with the l1 clusterpath
LOPART.ROC - ROC curve for LOPART algorithm and competitors
LOPART100 - Labeled Optimal Partitioning (LOPART) results
normal.l2.cluster - Clustering of some normal data in 2d with the l2 clusterpath
odd_timings - Odd timings
projectionSeconds - Timings of projection algorithms
prostate - Prostate Cancer Data
SegCost - Cost of segmentation models
svmtrain - False positive rates from several 1-SVM models

On CRAN:

cpp

11.16 score 88 stars 16 packages 2.0k scripts 8.7k downloads 2 mentions 103 exports 2 dependencies

Last updated from:8baad0f219. Checks:15 OK. Indexed: yes.

Target	Result	Time
linux-devel-arm64	OK	154
linux-devel-x86_64	OK	194
source / vignettes	OK	368
linux-release-arm64	OK	158
linux-release-x86_64	OK	150
macos-release-arm64	OK	135
macos-release-x86_64	OK	351
macos-oldrel-arm64	OK	134
macos-oldrel-x86_64	OK	197
windows-devel-arm64	OK	250
windows-devel-x86_64	OK	190
windows-release-arm64	OK	258
windows-release-x86_64	OK	132
windows-oldrel-x86_64	OK	149
wasm-release	OK	134

Exports:ahull.grid ahull.points aligned_labels_dp angled.boxes angled.endpoints apply.method big.boxes bottom.pieces bottom.points bottom.polygons bumpup calc.borders calc.boxes check.for.columns chull.grid chull.points default.ahull default.picker defaultpf.ggplot defaultpf.trellis direct.label direct.label.ggplot direct.label.trellis dl.add dl.combine dl.env dl.jitter dl.move dl.summarize dl.trans dlcompare dldoc dlgrob draw.polygons draw.rects drawDetails.dlgrob edges.to.outside empty.grid enlarge.box extract.plot extract.posfun extreme.grid extreme.points far.from.others.borders filltemplate first.points first.polygons first.qp gapply gapply.fun geom_dl get.means getLegendVariables ignore.na in1box in1which inside isoreg_dp isoreg_dp_interface label.endpoints label.pieces lasso.labels last.points last.polygons last.qp lattice.translators left.points left.polygons legends2hide lines2 make.tiebreaker maxvar.points maxvar.qp merge_recurse midrange only.unique.vals outside.ahull outside.chull panel.superpose.dl pkgFun polygon.method project.onto.segments qp.labels reduce.cex reduce.cex.lr reduce.cex.tb rhtmlescape right.points right.polygons smart.grid static.labels top.bumptwice top.bumpup top.pieces top.points top.polygons top.qp uselegend.ggplot uselegend.trellis vertical.qp visualcenter xlimits ylimits

Dependencies:data.table Rcpp

examples

Rendered fromexamples.Rmdusingknitr::knitr

Last update: 2026-08-27
Started: 2020-06-25

Citation

Development and contributors

Readme and manuals

Help Manual

Help page	Topics
ahull grid	ahull.grid
ahull points	ahull.points
aligned labels dp	aligned_labels_dp
angled boxes	angled.boxes
angled endpoints	angled.endpoints
Apply a Positioning Method	apply.method
big boxes	big.boxes
bottom pieces	bottom.pieces
bottom points	bottom.points
bottom polygons	bottom.polygons
bumpup	bumpup
calc borders	calc.borders
calc boxes	calc.boxes
check for columns	check.for.columns
chull grid	chull.grid
chull points	chull.points
default ahull	default.ahull
default picker	default.picker
defaultpf ggplot	defaultpf.ggplot
defaultpf trellis	defaultpf.trellis
Direct labels for color decoding	direct.label directlabels
direct label ggplot	direct.label.ggplot
direct label trellis	direct.label.trellis
dl add	dl.add
Combine output of several methods	dl.combine
dl env	dl.env
dl jitter	dl.jitter
Manually move a direct label	dl.move
dl summarize	dl.summarize
Direct label data transform	dl.trans
Direct label comparison plot	dlcompare
Make directlabels documentation	dldoc
dlgrob	dlgrob
draw polygons	draw.polygons
draw rects	draw.rects
drawDetails dlgrob	drawDetails.dlgrob
edges to outside	edges.to.outside
empty grid	empty.grid
enlarge box	enlarge.box
Extract plot and definition for documentation	extract.plot
Extract Positioning Method for documentation	extract.posfun
extreme grid	extreme.grid
extreme points	extreme.points
far from others borders	far.from.others.borders
filltemplate	filltemplate
first bumpup	first.bumpup
first points	first.points
first polygons	first.polygons
first qp	first.qp
gapply	gapply
Direct label groups independently	gapply.fun
geom dl	geom_dl
GeomDl	GeomDl
get means	get.means
getLegendVariables	getLegendVariables
ignore na	ignore.na
in1box	in1box
in1which	in1which
inside	inside
Clustering of the iris data with the l1 clusterpath	iris.l1.cluster
isoreg dp	isoreg_dp isoreg_dp_interface
label endpoints	label.endpoints
label pieces	label.pieces
lasso labels	lasso.labels
last bumpup	last.bumpup
last points	last.points
last polygons	last.polygons
last qp	last.qp
lattice translators	lattice.translators
left points	left.points
left polygons	left.polygons
legends2hide	legends2hide
lines2	lines2
ROC curve for LOPART algorithm and competitors	LOPART.ROC
Labeled Optimal Partitioning (LOPART) results	LOPART100
make tiebreaker	make.tiebreaker
maxvar points	maxvar.points
maxvar qp	maxvar.qp
merge recurse	merge_recurse
midrange	midrange
Clustering of some normal data in 2d with the l2 clusterpath	normal.l2.cluster
Odd timings	odd_timings
only unique vals	only.unique.vals
outside ahull	outside.ahull
outside chull	outside.chull
panel superpose dl	panel.superpose.dl
pkgFun	pkgFun
polygon method	polygon.method
Built-in Positioning Methods for direct label placement	positioning.functions positioning.methods
project onto segments	project.onto.segments
Timings of projection algorithms	projectionSeconds
Prostate Cancer Data	prostate
Make a Positioning Method for non-overlapping lineplot labels	qp.labels
reduce cex	reduce.cex
reduce cex lr	reduce.cex.lr
reduce cex tb	reduce.cex.tb
rhtmlescape	rhtmlescape
right points	right.points
right polygons	right.polygons
Cost of segmentation models	SegCost
smart grid	smart.grid
static labels	static.labels
False positive rates from several 1-SVM models	svmtrain
top bumptwice	top.bumptwice
top bumpup	top.bumpup
top pieces	top.pieces
top points	top.points
top polygons	top.polygons
top qp	top.qp
uselegend ggplot	uselegend.ggplot
uselegend trellis	uselegend.trellis
vertical qp	vertical.qp
visualcenter	visualcenter
xlimits	xlimits
ylimits	ylimits