1. Locate the year palace
Each year has a stem-branch pair (for example 丙午). Its branch identifies one of the twelve chart palaces as the annual Self palace; the other eleven annual palaces follow the fixed order from there. The app shows the annual palace position on the chart and lets you step through years with previous / next buttons, jumping to the neighbouring decadal span when you cross a boundary.
2. Fly that year's transformations
The year's heavenly stem produces its own four transformations. Separately, the stem of the annual Self palace flies transformations into the natal palaces. The app lists both, then checks where they land relative to each topic's palace: entering it, clashing it from the opposite palace, or shining on it from the trine.
| Pattern | Label in the app | Reading weight |
|---|---|---|
| Ji in the opposite palace | clash (冲) | Heaviest negative |
| Ji entering the palace | enters (入) | Next heaviest |
| Quan in the opposite palace | press (压) | Pressure; sign depends on topic |
| Lu entering the palace | enters (入) | Most tangible positive |
| Lu / Ke in the opposite palace | shines on (照) | Indirect, weaker |
3. Walk the sixteen topics
Every topic has a palace (or a pair of palaces) and an age gate. "Both parents", for example, reads the Parents palace together with the Siblings palace — the mother palace in this app's convention — and takes the heavier side when one transformation affects both. "Partnership" reads Friends; "Shop / store" reads Career with Spouse as a secondary view. Health and Parents have no lower age gate, so they are the only topics shown for a one-year-old chart.
4. Only show what the year actually touches
5. Respect layer boundaries
An annual transformation may affect the natal chart, the annual layer itself, and the monthly, daily and hourly layers below it. It cannot change the decadal layer above it. Conversely a decadal transformation can reach down into a specific year. This is the six-layer matrix, applied uniformly rather than topic by topic.
6. Check the deeper panels
In study mode the reading expands into three sections: point-by-point detail (which star and which transformation produced the line), combined readings (what happens when several transformations converge) and chart background (for instance, a relative's palace stem flying into Wealth). Formula hits from the written library are grouped under the topic they belong to and only counted for the layer they are annotated for.
A sensible caveat
Annual readings are a traditional framework for reflection, not a forecast. The source texts themselves warn that a formula being present does not mean an event must happen. Treat the output as a structured way to think about a period, and your own circumstances as the authority.