Skip to content

feat(steering): add FKC steered denoiser with RMSD/FNC CVs and examples#214

Draft
YuuuXie wants to merge 1 commit into
mainfrom
yuxie1/fkc-steering-v2
Draft

feat(steering): add FKC steered denoiser with RMSD/FNC CVs and examples#214
YuuuXie wants to merge 1 commit into
mainfrom
yuxie1/fkc-steering-v2

Conversation

@YuuuXie
Copy link
Copy Markdown
Collaborator

@YuuuXie YuuuXie commented May 12, 2026

Add Feynman-Kac Control (FKC) steering denoiser and supporting components:

Source code:

  • steering/dpm_fkc.py: FKC steered denoiser with analytical Girsanov weights
  • steering/collective_variables.py: Add RMSD, FractionNativeContacts CVs
  • steering/potentials.py: Add LinearPotential
  • steering/utils.py: Add compute_sequence_alignment, kabsch_align
  • denoiser.py: Add GuidedScore dataclass for FKC pre-scaled scores
  • config/steering/cv_steer.yaml: FKC steering config example
  • toy_gmm.py: 1D Gaussian mixture model for toy examples

Examples:

  • notebooks/fkc_steering.py: FKC steering toy demonstration
  • notebooks/gmm_umbrella_mbar.py: GMM umbrella sampling with MBAR analysis

Tests:

  • test_integration.py: FKC integration, ODE consistency, cv_steer config tests
  • test_potentials.py: LinearPotential unit tests
  • test_utils.py: Sequence alignment tests
  • test_steering_numerically.py: Numerical validation on GMM

Add Feynman-Kac Control (FKC) steering denoiser and supporting components:

Source code:
- steering/dpm_fkc.py: FKC steered denoiser with analytical Girsanov weights
- steering/collective_variables.py: Add RMSD, FractionNativeContacts CVs
- steering/potentials.py: Add LinearPotential
- steering/utils.py: Add compute_sequence_alignment, kabsch_align
- denoiser.py: Add GuidedScore dataclass for FKC pre-scaled scores
- config/steering/cv_steer.yaml: FKC steering config example
- toy_gmm.py: 1D Gaussian mixture model for toy examples

Examples:
- notebooks/fkc_steering.py: FKC steering toy demonstration
- notebooks/gmm_umbrella_mbar.py: GMM umbrella sampling with MBAR analysis

Tests:
- test_integration.py: FKC integration, ODE consistency, cv_steer config tests
- test_potentials.py: LinearPotential unit tests
- test_utils.py: Sequence alignment tests
- test_steering_numerically.py: Numerical validation on GMM

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant