Wendeng

I Ching: method and sources

What the program really does, and where every passage comes from.

Randomness

Each coin is decided by the browser's cryptographic random numbers (crypto.getRandomValues), heads or tails with equal chance. A cast is six throws of three coins: eighteen results, all recorded in the report as they fell. Nothing is adjusted afterwards, and a saved record shows the same hexagram.

The numbers are made on your device. No server takes part.

Coins and yarrow stalks do not have the same odds

With three coins the totals 6, 7, 8, 9 come with chances 1/8, 3/8, 3/8, 1/8. By the usual account of the yarrow method in the commentaries (大衍之数五十,其用四十有九) the chances are 1/16, 5/16, 7/16, 3/16: old yang is more common than old yin. This site uses coins because that is the most common method today and the easiest to check by hand.

Which passage to read

This site follows the rule set out by Zhu Xi in the 易学启蒙 (12th century). It is the most influential rule, not the only one.

Changing linesRead
NoneThe judgment of the first hexagram
OneThat line of the first hexagram
TwoBoth lines of the first hexagram; the upper leads
ThreeThe judgments of both hexagrams
FourThe two unchanged lines of the second hexagram; the lower leads
FiveThe one unchanged line of the second hexagram
Six乾 and 坤 read their extra statement; the rest read the second judgment

Where the text comes from

Judgments, line statements and Image lines are taken from the Zhou Yi on Chinese Wikisource, one page per hexagram. The classic is in the public domain.

  • The source marks about fifty variant readings. This site prints the received text throughout; the list of choices is kept in the program.
  • Simplified characters come from Wikisource's converter, keeping characters that must not be converted.
  • The program has its own, separately written table of the sixty-four structures. A test compares it with the titles of all 384 lines and with both trigrams of every hexagram: they agree.

The text has not been proofread line by line by a scholar. An English translation of the classic is not included yet. If you find a wrong character, please tell us.

Who wrote the plain notes

The theme and the question beside each hexagram were written by this site, with AI assistance, from the hexagram's name, its Image and the common understanding. They are pointers for beginners, not translations and not any scholar's interpretation.

What this site does not do

  • It does not attach stems, branches and "six relatives" to the lines. That is Liu Yao, a different rule set.
  • It gives no luck score and no success rate.
  • The cast does not depend on what your question says.

Sources

  • Zhou Yi with the Image, Shuo Gua and Xi Ci commentaries; text from Chinese Wikisource, read November 2026.
  • Zhu Xi, 易学启蒙, the chapter on changing lines.
  • Web Crypto API of the browser.

Versions

Casting engine 0.1.0 (November 2026): three coins, Zhu Xi's rule.

Use the I Ching toolBack to the beginner page