Package 'qualivahti'

Title: Local-First Qualitative Analysis Scripts (QualiVahti)
Description: Runners for the QualiVahti analysis scripts: coding review summaries, code frequency tables and charts, code-by-participant and theme-by-participant matrices, code co-occurrence network drawings, and publication-ready descriptive tables built from human-reviewed qualitative coding. All processing is local and only rows a human reviewer marked accepted or edited are counted. The scripts ship inside the package (see qv_scripts_path()) and can also be run directly with Rscript; they are the open analysis engine of the QualiVahti Local vault <https://vahtian.com/qualivahti-local/>.
Authors: Heidi Helena Andersén [aut, cre] (ORCID: <https://orcid.org/0000-0001-5923-5865>)
Maintainer: Heidi Helena Andersén <[email protected]>
License: Apache License (>= 2)
Version: 1.0.0
Built: 2026-07-09 14:19:53 UTC
Source: https://github.com/heidihelena/qualivahti-scripts

Help Index


Run the QualiVahti analysis scripts against a vault folder

Description

Executes the QualiVahti analysis scripts (shipped in the package under inst/scripts/) against a QualiVahti Local vault folder. The scripts read the human-reviewed coding files (04_Coding/reviewed_*.csv), count only rows a reviewer marked accepted or edited, write tables and charts to 12_Exports/, and append every run to the vault's audit trail. All processing is local.

Usage

qv_run(script, vault = ".", args = character())
qv_scripts_path()
qv_coding_summary(vault = ".")
qv_code_frequency(vault = ".")
qv_code_by_participant(vault = ".")
qv_theme_matrix(vault = ".")
qv_cooccurrence_network(vault = ".")
qv_results_tables(vault = ".")

Arguments

script

File name of a script in qv_scripts_path(), e.g. "coding_summary.R".

vault

Path to the vault folder (the folder that contains 04_Coding/, 07_Themes/, 12_Exports/, ...).

args

Additional command-line arguments passed to the script.

Details

The convenience wrappers run, in order of a typical study: qv_coding_summary (review progress), qv_code_frequency (frequency table + chart), qv_code_by_participant (heat map), qv_cooccurrence_network (network drawing; run the Python network builder first), qv_theme_matrix (themes across participants, read from the theme notes' codes: lists), and qv_results_tables (descriptive tables with honest captions). Charts state on the image that frequency is not importance.

Value

The script's exit status, invisibly. Outputs are written into the vault's 12_Exports/ folder; each script prints what it wrote and what to do next.

Examples

## Not run: 
qv_coding_summary("~/MyStudyVault")
qv_code_frequency("~/MyStudyVault")

## End(Not run)