Package 'packageRank' reference manual

Title:	Computation and Visualization of Package Download Counts and Percentiles
Description:	Compute and visualize the cross-sectional and longitudinal number and rank percentile of package downloads from Posit/RStudio's CRAN mirror.
Authors:	lindbrook [aut, cre]
Maintainer:	lindbrook <[email protected]>
License:	GPL (>= 2)
Version:	0.9.1.9000
Built:	2024-06-29 01:21:03 UTC
Source:	https://github.com/lindbrook/packagerank

packageRank

Description

Compute and Visualize Package Download Counts and Percentiles.

Details

Download counts via cranDownloads().
Rank percentiles of download counts via packageRank() and packageLog().
Download count inflation filters.
Availability of results via logInfo().
Data fixes for early logs and a later instance of double/triple counting of R application downloads.
Note Sunday and Wednesday spikes in Windows R Application Nov 2022 - Mar 2023.
Country code top-level domains, memoization and internet connection timeout problem.

Author(s)

Maintainer: lindbrook [email protected]

Count Total CRAN Download.

Description

From RStudio's CRAN Mirror http://cran-logs.rstudio.com/

Usage

annualDownloads(start.yr = 2013, end.yr = 2023)
annualDownloads(start.yr = 2013, end.yr = 2023)

Arguments

`start.yr`	Numeric or Integer.
`end.yr`	Numeric or Integer.

Note

A way around Gateway Timeout (HTTP 504). This takes a while since it computes each year separately.s

Annual/monthly package downloads from Bioconductor.

Description

Annual/monthly package downloads from Bioconductor.

Usage

bioconductorDownloads(packages = NULL, from = NULL, to = NULL,
  when = NULL, unit.observation = "month")
bioconductorDownloads(packages = NULL, from = NULL, to = NULL,
  when = NULL, unit.observation = "month")

Arguments

`packages`	Character. Vector of package names.
`from`	Start date as `yyyy-mm` or `yyyy`.
`to`	End date as `yyyy-mm` or `yyyy`.
`when`	`"last-year"`, or `"year-to-date"` or `"ytd"`.
`unit.observation`	"year" or "month".

Examples

## Not run: 
# all packages
bioconductorDownloads()

# entire history
bioconductorDownloads(packages = "clusterProfiler")

# year-to-date
bioconductorDownloads(packages = "clusterProfiler", when = "ytd")
bioconductorDownloads(packages = "clusterProfiler", when = "year-to-date")

# last 12 months
bioconductorDownloads(packages = "clusterProfiler", when = "last-year")

# from 2015 to current year
bioconductorDownloads(packages = "clusterProfiler", from = 2015)

# 2010 through 2015 (yearly)
bioconductorDownloads(packages = "clusterProfiler", from = 2010, to = 2015,
  unit.observation = "year")

# selected year (yearly)
bioconductorDownloads(packages = "clusterProfiler", from = 2015, to = 2015)

# selected year (monthly)
bioconductorDownloads(packages = "clusterProfiler", from = "2015-01", to = "2015-12")

# June 2014 through March 2015
bioconductorDownloads(packages = "clusterProfiler", from = "2014-06", to = "2015-03")

## End(Not run)
## Not run: 
# all packages
bioconductorDownloads()

# entire history
bioconductorDownloads(packages = "clusterProfiler")

# year-to-date
bioconductorDownloads(packages = "clusterProfiler", when = "ytd")
bioconductorDownloads(packages = "clusterProfiler", when = "year-to-date")

# last 12 months
bioconductorDownloads(packages = "clusterProfiler", when = "last-year")

# from 2015 to current year
bioconductorDownloads(packages = "clusterProfiler", from = 2015)

# 2010 through 2015 (yearly)
bioconductorDownloads(packages = "clusterProfiler", from = 2010, to = 2015,
  unit.observation = "year")

# selected year (yearly)
bioconductorDownloads(packages = "clusterProfiler", from = 2015, to = 2015)

# selected year (monthly)
bioconductorDownloads(packages = "clusterProfiler", from = "2015-01", to = "2015-12")

# June 2014 through March 2015
bioconductorDownloads(packages = "clusterProfiler", from = "2014-06", to = "2015-03")

## End(Not run)

Package download counts and rank percentiles.

Description

From bioconductor

Usage

bioconductorRank(packages = "monocle", date = "2019-01",
  count = "download")
bioconductorRank(packages = "monocle", date = "2019-01",
  count = "download")

Arguments

`packages`	Character. Vector of package name(s).
`date`	Character. Date. yyyy-mm
`count`	Character. "ip" or "download".

Value

An R data frame.

Examples

## Not run: 
bioconductorRank(packages = "cicero", date = "2019-09")

## End(Not run)
## Not run: 
bioconductorRank(packages = "cicero", date = "2019-09")

## End(Not run)

Tabulate package downloads by country.

Description

From RStudio's CRAN Mirror http://cran-logs.rstudio.com/

Usage

countryDistribution(date = NULL, all.filters = FALSE, ip.filter = FALSE,
  small.filter = FALSE, sequence.filter = FALSE, size.filter = FALSE,
  memoization = TRUE, multi.core = FALSE)
countryDistribution(date = NULL, all.filters = FALSE, ip.filter = FALSE,
  small.filter = FALSE, sequence.filter = FALSE, size.filter = FALSE,
  memoization = TRUE, multi.core = FALSE)

Arguments

