# FCA reported-table check

Package version: 1.0.0 · prepared 2026-09-05.

## What this checks

Checks and re-renders the four-model, four-metric held-out comparison already transcribed into this portfolio from Table 1.

Paper DOI: https://doi.org/10.1177/14604582261444612

The external paper-associated archive is https://doi.org/10.5281/zenodo.18730141. That archive is distinct from this small portfolio-authored package. Its installation environment and full experiments were not executed here.

## Run locally

Prerequisite: Python 3.10 or later, CPU only. No third-party packages, GPU, network, credentials, or dataset download is required.

Extract the complete ZIP, open a terminal in its folder, and run:

```sh
python check.py
```

An assertion failure exits nonzero. A successful check prints the numeric result and a scope-specific PASS message. The equivalent notebook contains the same Python code; open notebook.ipynb with its working directory set to this extracted folder. A notebook environment is optional and is not bundled.

## Expected output

FCA leads precision and F1; logistic regression and gradient boosting tie on AUC; gradient boosting has the lowest Brier score. The script also writes figure.svg with all reported values on fixed 0-to-1 scales.

Numeric reference values are in expected.json. The scripts check them deterministically; there is no random seed or stochastic training.

## Inputs and provenance

source.json is generated from content/fca-benchmarks.json, the same reported-value transcription used by the publication lab.

provenance.json records the source, scope, package version, and SHA-256 hashes of the executable check, input data, and expected output. README, Python, equivalent notebook, source JSON, expected JSON, and provenance are included together in the ZIP.

## Limits

Re-rendering reported values is not an independent patient-level replication or model refit. It does not rerun concept extraction, hyperparameter selection, threshold selection, or clinical validation.

Fresh network verification of the external archive was unavailable during package preparation. These small checks use the portfolio's existing sourced transcription, not a newly downloaded archive. A successful check must not be described as reproducing the full paper.
