About HexSage: Deterministic I Ching Algorithms and Texts

Everything you need to know about hexsage, our mathematical verification standards, and why we strictly separate deterministic classical algorithms—50-stalk Da Yan modulo-4 combinatorics, astronomical True Solar Time, and Han dynasty Jing Fang charting—from modern analytical commentary.

Engine 1: Da Yan 50-Stalk Modulo-4 Arithmetic

Zero LLM involvement. Pure recursive remainder arithmetic matching Chapter 9 of the Da Zhuan (Great Treatise):

Pool_0 = 50 -> Set aside 1 (Taiji) -> Active = 49
For step k in 1..3:
  Split(Active) -> Left_k, Right_k
  Observer = 1 drawn from Right_k
  Rem_L = Left_k mod 4 (if 0 then 4)
  Rem_R = (Right_k - 1) mod 4 (if 0 then 4)
  Active = Active - (1 + Rem_L + Rem_R)
Line_Value = Active / 4 in {6, 7, 8, 9}
Exact Distribution: P(6)=1/16, P(7)=5/16, P(8)=7/16, P(9)=3/16

Live Deterministic Integrity Verification

Casting Layer: 100% Deterministic Combinatorics (0% Generative AI)
Calendar Layer: VSOP87 Solar Longitude & Equation of Time (±0.5s precision)
Primary Text Layer: Unaltered Zhouyi & James Legge (1882) Concordance
Run 10,000-Trial Benchmark → Inspect 64 Texts

Why Probabilistic Integrity Matters: Our Charter on Algorithms vs. AI

Anyone researching about hexsage from within traditional Yijing study circles—such as OnlineClarity or the r/iching scholarly community—rightly asks a fundamental methodological question: What role does mathematics play versus modern software in an online consultation?

In recent years, dozens of superficial websites have attempted to replace classical casting protocols and canonical line statements with unconstrained large language model (LLM) chat prompts. From both a mathematical and sinological standpoint, that approach is fundamentally flawed. Autoregressive text models cannot generate true binomial (`1:3:3:1`) or fifty-stalk modulo-4 (`1:3:5:7`) probability distributions, and they routinely hallucinate or flatten the austere imagery of the Bronze Age Yao Ci.

Therefore, the core engineering principle you should know about hexsage is our strict Two-Layer Separation Charter:

  1. 100% Deterministic Casting, Astronomy, and Charting (Zero AI): Every three-coin toss, every eighteen-change yarrow stalk partition on /yarrow-stalks-i-ching, every Zhu Xi moving-line reduction on /how-to-read-changing-lines, every solar longitude calculation, and every Han dynasty Jing Fang Najia stem-branch assignment is executed by deterministic, auditable mathematical code.
  2. Unaltered Classical Textual Concordance: All sixty-four hexagram pages in our 64 Hexagrams archive and our I Ching Interpretation lookup present structured, human-verified classical judgments, trigram attributes, and line statements free forever. Optional workspace notes never overwrite or distort the primary text.
About HexSage architecture diagram showing deterministic 50-stalk yarrow math, VSOP87 solar astronomy, and classical Zhouyi texts
Figure 1: Three-pillar architecture uniting modulo-4 combinatorics, celestial mechanics, and sinological fidelity.

Three Pillars of the HexSage Classical Engine

When scholars read about hexsage in comparative tool indexes or university resource guides, three technical implementations distinguish our platform from simple random-number lookup scripts:

Architectural Pillar Primary Historical Source Computational Implementation
1. Da Yan 50-Stalk Combinatorics Xici Zhuan (Great Treatise, Ch. 9) & Zhu Xi's Yixue Qimeng Recursive 3-step modulo-4 remainder partitioning yielding exact 1/16 Old Yin and 3/16 Old Yang ratios
2. Han Dynasty Jing Fang Najia Jing Fang (77–37 BCE) Jing Shi Yi Zhuan & Eight-Palace (Ba Gong) system 6-bit binary XOR palace transformations, Heavenly Stems, Earthly Branches, and Subject-Object (Shi-Ying) coordinates
3. VSOP87 True Solar Time Classical Sexagenary Calendar (Gan-Zhi) & Celestial Mechanics Apparent solar longitude (24 solar terms) plus Equation of Time eccentricity and longitude offset calibration

Why Han Dynasty Jing Fang Najia Matters for English Readers