`date`	Character. Date. "yyyy-mm-dd". NULL uses latest available log.
`all.filters`	Logical. Master switch for filters.
`ip.filter`	Logical.
`small.filter`	Logical. TRUE filters out downloads less than 1000 bytes.
`sequence.filter`	Logical.
`size.filter`	Logical.
`memoization`	Logical. Use memoization when downloading logs.
`multi.core`	Logical or Numeric. `TRUE` uses `parallel::detectCores()`. `FALSE` uses one, single core. You can also specify the number logical cores. Mac and Unix only.

Value

An R data frame.

Tabulate a country's package downloads.

Description

From RStudio's CRAN Mirror http://cran-logs.rstudio.com/

Usage

countryPackage(country = "HK", date = NULL, all.filters = FALSE,
  ip.filter = FALSE, small.filter = FALSE, sequence.filter = FALSE,
  size.filter = FALSE, sort.count = TRUE, memoization = TRUE)
countryPackage(country = "HK", date = NULL, all.filters = FALSE,
  ip.filter = FALSE, small.filter = FALSE, sequence.filter = FALSE,
  size.filter = FALSE, sort.count = TRUE, memoization = TRUE)

Arguments

`country`	Character. country abbreviation.
`date`	Character. Date. "yyyy-mm-dd". NULL uses latest available log.
`all.filters`	Logical. Master switch for filters.
`ip.filter`	Logical.
`small.filter`	Logical. TRUE filters out downloads less than 1000 bytes.
`sequence.filter`	Logical. Set to FALSE.
`size.filter`	Logical. Set to FALSE.
`sort.count`	Logical. Sort by download count.
`memoization`	Logical. Use memoization when downloading logs.

Note

"US" outlier 10 min with all filters!

Counts v. Rank Percentiles for 'cholera' for First Week of March 2020.

Description

Document code for blog graph.

Usage

countsRanks(package = "cholera", size.filter = FALSE)
countsRanks(package = "cholera", size.filter = FALSE)

Arguments

`package`	Character.
`size.filter`	Logical.

Daily package downloads from the RStudio CRAN mirror.

Description

Enhanced implementation of cranlogs::cran_downloads().

Usage

cranDownloads(packages = NULL, when = NULL, from = NULL, to = NULL,
  check.package = TRUE, dev.mode = FALSE, fix.cranlogs = TRUE,
  pro.mode = FALSE)
cranDownloads(packages = NULL, when = NULL, from = NULL, to = NULL,
  check.package = TRUE, dev.mode = FALSE, fix.cranlogs = TRUE,
  pro.mode = FALSE)

Arguments

`packages`	A character vector, the packages to query, or `NULL` for a sum of downloads for all packages. Alternatively, it can also be `"R"`, to query downloads of R itself. `"R"` cannot be mixed with packages.
`when`	`last-day`, `last-week` or `last-month`. If this is given, then `from` and `to` are ignored.
`from`	Start date as `yyyy-mm-dd`, `yyyy-mm` or `yyyy`.
`to`	End date as `yyyy-mm-dd`, `yyyy-mm` or `yyyy`.
`check.package`	Logical. Validate and "spell check" package.
`dev.mode`	Logical. Use validatePackage0() to scrape CRAN.
`fix.cranlogs`	Logical. Use RStudio logs to fix 8 dates with duplicated data in 'cranlogs' results.
`pro.mode`	Logical. Faster but fewer checks/features. Closer to cranlogs::cran_downloads() but with cranDownload()'s plot method.

Examples

## Not run: 
cranDownloads(packages = "HistData")
cranDownloads(packages = "HistData", when = "last-week")
cranDownloads(packages = "HistData", when = "last-month")

# January 7 - 31, 2019
cranDownloads(packages = "HistData", from = "2019-01-07", to = "2019-01-31")

# February through March 2019
cranDownloads(packages = "HistData", from = "2019-02", to = "2019-03")

# 2024 year-to-date
cranDownloads(packages = "HistData", from = 2024)

## End(Not run)
## Not run: 
cranDownloads(packages = "HistData")
cranDownloads(packages = "HistData", when = "last-week")
cranDownloads(packages = "HistData", when = "last-month")

# January 7 - 31, 2019
cranDownloads(packages = "HistData", from = "2019-01-07", to = "2019-01-31")

# February through March 2019
cranDownloads(packages = "HistData", from = "2019-02", to = "2019-03")

# 2024 year-to-date
cranDownloads(packages = "HistData", from = 2024)

## End(Not run)

CRAN inflation plot.

Description

Document code.

Usage

cranInflationPlot(dataset = "october")
cranInflationPlot(dataset = "october")

Arguments

dataset

Character. "october" or "july" for October 2019 or July 2020.

Compute Current Time in Selected Time Zone.

Description

Compute Current Time in Selected Time Zone.

Usage

currentTime(tz = "Australia/Sydney")
currentTime(tz = "Australia/Sydney")

Arguments

`tz`	Character. Local time zone. See OlsonNames() or use Sys.timezone().

Compute Downloads by Country Code.

Description

Compute Downloads by Country Code.

Usage

downloadsCountry(month_cran_log, multi.core = FALSE)
downloadsCountry(month_cran_log, multi.core = FALSE)

Arguments

`month_cran_log`	Object.
`multi.core`	Logical or Numeric. `TRUE` uses `parallel::detectCores()`. `FALSE` uses one, single core. You can also specify the number logical cores to use. Note that due to performance considerations, the number of cores defaults to one on Windows.

Filtered package downloads from the RStudio CRAN mirror (prototype).

Description

ip, small, sequence and size filters.

Usage

