Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

eigen_I: define diagonalisability and multiplicity — the power-iteration precondition is never explained

Aperta Adatta ai principianti
#808 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
78/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Tranquilla
Stack tecnologico
jupyter-notebook
Ambito
documentation

Direzione di ricerca

Inizia in eigen_I.md dalla discussione esistente sull’iterazione delle potenze e leggi il materiale circostante sugli autovalori. Aggiungi l’introduzione richiesta alle molteplicità algebrica e geometrica, un esempio concreto di matrice difettiva 2×2 e un riferimento incrociato che spieghi la precondizione; lascia la forma canonica di Jordan e le conseguenze per lo spazio degli stati a linear_models.md e issue #1018.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

enhancement

eigen_I.md teaches eigenvalues, eigenvectors and power iteration over 33 KB, and uses the word "diagonalizable" exactly once — at the point where it introduces power iteration:

Power iteration is a method for finding the greatest absolute eigenvalue of a diagonalizable matrix.

The term is never defined, and the lecture contains no mention of algebraic or geometric multiplicity, defective matrices, or repeated eigenvalues. So the lecture states a precondition for a method it teaches, and gives the reader no way to know when that precondition holds or what happens when it fails.

Suggested scope

A short addition, sized to the intro series:

  • When diagonalisation fails — algebraic versus geometric multiplicity, and what makes a matrix defective
  • A worked example — the smallest defective matrix is 2×2 with a repeated eigenvalue and a one-dimensional eigenspace, which is concrete enough to show rather than assert
  • A sentence at the power-iteration precondition connecting back, so the one existing use of "diagonalizable" stops being unexplained

The Jordan normal form itself is not proposed here — that and its consequences for linear state-space transients stay in QuantEcon/lecture-python.myst#1018.

Why the split

Both halves descend from Tom Sargent's brief in QuantEcon/meta#28, which filed Jordan form under "Linear state-space dynamics". Reviewing that in QuantEcon/meta#344, the decision was to split it: the prerequisite belongs here, because a reader who meets a defective matrix in the intro series should not have to reach the intermediate series to learn what happened, and the gap stands on its own independently of state-space models. The dynamics consequence — how a Jordan block produces polynomial-times-exponential transients rather than pure exponentials — stays with linear_models.md in lecture-python.myst.

Lingua principale
Jupyter Notebook
Stelle
65
Fork
31
Merge medio
2g 15h
PR unite (30g)
11

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di QuantEcon/lecture-python-intro

Tutte le issue di QuantEcon/lecture-python-intro

Issue simili

Altre issue su Documentation

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.