Skip to content

psychds

0.1.0Package record

Creating and Validating 'Psych-DS' Datasets

0packages depend
33downloads / year
0.4%test coverage
9/9flavors OK

Overview

About

Provides a 'Shiny' application and helper functions for adopting 'Psych-DS' (https://psych-ds.github.io/), a community data standard for organizing and documenting datasets in the psychological and behavioral sciences inspired by the Brain Imaging Data Structure ('BIDS'). A guided interface walks researchers through the dataset creation process, organizing tabular data files into proper 'Psych-DS' directory structures, generating new, compliant, keyword-based filenames, and generating machine-readable 'JSON' metadata. Additional tools support building and editing data dictionaries with variable-level descriptions, validating datasets against the full 'Psych-DS' specification via a bundled 'JavaScript' validator, and exploring dataset contents interactively.

Changes in 0.1.0

New Features

  • Initial CRAN release

Shiny Application

  • Three-step wizard for creating Psych-DS compliant datasets
  • Interactive file browser for selecting data files
  • Automatic detection of CSV column structures
  • Keyword-based filename standardization with batch operations
  • Auto-naming from constant columns in data files

Data Dictionary

  • Professional HTML data dictionary generator with modern styling
  • Support for variable descriptions, types, units, and constraints
  • Categorical value documentation with labels and descriptions
Show all changes in 0.1.0Hide the rest of the changes in 0.1.0
  • Summary statistics display
  • Global missing value code definitions
  • Print-to-PDF support via browser

Validation

  • Dataset structure validation against Psych-DS specification
  • JSON schema validation for dataset_description.json
  • Detailed error messages and fix suggestions
  • Step-by-step validation progress display

OSF Integration

  • Authentication with OSF Personal Access Token
  • Upload to existing projects or create new ones
  • Folder structure preservation
  • Automatic README generation

Utilities

  • run_psych_ds_app() - Launch the Shiny application
  • check_psychds_deps() - Verify package dependencies
  • generate_html_dictionary() - Programmatic dictionary generation

Documentation

  • Comprehensive pkgdown website
  • Getting Started vignette
  • Shiny App Guide vignette
  • Data Dictionaries vignette
  • Full function reference

Known Issues

  • PDF generation requires external LaTeX installation or browser print-to-PDF
  • Large datasets (>100MB) may experience slower upload times to OSF and slower validation

---

From NEWS.md in the release

Install

Health

CRAN checks
9OK
Slowest check: 2.5 min · r-release-macos-x86_64
Status changes
  • OK9 OKNow
  • OK6 OK2026-10-16
Advisories

none known

Documentation

In release 0.1.0
READMEYes · 405 wordsVignettesYes · 3 · staticNEWSYes · 100% structured · mentions 0.1.0Citation fileNoWebsiteYes
Help pages
12 (7 internal)
Examples that run
67%2 run in a plain check (1 of them under a condition) · 1 never run
Exported functions with examples
60%
Documented parameters
84%
Return-value docs
100%
Help pages citing references
0%

Downloads

33
CRAN downloads in the past year
Rank #25,559 · ~0/day · ~3/mo
psychds
Daily download trend is not available in this view yet.

Repository

3Stars
0Forks
8Open issues
0Open PRs
0Releases
77Commits
5Commit identities
77 commits · Last activity 2026-09-21
Responsiveness
How these are sampled
PRs merged (all time)
100%
Median days to close, 50 most recently updated closed issues
180
Median days to close, 50 most recently updated closed PRs
0
PracticesBeta

Repository github.com/psych-ds/psychds-r is linked, but repository-practices checks have not run for it yet.

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

Dependencies

Declared dependencies
17 external dependencies (excludes base and recommended)

Installing psychds adds 31 packages (19 with compiled code, 26 MB of source tarballs). Heaviest: bslib 5.6 MB, promises 3.1 MB, sass 2.9 MB.

Depends (1)
R >= 4.1.0
Imports (6)
LinkingTo (0)
none
Enhances (0)
none
Reverse dependencies
0direct
0indirect

Nothing depends on this yet.

People & History

People (3)
Author, Maintainer since 0.1.0 (2026)
Releases (1)
  • 0.1.0Latest
    2026-10-15 · current release ·
    10 days in CRAN's queue
    Listed in CRAN's incoming queue from 2026-10-05 20:05 to 2026-10-15 12:21 UTC, in 43 readings.
  • R
    R 4.6.0 released · 2026-04-24
Across CRAN, the median accepted release of the past year spent 19 hours in the queue, 90% under 11 days.How queue time is measured

Package metadata

First published
2026-10-15
Total releases
1 / 1 yrs
License
MIT + file LICENSE OSI
Copyright
see file inst/COPYRIGHTS for bundled 'JavaScript' library copyrights and licenses
Minimum R
≥ 4.1.0
Download size
1.2 MB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("psychds")
Leonard, B., Massachusetts Institute of Technology, & Kline Struhl, M. (2026). psychds: Creating and Validating 'Psych-DS' Datasets (Version 0.1.0) [Computer software]. https://doi.org/10.32614/CRAN.package.psychds

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.

APA

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

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