filteredDownloads(packages = "HistData", date = NULL, all.filters = TRUE,
  ip.filter = FALSE, small.filter = FALSE, sequence.filter = FALSE,
  size.filter = FALSE, check.package = TRUE, memoization = TRUE,
  multi.core = FALSE)
filteredDownloads(packages = "HistData", date = NULL, all.filters = TRUE,
  ip.filter = FALSE, small.filter = FALSE, sequence.filter = FALSE,
  size.filter = FALSE, check.package = TRUE, memoization = TRUE,
  multi.core = FALSE)

Arguments

`packages`	Character. Vector of package name(s).
`date`	Character. Date. "yyyy-mm-dd". NULL uses latest available log.
`all.filters`	Logical. Master switch for filters.
`ip.filter`	Logical.
`small.filter`	Logical. TRUE filters out downloads less than 1000 bytes.
`sequence.filter`	Logical.
`size.filter`	Logical.
`check.package`	Logical. Validate and "spell check" package.
`memoization`	Logical. Use memoization when downloading logs.
`multi.core`	Logical or Numeric. `TRUE` uses `parallel::detectCores()`. `FALSE` uses one, single core. You can also specify the number logical cores. Mac and Unix only.

Inflation plots of effects of "small" downloads and prior versions for October 2019: 'cholera', 'ggplot2', and 'VR'.

Description

Document code for blog graph.

Usage

inflationPlot(package = "cholera", filter = "size",
  legend.loc = "topleft")
inflationPlot(package = "cholera", filter = "size",
  legend.loc = "topleft")

Arguments

`package`	Character.
`filter`	Character. Size, version, or size and version
`legend.loc`	Character. Location of legend.

Inflation plots of effects of "small" downloads on aggregate CRAN downloads for October 2019 and July 2020.

Description

Document code.

Usage

inflationPlot2(dataset = "october", filter = "small", wed = FALSE,
  subtitle = TRUE, legend.loc = "topleft")
inflationPlot2(dataset = "october", filter = "small", wed = FALSE,
  subtitle = TRUE, legend.loc = "topleft")

Arguments

`dataset`	Character. "october" or "july" for October 2019 or July 2020.
`filter`	Character. "small", "ip", or "ip.small".
`wed`	Logical.
`subtitle`	Logical.
`legend.loc`	Character. Location of legend.

Count number of IP addresses.

Description

From RStudio's CRAN Mirror http://cran-logs.rstudio.com/

Usage

ipCount(date = NULL, memoization = TRUE, sort.count = TRUE)
ipCount(date = NULL, memoization = TRUE, sort.count = TRUE)

Arguments

`date`	Character. Date. "yyyy-mm-dd". NULL uses latest available log.
`memoization`	Logical. Use memoization when downloading logs.
`sort.count`	Logical. Sort by download count.

Unique package download counts by IP address.

Description

From RStudio's CRAN Mirror http://cran-logs.rstudio.com/

Usage

ipDownloads(date = NULL, memoization = TRUE)
ipDownloads(date = NULL, memoization = TRUE)

Arguments

`date`	Character. Date. "yyyy-mm-dd". NULL uses latest available log.
`memoization`	Logical. Use memoization when downloading logs.

Tabulate an IP's package downloads.

Description

From RStudio's CRAN Mirror http://cran-logs.rstudio.com/

Usage

ipPackage(ip = 10, date = NULL, all.filters = FALSE, ip.filter = FALSE,
  small.filter = FALSE, sequence.filter = FALSE, size.filter = FALSE,
  sort.count = TRUE, memoization = TRUE, multi.core = FALSE)
ipPackage(ip = 10, date = NULL, all.filters = FALSE, ip.filter = FALSE,
  small.filter = FALSE, sequence.filter = FALSE, size.filter = FALSE,
  sort.count = TRUE, memoization = TRUE, multi.core = FALSE)

Arguments

`ip`	Numeric. ip_id. Positive integer.
`date`	Character. Date. "yyyy-mm-dd". NULL uses latest available log.
`all.filters`	Logical. Master switch for filters.
`ip.filter`	Logical.
`small.filter`	Logical. TRUE filters out downloads less than 1000 bytes.
`sequence.filter`	Logical.
`size.filter`	Logical.
`sort.count`	Logical. Sort by download count.
`memoization`	Logical. Use memoization when downloading logs.
`multi.core`	Logical or Numeric. `TRUE` uses `parallel::detectCores()`. `FALSE` uses one, single core. You can also specify the number logical cores. Mac and Unix only.

Note

ip = 10 is a tw top-level domain on 2020-07-09.

Compute Local Time from Coordinated Universal Time (UTC/GMT).

Description

Compute Local Time from Coordinated Universal Time (UTC/GMT).

Usage

localTime(date = "2021-1-1", time = "12:00", tz = Sys.timezone())
localTime(date = "2021-1-1", time = "12:00", tz = Sys.timezone())

Arguments

`date`	Character. Date "yyyy-mm-dd".
`time`	Character. Local time "hh:mm" or "hh:mm:ss".
`tz`	Character. Local time zone. See OlsonNames() or use Sys.timezone().

Compute Effective CRAN Log Date Based on Local and UTC Time (prototype).

Description

RStudio CRAN Mirror Logs for previous day are posted at 17:00:00 UTC.

Usage

logDate(date = NULL, check.url = TRUE, tz = Sys.timezone(),
  upload.time = "17:00", warning.msg = TRUE, fix.date = TRUE)
logDate(date = NULL, check.url = TRUE, tz = Sys.timezone(),
  upload.time = "17:00", warning.msg = TRUE, fix.date = TRUE)

