Installation | Syntax| Citation guidelines | Examples | Feedback | Change log
(11 June 2024)
The package can be installed via SSC or GitHub. The GitHub version, might be more recent due to bug fixes, feature updates etc, and may contain syntax improvements and changes in default values. See version numbers below. Eventually the GitHub version is published on SSC.
SSC (v1.1):
ssc install bumpline, replace
GitHub (v1.21):
net install bumpline, from("https://raw.githubusercontent.com/asjadnaqvi/stata-bumpline/main/installation/") replace
The palettes
package is required to run this command:
ssc install palettes, replace
ssc install colrspace, replace
Even if you have these packages installed, please check for updates: ado update, update
.
If you want to make a clean figure, then it is advisable to load a clean scheme. These are several available and I personally use the following:
ssc install schemepack, replace
set scheme white_tableau
You can also push the scheme directly into the graph using the scheme(schemename)
option. See the help file for details or the example below.
I also prefer narrow fonts in figures with long labels. You can change this as follows:
graph set window fontface "Arial Narrow"
The syntax for the latest version is as follows:
bumpline y x [if] [in], by(varname)
[ top(num) select(any|last) smooth(num) palette(str) labcond(str) offset(num)
lwidth(str) labsize(str) xlabsize(str) ylabsize(str) xlabangle(str)
msymbol(str) msize(str) mlabsize(str) mlwidth(str) wrap(num) * ]
See the help file help bumpline
for details.
The most basic use is as follows:
bumparea y x, by(group)
where y
is a numerical variable we want to plot and x
is the time dimension. Both need to be numeric. The by()
is the category variable.
Software packages take countless hours of programming, testing, and bug fixing. If you use this package, then a citation would be highly appreciated. Suggested citations:
in BibTeX
@software{bumpline,
author = {Naqvi, Asjad},
title = {Stata package ``bumpline''},
url = {https://github.com/asjadnaqvi/stata-bumpline},
version = {1.21},
date = {2024-06-11}
}
or simple text
Naqvi, A. (2024). Stata package "bumpline" version 1.21. Release date 11 June 2024. https://github.com/asjadnaqvi/stata-bumpline.
or see SSC citation (updated once a new version is submitted)
Load the Stata dataset
use "https://github.com/asjadnaqvi/stata-bumpline/blob/main/data/owid_emissions_reduced.dta?raw=true", clear
drop if iso_code==""
// keep a random set of years
keep if inlist(year, 1990, 1992, 1995, 2000, 2005, 2007, 2010, 2013, 2016, 2019)
Let's test the bumpline
command:
bumpline total_ghg year, by(country)
bumpline total_ghg year, by(country) top(10) ///
xsize(2) ysize(1)
bumpline total_ghg year, by(country) select(last) top(10) ///
xsize(2) ysize(1)
bumpline total_ghg year, by(country) top(10) ///
smooth(1) xsize(2) ysize(1)
bumpline total_ghg year, by(country) top(10) ///
smooth(8) xsize(2) ysize(1)
bumpline total_ghg year, by(country) top(10) ///
top(15) xsize(2) ysize(1)
bumpline total_ghg year, by(country) top(10) ///
top(20) xsize(2) ysize(1)
bumpline total_ghg year, by(country) top(10) ///
palette(CET L20) xsize(2) ysize(1)
bumpline total_ghg year, by(country) top(10) ///
palette(viridis) xsize(2) ysize(1)
bumpline total_ghg year, by(country) top(10) ///
palette(reds, reverse) xsize(2) ysize(1)
bumpline total_ghg year, by(country) top(10) ///
lw(1.4) xsize(2) ysize(1)
bumpline total_ghg year, by(country) top(10) ///
lw(1.2) msym(square) msize(1.3) xsize(2) ysize(1)
bumpline total_ghg year, by(country) ///
smooth(4) top(30) palette(CET L19, reverse) ///
lw(0.5) msym(square) mlwid(0.3) msize(1.1) xlaba(45) offset(20) ///
title("Top 10 countries by annual GHG emissions", size(6)) ///
note("Source: OWID.") ///
xsize(2) ysize(1)
Please open an issue to report errors, feature enhancements, and/or other requests.
v1.21 (11 Jun 2024)
- Added
wrap()
for label wrapping. - Several code improvements for faster rendering.
v1.2 (10 Feb 2024)
- Fixes to how colors are assigned.
- Minor cleanups.
v1.1 (28 May 2023)
- Fixed
if
andin
conditions that were not passing correctly. - Added checks for duplicates.
- Removed graph grids.
- Added
mlabsize()
for smaller labels. - Minor code cleanups, updates to defaults, and help file.
v1.0 (10 Apr 2023)
- Public release.