The short version
A Zi Wei Dou Shu chart — often translated as Purple Star Astrology or the Emperor Star chart — is a twelve-cell grid. Each cell is a palace covering an area of life (self, family, money, work, health, and so on). Fourteen major stars are distributed among those cells according to your birth data. A second layer of rules, the Four Transformations, describes how the stars behave and how a given period of time activates them.
Unlike a sun-sign horoscope, the chart is not a paragraph about your personality. It is a structured diagram with a fixed set of inputs and reproducible rules — which is exactly why it lends itself to software.
Where it comes from
The system is traditionally attributed to the Song-dynasty Daoist scholar Chen Tuan, and took its modern form in later manuscripts that circulated among court astrologers. Over centuries, different schools developed different conventions for star placement and for which transformations belong to which heavenly stem. There is no single universal standard: two calculators can legitimately produce slightly different charts.
The four building blocks
| Part | What it is | Where to learn more |
|---|---|---|
| 12 palaces (十二宫) | Fixed areas of life laid around a 12-branch grid. The Self palace is the anchor; the others follow a fixed order. | Twelve palaces guide |
| 14 major stars (十四主星) | The principal star types, led by Zi Wei and Tian Fu, plus supporting and challenging stars. | Major stars guide |
| Four Transformations (四化) | Lu, Quan, Ke and Ji — the mechanism that turns a static quality into something happening in a palace. | Si Hua guide |
| Time layers (运限) | Natal chart, ten-year decadal spans, then annual, monthly, daily and hourly layers. | Luck layers guide |
A star sitting quietly in a palace describes a temperament. Once a transformation lands on it, the tradition reads that as an event or pressure in that area of life. That distinction — quality versus activation — is the core idea to hold on to.
How it differs from Western astrology
| Western natal astrology | Zi Wei Dou Shu | |
|---|---|---|
| Grid | 12 zodiac signs + houses, planets and aspects | 12 earthly-branch palaces, no planets or zodiac signs |
| Calendar | Solar date and exact birth time | Chinese lunar calendar date + one of 12 double-hours |
| Core objects | Sun, Moon, planets | Symbolic stars (Zi Wei, Tian Ji, Tai Yang ...) with brightness grades |
| Time technique | Transits, progressions, directions | Nested decadal / annual / monthly / daily / hourly layers flying transformations |
Both systems assign meaning to a birth moment, but they are not translations of each other. If you already know Western astrology, the useful mental reset is: forget planets, think palaces and transformations. There is a longer comparison if you want the details.
A note on how to use it
This app treats the system as a piece of traditional culture and a structured reasoning exercise. It does not tell you what will happen, and its output is not medical, legal, financial or personal advice. The interesting part is the internal consistency: given the same birth data and the same rule set, the same chart and the same reading come out every time. You can study the rules, disagree with a convention, or compare schools — all of which is impossible with a generated paragraph.