[action-translation] resync: kalman.md - #118
Conversation
mmcky
added
action-translation-sync
✅ Deploy Preview for astonishing-narwhal-a8fc64 ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
There was a problem hiding this comment.
Pull request overview
This PR forward-resyncs the Chinese translation of the Kalman filter lecture (lectures/kalman.md) to match the current upstream English source, and records the resync metadata under .translate/state/.
Changes:
- Resynced
lectures/kalman.mdcontent, including updated notation, rewritten explanations, and updated code cells/plots to align with the upstream lecture. - Added translation frontmatter (title + heading mappings) for navigation/structure alignment.
- Added resync state metadata file
.translate/state/kalman.md.ymlpointing to the upstream source commit SHA.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| lectures/kalman.md | Whole-document translation resync, including updated math notation, narrative, exercises, and code cell modernization. |
| .translate/state/kalman.md.yml | Records the upstream source SHA, sync timestamp, model, and resync mode for this file. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| \hat x^F := \hat x + \Sigma G' (G \Sigma G' + R)^{-1}(y - G \hat x) | ||
| \quad \text{和} \quad | ||
| \Sigma^F := \Sigma - \Sigma G' (G \Sigma G' + R)^{-1} G \Sigma | ||
| \mu^F := \mu + \Sigma G^\top (G \Sigma G^\top + R)^{-1}(y - G \mu) |
| \begin{aligned} | ||
| \hat x_{new} &:= A \hat x + K_{\Sigma} (y - G \hat x) \\ | ||
| \Sigma_{new} &:= A \Sigma A' - K_{\Sigma} G \Sigma A' + Q \nonumber | ||
| \mu_{\mathrm{new}} &:= A \mu + K_{\Sigma} (y - G \mu) \\ |
These {doc} targets exist only in lecture-python.myst until Phase 2
translates them; qualifying with the intermediate: intersphinx prefix
gives working links now, and a future resync restores local refs once
the targets exist. Program decision recorded 2026-07-18 (Matt).
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
✅ Translation Quality ReviewVerdict: PASS | Model: claude-sonnet-5 | Date: 2026-07-19 📝 Translation Quality
Summary: This is a high-quality resync translation that accurately preserves the mathematical content, code, and structure of the original document. Terminology is consistent with standard Chinese academic conventions for Kalman filter concepts. The main concerns are the substitution of Wikipedia links with Zhihu article links for 'Woodbury matrix identity' and 'discrete-time algebraic Riccati equation', and the addition of an 'intermediate:' namespace prefix to the kalman_filter_var reference that doesn't appear in the English source - both worth verifying for intentionality. No markdown/MyST syntax errors were found. Mathematical notation, LaTeX equations, and code blocks are preserved accurately and completely throughout the resynced document. Technical terminology such as '先验分布' (prior), '滤波分布' (filtering distribution), '预测分布' (predictive distribution), and '卡尔曼增益' (Kalman gain) is consistent and matches standard Chinese statistical/econometric usage. The added YAML 'translation' metadata block with title and headings mapping is correctly implemented per the expected sync system format. Complex mathematical explanations (e.g., Bayes' theorem, Riccati equations, convergence conditions) are translated with accurate technical meaning and appropriate academic register. Suggestions:
🔍 Diff Quality
Summary: The target document was correctly resynced to match the current English source structure, content, and code cells, with an appropriate translation heading map added. This review was generated automatically by action-translation review mode. |
…anslation#116) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Forward Resync: kalman.md
Source: QuantEcon/lecture-python.myst — lectures/kalman.md
Source commit:
7c6396aThis PR resyncs the translation to match the current source document.
Reason: The Chinese version contains substantial extra content not in the English source: a custom bivariate_normal function with docstring, additional figure references (kl_ex2_fig.png, kalman_ex3.png) not in source, extra explanatory text in exercise 2 and 3 (e.g. 'your figure should show errors decreasing irregularly', expected output description), and a footnote [^f1] citing Bishop2006 page 93 replacing the inline {note} block. It also omits some source content (e.g. detailed explanation of prior/measurement model context, the 'note' about x_hat notation, some paragraph text about President/Manhattan example, and the missile launched from 'hostile country' vs 'Y国'). Overall there are both additions unique to target and some content changes/omissions from source, but the presence of extra figures and expanded exercise text not present in source means TARGET_HAS_ADDITIONS takes priority.
Changes
Whole-file resync applied. The entire document was resynced in a single pass.
Created by action-translation forward resync