Package index • PTSDdiag

Data Preparation

Functions for preparing and standardizing PCL-5 and CAPS-5 data

Functions for calculating PTSD diagnoses and total scores

calculate_ptsd_total(): Calculate PTSD total score
create_ptsd_diagnosis_binarized(): Determine PTSD diagnosis based on DSM-5 criteria using binarized scores
create_ptsd_diagnosis_nonbinarized(): Determine PTSD diagnosis based on DSM-5 criteria using non-binarized scores

Functions for analyzing optimal symptom combinations

optimize_combinations(): Find optimal symptom combinations for diagnosis (non-hierarchical)
optimize_combinations_clusters(): Find optimal symptom combinations for diagnosis (hierarchical/cluster-based)
apply_symptom_combinations(): Apply pre-specified symptom combinations to new data
score_all_combinations(): Score every candidate symptom combination
analyze_best_six_symptoms_four_required(): Find optimal non-hierarchical six-symptom combinations for PTSD diagnosis
analyze_best_six_symptoms_four_required_clusters(): Find optimal hierarchical six-symptom combinations for PTSD diagnosis

Compare multiple optimization scenarios in one call and visualise the results

compare_optimizations(): Run multiple PTSD optimization scenarios in one call
print(<ptsdiag_comparison>): Print method for ptsdiag_comparison objects
summarize_top_combinations(): Build a tidy comparison table of top combinations across scenarios
symptom_frequency(): Per-symptom inclusion counts across optimization scenarios
plot_symptom_frequency(): Heatmap of PCL-5 symptom selection frequency across optimization scenarios

Share derived symptom definitions across research groups and evaluate them at validation sites — the full derivation-to-validation chain

extract_definitions(): Extract portable symptom definitions from a comparison
write_combinations(): Write symptom combinations to a JSON file
read_combinations(): Read symptom combinations from a JSON file
as_definitions(): Convert imported combination specifications into definitions
evaluate_definitions(): Evaluate symptom definitions against a sample

Functions for creating summaries and comparing diagnostic approaches

summarize_ptsd(): Summarize PTSD scores and diagnoses
summarize_ptsd_changes(): Summarize changes in PTSD diagnostic metrics
create_readable_summary(): Create readable summary of PTSD diagnostic changes
create_icd11_diagnosis(): Apply ICD-11 PTSD diagnostic criteria to PCL-5 data
create_caps5_diagnosis(): Compute CAPS-5 DSM-5-TR PTSD diagnosis
compare_diagnostic_systems(): Compare multiple diagnostic systems against a reference standard

Model validation methods

holdout_validation(): Perform holdout validation for PTSD diagnostic models
cross_validation(): Perform k-fold cross-validation for PTSD diagnostic models

Example and simulated datasets