packageRank 0.9.0

packageRank 0.9.0

New Functionality

• add rLog().
• add cranPackageSize(mac.ver = "arm").

Deprecated

• remove tripletFilter() - redundant with amended sizeFilter().

Fixes/Updates

• If available, multi.core = FALSE by default in all functions.

• amend/correct aggregateData(unit.observation = "week").

• fix computeFileSizeB() for multiple size units.

• update cranMirrors().

• update/set cranPackageSize(r.ver = "4.3").

• fix argument error in packageArchive() for sizeFilter().

• fix packageDistribution() for multiple packages.

• add timeout fix to packages_on_CRAN(), packageArchive() and packageCRAN().

• fix/ensure exact package name matching in packageCRAN().

• return latest release in package_info() for packageCRAN() (n.b. pkg updates).

• fix packageCRAN(size) and packageArchive(size).

• fix packageHistory("R").

• match point types in
  plot.cranDownloads(graphics = "ggplot2", unit.observation = "week").

• modify removeSequences() for high volume packages.

• fix typo/error in sequenceFilter().

Function Changes

• use previous day if today not available in cranDownloads().

• remove non-user facing functions from NAMESPACE.

• update 'ggplot2' syntax in cranDownloads() plot functions,
  ggPlot(), gg_bioc_plot(), plot.annualDownloads(), plotDownloadsCountry(),
  plot.packageDistribution(), plotTopCountryCodes(), plot.weeklyDownloads() and
  plot.packageVersionPercent().

• check internet connection in bioconductorDownloads() and bioconductorRank().

• change "warn.msg" to "print.message" in checkPackage().

• remove dev.mode argument from checkPackage().

• add/set plot.countryDistribution(N = 10) for top N country domains.

• match cranlogs::cran_downloads() behavior with duplicate packages in
  cranDownloads() and packageHistory().

• add delta count and inflation unit in filteredDownloads().

• replace ip_filter() with greedyIP() in ipFilter().

• use only counts in greedyIP() in ipFilter().

• compute run length encoding and candidate.data in ipFilter(campaigns = TRUE).

• change/set ipCount(sort.count = TRUE).

• use "file.url.date" in ipCount() and ipDownloads().

• disable parallel code for ipFilter(campaigns = TRUE).

• include local time with logInfo(details = TRUE).

• check last 3 rather than last 7 logs for logInfo(details = TRUE).

• name list elements in packageHistory().

• set packageHistory(check.package = TRUE).

• use "crandb_file_date" for dates in packageHistory().

• use packageCRAN() instead of mpackages_on_CRAN() in packageHistory().

• return empty data frame for no CRAN, no Archive in packageHistory0().

• make packageHistory0(), packageCRAN() and packageArchive() standalone and
  private.

• change plot.annualDownloads(f = 1/4).

• add/set plot.annualDownloads(line.col = "gray") and fix outliers.

• replace log_count argument with log.y in plot.bioconductorRank and
  plot.packageRank().

• rename/set sequenceFilter(delta.time = 10).

• add pre-flight checks to sequenceFilter() and smallFilter().

• replace identifySequences() with removeSequences() in sequenceFilter().

• set packageHistory(check.package = FALSE) in sequenceFilter().

• filter out undersized downloads of past versions in sizeFilter().

• add exception for "R" in validatePackage() and validatePackage0().

• remove tripletFilter() code from utilities.R functions.

Documentation

• add annualDownloads() example to README.
• add personal default plots to README.

packageRank 0.8.3

Fixes

• use packageLifeFilter() only when cranDownloads(check.package = TRUE).
• remove fix for doubled cranlogs::cran_downloads(packages %in% c(NULL, pkg))
  counts; underlying 'cranlogs' issue #68 fixed.

Documentation

• amend/update README.

Changes

• clean DESCRIPTION Imports.

packageRank 0.8.2

packageRank 0.8.2

Fixes

• fix "doubled" cranlogs::cran_downloads(packages = "R") R application
  download counts in cranDownloads() from 2023-09-12 to 2023-10-02.
• fix doubled cranlogs::cran_downloads(packages %in% c(NULL, pkg)) download
  counts in cranDownloads() from 2023-09-19 to 2023-10-01.
• add timeout fix to checkPackage().

Function Changes

• set packageHistory(check.package = FALSE)
• remove "Today's results not available" message from cranDownloads().

Documentation

• amend Sunday/Wednesday R Windows application download spikes README note.
• add discussion of "doubled" counts in cranlogs::cran_downloads() to README.

packageRank 0.8.1

New Functionality

• add packages_on_CRAN(), packages_in_Archive(), packages_observed_in_logs()
  and packages_partitioned().
• add extractArchiveDate().
• add/set packages_partitioned(observed.downloads = FALSE).

Fixes

