CARSGuard v0.1.0-alpha

CARSGuard v0.1.0-alpha

Initial alpha release of CARSGuard, a validation and quality-control framework for assessing physical realism, Raman consistency, artifact risk, and confidence in CARS/BCARS spectra.

Added

• CARS/BCARS spectrum loading utilities
• Raman spectrum loading utilities
• CARSBench adapter for simulated spectra
• Dataset benchmark-table workflow
• Spectrum preprocessing and harmonization utilities
• Spectral feature extraction
• Reference profile construction
• Nearest-reference comparison utilities
• BCARS/CARS realism scoring
• Raman consistency scoring
• Artifact-risk scoring
• Confidence scoring
• JSON and text validation report export
• Configuration files for preprocessing, references, and scoring
• Unit tests for adapters, config, features, loaders, preprocessing, and scoring
• GitHub Actions CI for automated testing
• Citation metadata with CITATION.cff
• Improved README with installation, workflow, scores, limitations, and roadmap

Notes

The dataset and large generated outputs are not included in the repository.

CARSGuard is for research, education, benchmarking, and portfolio demonstration. It is not intended for clinical diagnosis, medical decision-making, or deployment in real healthcare settings.

This release is labeled as alpha because scoring rules are partly heuristic and should be expanded with stronger real-data validation.