Arguments

`date`	Character. Date of desired log `"yyyy-mm-dd"`. NULL returns date of latest available log.
`check.url`	Logical.
`tz`	Character. Time zone. See OlsonNames().
`upload.time`	Character. UTC upload time for logs "hh:mm" or "hh:mm:ss".
`warning.msg`	Logical. TRUE uses warning() if the function returns the date of the previous available log.
`fix.date`	Logical. Fix date when directly accessing RStudio logs.

Value

An R date object.

Compute Availability, Date, Time of "Today's" Log.

Description

Also checks availability of Posit/RStudio logs and 'cranlogs' data.

Usage

logInfo(details = FALSE, tz = Sys.timezone(), upload.time = "17:00")
logInfo(details = FALSE, tz = Sys.timezone(), upload.time = "17:00")

Arguments

`details`	Logical. Check available logs and results.
`tz`	Character. Local time zone. See OlsonNames() or use Sys.timezone().
`upload.time`	Character. UTC upload time for logs "hh:mm" or "hh:mm:ss".

Get CRAN logs for selected month.

Description

Compute list of log files, 'lst', for packageVersionPercent().

Usage

monthlyLog(yr.mo = "2020-07")
monthlyLog(yr.mo = "2020-07")

Arguments

yr.mo

Character. "yyyy-mm".

Note

