summarize_nmap_s2_self_report: Summarize Self-Report Completion for NMAP Session 2

In PennStateDEPENdLab/dependlab: Useful functions for the UNC Chapel Hill DEPENd Lab (Director: Michael Hallquist)

Summarize Self-Report Completion for NMAP Session 2

Description

This function processes and summarizes self-report data for NMAP session 2. It calculates the number of complete items, missing items, and the percentage of completion for each psychological measure per participant. The function integrates data from Qualtrics, filters based on session-specific criteria, and excludes certain IDs as specified.

Usage

summarize_nmap_s2_self_report(...)

Details

The function performs the following operations: - Checks for the presence of Qualtrics API credentials. - Fetches raw self-report and session 3 data from Qualtrics. - Excludes specific IDs based on predefined criteria (e.g., PSU IDs). - Calculates completion metrics (# complete, # missing, such as IIP, CTQ, PANAS, PID, and others. - Returns a cleaned dataset with summarized completion metrics per participant.

Value

A data frame containing the following columns for each participant: - 'id': Participant ID. - Completion metrics for each measure: - Number of complete items ('*_complete'). - Number of missing items ('*_missing'). - Percentage of completion ('*_percent').

Note

Ensure that Qualtrics API credentials are set in the environment using 'qualtrics_api_credentials()'.

Author(s)

Rachel Velasquez

Examples

## Not run: 
# Run the function to summarize self-report completion:
results <- summarize_nmap_s2_self_report()
head(results)

## End(Not run)

PennStateDEPENdLab/dependlab documentation built on Dec. 14, 2024, 7:12 a.m.