[action-translation] resync: kalman_2.md#119
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 MyST/Jupytext lecture kalman_2.md to align with the latest upstream English source, including updated notation, additional derivations, figures/captions, and expanded computational experiments.
Changes:
- Added translation metadata (title + heading mapping) and updated section anchor to
(kalman_2)=. - Resynced/expanded the lecture content: revised state-space notation, innovations representation derivations, and multiple new/updated simulation experiments and figures.
- Added translation sync state file recording the upstream source SHA and resync metadata.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| lectures/kalman_2.md | Whole-lecture resync to match upstream content, including updated math, code cells, and MyST figure metadata. |
| .translate/state/kalman_2.md.yml | Adds resync provenance metadata (source commit, date, model, tool version). |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| mpl.rcParams['text.usetex'] = True | ||
| mpl.rcParams['text.latex.preamble'] = r'\usepackage{amsmath,amsfonts}' |
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 strong, accurate translation that faithfully conveys the technical content, equations, and narrative flow of the English source. The main concerns are non-textual additions (extra CJK font-rendering code, a duplicate import, and a possibly incorrect cross-reference prefix) introduced in the code cells and frontmatter, which should be verified against the intended build pipeline rather than being translation errors per se. Overall terminology and fluency are excellent. Mathematical notation and LaTeX equations are fully preserved and correctly rendered throughout the translation. Technical terminology (e.g., 状态空间表示, 创新表示, 卡尔曼增益矩阵, 工作伦理) is applied consistently and aligns well with domain conventions. Code comments are accurately and naturally translated, maintaining clarity for readers following the code cells. Sentence structure and academic register read fluently in Chinese, closely mirroring the logical flow of the English original. Suggestions:
🔍 Diff Quality
Summary: The resync correctly re-aligns the target document to the current source, with matching structure, section order, and an accurate translation heading map. This review was generated automatically by action-translation review mode. |
The resync kept upstream's text.usetex=True config but dropped the zh-specific LaTeX adaptation (CJKutf8 package + the cjk() wrapper that renders Chinese under usetex), while retaining the 13 cjk() call sites in the plotting cells. Every figure cell raised NameError: name 'cjk' is not defined. Restored the setup block from the current translation (same i18n-adaptation class as the dropped font blocks in #107). Also adds the missing trailing newline (QuantEcon/action-translation#116). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The upstream rewrite introduced \mathbb{E}[...] notation in plot titles
and labels; the CJK-adapted preamble carried only CJKutf8+amsmath, so
under text.usetex=True the \mathbb control sequence was undefined and
fig.tight_layout() raised RuntimeError (latex failed). Upstream's own
preamble is amsmath,amsfonts; this restores amsfonts alongside the
zh-specific CJKutf8 adaptation.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Forward Resync: kalman_2.md
Source: QuantEcon/lecture-python.myst — lectures/kalman_2.md
Source commit:
7c6396aThis PR resyncs the translation to match the current source document.
Reason: The Chinese translation is based on an older/different version of this lecture and is missing large amounts of content present in the English source: the innovations representation math (Kalman gain formulas, K_t, L_t derivations), the state-space equations' updated notation (multivariate_normal, epsilon vs w), figures/captions using MyST figure directives, several code cells (e.g. G=[g,0] vs G=[g,1], different sigma parameterization as variances vs std devs), the T=100 vs T=50 experiments, random_state usage, and multiple explanatory paragraphs about learning speed, beta/alpha effects, observability conditions (g≠0, β≠0), and the final experiments comparing hard-working vs normal workers with different plots/captions. The target also has some content not aligned (e.g., different simulate_workers signature, some paragraphs paraphrased differently, missing detailed math like Sigma_t formulas). Overall substantial source content is missing/altered in translation, requiring re-translation to fully match updated source.
Changes
Whole-file resync applied. The entire document was resynced in a single pass.
Created by action-translation forward resync