Skip to content
CRAN requires the check problems on this package to be fixed before Nov 14 or it will be archived. See the check details

nethist

1.1.0Package record

Network Histograms

0packages depend
505downloads / year
88.1%test coverage
13/13flavors OK

Overview

About

Estimates network histograms, a blockmodel approximation to the graphon underlying a network's connectivity pattern, for both single-layer and multilayer networks. Implements graphon estimation methods including the profile-likelihood method of Olhede and Wolfe (2014) doi:10.1073/pnas.1400374111 and the least-squares method of Gao, Lu, and Zhou (2015) doi:10.1214/15-AOS1354 for single-layer networks, and the multilayer extension of Song and Olhede (2026) doi:10.1093/comnet/cnag042.

Changes in 1.1.0

New features

  • logLik(): new S3 method for nethist, multinethist, and hnethist objects. Returns the unnormalized Bernoulli log-likelihood as a logLik object with df and nobs attributes, so AIC() and BIC() work directly on a fit. Use logLik(fit, normalized = TRUE) for the per-edge normalized value stored in fit$normalized_LL.
  • hnethist(): added examples to the help page.
  • summary(): new S3 method for nethist, multinethist, and hnethist objects. Reports the fit dimensions, the edge density, the log-likelihood with its degrees of freedom, AIC, BIC, and, for hnethist, the shape selection.

Bug fixes

Show all changes in 1.1.0Hide the rest of the changes in 1.1.0
  • hnethist(): normalized_LL is now divided by the number of edges sum(A)/2, matching nethist() and multinethist(). Previously it was divided by sum(A), so reported values were half the size of the corresponding nethist() values. Model selection and BIC are unaffected.
  • print() methods for nethist, multinethist, and hnethist now respect the digits argument when printing the normalized likelihood and the mean squared error.
  • netsummary_plot(): the example using the suggested package **network** is now guarded by requireNamespace().
  • logLik() on a multinethist fit that collapses to a single block now reports the correct degrees of freedom.
  • multinethist(): method = "LSE" with multilayer input now raises an error. Previously it was accepted silently, the fit was computed by profile likelihood, and the returned object was labelled "LSE".

Class hierarchy

  • All fitted objects now inherit from a common base class, network_histogram: nethist fits have class c("nethist", "network_histogram"), multinethist fits c("multinethist", "network_histogram"), and hnethist fits c("hnethist", "nethist", "network_histogram"). Previously hnethist inherited from nethist while multinethist was unrelated to either.
  • logLik() and the print() method of the summary objects are defined once on network_histogram. summary.multinethist() and summary.hnethist() extend the base method through NextMethod(). Methods whose behaviour depends on the layer dimension, namely plot(), plot3d(), fitted(), and print(), remain specific to the subclasses.
  • See ?"network_histogram-class" for the documented hierarchy.
  • Code that tests for an exact class vector, such as identical(class(fit), c("hnethist", "nethist")), needs updating. Use inherits() instead.

User-visible changes

  • The print() methods for nethist, multinethist, and hnethist are now compact. They identify the fit and report thetahat by its dimensions only, instead of printing the whole probability matrix or array, and the Available components listing has been dropped. The detailed output moved to the new summary() methods. Use object$thetahat or fitted() for the estimated probabilities.

Documentation

  • nethist(), multinethist(), and hnethist() now state in their help pages that the greedy search is stochastic and converges to a local optimum, and that set.seed() should be called immediately before the fit for reproducible results. hnethist() additionally notes that its merging step draws stats::kmeans() starting centres from the same stream, so the selected number of shapes depends on it.
  • The @returns sections of nethist(), multinethist(), and hnethist() now state the full class vector including network_histogram, and multinethist() lists the method field.
  • Removed the leftover prompt boilerplate from the polblog and polblog_edgelist help pages, as requested by the CRAN team.
  • The polblog and polblog_edgelist examples now call igraph::delete_vertices() instead of the deprecated igraph::delete.vertices().

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 7.2 min · r-devel-windows-x86_64
Status changes
  • OK13 OKNow
  • OK11 OK2026-09-06
  • ERROR8 OK, 1 ERROR2026-09-04
Advisories

none known

Documentation

In release 1.1.0
READMEYes · 399 wordsVignettesYes · 1 · dynamicNEWSYes · 100% structured · mentions 1.1.0Citation fileYes · software entry onlyWebsiteYes · pkgdown
Help pages
20 (1 internal)includes a package overview page
Examples that run
28%5 run in a plain check · 13 only when donttest examples are enabled (R CMD check --as-cran)
Exported functions with examples
100%
Documented parameters
95%
Return-value docs
100%
Help pages citing references
35%

Downloads

505
CRAN downloads in the past year
Rank #24,357 · ~1/day · ~42/mo
Daily download trend is not available in this view yet.
20430 days
50590 days
5051 year
Compare downloads with other packages →
Also on17 r2u1 autocran

Repository

2Stars
1Forks
1Open issues
0Open PRs
4Releases
159Commits
2Commit identities
rstats-package
159 commits · Last activity 2026-10-23
Responsiveness
How these are sampled
PRs merged (all time)
82%
Median days to close, 50 most recently updated closed issues
104
Median days to close, 50 most recently updated closed PRs
0

Releases over time

2026-09-03 · 32026-10-24 · 4
PracticesBeta

7 development-tooling and community-health practices detected across 3 families in the upstream repository

Checks run against github.com/enigmasong/nethist on 2026-10-21.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux

Docs source (4)
README.Rmdpkgdown

GitHub Pages site last deployed 2026-08-22 · The repository has a site deploy workflow

pkgdown site last built 2026-08-22, before release 1.1.0 (2026-10-23)

Reproducibility and dev environment (1)
data-raw/
How this is detected·Detection ruleset v4 (2026-10-20)

Dependencies

Declared dependencies
22 external dependencies (excludes base and recommended)

Installing nethist adds 55 packages (30 with compiled code, 42 MB of source tarballs). Heaviest: stringi 11 MB, ggplot2 6.0 MB, igraph 4.8 MB.

Depends (1)
R >= 3.5.0
Imports (11)
Enhances (0)
none
Reverse dependencies
0direct
0indirect

Nothing depends on this yet.

Datasets

People & History

People (2)
Author, Maintainer since 1.0.0 (2026)
Releases (2)

Pick two releases to compare their code metrics.

  • 1.1.0Latest
    record
    2026-10-23 · current release · diff ↗
  • 1.0.0
    record
    2026-09-02
  • R
    R 4.6.0 released · 2026-04-24

Package metadata

First published
2026-09-02
Total releases
2 / 1 yrs
License
MIT + file LICENSE OSI
Minimum R
≥ 3.5.0
Bundled data
265 KB / 3 files
Download size
867 KB

Cite

Cite this package

Run in R for the authors' entry:

citation("nethist")

The package provides a citation file, so citation() returns the authors' own entry.

Cite the R Observatory

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

APA

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

From data release v2026-10-24, 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 →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy