Downloads · 30 days
0
QinLei086/pec-breast-mri-vce
pec-breast-mri-vce is a image-to-image model from QinLei086. Use it when you need one image transformed into another. It is set up for diffusers. The card lists the license as other.
Original challenge artifacts for Predictive Enhancement Calibration for Latent Breast MRI Virtual Contrast Enhancement, accepted for an oral presentation at the MICCAI 2026 MAMA-SYNTH Challenge and recognized as a Top…
Downloads · 30 days
0
Access
Public
Updated Aug 7, 2026
Repo size
234 MB
Likes
0
Public
Click a slice to open those files.
.safetensors218 MB · 93%
From the Hugging Face model README
Original challenge artifacts for Predictive Enhancement Calibration for Latent Breast MRI Virtual Contrast Enhancement, accepted for an oral presentation at the MICCAI 2026 MAMA-SYNTH Challenge and recognized as a Top-3 challenge submission.
Paper · Code and reproduction guide · Interactive demo
Virtual contrast enhancement (VCE) synthesizes enhanced breast MR images from pre-contrast acquisitions. Modern latent generators offer strong image priors, but their bounded natural-image autoencoders conflict with the non-canonical intensity scale of MRI. We show that the upper bound can alter radiomic fidelity before generation, while scaling source and target independently creates a coordinate inconsistency. We propose Predictive Enhancement Calibration (PEC), which represents each pair in a shared, case-adaptive coordinate during training and predicts its unavailable upper endpoint from the pre-contrast image at inference. We integrate PEC with a pretrained FLUX latent flow transformer via parameter-efficient reference conditioning. Target round trips first isolate representation loss before generation; near-matched conditional models then compare PEC with fixed-wide and separate coordinates under comparable training budgets and backbone settings. On the fixed internal MAMA100 development cohort, PEC improves all eight point estimates in this source-only VCE setting, with paired evidence strongest for MSE and LPIPS.
PEC predicts a post-contrast intensity endpoint from a pre-contrast breast MRI
slice and uses one shared, case-adaptive coordinate for conditioning and output
decoding. The generator is a rank-128 reference-conditioning LoRA for
black-forest-labs/FLUX.2-klein-base-9B. A fixed BF16 prompt embedding and the
source-only PEC endpoint predictor are included for challenge-parity inference.
This repository is an adapter release. It does not contain the FLUX.2 transformer, VAE, text encoder, FP8 conversion, or medical images.
lora/easycontrol_lora.safetensors # final step-3156 rank-128 LoRA
pec/checkpoint_best.pt # source-only PEC endpoint predictor
pec/config.yaml # portable predictor configuration
pec/normalization.json # 47-token normalization statistics
prompt/prompt_da_peakpost_bf16.pt # fixed challenge prompt embedding
encoding.json # shared PEC intensity contract
manifest.json # provenance and source/release hashes
assets/mama_synth_challenge_objective.png # official task illustration
SHA256SUMS # release-file checksums
The release script verifies the archived source SHA-256 values before staging. Tensor values are unchanged; local filesystem paths in PyTorch/YAML metadata are replaced with portable identifiers.
First accept the FLUX.2 [klein] Base 9B license, then download this adapter:
from huggingface_hub import snapshot_download
model_dir = snapshot_download(
repo_id="QinLei086/pec-breast-mri-vce",
local_dir="models/pec-breast-mri-vce",
)
Follow the inference guide to combine these artifacts with the official base model. Standard research inference uses BF16. The challenge's FP8 base transformer can be reconstructed locally from the licensed base weights; it is not redistributed.
Once data/processed/mama_source/mama100/source.jsonl has been reconstructed
directly from public MAMA-MIA with scripts/build_mama_slice_manifest.py, the
public recipe runs endpoint prediction, PEC source encoding, the released fixed
prompt embedding, LoRA inference, and shared-coordinate decoding end to end:
bash recipes/infer_mama100.sh
Use PREPARE_ONLY=1 to verify endpoint prediction and source encoding without
loading FLUX.2 9B. The recipe explicitly ignores target paths during endpoint
prediction and strips target/mask fields from its inference manifest.
See the paper repository for the full data contract, configurations, metrics, and scripts.
This release is for non-commercial medical-imaging research only. It is not
a medical device and must not be used for diagnosis or treatment decisions.
It was developed for two-dimensional, peak-phase breast MRI VCE and has not
been clinically validated. Users must review TERMS.md and comply with the
FLUX.2 license, dataset terms, and applicable acceptable-use policies.
@misc{lei2026predictiveenhancementcalibrationlatent,
title = {Predictive Enhancement Calibration for Latent Breast MRI
Virtual Contrast Enhancement},
author = {Qin Lei and Hao Wu},
year = {2026},
eprint = {2608.03612},
archivePrefix = {arXiv},
primaryClass = {eess.IV},
url = {https://arxiv.org/abs/2608.03612}
}
Dr. Qin Lei<br> [email protected]