R Observatory: Metrics for statebins version 1.4.0

Balamuta, James Joseph

doi:10.5281/zenodo.21843040

statebins

1.4.0Package record

Create United States Uniform Cartogram Heatmaps

2packages depend

9Kdownloads / year

48.7%test coverage

8/13flavors OK

Overview

About

Maintained by Bob RudisCRAN page ↗GitLab ↗Issues ↗

The 'cartogram' heatmaps generated by the included methods are an alternative to choropleth maps for the United States and are based on work by the Washington Post graphics department in their report on "The states most threatened by trade" (http://www.washingtonpost.com/wp-srv/special/business/states-most-threatened-by-trade/). "State bins" preserve as much of the geographic placement of the states as possible but have the look and feel of a traditional heatmap. Functions are provided that allow for use of a binned, discrete scale, a continuous scale or manually specified colors depending on what is needed for the underlying data.

Install

R (CRAN)pak (dev)Ubuntu (r2u)Fedora (COPR)openSUSE (OBS)

install.packages("statebins", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("hrbrmstr/statebins")

Development version from hrbrmstr/statebins. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-statebins

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled. We list this channel from recorded r2u download activity rather than from a live index of the repository, so treat it as last known rather than guaranteed.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-statebins

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-statebins

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed). We list this channel from recorded autoCRAN download activity rather than from a live index of the repository, so treat it as last known rather than guaranteed.

Health

CRAN checks

5NOTE8OK

Check messages

NOTER code for possible problemsr-devel-linux-x86_64-debian-clang, r-devel-linux-x86_64-debian-gcc, r-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc, r-devel-windows-x86_64

Found calls to structure() using deprecated special names:
  statebins/R/aaa.R (.Names: 1)
'.Names' should be changed to 'names'.

NOTECRAN incoming feasibilityr-devel-linux-x86_64-debian-clang, r-devel-linux-x86_64-debian-gcc

Maintainer: ‘Bob Rudis <bob@rud.is>’

The BugReports field in DESCRIPTION has
  https://gitlab.com/hrbrmstr/statebins/issues
which should likely be
  https://gitlab.com/hrbrmstr/statebins/-/issues
instead.

CRAN check page ↗

Slowest check: 1.5 min · r-oldrel-windows-x86_64

Status changes

NOTE8 OK, 5 NOTENow
NOTE11 OK, 2 NOTE2026-07-16
OK14 OK2026-03-10

Advisories

none known

How this is measured·How advisories are found

Documentation

In release 1.4.0

READMENoVignettesNoNEWSNoCitation fileNoWebsitenot declared in DESCRIPTION

Help pages: 5includes a package overview page
Examples that run: 50%1 run in a plain check · 1 never run
Exported functions with examples: 67%
Documented parameters: 63%
Return-value docs: 33%
Help pages citing references: 0%

How these are measured

Downloads

9K

CRAN downloads in the past year

Rank #4,587 · ~25/day · ~748/mo

Releases R versions

Daily download trend is not available in this view yet.

77030 days

1.8K90 days

9K1 year

Compare downloads with other packages →

Also on234 r2u6 autocran729 conda_forge132 c2d4u

How downloads are counted

Repository

gitlab.com/hrbrmstr/statebins ↗

Responsiveness

not measured

How these are measured

PracticesBeta

Repository gitlab.com/hrbrmstr/statebins is linked, but repository-practices checks have not run for it yet. Checks are GitHub-only for now.

How this is detected·Detection ruleset v3 (2026-09-26)

Dependencies

Declared dependencies

6 external dependencies (excludes base and recommended)

Installing statebins adds 17 packages (7 with compiled code, 14 MB of source tarballs). Heaviest: ggplot2 6.0 MB, isoband 1.5 MB, farver 1.2 MB.

Depends (1)

R >= 3.5.0

Imports (3)

ggplot2 scalesgrid

LinkingTo (0)

none

Suggests (4)

viridis RColorBrewer covr tinytest

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

2direct

0indirect

Imports 2

Depends, Imports or LinkingTo, most downloaded first

patterncausality geoheatmap

How these are counted

Code & Tests

Datasets

People & History

People (5)

Bob Rudis

Author, Maintainer since 1.0 (2014)

Brian Adams

Contributor · added in 1.4.0

theme testing & feedback

Harold Gil

Contributor · added in 1.4.0

fix for show.guide

Mathew Kiang

Contributor · added in 1.4.0

Minor fix for NA handling

Thomas Wood

Contributor · added in 1.4.0

Significant suggestions & testing that made new features possible

Releases (3)

Pick two releases to compare their code metrics.

R
R 4.6.0 released · 2026-04-24
R
R 4.5.0 released · 2025-04-11
R
R 4.4.0 released · 2024-04-24
R
R 4.3.0 released · 2023-04-21
R
R 4.2.0 released · 2022-04-22
R
R 4.1.0 released · 2021-05-18
1.4.0Latest
record
2020-07-09 · current release · diff ↗ ·
removed 2 exports
statebins_continuous, statebins_manual

added 3 exports
GeomStatebins, geom_statebins, theme_statebins
R
R 4.0.0 released · 2020-04-24
R
R 3.6.0 released · 2019-04-26
R
R 3.5.0 released · 2018-04-23
R
R 3.4.0 released · 2017-04-21
R
R 3.3.0 released · 2016-05-03
1.2.2
record
2015-12-21 · diff ↗ ·
added 1 export
statebins_manual
R
R 3.2.0 released · 2015-04-16
1.0
record
2014-08-27
R
R 3.1.0 released · 2014-04-10

Package metadata

First published: 2014-08-27
Total releases: 3 / 12 yrs
License: MIT + file LICENSE OSI
Minimum R: ≥ 3.5.0
Bundled data: 0.7 KB / 1 file
Download size: 858 KB

Appears in task views

Analysis of Spatial Data

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("statebins")

Format

Rudis, B., Adams, B., Gil, H., Kiang, M., & Wood, T. (2020). statebins: Create United States Uniform Cartogram Heatmaps (Version 1.4.0) [Computer software]. https://doi.org/10.32614/CRAN.package.statebins

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

Format

APA

Balamuta, J. J. (2026). R Observatory: Metrics for statebins version 1.4.0 [Data set]. HJJB, LLC. Data release v2026-10-22. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-22, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →