🌐 [translation-sync] [var_dmd, svd_intro, measurement_models] Correct math, add exercises by mmcky · Pull Request #303 · QuantEcon/lecture-python.zh-cn

mmcky · 2026-10-22T00:41:38Z

Automated Translation Sync

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

Source PR

#1055 - [var_dmd, svd_intro, measurement_models] Correct math, add exercises

Files Updated

✏️ lectures/svd_intro.md
✏️ .translate/state/svd_intro.md.yml

Details

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

This PR was created automatically by the translation action.

netlify · 2026-10-22T00:41:44Z

✅ Deploy Preview for astonishing-narwhal-a8fc64 ready!

Name	Link
🔨 Latest commit	`2969f89`
🔍 Latest deploy log	https://app.netlify.com/projects/astonishing-narwhal-a8fc64/deploys/6ad95c95a0aaa600d7a48c95
😎 Deploy Preview	https://deploy-preview-303--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 · 2026-10-22T00:42:14Z

✅ Translation Quality Review

Verdict: PASS | Model: claude-sonnet-5 | Date: 2026-10-22
Routing: editor — 2 minor finding(s) in gating categories (accuracy/terminology/syntax/diff-check/other)
Shadow gate: would NOT auto-merge (recorded only; no action taken)

📝 Translation Quality

Criterion	Score
Accuracy	9/10
Fluency	8/10
Terminology	9/10
Formatting	9/10
Overall	8.8/10

Summary: This is a high-quality, technically accurate translation of a dense linear algebra/statistics lecture. Mathematical content, equation references, and code are preserved correctly, and terminology aligns well with the glossary. Minor fluency issues exist (one slightly awkward sentence split in the SVD section, a small unsupported addition in the Overview, and a minor redundancy in 'The setting' section), but these do not impede comprehension. No blocking or major issues were found in the modified sections, and no markdown/MyST syntax errors were detected. Mathematical notation, equation labels, and LaTeX are preserved accurately throughout all modified sections Core technical terminology (奇异值分解, 特征向量, 伪逆, 极分解, 主成分分析, etc.) is applied consistently and matches the provided glossary Code blocks are faithfully preserved with appropriately translated comments and print statements, maintaining functional equivalence with the source

Suggestions:

[minor · accuracy] lectures/svd_intro.md — ## Singular value decomposition: The source sentence 'This structure of the $m \times n$ matrix $X$ opens the door to constructing systems of data encoders and decoders.' is split awkwardly across two lines in the translation ('这种结构...开启了大门' / '数据编码器和解码器'), leaving a dangling fragment on its own line that reads oddly as a standalone paragraph. → 合并为一句：'$m \times n$ 矩阵 $X$ 的这种结构为构建数据编码器和解码器系统打开了大门。'
[minor · fluency] lectures/svd_intro.md — ## Overview: The translated overview paragraph adds an unsupported editorializing sentence not present in the English source ('是一个强大的数学工具，在数据分析和机器学习中有着广泛的应用'), which is an addition of information not in the original, even though it is relatively harmless framing. → 更贴近原文的翻译：'奇异值分解（SVD）是最小二乘投影应用中的主力工具，是许多统计和机器学习方法的基础。'
[minor · fluency] lectures/svd_intro.md — ## 基本设定: The phrase 'In much of this lecture, we'll think of $X$ as a matrix of data' is rendered as a flat declarative '通常，$X$通常代表一个数据矩阵' which repeats '通常' twice in close proximity (awkward redundancy) and drops the hedging nuance ('in much of this lecture... we'll think of'). → '在本讲座的大部分内容中，我们将把 $X$ 视为一个数据矩阵：'
[minor · accuracy] lectures/svd_intro.md — ## PCA与SVD的关系: Code comment translations in the DecomAnalysis class changed 'columns of P are eigenvectors' and similar comments into Chinese, which is fine, but one comment '# P的列是特征向量' slightly differs from a more literal rendering; this is a very minor stylistic note and not an error, included only as a nit-level consistency check across code comments.
[nit · terminology] lectures/svd_intro.md — ## 应用：主成分分析(PCA): Heading uses half-width parentheses '(PCA)' instead of the full-width punctuation convention generally applied to Chinese prose; while parentheses around acronyms are often kept half-width by convention, this is inconsistent with the glossary's heading entry 'Application: principal components analysis (PCA)': '应用：主成分分析(PCA)' which also lacks a space before '('. → '应用：主成分分析 (PCA)'

🔍 Diff Quality

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

Summary: The translation sync correctly updated only the target file, preserved section order and heading structure, and updated the heading-map keys to match the lowercase English heading changes made in the source.

Issues:

Source 'Road Ahead' / 'Road ahead' is a bold-text subheading not an actual markdown heading, so it correctly does not appear in translation metadata headings map - consistent in both versions
Minor: the translation's new content (e.g., new exercises svd_ex2, svd_ex3, new code cells with rng seed, font setup) is a reasonable adaptation rather than literal translation, but matches source's new structural additions (Exercises section, two new exercises, new explanatory paragraphs) in position and intent
The heading 'Overview' remains correctly unchanged in both source and target heading maps since English text didn't change

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

The zh-cn rules (QuantEcon/project-translation#70): a space before inline roles (two lines, three roles) and a full-width colon (one line). All three are in passages this resync did not change. The half-width parentheses in the "应用：主成分分析(PCA)" heading are left as they are: the heading map in the front matter keys on that exact text. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Copilot

🔵 Needs a closer look

It is a large translation sync adding substantial new mathematical prose and executable exercise code whose runtime/build I cannot verify here, so it warrants human translator/maintainer review.

2 open issues

What changed in this PR

This is an automated translation-sync PR that updates the Chinese translation of lectures/svd_intro.md to match upstream English PR QuantEcon/lecture-python.myst#1055, which corrected math and added exercises for the SVD lecture. The changes keep the zh-cn book in sync with the source material and fit the repository's translation workflow (paired .translate/state/*.yml tracking file).

Changes:

Corrected/clarified math notation (e.g. <<→\ll, ordered singular values \sigma_1 \ge \cdots, pseudo-inverse formulas) and rewrote the four-fundamental-subspaces, Eckart-Young, reduced-SVD, polar-decomposition, and PCA sections to match the updated source.
Added three new worked exercises with executable solutions (svd_ex1–svd_ex3) covering the pseudo-inverse/OLS, numerical verification of Eckart-Young, and a VAR/DMD bridge, plus a new PCA-vs-SVD demonstration on simulated data.
Updated translation state metadata (source-sha, synced-at 2026-10-22, tool-version 0.29.6).

File	Description
`lectures/svd_intro.md`	Synced translated SVD lecture: corrected math, added exercises/solutions and a PCA demo; faithful to source but with minor terminology/link-text inconsistencies.
`.translate/state/svd_intro.md.yml`	Updated sync metadata (source commit SHA, synced-at date, tool version) for the new translation.

_{Review effort: Balanced}

 * $U$ 是一个解码器，用于处理将运算符 $\Sigma$ 应用于编码数据后的输出

-我们将在本讲稍后研究动态模态分解时应用这些概念。
+我们将在后续的 {doc}`VARs and DMDs <var_dmd>` 中研究动态模态分解时应用这些概念。


 \frac{\sum_{i = 1}^{r} \sigma^2_{i}}{\sum_{i = 1}^{p} \sigma^2_{i}}
 $$

+根据埃克特-杨定理（Eckart-Young theorem），$1$ 减去这个比率，也等于 $B$ 的最佳秩 $r$ 近似 $\hat B_r$ 的平方相对弗罗贝尼乌斯范数误差 $||B - \hat B_r||_F^2 / ||B||_F^2$。


github-actions · 2026-10-22T00:48:37Z

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

The resync of QuantEcon/lecture-python.myst#1055 regenerates all three of its lectures, but svd_intro.md was delivered by #303 from the same English. Applying #1055's changes again altered 9 lines of a translation that was already current, so svd_intro.md and its state file go back to main's versions. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

… math, add exercises (#304) * Update translation: lectures/measurement_models.md * Update translation: .translate/state/measurement_models.md.yml * Update translation: lectures/svd_intro.md * Update translation: .translate/state/svd_intro.md.yml * Update translation: lectures/var_dmd.md * Update translation: .translate/state/var_dmd.md.yml * Update translation: lectures/_static/quant-econ.bib * Drop svd_intro from this resync: #303 already delivered it The resync of QuantEcon/lecture-python.myst#1055 regenerates all three of its lectures, but svd_intro.md was delivered by #303 from the same English. Applying #1055's changes again altered 9 lines of a translation that was already current, so svd_intro.md and its state file go back to main's versions. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * var_dmd: restore the 2025 reviewers' conventions lost in the resync The resync translated the rewritten sections of QuantEcon/lecture-python.myst#1055 afresh, so the conventions Songyi Wang and Humphrey Yang set in their 2025 review of this lecture did not survive. Restored, text only (structure unchanged: 992 lines, 16 headings, 28 directives, 88 math lines, 12 code cells, 2 links): - pseudo-inverse is 广义逆矩阵 and Moore-Penrose is 穆尔-彭罗斯 (7 lines), with the reviewers' Baidu Baike link and their note on the choice; - the case labels are 短胖型情况 and 高瘦型情况, and tall-skinny is 高瘦型; - reduced SVD is 简化 (the resync wrote 约化); - a dimension before 矩阵 takes 的: `$m \times n$ 的矩阵` (18 places). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

mmcky added 2 commits October 22, 2026 11:41

Update translation: lectures/svd_intro.md

2d19bde

Update translation: .translate/state/svd_intro.md.yml

0ef0326

mmcky added action-translation PRs created by QuantEcon/action-translation automated Automated sync PR opened by action-translation labels Oct 22, 2026

Copilot AI balanced review requested due to automatic review settings October 22, 2026 00:41

mmcky added action-translation PRs created by QuantEcon/action-translation automated Automated sync PR opened by action-translation labels Oct 22, 2026

Copilot started reviewing on behalf of mmcky October 22, 2026 00:42

View session

Copilot AI reviewed Oct 22, 2026

View reviewed changes

github-actions Bot temporarily deployed to pull request October 22, 2026 00:52 Inactive

This was referenced Oct 22, 2026

sync: an intro that appears or disappears (#362); parity: body admonitions' fence-line text (#407) QuantEcon/action-translation#408

Merged

Recover the nine lectures behind the English by state-sha, then merge #286, #294 and #296 #298

Closed

mmcky merged commit 0ab6a43 into main Oct 22, 2026
7 checks passed

mmcky deleted the translation-sync-2026-10-22T00-41-36-pr-1055 branch October 22, 2026 01:27

mmcky mentioned this pull request Oct 22, 2026

[var_dmd, svd_intro, measurement_models] Correct math, add exercises QuantEcon/lecture-python.myst#1055

Merged

Navigation Menu

Repository navigation

🌐 [translation-sync] [var_dmd, svd_intro, measurement_models] Correct math, add exercises - #303

🌐 [translation-sync] [var_dmd, svd_intro, measurement_models] Correct math, add exercises#303
mmcky merged 3 commits into
mainfrom
translation-sync-2026-10-22T00-41-36-pr-1055

mmcky commented Oct 22, 2026

Uh oh!

netlify Bot commented Oct 22, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Oct 22, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

github-actions Bot commented Oct 22, 2026 •

edited

Loading

Uh oh!

Uh oh!

This branch was previously deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

mmcky commented Oct 22, 2026

Automated Translation Sync

Source PR

Files Updated

Details

Uh oh!

netlify Bot commented Oct 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for astonishing-narwhal-a8fc64 ready!

Uh oh!

github-actions Bot commented Oct 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Translation Quality Review

📝 Translation Quality

🔍 Diff Quality

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🔵 Needs a closer look

Uh oh!

github-actions Bot commented Oct 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

This branch was previously deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

netlify Bot commented Oct 22, 2026 •

edited

Loading

github-actions Bot commented Oct 22, 2026 •

edited

Loading

github-actions Bot commented Oct 22, 2026 •

edited

Loading