• amend packageLog() for packages that get filtered to zero.
• amend/fix sizeFilter() for archive-only packages.
• fix pkgsearch::cran_package_history() "try-error" in packageHistory().
• fix ylim in plot.cranDownloads(graphics = "base", unit.observation = "week").
• fix logInfo() when 'cranlogs' not available.
• set filteredDownloads(all.filters = FALSE) if any individual filter is TRUE.
• add temporary timeout = 600L to packages_partitioned().
• set options(timeout = 600L) in cranPackageSize().
• sort list element names in packageHistory().

Function Changes

• set packageLog(check.package = FALSE) in filteredDownloads().
• memoize packages_partitioned().
• add/set dev.mode = FALSE for ipFilter() in countryDistribution(),
  countryPackage() and ipPackage().
• add memoized archivePackages().
• refactor checkPackage().
• change result data type and content of validatePackage().
• add 'cranlogs' check to cranDownloads().
• add/use memoized packageHistory0() in packageHistory().
• allow mix of CRAN and Archive-only packages (and R) in packageHistory().
• add memoized packages_on_CRAN().
• add CRAN check to packageHistory().

Documentation

• note Wednesday R Windows application download spikes in README.

packageRank v0.8.0

Fixes

• add lookup for exceptions in cranMirrors().
• fix plot.cranDownloads(graphics = "base", multi.plot = TRUE, smooth = TRUE).
• fix sequenceFilter() for packages not in CRAN Archive.

Function Change

• set annualDownloads(log.y = FALSE).
• add/set annualDownloads(sep.y = FALSE).
• add/set cranMirrors(description = FALSE).
• change logInfo(list.available = FALSE) to logInfo(show.available = FALSE).
• set class of packageHistory()$Date to "Date".
• archive/deprecate packageMRAN() and related functionality.
• set loess as default smoother in plot.cranDownloads()

Documentation

• add discussion about R Windows Sunday downloads to README.

packageRank v0.7.2

packageRank 0.7.2

Function Change

• add exception to logInfo() when 'cranlogs' is down.

packageRank v0.7.1

packageRank 0.7.1

Fixes

• fix/clean rPlot(r.version = TRUE).
• fix plot(cranDownloads("R"), r.total = TRUE).

Function Change

• logInfo() checks for last available log.

packageRank v0.7.0

packageRank 0.7.0

New Features

• add plot.cranDownloads(unit.observation = "week").
• discuss 'from =' and 'to =' cranDownloads() shortcuts in README.

Fixes

• enable ipPackage().
• fix cranDownloads("R", to = ).
• fix output for packageHistory("R").

Function Changes

• add logInfo() and deprecate logPostInfo().
• change 'log.count' to 'log.y' in plot.bioconductorDownloads() and
  plot.cranDownloads().
• limit available unit of observations:
  • with when = "last-week" only unit.observation = "day" available.
  • with when = "last-month" AND graphics = "ggplot2",
    unit.observation = "month" not available
• recompute cumulative count with plot.cranDownloads(unit.observation = "week")
  to include backdate data.
• return cores = 1L on Windows with multiCore(); parallelization on Windows not
  currently available.
• use 'ISOcodes' in cranMirrors().

Graphical Changes

• amend plot.cranDownloads(graphics = "ggplot2") legends.
• plot.cranDownloads(unit.observation = "month") date plotted on first rather than last day of month.
• use observed date for first week observed data in plot.cranDownloads()
• set 0s to 1s to avoid NAs when plot.cranDownloads(log.y = TRUE).

Graphical Fixes

• amend xy labels for "count" or "cumulative" in plot.cranDownloads().

New Auxiliary/Helper Functions

• add fetchRLog().
• add getCorrectLogs() and rstudio.logs list object.
• add rev_fixDate_2012().
• add/set cranDownloads(fix.cranlogs = TRUE).
• add/use fixCranlogs().
• add/set logDate(fix.date = TRUE).
• add/set resolveDate(fix.date = FALSE).

packageRank v0.6.0

Fixes

• amend fetchCranLog() message.
• fix tripletFilter().
• add exception and warning for packages with zero downloads (not in log) for
  packageLog() and packageRank().
• fix variable names in packageCRAN() and packageArchive().
• fix y-axis typo and labels in cranPlot().
• set data.frame(row.names = NULL) in packageHistory().
• amend/update country code top level domains in cranMirrors().

Function Changes

• add packageHistory("R").
• allow multiple packages (vector) in packageHistory() and packageMRAN().
• restrict parLapply() to dev.mode = TRUE.

Graphical Changes

• amend graphical elements for estimate and in-progress download counts in
  plot.cranDownloads().

packageRank v0.5.0

Fixes

• increase fetchCranLog() timeout to 600.

Function Changes

• visualize different units of observation: "day" (default), "month", and "year" with plot.cranDownloads(unit.observation = "day").
• add in-progress plots with nominal and estimated totals for aggregate units of observation.