https://github.com/asjadnaqvi/stata-bumparea
A Stata package for ribbon plots.
https://github.com/asjadnaqvi/stata-bumparea
area bump package ribbon stata
Last synced: 7 months ago
JSON representation
A Stata package for ribbon plots.
- Host: GitHub
- URL: https://github.com/asjadnaqvi/stata-bumparea
- Owner: asjadnaqvi
- License: mit
- Created: 2023-04-09T23:04:53.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-01-08T09:30:53.000Z (9 months ago)
- Last Synced: 2025-03-10T06:34:48.667Z (7 months ago)
- Topics: area, bump, package, ribbon, stata
- Language: Stata
- Homepage:
- Size: 8.9 MB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
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)
---
# bumparea v1.4
(21 Oct 2024)
## 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.4**):
```
ssc install bumparea, replace
```
GitHub (**v1.4**):
```
net install bumparea, from("https://raw.githubusercontent.com/asjadnaqvi/stata-bumparea/main/installation/") replace
```
The following packages are required for this command:
```
ssc install palettes, replace
ssc install colrspace, replace
ssc install graphfunctions, 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
```
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
bumparea y x [if] [in] [weight], by(varname)
[ top(num) dropother smooth(num) palette(str) labcond(str) offset(num) alpha(num)
lcolor(str) lwidth(str) percent format(fmt) recenter(mid|top|bot) colorby(name) colorvar(var) colother(str)
wrap(num) labsize(str) labcolor(str) labangle(str) labgap(str) labprop labscale(num) * ]
```
See the help file `help bumparea` for details.
The most basic use is as follows:
```stata
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. Suggested citations:
*in BibTeX*
```
@software{bumparea,
author = {Naqvi, Asjad},
title = {Stata package ``bumparea''},
url = {https://github.com/asjadnaqvi/stata-bumparea},
version = {1.4},
date = {2024-10-21}
}
```
*or simple text*
```
Naqvi, A. (2024). Stata package "bumparea" version 1.4. Release date 21 October 2024. https://github.com/asjadnaqvi/stata-bumparea.
```
*or see [SSC citation](https://ideas.repec.org/c/boc/bocode/s459196.html) (updated once a new version is submitted)*
## Examples
Load the Stata dataset
```stata
use "https://github.com/asjadnaqvi/stata-bumparea/blob/main/data/owid_emissions_reduced.dta?raw=true", clear
drop if iso_code==""
keep if year >= 1990
```
Let's test the `bumparea` command:
```
bumparea total_ghg year, by(country)
```
```stata
bumparea total_ghg year, by(country) top(10) ///
xsize(2) ysize(1)
```
### percent
```stata
bumparea total_ghg year, by(country) top(10) ///
percent labs(2) xsize(2) ysize(1)
```
### dropother
```
bumparea total_ghg year, by(country) top(10) ///
dropother labs(2) xsize(2) ysize(1)
```
```
bumparea total_ghg year, by(country) top(10) ///
dropother percent labs(2) xsize(2) ysize(1)
```
```stata
bumparea total_ghg year, by(country) ///
top(12) dropother labs(2) xsize(2) ysize(1)
```
### smooth
```stata
bumparea total_ghg year, by(country) top(10) ///
smooth(1) dropother labs(2) xsize(2) ysize(1)
```
```stata
bumparea total_ghg year, by(country) top(10) ///
smooth(8) dropother labs(2) xsize(2) ysize(1)
```
### recenter
```stata
bumparea total_ghg year, by(country) top(10) ///
recenter(top) dropother labs(2) xsize(2) ysize(1)
```
```stata
bumparea total_ghg year, by(country) top(10) ///
recenter(bot) dropother labs(2) xsize(2) ysize(1)
```
### alpha and lines
```stata
bumparea total_ghg year, by(country) top(10) ///
lc(black) lw(0.03) dropother labs(2) xsize(2) ysize(1)
```
### colors
```stata
bumparea total_ghg year, by(country) top(10) ///
lc(black) lw(0.03) palette(reds, reverse) dropother labs(2) xsize(2) ysize(1)
```
```stata
bumparea total_ghg year, by(country) top(10) ///
lc(black) lw(0.03) palette(viridis) dropother labs(2) xsize(2) ysize(1)
```
```stata
bumparea total_ghg year, by(country) top(10) ///
lc(black) lw(0.03) palette(CET C6) alpha(100) dropother labs(2) xsize(2) ysize(1)
```
```stata
bumparea total_ghg year, by(country) top(10) ///
lc(black) lw(0.03) palette(CET C6) alpha(50) dropother labs(2) xsize(2) ysize(1)
```
### all together
```stata
bumparea total_ghg year, by(country) smooth(6) palette(CET L20) labs(2) ///
top(10) dropother recenter(mid) alpha(90) lw(0.15) xlabel(1990(1)2019, angle(45)) ///
title("Top 10 countries by annual GHG emissions", size(6)) ///
note("Source: OWID.") ///
xsize(2) ysize(1)
```
### custom x axis
```stata
use "https://github.com/asjadnaqvi/stata-bumparea/blob/main/data/owid_emissions_reduced.dta?raw=true", clear
drop if iso_code==""
keep if inlist(year, 1990, 1993, 1997, 2000, 2005, 2007, 2010, 2014, 2017, 2019)
bumparea total_ghg year, by(country) smooth(8) palette(CET L08) labs(2) ///
top(15) dropother recenter(mid) alpha(80) lw(0.1) xlabel(1990(1)2019, angle(45)) ///
title("Top 10 countries by annual GHG emissions", size(6)) ///
note("Source: OWID. bumparea package. @AsjadNaqvi") ///
xsize(2) ysize(1)
```
### v1.2 options
```stata
bumparea total_ghg year, by(country) top(10) ///
xsize(2) ysize(1)
```
```stata
bumparea total_ghg year, by(country) top(10) colother(gs6) ///
xsize(2) ysize(1)
```
```stata
bumparea total_ghg year, by(country) top(10) colorby(name) ///
xsize(2) ysize(1
```
```stata
cap drop cats
gen cats = .
replace cats = 1 if inlist(country, "Indonesia", "Japan")
replace cats = 2 if inlist(country, "United States", "Canada")
replace cats = 3 if inlist(country, "Iran", "Saudi Arabia")
replace cats = 4 if inlist(country, "China")
bumparea total_ghg year, by(country) top(10) colorvar(cats) ///
xsize(2) ysize(1) colo(white)
```
### v1.4 options
```stata
bumparea total_ghg year, by(country) top(10) dropother xsize(2) ysize(1) format(%8.1f) offset(10) labprop labc(red) laba(45) ///
xlabel(1990(1)2019, labsize(2) angle(45) )
```
```stata
bumparea total_ghg year [aw = gdp], by(country) top(10) dropother xsize(2) ysize(1) format(%10.0fc) offset(10) labprop ///
xlabel(1990(1)2018, labsize(2) angle(90) )
```
```stata
levelsof year if !missing(gdp)
bumparea total_ghg year [aw = gdp], by(country) wrap(20) dropother lc(black) labprop labc(white) ///
smooth(8) top(15) palette(CET L20, reverse) ///
lw(0.1) 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)
```
## Feedback
Please open an [issue](https://github.com/asjadnaqvi/stata-bumparea/issues) to report errors, feature enhancements, and/or other requests.
## Change log
**v1.4 (21 Oct 2024)**
- Weights are supported.
- `wrap()` ported to `graphfunctions`.
- All x-axis options removed. Use standard `xlabel()` syntax.
- Added `labgap()`, `labcolor()`, `labangle()` for more flexiblity with ribbon labels.
- Added `labprop` for proportional labels. Can be rescaled using `labscale()`.
- Several bug fixes.
**v1.31 (11 Jun 2024)**
- Added `wrap()` to wrap labels.
- Several code updates.
**v1.3 (26 May 2024)**
- The command now sums and fills missing categories.
**v1.21 (15 Jan 2024)**
- Minor fixes.
- Updates to defaults.
**v1.2 (25 Jul 2023)**
- Several new options added: `colorby(name)` to alpha sort the colors, `colorby(var)` to color using a custom `var`, `colother()` to define the color of the "Other" category.
- A bug with labels fixed (found by Marc Kaulisch)
- Better checks for `by()` variables.
- `saving()` option added.
- Several small bug fixes and code optimizations.
**v1.11 (06 Jun 2023)**
- Minor bug fixes, checks, enhancements.
**v1.1 (28 May 2023)**
- Fixed `if` and `in` conditions that were not passing correctly.
- Added checks for duplicates.
- Minor code cleanups, updates to defaults, and help file.
**v1.0 (10 Apr 2023)**
- Public release.