🌐 [translation-sync] [kalman_2] Use a typed NamedTuple for WorkerModel

[mmcky]

Automated Translation Sync

This PR contains automated translations from QuantEcon/lecture-python.myst.

Source PR

#644 - [kalman_2] Use a typed NamedTuple for WorkerModel

Files Updated

• ✏️ lectures/kalman_2.md
• ✏️ .translate/state/kalman_2.md.yml

Details

• Source Language: en
• Target Language: zh-cn
• Model: claude-sonnet-5

---

This PR was created automatically by the translation action.

[netlify]

✅ Deploy Preview for astonishing-narwhal-a8fc64 ready!

Name	Link
🔨 Latest commit	4272c6f
🔍 Latest deploy log	https://app.netlify.com/projects/astonishing-narwhal-a8fc64/deploys/6a84e6cd9d83710008d74f23
😎 Deploy Preview	https://deploy-preview-238--astonishing-narwhal-a8fc64.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[github-actions]

✅ Translation Quality Review

Verdict: PASS | Model: claude-sonnet-5 | Date: 2026-08-18
Routing: editor — 1 major finding(s); 1 minor finding(s) in gating categories (accuracy/terminology/syntax/diff-check/other); accuracy 8 below floor 9; formatting 6 below floor 8
Shadow gate: would NOT auto-merge (recorded only; no action taken)

---

📝 Translation Quality

Criterion	Score
Accuracy	8/10
Fluency	9/10
Terminology	9/10
Formatting	6/10
Overall	8.2/10

Summary: The translation of the changed sections (frontmatter, state-space representation, and computational experiments) is accurate, fluent, and terminologically consistent with the glossary. The main issues are in code cells rather than prose: the cov_latex matrix rendering was altered from bmatrix to a substack-based layout that may not render as intended, and font-configuration code was added/changed in a way that diverges from the source's original matplotlib LaTeX settings. These are worth verifying but do not break the overall narrative or mathematical meaning of the prose translation. Mathematical notation and equations are accurately preserved throughout the changed sections Technical terminology (卡尔曼滤波器, 状态空间表示, 创新表示, 增益矩阵, etc.) is consistent and matches established glossary conventions Full-width Chinese punctuation is used correctly throughout prose text Spacing around inline MyST directives ({doc}, {eq}) is correctly applied per the language policy

Suggestions:

• [major · formatting] lectures/kalman_2.md — ## Some computational experiments - cov_latex block: The translation changed the LaTeX matrix rendering from \begin{bmatrix}...\end{bmatrix} to \left[ \substack{...} \right] with \; separators instead of & column separators and \\ row separators. This is a substantive change to the math formatting that departs from the source's actual bmatrix environment and risks rendering incorrectly since \substack is meant for subscripts/superscripts,… → Keep the original: r'$\Sigma_{{{}}}= \begin{{bmatrix}} {:.2f} & {:.2f} \ {:.2f} & {:.2f} \end{{bmatrix}}$'
• [minor · formatting] lectures/kalman_2.md — imports code cell after 'To conduct simulations...': The translation added extra font-configuration code (FONTPATH, mpl.font_manager, plt.rcParams) and removed the original mpl.rcParams LaTeX preamble lines present in the English source. This is a code content change beyond translation scope for a 'MODIFIED' section list that didn't include this cell's content changes, and it silently drops the original's text.usetex/preamble settings which could… → If font handling for Chinese labels is required project-wide, keep it consistent with source intent, but avoid removing the original mpl.rcParams LaTeX preamble configuration unless intentionally replaced elsewhere.
• [minor · accuracy] lectures/kalman_2.md — 'The lecture {doc}kalman_filter_var uses the same recursion...': The English source references {doc}kalman_filter_var, but the translation renders it as {doc}intermediate:kalman_filter_var, adding an 'intermediate:' namespace prefix not present in the source. This could be intentional cross-referencing to a different doc collection, but it changes the reference target and should be verified against the actual project structure. → Confirm whether 'intermediate:kalman_filter_var' is the correct cross-reference target; if not, revert to {doc}kalman_filter_var.
• [nit · fluency] lectures/kalman_2.md — axs[i].set_title code line in contour plot cell: The code comment/string '时间步'+f' {t}' is a slightly awkward string concatenation compared to a straightforward f-string; functionally correct but stylistically inconsistent with the rest of the translated code comments. → axs[i].set_title(f'时间步 {t}')

---

🔍 Diff Quality

Check	Status
Scope Correct	✅
Position Correct	✅
Structure Preserved	✅
Heading-map Correct	✅
Overall	10/10

Summary: The translation sync correctly updated the namedtuple-to-NamedTuple refactor, jupytext_version bump, and related prose in matching positions without altering document structure or headings.

---

This review was generated automatically by action-translation review mode.

[Copilot]

Pull request overview

This automated translation-sync PR updates the zh-cn kalman_2 lecture to match upstream changes from lecture-python.myst, specifically migrating the WorkerModel definition to a typed NamedTuple for clearer structure and type intent in the embedded code cells.

Changes:

• Replaced collections.namedtuple usage with a typed typing.NamedTuple class for WorkerModel.
• Updated surrounding Chinese text to refer to NamedTuple and to correctly describe create_worker as a factory function.
• Refreshed translation sync state metadata (source SHA, sync date, mode, tool version).

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
lectures/kalman_2.md	Migrates WorkerModel to a typed NamedTuple and updates related prose accordingly.
.translate/state/kalman_2.md.yml	Updates translation-sync bookkeeping (source SHA/date/mode/tool version).

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[github-actions]

🚀 Deployed on https://6a84e8da61f5c984b39bcd36--astonishing-narwhal-a8fc64.netlify.app