R Observatory: Metrics for statfidelity version 0.1.0

Balamuta, James Joseph

doi:10.5281/zenodo.21843040

statfidelity

0.1.0Package record

Audit Statistical Fidelity of AI-Mediated Official Statistics

0packages depend

385downloads / year

55.9%test coverage

13/13flavors OK

Overview

About

Maintained by Leila Marvian MashhadCRAN page ↗

Provides deterministic tools for auditing whether artificial intelligence systems preserve the numerical, semantic, contextual, temporal, geographic, unit, provenance, revision, transformation, and uncertainty properties of official statistics. Structured reference statistics and machine-generated claims can be compared with non-compensatory critical-error rules, weakest-link and geometric fidelity summaries, provenance graphs, and portable SHA-256 proof bundles. The package also provides bounded connectors for official Eurostat, World Bank, OECD, United Nations SDG, United Kingdom Office for National Statistics, and United States Bureau of Labor Statistics application programming interfaces, plus an extensible HTTPS JSON API registry with session-only API-key support. Prompt perturbation, statistical red-team generation, minimal-pair tests, and starter benchmark data support reproducible evaluation of generative, retrieval-augmented, and agentic statistical systems. An embedded alignment layer maps claim-level controls to relevant activities of the Generic Statistical Business Process Model (GSBPM) 5.2, including Analyse, Disseminate, Evaluate, Quality Management, and Metadata Management. No specific model provider is required.

Changes in 0.1.0

Release scope

Provides a ten-dimensional statistical-fidelity audit covering semantic, numerical, temporal, geographic, unit, contextual, provenance, revision, transformation, and uncertainty fidelity.
Provides geometric and weakest-link summaries together with non-compensatory critical-error rules and PASS/WARN/FAIL certification logic.
Provides provenance graphs, revision handling, portable SHA-256 proof bundles, batch auditing, prompt perturbation, statistical red-team generation, minimal-pair tests, benchmark utilities, and model-stability tools.
Provides bounded interfaces for Eurostat, World Bank, OECD, UNSD SDG, UK ONS, U.S. BLS, and low-level IMF SDMX URL construction, together with an extensible HTTPS JSON API registry.
Provides gsbpm52_map(), gsbpm_align(), and gsbpm_quality_report() for explicit alignment with relevant GSBPM 5.2 Analyse, Disseminate, Evaluate, Quality Management, and Metadata Management activities.
Includes offline fixtures and regression tests for provider parsing, audit behaviour, proof integrity, and GSBPM alignment.

Scope and compatibility

GSBPM alignment is offline and deterministic and introduces no additional network dependency.
The package supports relevant GSBPM 5.2 activities but does not claim to implement or certify the complete GSBPM statistical production process.

From NEWS.md in the release

Install

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

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

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

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-statfidelity

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-statfidelity

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-statfidelity

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

13OK

CRAN check page ↗

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

Status changes

OK13 OKNow
OK6 OK2026-09-04

Advisories

none known

How this is measured·How advisories are found

Documentation

In release 0.1.0

READMEYes · 594 wordsVignettesNoNEWSYes · 67% structured · mentions 0.1.0Citation fileYes · software entry onlyWebsitenot declared in DESCRIPTION

Help pages: 18includes a package overview page
Examples that run: 93%13 run in a plain check · 1 hold no code
Exported functions with examples: 82%
Documented parameters: 93%
Return-value docs: 100%
Help pages citing references: 0%

How these are measured

Downloads

385

CRAN downloads in the past year

Rank #25,178 · ~1/day · ~32/mo

Releases R versions

Daily download trend is not available in this view yet.

20430 days

38590 days

3851 year

Compare downloads with other packages →

Also on8 r2u2 autocran

How downloads are counted

Dependencies

Declared dependencies

3 external dependencies (excludes base and recommended)

Installing statfidelity adds 2 packages (2 with compiled code, 1.2 MB of source tarballs). Heaviest: jsonlite 1.0 MB, digest 231 KB.

Depends (1)

R >= 4.1.0

Imports (4)

digest jsonlitestatsutils

LinkingTo (0)

none

Suggests (1)

testthat

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

0direct

0indirect

Nothing depends on this yet.

How these are counted

Code & Tests

Datasets

People & History

People (3)

Leila Marvian Mashhad

Author, Maintainer since 0.1.0 (2026)

Hossein Hassani

Author

Steve MacFeely

Author

Releases (1)

0.1.0Latest
record
2026-09-03 · current release
R
R 4.6.0 released · 2026-04-24

Package metadata

First published: 2026-09-03
Total releases: 1 / 1 yrs
License: MIT + file LICENSE OSI
Minimum R: ≥ 4.1.0
Download size: 53 KB

Cite

Cite this package

Run in R for the authors' entry:

citation("statfidelity")

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.

Format

APA

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

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