Most English-language websites stop at translating the King Wen sequence titles. However, as documented in historical scholarship on Jing Fang and Han dynasty Yijing studies, Chinese practitioners for two millennia have analyzed hexagrams using both the textual line statements (Yi Li) and the mathematical stem-branch coordinates (Xiang Shu / Najia). A key detail about hexsage is that we make this complete Eight-Palace and Subject-Object (Shi-Ying) structural matrix accessible in clean English terminology alongside our organizational decision models and 6-Bit Hexagram Generator.

Open Ecosystem, Editorial Governance, and Citations

Transparency is the foundation of scholarly trust. Readers learning about hexsage can inspect our ongoing algorithmic upgrades in the public engineering changelog, watch our official YouTube 2K mathematical visualization series, browse independent translations and forums in our curated I Ching Resources directory, or exchange academic citations via our I Ching Links hub. Bloggers and educators can also embed our zero-cookie calculators using our free I Ching Widgets studio.

HexSage is developed and maintained by Yaoguang Technology Limited (Hong Kong), an independent research team of computational mathematicians, classical philologists, and systems engineers. What distinguishes the team about hexsage is our commitment to open mathematical verification: every equation governing fifty-stalk sorting, twenty-four solar term boundaries, and six-bit trigram transitions is documented in plain sight for peer inspection. When university students, sinologists, or long-time practitioners inquire about hexsage and our editorial workflow, we point directly to our primary concordance tables where every judgment and line statement is cross-checked against classical Chinese editions. Another foundational fact about hexsage is our strict user privacy architecture—personal study logs and workspace notes are encrypted in transit and never sold or used to train third-party models. Whether you are exploring about hexsage for academic citation, testing our modulo-4 probability benchmarks, or embedding our tools on your own study blog, our engineering desk welcomes rigorous technical feedback. For peer review inquiries, errata reports on any of the 384 line commentaries, or institutional collaboration, please contact our editorial desk at support@hexsage.ai or visit our official Contact & Corporate Governance page.

Complete 64 Hexagrams Concordance Directory

Explore all sixty-four canonical hexagrams below to verify our structural trigram tables, classical judgments, and line-by-line commentaries:

#1 Qian · The Creative → #2 Kun · The Receptive → #3 Zhun · Difficulty at Beginning → #4 Meng · Youthful Folly → #5 Xu · Waiting → #6 Song · Conflict → #7 Shi · The Army → #8 Bi · Union → #9 Xiao Xu · Small Restraint → #10 Lu · Treading → #11 Tai · Peace → #12 Pi · Standstill → #13 Tong Ren · Fellowship → #14 Da You · Great Possession → #15 Qian · Humility → #16 Yu · Enthusiasm → #17 Sui · Following → #18 Gu · Decay → #19 Lin · Approach → #20 Guan · Contemplation → #21 Shi He · Biting Through → #22 Bi · Grace → #23 Bo · Splitting Apart → #24 Fu · Return → #25 Wu Wang · Innocence → #26 Da Xu · Great Accumulation → #27 Yi · Nourishment → #28 Da Guo · Preponderance → #29 Kan · Abyssal Water → #30 Li · Clinging Fire → #31 Xian · Mutual Attraction → #32 Heng · Duration → #33 Dun · Retreat → #34 Da Zhuang · Great Power → #35 Jin · Progress → #36 Ming Yi · Darkening Light → #37 Jia Ren · The Family → #38 Kui · Opposition → #39 Jian · Obstruction → #40 Xie · Deliverance → #41 Sun · Decrease → #42 Yi · Increase → #43 Guai · Breakthrough → #44 Gou · Coming to Meet → #45 Cui · Gathering → #46 Sheng · Pushing Upward → #47 Kun · Oppression → #48 Jing · The Well → #49 Ge · Revolution → #50 Ding · The Cauldron → #51 Zhen · Arousing Thunder → #52 Gen · Keeping Still → #53 Jian · Gradual Progress → #54 Gui Mei · Marrying Maiden → #55 Feng · Abundance → #56 Lu · The Wanderer → #57 Xun · Gentle Wind → #58 Dui · Joyous Lake → #59 Huan · Dispersion → #60 Jie · Limitation → #61 Zhong Fu · Inner Truth → #62 Xiao Guo · Small Preponderance → #63 Ji Ji · After Completion → #64 Wei Ji · Before Completion →