This is computationally intensive; you're downloading 30 odd files that are each around 50 MB in size (and creating a ~1.5 GB file)! Parallelization not practical; multiple attempts to connect to website causes problems. Truncates in-progress/future dates to yesterday's date. Automatically takes care of leap days (e.g., monthlyLog("2020-02").

Package download counts by country.

Description

From RStudio's CRAN Mirror http://cran-logs.rstudio.com/

Usage

packageCountry(packages = "cholera", date = NULL, all.filters = FALSE,
  ip.filter = FALSE, small.filter = FALSE, sequence.filter = FALSE,
  size.filter = FALSE, sort = TRUE, na.rm = FALSE, memoization = TRUE,
  check.package = TRUE, multi.core = FALSE)
packageCountry(packages = "cholera", date = NULL, all.filters = FALSE,
  ip.filter = FALSE, small.filter = FALSE, sequence.filter = FALSE,
  size.filter = FALSE, sort = TRUE, na.rm = FALSE, memoization = TRUE,
  check.package = TRUE, multi.core = FALSE)

Arguments

`packages`	Character. Vector of package name(s).
`date`	Character. Date. "yyyy-mm-dd". NULL uses latest available log.
`all.filters`	Logical. Master switch for filters.
`ip.filter`	Logical.
`small.filter`	Logical. TRUE filters out downloads less than 1000 bytes.
`sequence.filter`	Logical.
`size.filter`	Logical.
`sort`	Logical. Sort by download count.
`na.rm`	Logical. Remove NAs.
`memoization`	Logical. Use memoization when downloading logs.
`check.package`	Logical. Validate and "spell check" package.
`multi.core`	Logical or Numeric. `TRUE` uses `parallel::detectCores()`. `FALSE` uses one, single core. You can also specify the number logical cores. Mac and Unix only.

Package Download Distribution.

Description

Package Download Distribution.

Usage

packageDistribution(package = "HistData", date = NULL,
  all.filters = FALSE, ip.filter = FALSE, small.filter = FALSE,
  memoization = TRUE, check.package = TRUE, multi.core = FALSE)
packageDistribution(package = "HistData", date = NULL,
  all.filters = FALSE, ip.filter = FALSE, small.filter = FALSE,
  memoization = TRUE, check.package = TRUE, multi.core = FALSE)

Arguments

`package`	Character. Vector of package name(s).
`date`	Character. Date. "yyyy-mm-dd". NULL uses latest available log.
`all.filters`	Logical. Master switch for filters.
`ip.filter`	Logical.
`small.filter`	Logical. TRUE filters out downloads less than 1000 bytes.
`memoization`	Logical. Use memoization when downloading logs.
`check.package`	Logical. Validate and "spell check" package.
`multi.core`	Logical or Numeric. `TRUE` uses `parallel::detectCores()`. `FALSE` uses one, single core. You can also specify the number logical cores. Mac and Unix only.

Extract package or R version history.

Description

Date and version of all publications.

Usage

packageHistory(package = "cholera", check.package = TRUE)
packageHistory(package = "cholera", check.package = TRUE)

Arguments

`package`	Character. Vector of package names (including "R").
`check.package`	Logical. Validate and "spell check" package.

Get Package Download Logs.

Description

From RStudio's CRAN Mirror http://cran-logs.rstudio.com/

Usage

packageLog(packages = "cholera", date = NULL, all.filters = FALSE,
  ip.filter = FALSE, sequence.filter = FALSE, size.filter = FALSE,
  small.filter = FALSE, memoization = TRUE, check.package = TRUE,
  multi.core = FALSE)
packageLog(packages = "cholera", date = NULL, all.filters = FALSE,
  ip.filter = FALSE, sequence.filter = FALSE, size.filter = FALSE,
  small.filter = FALSE, memoization = TRUE, check.package = TRUE,
  multi.core = FALSE)

Arguments

`packages`	Character. Vector of package name(s).
`date`	Character. Date. "yyyy-mm-dd". NULL uses latest available log.
`all.filters`	Logical. Master switch for filters.
`ip.filter`	Logical.
`sequence.filter`	Logical.
`size.filter`	Logical.
`small.filter`	Logical. TRUE filters out downloads less than 1000 bytes.
`memoization`	Logical. Use memoization when downloading logs.
`check.package`	Logical. Validate and "spell check" package.
`multi.core`	Logical or Numeric. `TRUE` uses `parallel::detectCores()`. `FALSE` uses one, single core. You can also specify the number logical cores. Mac and Unix only.

Value

An R data frame.

Package download counts and rank percentiles (prototype).

Description

From RStudio's CRAN Mirror http://cran-logs.rstudio.com/

Usage

packageRank(packages = "HistData", date = NULL, all.filters = FALSE,
  ip.filter = FALSE, small.filter = FALSE, memoization = TRUE,
  check.package = TRUE, multi.core = FALSE)
packageRank(packages = "HistData", date = NULL, all.filters = FALSE,
  ip.filter = FALSE, small.filter = FALSE, memoization = TRUE,
  check.package = TRUE, multi.core = FALSE)

Arguments

`packages`	Character. Vector of package name(s).
`date`	Character. Date. "yyyy-mm-dd". NULL uses latest available log.
`all.filters`	Logical. Master switch for filters.
`ip.filter`	Logical.
`small.filter`	Logical. TRUE filters out downloads less than 1000 bytes.
`memoization`	Logical. Use memoization when downloading logs.
`check.package`	Logical. Validate and "spell check" package.
`multi.core`	Logical or Numeric. `TRUE` uses `parallel::detectCores()`. `FALSE` uses one, single core. You can also specify the number logical cores. Mac and Unix only.

Value

An R data frame.

Examples

## Not run: 
packageRank(packages = "HistData", date = "2020-01-01")
packageRank(packages = c("h2o", "Rcpp", "rstan"), date = "2020-01-01")

## End(Not run)
## Not run: 
packageRank(packages = "HistData", date = "2020-01-01")
packageRank(packages = c("h2o", "Rcpp", "rstan"), date = "2020-01-01")

## End(Not run)

Compute data for versionPlot().

Description

packageRank::blog.data or recompute random sample of packages.

Usage

packageVersionPercent(lst, yr.mo = "2020-07", multi.core = FALSE)
packageVersionPercent(lst, yr.mo = "2020-07", multi.core = FALSE)

Arguments

`lst`	Object. List of CRAN download logs data frames. Use monthlyLog().
`yr.mo`	Character. "yyyy-mo". packageVersionsPercent(NULL, yr.mo)
`multi.core`	Logical or Numeric. `TRUE` uses `parallel::detectCores()`. `FALSE` uses one, single core. You can also specify the number logical cores. Mac and Unix only.

Examples

## Not run: 
# To resample and recompute, set lst to NULL, specify a yr.mo:
packageVersionPercent(NULL, yr.mo = "2020-07")

Otherwise, you must provide a pre-computed lst of logs.

## End(Not run)
## Not run: 
# To resample and recompute, set lst to NULL, specify a yr.mo:
packageVersionPercent(NULL, yr.mo = "2020-07")

Otherwise, you must provide a pre-computed lst of logs.

## End(Not run)

Plot method for annualDownloads().

Description

Plot method for annualDownloads().

Usage

## S3 method for class 'annualDownloads'
plot(x, statistic = "count", pool = TRUE,
  log.y = FALSE, sep.y = FALSE, nrow = 3, smooth = TRUE, f = 1/4,
  span = 3/4, points = FALSE, line.col = "gray", ...)
## S3 method for class 'annualDownloads'
plot(x, statistic = "count", pool = TRUE,
  log.y = FALSE, sep.y = FALSE, nrow = 3, smooth = TRUE, f = 1/4,
  span = 3/4, points = FALSE, line.col = "gray", ...)

Arguments

`x`	object.
`statistic`	Character. "count" or "percent".
`pool`	Logical. Pool annual data into single time series.
`log.y`	Logical. Base 10 logarithm of y-axis.
`sep.y`	Logical. Separate, independent y-scales for each panel.
`nrow`	Numeric. Number of rows for ggplot2 facets.
`smooth`	Logical. Add smoother (loess).
`f`	Numeric. Parameter for lowess.
`span`	Numeric. Smoothing parameter for geom_smooth(), which uses loess.
`points`	Logical.
`line.col`	Character. Color of line
`...`	Additional plotting parameters.

Plot method for bioconductorDownloads().

Description

Plot method for bioconductorDownloads().

Usage

## S3 method for class 'bioconductorDownloads'
plot(x, graphics = NULL,
  count = "download", cumulative = FALSE, points = "auto",
  smooth = FALSE, f = 2/3, span = 3/4, se = FALSE, log.y = FALSE,
  r.version = FALSE, same.xy = TRUE, multi.plot = FALSE,
  legend.loc = "topleft", ...)
## S3 method for class 'bioconductorDownloads'
plot(x, graphics = NULL,
  count = "download", cumulative = FALSE, points = "auto",
  smooth = FALSE, f = 2/3, span = 3/4, se = FALSE, log.y = FALSE,
  r.version = FALSE, same.xy = TRUE, multi.plot = FALSE,
  legend.loc = "topleft", ...)

Arguments

`x`	object.
`graphics`	Character. NULL, "base" or "ggplot2".
`count`	Character. "download" or "ip".
`cumulative`	Logical. Use cumulative counts.
`points`	Character of Logical. Plot points. "auto", TRUE, FALSE. "auto" for bioconductorDownloads(unit.observation = "month") with 24 or fewer months, points are plotted.
`smooth`	Logical. Add stats::lowess smoother.
`f`	Numeric. smoother window for stats::lowess(). For graphics = "base" only; c.f. stats::lowess(f)
`span`	Numeric. Smoothing parameter for geom_smooth(); c.f. stats::loess(span).
`se`	Logical. Works only with graphics = "ggplot2".
`log.y`	Logical. Logarithm of package downloads.
`r.version`	Logical. Add R release dates.
`same.xy`	Logical. Use same scale for multiple packages when graphics = "base".
`multi.plot`	Logical. Plot all data in a single window frame.
`legend.loc`	Character.
`...`	Additional plotting parameters.

Examples

## Not run: 
plot(bioconductorDownloads())
plot(bioconductorDownloads(packages = "graph"))
plot(bioconductorDownloads(packages = "graph", from = 2010, to = 2015))
plot(bioconductorDownloads(packages = "graph", from = "2014-06", to = "2015-03"))
plot(bioconductorDownloads(packages = c("graph", "IRanges", "S4Vectors"), from = 2018))

## End(Not run)
## Not run: 
plot(bioconductorDownloads())
plot(bioconductorDownloads(packages = "graph"))
plot(bioconductorDownloads(packages = "graph", from = 2010, to = 2015))
plot(bioconductorDownloads(packages = "graph", from = "2014-06", to = "2015-03"))
plot(bioconductorDownloads(packages = c("graph", "IRanges", "S4Vectors"), from = 2018))

## End(Not run)

Plot method for bioconductorRank().

Description

Plot method for bioconductorRank().

Usage

## S3 method for class 'bioconductorRank'
plot(x, graphics = NULL, log.y = TRUE, ...)
## S3 method for class 'bioconductorRank'
plot(x, graphics = NULL, log.y = TRUE, ...)

Arguments

`x`	An object of class "bioconductor_rank" created by `bioconductorRank()`.
`graphics`	Character. "base" or "ggplot2".
`log.y`	Logical. Logarithm of package downloads.
`...`	Additional plotting parameters.

Value

A base R or ggplot2 plot.

Plot top 10 package downloads by country domain.

Description

Plot method for countryDistribution().

Usage

## S3 method for class 'countryDistribution'
plot(x, N = 10, ...)
## S3 method for class 'countryDistribution'
plot(x, N = 10, ...)

Arguments

`x`	An object of class "countryDistribution" created by `countryDistribution()`.
`N`	Integer. Top N countries.
`...`	Additional plotting parameters.

Plot method for countsRanks().

Description

Plot method for countsRanks().

Usage

## S3 method for class 'countsRanks'
plot(x, ...)
## S3 method for class 'countsRanks'
plot(x, ...)

Arguments

`x`	object.
`...`	Additional plotting parameters.

Plot method for cranDownloads().

Description

Plot method for cranDownloads().

Usage

## S3 method for class 'cranDownloads'
plot(x, statistic = "count", graphics = "auto",
  points = "auto", log.y = FALSE, smooth = FALSE, se = FALSE,
  f = 1/3, span = 3/4, package.version = FALSE, r.version = FALSE,
  population.plot = FALSE, population.seed = as.numeric(Sys.Date()),
  multi.plot = FALSE, same.xy = TRUE, legend.location = "topleft",
  ip.legend.location = "topright", r.total = FALSE, dev.mode = FALSE,
  unit.observation = "day", multi.core = FALSE, ...)
## S3 method for class 'cranDownloads'
plot(x, statistic = "count", graphics = "auto",
  points = "auto", log.y = FALSE, smooth = FALSE, se = FALSE,
  f = 1/3, span = 3/4, package.version = FALSE, r.version = FALSE,
  population.plot = FALSE, population.seed = as.numeric(Sys.Date()),
  multi.plot = FALSE, same.xy = TRUE, legend.location = "topleft",
  ip.legend.location = "topright", r.total = FALSE, dev.mode = FALSE,
  unit.observation = "day", multi.core = FALSE, ...)

Arguments

`x`	object.
`statistic`	Character. "count" or "cumulative".
`graphics`	Character. "auto", "base" or "ggplot2".
`points`	Character of Logical. Plot points. "auto", TRUE, FALSE.
`log.y`	Logical. Logarithm of package downloads.
`smooth`	Logical. Add smoother.
`se`	Logical. Works only with graphics = "ggplot2".
`f`	Numeric. smoother window for stats::lowess(). For graphics = "base" only; c.f. stats::lowess(f)
`span`	Numeric. Smoothing parameter for geom_smooth(); c.f. stats::loess(span).
`package.version`	Logical. Add latest package release dates.
`r.version`	Logical. Add R release dates.
`population.plot`	Logical. Plot population plot.
`population.seed`	Numeric. Seed for sample in population plot.
`multi.plot`	Logical.
`same.xy`	Logical. Use same scale for multiple packages when graphics = "base".
`legend.location`	Character.
`ip.legend.location`	Character. Location of in-progress legend.
`r.total`	Logical.
`dev.mode`	Logical. Use packageHistory0() to scrape CRAN.
`unit.observation`	Character. "year", "month", "week", or "day".
`multi.core`	Logical or Numeric. `TRUE` uses `parallel::detectCores()`. `FALSE` uses one, single core. You can also specify the number logical cores. Mac and Unix only.
`...`	Additional plotting parameters.

Value

A base R or ggplot2 plot.

Examples

## Not run: 
plot(cranDownloads(packages = c("Rcpp", "rlang", "data.table")))
plot(cranDownloads(packages = c("Rcpp", "rlang", "data.table"), when = "last-month"))
plot(cranDownloads(packages = "R", from = "2020-01-01", to = "2020-01-01"))
plot(cranDownloads(packages = "R", from = 2020))

## End(Not run)
## Not run: 
plot(cranDownloads(packages = c("Rcpp", "rlang", "data.table")))
plot(cranDownloads(packages = c("Rcpp", "rlang", "data.table"), when = "last-month"))
plot(cranDownloads(packages = "R", from = "2020-01-01", to = "2020-01-01"))
plot(cranDownloads(packages = "R", from = 2020))

## End(Not run)

Plot method for packageDistribution().

Description

Plot method for packageDistribution().

Usage

## S3 method for class 'packageDistribution'
plot(x, ...)
## S3 method for class 'packageDistribution'
plot(x, ...)

Arguments

`x`	An object of class "packageDistribution" created by `packageDistribution()`.
`...`	Additional plotting parameters.

Plot method for packageRank() and packageRank0().

Description

Plot method for packageRank() and packageRank0().

Usage

## S3 method for class 'packageRank'
plot(x, graphics = NULL, log.y = TRUE, ...)
## S3 method for class 'packageRank'
plot(x, graphics = NULL, log.y = TRUE, ...)

Arguments

`x`	An object of class "packageRank" created by `packageRank()`.
`graphics`	Character. "base" or "ggplot2".
`log.y`	Logical. Logarithm of package downloads.
`...`	Additional plotting parameters.

Value

A base R or ggplot2 plot.

Examples

## Not run: 
plot(packageRank(packages = "HistData", date = "2020-01-01"))
plot(packageRank(packages = c("h2o", "Rcpp", "rstan"), date = "2020-01-01"))

## End(Not run)
## Not run: 
plot(packageRank(packages = "HistData", date = "2020-01-01"))
plot(packageRank(packages = c("h2o", "Rcpp", "rstan"), date = "2020-01-01"))

## End(Not run)

Plot method for packageVersionPercent().

Description

Plot method for packageVersionPercent().

Usage

## S3 method for class 'packageVersionPercent'
plot(x, ...)
## S3 method for class 'packageVersionPercent'
plot(x, ...)

Arguments

`x`	An object of class "packageVersionPercent".
`...`	Additional plotting parameters.

Plot method for weeklyDownloads().

Description

Plot method for weeklyDownloads().

Usage

## S3 method for class 'weeklyDownloads'
plot(x, statistic = "percent",
  aggregation = "day", typical.value = "mean", nrow = 3L, ...)
## S3 method for class 'weeklyDownloads'
plot(x, statistic = "percent",
  aggregation = "day", typical.value = "mean", nrow = 3L, ...)

Arguments

`x`	object.
`statistic`	Character. "count" or "percent".
`aggregation`	Character. "week" or "day".
`typical.value`	Character. "mean" or "median".
`nrow`	Numeric. Number of rows for ggplot2 facets.
`...`	Additional plotting parameters.

Examples

## Not run: 
plot(weeklyDownloads())
plot(weeklyDownloads(n = 9), aggregation = "week")

## End(Not run)
## Not run: 
plot(weeklyDownloads())
plot(weeklyDownloads(n = 9), aggregation = "week")

## End(Not run)

Plot Compute Downloads by Country Code.

Description

Plot Compute Downloads by Country Code.

Usage

plotDownloadsCountry()
plotDownloadsCountry()

Plot Top N Downloads by Country Code.

Description

Plot Top N Downloads by Country Code.

Usage

plotTopCountryCodes(dataset = "october", second.place = FALSE)
plotTopCountryCodes(dataset = "october", second.place = FALSE)

Arguments

`dataset`	Character.
`second.place`	Logical. Annotate second place country.

Print method for bioconductorDownloads().

Description

Print method for bioconductorDownloads().

Usage

## S3 method for class 'bioconductorDownloads'
print(x, ...)
## S3 method for class 'bioconductorDownloads'
print(x, ...)

Arguments

`x`	object.
`...`	Additional parameters.

Print method for bioconductorRank().

Description

Print method for bioconductorRank().

Usage

## S3 method for class 'bioconductorRank'
print(x, ...)
## S3 method for class 'bioconductorRank'
print(x, ...)

Arguments

`x`	An object of class "bioconductor_rank" created by `bioconductorRank()`
`...`	Additional parameters.

Print method for countryDistribution().

Description

Print method for countryDistribution().

Usage

## S3 method for class 'countryDistribution'
print(x, N = 10, ...)
## S3 method for class 'countryDistribution'
print(x, N = 10, ...)

Arguments

`x`	object.
`N`	Integer. Top N countries.
`...`	Additional parameters.

Print method for cranDownloads().

Description

Print method for cranDownloads().

Usage

## S3 method for class 'cranDownloads'
print(x, ...)
## S3 method for class 'cranDownloads'
print(x, ...)

Arguments

`x`	object.
`...`	Additional parameters.

Print method for packageDistribution().

Description

Print method for packageDistribution().

Usage

## S3 method for class 'packageDistribution'
print(x, ...)
## S3 method for class 'packageDistribution'
print(x, ...)

Arguments

`x`	An object of class "packageDistribution" created by `packageDistribution()`
`...`	Additional parameters.

Print method for packageRank().

Description

Print method for packageRank().

Usage

## S3 method for class 'packageRank'
print(x, ...)
## S3 method for class 'packageRank'
print(x, ...)

Arguments

`x`	An object of class "packageRank" created by `packageRank()`
`...`	Additional parameters.

Get R Application Download Logs.

Description

From RStudio's CRAN Mirror http://cran-logs.rstudio.com/

Usage

rLog(date = NULL)
rLog(date = NULL)

Arguments

date

Character. Date. "yyyy-mm-dd". NULL uses last available log.

Eight RStudio Download Logs to Fix Duplicate Logs Errors in 'cranlogs'.

Description

October 6-8, 2012; October 11, 2012; December 26-28; and January 1, 20113.

Usage

rstudio.logs
rstudio.logs

Format

date
time
size
r_version
r_arch
r_os
package
version
country
ip_id

Summary method for bioconductorDownloads().

Description

Summary method for bioconductorDownloads().

Usage

## S3 method for class 'bioconductorDownloads'
summary(object, ...)
## S3 method for class 'bioconductorDownloads'
summary(object, ...)

Arguments

`object`	Object.
`...`	Additional parameters.

Summary method for bioconductorRank().

Description

Summary method for bioconductorRank().

Usage

## S3 method for class 'bioconductorRank'
summary(object, ...)
## S3 method for class 'bioconductorRank'
summary(object, ...)

Arguments

`object`	Object. An object of class "bioconductor_rank" created by `bioconductorRank()`
`...`	Additional parameters.

Note

This is useful for directly accessing the data frame.

Summary method for cranDownloads().

Description

Summary method for cranDownloads().

Usage

## S3 method for class 'cranDownloads'
summary(object, ...)
## S3 method for class 'cranDownloads'
summary(object, ...)

Arguments

`object`	Object.
`...`	Additional parameters.

Note

This is useful for directly accessing the data frame.

Summary method for packageRank().

Description

Summary method for packageRank().

Usage

## S3 method for class 'packageRank'
summary(object, ...)
## S3 method for class 'packageRank'
summary(object, ...)

Arguments

`object`	Object. An object of class "packageRank" created by `packageRank()`
`...`	Additional parameters.

Note

This is useful for directly accessing the data frame.

Compute Top N Downloads by Country Code.

Description

Compute Top N Downloads by Country Code.

Usage

topCountryCodes(month_cran_log, top.n = 5L, multi.core = FALSE)
topCountryCodes(month_cran_log, top.n = 5L, multi.core = FALSE)

Arguments

`month_cran_log`	Object.
`top.n`	Integer.
`multi.core`	Logical or Numeric. `TRUE` uses `parallel::detectCores()`. `FALSE` uses one, single core. You can also specify the number logical cores to use. Note that due to performance considerations, the number of cores defaults to one on Windows.

Compute Coordinated Universal Time (UTC/GMT) for Your Local Time.

Description

Compute Coordinated Universal Time (UTC/GMT) for Your Local Time.

Usage

utc()
utc()

Compute Coordinated Universal Time (UTC/GMT) for Specified Local Time.

Description

Compute Coordinated Universal Time (UTC/GMT) for Specified Local Time.

Usage

utc0(date = "2020-01-01", time = "12:00:00", tz = "Europe/Vienna")
utc0(date = "2020-01-01", time = "12:00:00", tz = "Europe/Vienna")

Arguments

`date`	Character. Date "yyyy-mm-dd".
`time`	Character. Local time "hh:mm" or "hh:mm:ss".
`tz`	Character. Local time zone. See OlsonNames() or use Sys.timezone().

Version Plot.

Description

Document code for blog graph.

Usage

versionPlot()
versionPlot()

Sample Weekly CRAN Downloads Data.

Description

From RStudio's CRAN Mirror http://cran-logs.rstudio.com/

Usage

weeklyDownloads(start.yr = 2013, n = 50, multi.core = FALSE)
weeklyDownloads(start.yr = 2013, n = 50, multi.core = FALSE)

Arguments

`start.yr`	Numeric or Integer.
`n`	Numeric or Integer. Number of weeks (samples).
`multi.core`	Logical or Numeric. `TRUE` uses `parallel::detectCores()`. `FALSE` uses one, single core. You can also specify the number logical cores. Mac and Unix only.

Package 'packageRank'

Help Index

packageRank

Description

Details

Author(s)

See Also

Count Total CRAN Download.

Description

Usage

Arguments

Note

Annual/monthly package downloads from Bioconductor.

Description

Usage

Arguments

Examples

Package download counts and rank percentiles.

Description

Usage

Arguments

Value

Examples

Blog post data.

Description

Usage

Format

Tabulate package downloads by country.

Description

Usage

Arguments

Value

Tabulate a country's package downloads.

Description

Usage

Arguments

Note

Counts v. Rank Percentiles for 'cholera' for First Week of March 2020.

Description

Usage

Arguments

Daily package downloads from the RStudio CRAN mirror.

Description

Usage

Arguments

Examples

CRAN inflation plot.

Description

Usage

Arguments

Scrape CRAN Mirrors data.

Description

Usage

Arguments

Compute Current Time in Selected Time Zone.

Description

Usage

Arguments

Compute Downloads by Country Code.

Description

Usage

Arguments

Filtered package downloads from the RStudio CRAN mirror (prototype).

Description

Usage

Arguments

Inflation plots of effects of "small" downloads and prior versions for October 2019: 'cholera', 'ggplot2', and 'VR'.

Description

Usage

Arguments

Inflation plots of effects of "small" downloads on aggregate CRAN downloads for October 2019 and July 2020.

Description

Usage

Arguments

Count number of IP addresses.

Description

Usage

Arguments

Unique package download counts by IP address.

Description