phdpablo/cfa-tutorial repository overview

⁠CFA Tutorial

A reproducible computational environment for a confirmatory factor analysis (CFA) tutorial using R and Quarto, illustrated with the WHOQOL-Bref questionnaire.

The tutorial covers model specification, a priori power analysis, simulation, data preprocessing, model estimation, fit assessment, and theoretically justified model comparisons. The article, analysis code, data, and supporting files are included in the image.

⁠Reproduce the article

The image provides the R packages, Quarto, and system dependencies required to render the article in HTML and PDF.

To run the audit:

1. Download or clone the project repository⁠.
2. Start Docker Desktop or Docker Engine.
3. Run the appropriate script from the docker folder:

Windows

audit.bat

Linux or macOS

bash audit.sh

The script downloads the image if needed, renders the article inside a temporary container, checks the generated outputs, and copies the results to the project's local docs folder. The container is removed when the process ends; the image remains available for subsequent runs.

The audit uses the eight RDS files distributed with the project to reuse previously computed simulation results.

⁠Image

docker pull phdpablo/cfa-tutorial:4.5.2

The image is based on rocker/r-ver:4.5.2. R package versions are recorded in the project's renv.lock file.

⁠Build from source

The Dockerfile is available in the project repository. To build the image yourself, run the following command from the project root:

docker build --platform linux/amd64 -f docker/Dockerfile -t phdpablo/cfa-tutorial:4.5.2 .

⁠Source code and documentation

Visit the GitHub repository⁠ for the article source, data, analysis scripts, and usage instructions.