ClinicoPathDescriptives is a comprehensive R package designed specifically for descriptive analysis in clinicopathological research. This toolkit bridges the gap between statistical analysis and medical research workflows by providing both programmatic R functions and an intuitive graphical interface through the jamovi statistical platform.

The package emphasizes reproducible research workflows, automated reporting capabilities, and natural language interpretation of statistical results, making advanced statistical analysis accessible to medical researchers regardless of their programming background. With over 50 comprehensive vignettes and extensive documentation, ClinicoPathDescriptives serves as both a powerful analytical tool and an educational resource for clinicopathological research.

• Table One Generation (tableone): Create publication-ready baseline characteristics tables with automatic variable type detection and appropriate statistical tests
• Cross-tabulation Analysis (crosstable): Generate comprehensive contingency tables with chi-square, Fisher's exact, and other appropriate statistical tests, including q-value corrections for multiple comparisons
• Summary Statistics (summarydata): Automated descriptive statistics with natural language interpretation and multiple output formats
• Categorical Data Reporting (reportcat): Specialized reporting tools for categorical variables with clinical context

• Age Pyramid Plots (agepyramid): Population structure visualizations for demographic analysis
• Alluvial Diagrams (alluvial): Flow visualizations for tracking categorical variable relationships and patient pathways
• Venn Diagrams (venn): Set relationship visualizations with statistical overlap analysis
• Swimmer Plots (swimmerplot): Timeline visualizations for longitudinal clinical studies and treatment responses
• Waterfall Plots (waterfall): Treatment response and biomarker change visualizations
• Variable Trees (vartree): Hierarchical data structure visualizations for complex datasets

• Benford's Law Analysis (benford): Statistical data quality assessment and fraud detection using first-digit distribution analysis
• Comprehensive Data Profiling: Automated data quality reports with missing value analysis, distribution assessments, and outlier detection
• Variable Validation: Built-in checks for data consistency and clinical plausibility

• Medical Terminology Integration: Functions and outputs designed with clinical research workflows in mind
• Journal-Ready Tables: Multiple formatting options compatible with major medical journals (NEJM, Lancet, JAMA styles)
• Statistical Best Practices: Appropriate test selection based on data characteristics and clinical research standards
• Natural Language Summaries: Automated interpretation of statistical results in clinically meaningful language

• R Programming Interface: Full programmatic control with pipe-friendly syntax and tidy data principles
• jamovi GUI Modules: Point-and-click interface for researchers without programming experience
• Reproducible Workflows: All analyses generate reproducible code regardless of interface used

• 50+ Detailed Vignettes: Step-by-step tutorials covering all package functions with clinical examples
• 22 Clinical Datasets: Real-world medical research scenarios for testing and learning
• Interactive Examples: Hands-on tutorials with interpretation guidance
• pkgdown Website: Professional documentation at serdarbalci.com/ClinicoPathDescriptives

# Install from GitHub
devtools::install_github("sbalci/ClinicoPathDescriptives")

Install the jamovi module from the jamovi library or visit ClinicoPath jamovi Module.

library(ClinicoPathDescriptives)

# Load example clinical dataset
data("histopathology")

# Generate Table One for baseline characteristics
tableone_result <- tableone(
  data = histopathology,
  grouping_variable = "Treatment_Group",
  explanatory_variables = c("Age", "Gender", "Tumor_Size", "Grade")
)

# Create cross-tabulation with statistical tests
crosstable_result <- crosstable(
  data = histopathology,
  dependent_variable = "Response",
  explanatory_variables = c("Treatment_Group", "Biomarker_Status"),
  statistical_test = TRUE
)

# Generate alluvial diagram for treatment pathways
alluvial_plot <- alluvial(
  data = histopathology,
  variables = c("Initial_Treatment", "Response", "Second_Line_Treatment")
)

• Package Website: https://www.serdarbalci.com/ClinicoPathDescriptives/
• GitHub Repository: https://github.com/sbalci/ClinicoPathDescriptives/
• jamovi Module: https://sbalci.github.io/ClinicoPathJamoviModule/
• Issue Tracking: GitHub Issues

If you use ClinicoPathDescriptives in your research, please cite:

Balci, S. (2024). ClinicoPathDescriptives: Descriptive Analysis Tools for 
Clinicopathological Research. R package version 0.0.3.90. 
https://www.serdarbalci.com/ClinicoPathDescriptives/

GPL (>= 2) - see LICENSE file for details.

Contributions are welcome! Please see our contributing guidelines and feel free to submit issues, feature requests, or pull requests.