https://github.com/asjadnaqvi/stata-bumpline
A Stata package for bump line charts
https://github.com/asjadnaqvi/stata-bumpline
bump line package stata
Last synced: 7 months ago
JSON representation
A Stata package for bump line charts
- Host: GitHub
- URL: https://github.com/asjadnaqvi/stata-bumpline
- Owner: asjadnaqvi
- License: mit
- Created: 2023-04-09T23:04:32.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-17T16:44:16.000Z (8 months ago)
- Last Synced: 2025-03-10T06:34:48.727Z (7 months ago)
- Topics: bump, line, package, stata
- Language: Stata
- Homepage:
- Size: 15.2 MB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Citation: CITATION.cff
Awesome Lists containing this project
README
     
[Installation](#Installation) | [Syntax](#Syntax)| [Citation guidelines](#Citation-guidelines) | [Examples](#Examples) | [Feedback](#Feedback) | [Change log](#Change-log)
---
# bumpline v1.4
(16 Feb 2025)
## Installation
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.3**):
```
ssc install bumpline, replace
```
GitHub (**v1.4**):
```
net install bumpline, from("https://raw.githubusercontent.com/asjadnaqvi/stata-bumpline/main/installation/") replace
```
Please make sure that you have the latest versions of the following packages installed:
```
ssc install palettes, replace
ssc install colrspace, replace
ssc install graphfunctions, replace
```
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"
```
## Syntax
The syntax for the latest version is as follows:
```stata
bumpline y x [if] [in] [weight], by(varname)
[ top(num) select(any|last) smooth(num) palette(str) colorby(var) labcond(str) offset(num)
dropother wrap(num) stat(mean|sum) lwidth(str) lpattern(str)
msize(str) msymbol(str) mcolor(str) mlcolor(str) mlwidth(str)
labsize(str) labcolor(str) labangle(str) labposition(str) labgap(str)
olcolor(str) olwidth(str) olpattern(str)
omcolor(str) omsymbol(str) omsize(str) omlcolor(str) omlwidth(str)
olabsize(str) olabcolor(str) olabangle(str) olabposition(str) olabgap(str)
ylabsize(str) * ]
```
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.
## Citation guidelines
Software packages take countless hours of programming, testing, and bug fixing. If you use this package, then a citation would be highly appreciated.
The [SSC citation](https://ideas.repec.org/c/boc/bocode/s459195.html) is recommended. Please note that the GitHub version might be newer than the SSC version.
## Examples
Load the Stata dataset
```stata
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)
```
### Smooth
```
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)
```
### top lists
```
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) dropother ///
top(20) xsize(2) ysize(1)
```
### Palettes
```
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)
```
### Lines and symbols
```
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)
```
```stata
bumpline total_ghg year, by(country) top(12) ///
smooth(4) palette(CET L04) ///
lw(0.8) msym(square) mlwid(0.3) msize(1) offset(20) ///
title("Top 30 countries by annual GHG emissions", size(6)) ///
note("Source: OWID.") ///
xsize(4) ysize(2)
```
```stata
bumpline total_ghg year, by(country) top(12) ///
smooth(4) palette(CET L04) ///
lw(0.8) msym(square) mlwid(0.3) msize(1) offset(20) ///
title("Top 30 countries by annual GHG emissions", size(6)) ///
note("Source: OWID.") ///
xsize(4) ysize(2)
```
### v1.3
```stata
graph set window fontface "Abel"
bumpline total_ghg year, by(country) ///
smooth(4) top(20) palette(CET L04) ///
lw(0.5) msym(square) mlwid(0.3) msize(0.4) xlabel(, angle(90)) offset(20) labsize(2) ///
title("{fontface Merriweather Bold:Top 30 countries by annual GHG emissions}", size(6)) ///
note("Source: Our World in Data. bumpline package. @AsjadNaqvi.") ///
xsize(8) ysize(5)
```
```stata
use "https://github.com/asjadnaqvi/stata-bumpline/blob/main/data/owid_emissions_reduced.dta?raw=true", clear
drop if iso_code==""
drop if year < 1995
levelsof year if !missing(gdp)
bumpline total_ghg year [aw = gdp], by(country) wrap(20) dropother ///
smooth(8) top(16) palette(CET L20, reverse) labc(white) ///
lw(0.8) msym(square) mlwid(0.3) msize(0.5) xlabel("`r(levels)'", angle(90) labsize(2)) offset(10) labsize(2.6) ///
title("{fontface Merriweather Bold:Top 30 countries by annual GHG emissions (GDP weighted)}", size(6)) ///
note("Source: Our World in Data. bumpline package.", size(1.6)) ///
xsize(3) ysize(1) scheme(neon)
```
### v1.4
Define a custom color variable:
```stata
gen focus = .
replace focus = 1 if inlist(country, "China", "Japan", "Indonesia")
replace focus = 2 if inlist(country, "United States", "Canada", "Brazil")
```
Pass it to the command and also control the colors:
```stata
bumpline total_ghg year, by(country) top(10) xsize(3) ysize(1) colorby(focus) palette(eltblue orange gs13) dropother
```
## Feedback
Please open an [issue](https://github.com/asjadnaqvi/stata-bumpline/issues) to report errors, feature enhancements, and/or other requests.
## Change log
**v1.4 (16 Fen 2025)**
- `colorby()` option added.
- Minor improvements to defaults and the syntax.
**v1.3 (22 Oct 2024)**
- `wrap()` ported to `graphfunctions`.
- Weights are now allowed.
- Added options `stat(mean)` and `stat(sum)` (default) for collapsing the data. If the data has duplicate values, collapse will be used and a warning message will be displayed.
- Added `dropther` to drop `by()` categories that start and end in the middle.
- All possible line, marker, symbol, other line, other marker, other symbol options added for maximum control.
- Removed x-axis options. Use the standard `xlabel()` with standard options. This provides the most control over the axis.
- Major code clean up.
**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` and `in` 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.