Semantic text (to_text)

chart = astro.by_solar("2000-8-16", 2, "female", language="en-US")
h = chart.horoscope("2025-1-1", 0)

text = f"{chart.to_text()}\n{h.to_text()}"   # str(chart) / str(h) are equivalent

let chart = by_solar("2000-8-16", 2, Gender::Female, true, Language::EnUS, Config::default())?;
let h = chart.horoscope("2025-1-1", 0)?;

let text = format!("{}\n{}", chart.to_text(), h.to_text());

chart, _ := iztro.BySolar("2000-8-16", 2, iztro.GenderFemale, true, iztro.LanguageEnUS, nil)
h, _ := chart.Horoscope("2025-1-1", 0)

natal, _ := chart.ToText()
fortune, _ := h.ToText()

chart.palace("soul").to_text()                  # one palace
chart.surrounded_palaces("soul").to_text()      # surrounded palaces
chart.flanking_palaces("soul").to_text()        # flanking palaces
chart.decadal_list_to_text()                    # decadal timeline
chart.patterns_to_text()                        # natal patterns
h.patterns_to_text("yearly")                    # patterns from the yearly perspective

chart.PalaceToText(iztro.PalaceTarget{Key: iztro.PalaceSoul})
chart.SurroundedPalacesToText(iztro.PalaceTarget{Key: iztro.PalaceSoul})
chart.FlankingPalacesToText(iztro.PalaceTarget{Key: iztro.PalaceSoul})
chart.DecadalListToText()
chart.PatternsToText(nil)
h.PatternsToText(iztro.ScopeYearly, nil)

# Natal Chart <solar date> <hour> <gender>
## Basic Info          four lines of merged fields + birth-year mutagens (with landing palaces)
## Palace Overview     a narrow table Palace | Major Stars | Minor Stars | Decadal, Soul palace first
## Patterns            the hit list; omitted entirely when there are no hits
## Palaces             from the Soul palace in order: soul, siblings, spouse, children, wealth, health, surface, friends, career, property, spirit, parents
### soul (ren woo) · Decadal 3-12   one section per palace: major, minor and adjective stars, trine & opposite, stem flying, twelve gods, age-fortune years
### siblings (xin si) · Decadal 13-22
…

# Horoscope <solar date> (<lunar date>)
## Decadal Fortune · Soul Palace: Natal X (stem-branch)   mutagens, patterns + a twelve-palace table (Decadal | Natal | Major | Minor | Scope Stars); "Childhood Fortune" before the decadals start
## Age Fortune · Soul Palace: Natal X · Nominal Age N      palace names, mutagens, that palace's three star groups
## Yearly · Soul Palace: Natal X (stem-branch)             mutagens, patterns + a twelve-palace table (with a Twelve Gods column)
## Monthly · Soul Palace: Natal X (stem-branch)            palace names, mutagens, scope stars (with landing palaces), patterns
## Daily · …                                               as monthly
## Hourly · …                                              as monthly

# Natal Chart 2000-8-16 Tiger hour female

## Basic Info
- Solar: 2000-8-16 · Lunar: 二〇〇〇年七月十七 · Hour: Tiger hour (03:00~05:00)
- Pillars: geng chen - jia shen - bing woo - geng yin · Zodiac: dragon · Sign: leo
- Five Elements Class: wood 3rd · Soul Star: rebel · Body Star: scholar
- Soul Palace: woo · Body Palace: xu (career) · Original Palace: chen (spouse)
- Birth-Year Mutagen: sun [A]→children, warrior [B]→wealth, moon [C]→friends, fortunate [D]→health

## Palace Overview
| Palace | Major Stars | Minor Stars | Decadal |
|---|---|---|---|
| **soul** woo | emperor([+3]) | artist([-3]) | 3-12 |
| siblings si | advisor([-1]) | — | 13-22 |
| spouse chen [Original Palace] | marshal([+3]) | helper, impulsive([-3]) | 23-32 |
| children mao | sun([+3]) [A], sage([+3]) | — | 33-42 |
| wealth yin | warrior([+1]) [B], minister([+3]) | horse | 43-52 |
| health chou | fortunate([-2]) [D], advocator([-2]) | assistant, fickle | 53-62 |
| surface zi | wolf([+2]) | spark([-3]) | 63-72 |
| friends hai | moon([+3]) [C] | — | 73-82 |
| career xu [Body Palace] | judge([0]), empress([+3]) | officer | 83-92 |
| property you | — | ideologue, driven([-3]) | 93-102 |
| spirit shen | rebel([+1]) | scholar([+1]), money | 103-112 |
| parents wei | — | aide, tangled([+3]) | 113-122 |

## Patterns
- **Empress and Minister Facing the Palace** (soul): empress([+3]), minister([+3])

## Palaces

### soul (ren woo) · Decadal 3-12
- Major Stars: emperor([+3])
- Minor Stars: artist([-3])
- Adjective Stars: refined, lucky, intercepted, instigated, considery(Y)
- Trine & Opposite: Opposite surface · Trine wealth, career
- Stem ren Flying: sage [A]→children, emperor [B]→soul, officer [C]→career, warrior [D]→wealth
- Twelve Gods: Changsheng·weak, Boshi·dragon, Suiqian·downcast, Jiangqian·disastery
- Age Fortune Years: 5, 17, 29, 41, 53, 65, 77, 89, 101, 113

### siblings (xin si) · Decadal 13-22
- Major Stars: advisor([-1])
- Adjective Stars: cheerful, utopian, alone
- Trine & Opposite: Opposite friends · Trine health, property
- Stem xin Flying: advocator [A]→health, sun [B]→children, artist [C]→soul, scholar [D]→spirit
- Twelve Gods: Changsheng·sick, Boshi·consumer, Suiqian·unlucky, Jiangqian·robbed
- Age Fortune Years: 6, 18, 30, 42, 54, 66, 78, 90, 102, 114

(the other ten palaces follow in the same shape)

# Horoscope 2025-1-1 (二〇二四年腊月初二)

## Decadal Fortune · Soul Palace: Natal spouse (geng chen)
- Mutagen: sun [A]→Natal children, warrior [B]→Natal wealth, moon [C]→Natal friends, fortunate [D]→Natal health
- Patterns: Marshal, Rebel and Wolf (soul), Meeting of Wind and Cloud (soul)

| Decadal Fortune | Natal | Major Stars | Minor Stars | Scope Stars |
|---|---|---|---|---|
| soul | spouse | marshal([+3]) | helper, impulsive([-3]) | — |
| siblings | children | sun([+3]) [A], sage([+3]) | — | artist(D) |
| spouse | wealth | warrior([+1]) [B], minister([+3]) | horse | horse(D) |
| children | health | fortunate([-2]) [D], advocator([-2]) | assistant, fickle | assistant(D) |
| wealth | surface | wolf([+2]) | spark([-3]) | — |
| health | friends | moon([+3]) [C] | — | scholar(D), attractive(D) |
| surface | career | judge([0]), empress([+3]) | officer | — |
| friends | property | — | ideologue, driven([-3]) | driven(D) |
| career | spirit | rebel([+1]) | scholar([+1]), money | money(D) |
| property | parents | — | aide, tangled([+3]) | aide(D), tangled(D) |
| spirit | soul | emperor([+3]) | artist([-3]) | — |
| parents | siblings | advisor([-1]) | — | cheerful(D) |

## Age Fortune · Soul Palace: Natal career · Nominal Age 25
- Palace Names: soul→Natal career, siblings→Natal property, spouse→Natal spirit, children→Natal parents, wealth→Natal soul, health→Natal siblings, surface→Natal spouse, friends→Natal children, career→Natal wealth, property→Natal health, spirit→Natal surface, parents→Natal friends
- Mutagen: fortunate [A]→Natal health, advisor [B]→Natal siblings, scholar [C]→Natal spirit, judge [D]→Natal career
- Major Stars: judge([0]), empress([+3])
- Minor Stars: officer
- Adjective Stars: gifted, frail

## Yearly · Soul Palace: Natal spouse (jia chen)
- Mutagen: judge [A]→Natal career, rebel [B]→Natal spirit, warrior [C]→Natal wealth, sun [D]→Natal children
- Patterns: Marshal, Rebel and Wolf (soul), Money and Horse Galloping Together (spouse), Money and Horse Bearing the Seal (spouse), Scholar and Artist Flanking Life (soul, broken), Literary Stars in Hidden Support (soul)

| Yearly | Natal | Major Stars | Minor Stars | Scope Stars | Twelve Gods |
|---|---|---|---|---|---|
| soul | spouse | marshal([+3]) | helper, impulsive([-3]) | — | Suiqian·initial, Jiangqian·religious |
| siblings | children | sun([+3]) [A], sage([+3]) | — | driven(Y) | Suiqian·illness, Jiangqian·listless |
| spouse | wealth | warrior([+1]) [B], minister([+3]) | horse | money(Y), horse(Y) | Suiqian·sorrowing, Jiangqian·varied |
(the other nine rows follow in the same shape)

## Monthly · Soul Palace: Natal friends (ding chou)
- Palace Names: soul→Natal friends, siblings→Natal career, spouse→Natal property, children→Natal spirit, wealth→Natal parents, health→Natal soul, surface→Natal siblings, friends→Natal spouse, career→Natal children, property→Natal wealth, spirit→Natal health, parents→Natal surface
- Mutagen: moon [A]→Natal friends, fortunate [B]→Natal health, advisor [C]→Natal siblings, advocator [D]→Natal health
- Scope Stars: attractive(M)→property, artist(M)→surface, tangled(M)→surface, money(M)→health, driven(M)→wealth, cheerful(M)→children, aide(M)→spouse, scholar(M)→spouse, assistant(M)→soul, horse(M)→soul
- Patterns: Advisor, Moon, Fortunate and Sage (soul), Sun Shining on Thunder Gate (career), Sun and Moon Both Bright (soul), Cinnabar and Cassia Steps (soul), Bright Moon at Heaven's Gate (soul), Money and Horse Galloping Together (property), Open and Hidden Fortune (soul), Money and Horse Bearing the Seal (property), Literary Stars Facing Life (soul, broken), Literary Stars in Hidden Support (soul)

## Daily · Soul Palace: Natal surface (geng woo)
- Palace Names: soul→Natal surface, siblings→Natal friends, spouse→Natal career, children→Natal property, wealth→Natal spirit, health→Natal parents, surface→Natal soul, friends→Natal siblings, career→Natal spouse, property→Natal children, spirit→Natal wealth, parents→Natal health
- Mutagen: sun [A]→Natal children, warrior [B]→Natal wealth, moon [C]→Natal friends, fortunate [D]→Natal health
- Scope Stars: artist(d)→property, cheerful(d)→property, aide(d)→health, tangled(d)→health, money(d)→wealth, horse(d)→wealth, driven(d)→children, attractive(d)→children, scholar(d)→siblings, assistant(d)→parents
- Patterns: Fire and Wolf (soul), Bell and Wolf (soul), Marshal, Rebel and Wolf (soul), Money and Horse Galloping Together (spirit), Money and Horse Bearing the Seal (spirit), Literary Stars Facing Life (soul, broken), Literary Stars in Hidden Support (soul)

## Hourly · Soul Palace: Natal surface (bing zi)
(written like the daily section)

## soul Trine & Opposite

### Target Palace · soul (ren woo) · Decadal 3-12
- Major Stars: emperor([+3])
- Minor Stars: artist([-3])
- Adjective Stars: refined, lucky, intercepted, instigated, considery(Y)
- Trine & Opposite: Opposite surface · Trine wealth, career
- Stem ren Flying: sage [A]→children, emperor [B]→soul, officer [C]→career, warrior [D]→wealth
- Twelve Gods: Changsheng·weak, Boshi·dragon, Suiqian·downcast, Jiangqian·disastery
- Age Fortune Years: 5, 17, 29, 41, 53, 65, 77, 89, 101, 113

### Opposite Palace · surface (wu zi) · Decadal 63-72
- Major Stars: wolf([+2])
- Minor Stars: spark([-3])
- Adjective Stars: dignified
- Trine & Opposite: Opposite soul · Trine spirit, spouse
- Stem wu Flying: wolf [A]→surface, moon [B]→friends, helper [C]→spouse, advisor [D]→siblings
- Twelve Gods: Changsheng·molding, Boshi·illness, Suiqian·sinister, Jiangqian·capable
- Age Fortune Years: 11, 23, 35, 47, 59, 71, 83, 95, 107, 119

### Wealth Palace · wealth (wu yin) · Decadal 43-52
(fact lines as in the palace text)

### Career Palace · career (bing xu) · Decadal 83-92 [Body Palace]
(fact lines as in the palace text)

## Flanking Palaces

### Previous Palace · siblings (xin si) · Decadal 13-22
- Major Stars: advisor([-1])
- Adjective Stars: cheerful, utopian, alone
- Trine & Opposite: Opposite friends · Trine health, property
- Stem xin Flying: advocator [A]→health, sun [B]→children, artist [C]→soul, scholar [D]→spirit
- Twelve Gods: Changsheng·sick, Boshi·consumer, Suiqian·unlucky, Jiangqian·robbed
- Age Fortune Years: 6, 18, 30, 42, 54, 66, 78, 90, 102, 114

### Next Palace · parents (gui wei) · Decadal 113-122
- Major Stars: Empty
- Minor Stars: aide, tangled([+3])
- Adjective Stars: social, bottomless
- Trine & Opposite: Opposite health · Trine children, friends
- Stem gui Flying: rebel [A]→spirit, advocator [B]→health, moon [C]→friends, wolf [D]→surface
- Twelve Gods: Changsheng·prime, Boshi·sumo, Suiqian·tied, Jiangqian·condemned
- Age Fortune Years: 4, 16, 28, 40, 52, 64, 76, 88, 100, 112

# Decadal Timeline

| # | Natal Palace | Nominal Age | Years | Stem-Branch | Mutagen |
|---|---|---|---|---|---|
| 1 | soul | 3-12 | 2002-2011 | ren woo | sage [A]→Natal children, emperor [B]→Natal soul, officer [C]→Natal career, warrior [D]→Natal wealth |
| 2 | siblings | 13-22 | 2012-2021 | xin si | advocator [A]→Natal health, sun [B]→Natal children, artist [C]→Natal soul, scholar [D]→Natal spirit |
| 3 | spouse | 23-32 | 2022-2031 | geng chen | sun [A]→Natal children, warrior [B]→Natal wealth, moon [C]→Natal friends, fortunate [D]→Natal health |

# Patterns

- **Empress and Minister Facing the Palace** (soul): empress([+3]), minister([+3])

chart.to_text(knowledge=True)          # True takes the bundled pack for the chart language
chart.to_text(knowledge=my_pack)       # or any KnowledgePack
h.to_text(knowledge=True)
chart.palace("soul").to_text(knowledge=True)
chart.surrounded_palaces("soul").to_text(knowledge=True)
chart.flanking_palaces("soul").to_text(knowledge=True)
chart.decadal_list_to_text(knowledge=True)
chart.patterns_to_text(knowledge=True)
h.patterns_to_text("yearly", knowledge=True)

chart.to_text(knowledge=True, config=PatternConfig(borrow=False))   # all five to_text take config

let pack = KnowledgePack::builtin(Language::ZhCN).unwrap();
let opts = TextOptions::new().knowledge(&pack);

chart.to_text_with(&opts);
h.to_text_with(&opts);
chart.palace(Palace::Soul).unwrap().to_text_with(&opts);
chart.surrounded_palaces(Palace::Soul).unwrap().to_text_with(&opts);
chart.flanking_palaces(Palace::Soul).unwrap().to_text_with(&opts);
chart.decadal_list_to_text_with(&opts);
text::patterns_to_text_with(&hits, &names, &opts, chart.language);

let cfg = PatternConfig { borrow: false, ..PatternConfig::default() };
chart.to_text_with(&TextOptions::new().knowledge(&pack).pattern_config(&cfg));

opts := iztro.TextOptions{Knowledge: iztro.BuiltinKnowledge()}   // or iztro.KnowledgeFrom(pack)

chart.ToTextWith(opts)
h.ToTextWith(opts)
chart.PalaceToTextWith(iztro.PalaceTarget{Key: iztro.PalaceSoul}, opts)
chart.SurroundedPalacesToTextWith(iztro.PalaceTarget{Key: iztro.PalaceSoul}, opts)
chart.FlankingPalacesToTextWith(iztro.PalaceTarget{Key: iztro.PalaceSoul}, opts)
chart.DecadalListToTextWith(opts)
chart.PatternsToTextWith(opts)
h.PatternsToTextWith(iztro.ScopeYearly, opts)

cfg := iztro.PatternConfig{Borrow: iztro.Bool(false)}
chart.ToTextWith(iztro.TextOptions{Knowledge: iztro.BuiltinKnowledge(), PatternConfig: &cfg})

### 命宫 (壬午) · 大限 3-12
- 主星: 紫微(庙)
- 辅星: 文曲(陷)
- 杂耀: 凤阁, 天福, 截路, 蜚廉, 年解
- 三方四正: 对宫 迁移 · 三合 财帛, 官禄
- 宫干壬飞化: 天梁化禄→子女, 紫微化权→命宫, 左辅化科→官禄, 武曲化忌→财帛
- 十二神: 长生·衰, 博士·青龙, 岁前·丧门, 将前·灾煞
- 小限虚岁: 5, 17, 29, 41, 53, 65, 77, 89, 101, 113

**紫微(庙)**: 紫微星号称 `帝王星`，并非指紫微坐命者能成帝王，而是指其个性带有“王者”特质……

**文曲(陷)**: 文曲星是紫微斗数里第一文艺之星，代表艺术修养与浪漫……

**凤阁**: 凤阁星会增加比较柔和的技能天赋，比如音乐、舞蹈……

(one entry each for 天福, 截路, 蜚廉, 年解)

# 格局

- **府相朝垣** (命宫): 天府(庙), 天相(庙)

**府相朝垣**: “食禄千锺”的断语使此格备受欢迎，但成格并不必然富足。……

成立条件: 此格指 天府星 在官禄宫、天相星 在财帛宫会照命宫。……

pack = KnowledgePack.builtin().merged(KnowledgePack.from_json(open("my-school.json").read()))
chart.to_text(knowledge=pack)

system = ("You are a Zi Wei Dou Shu analyst. Answer from the given chart only; "
          "do not invent information that is not on it.")
user = f"""{chart.to_text()}

{chart.horoscope("2025-1-1", 0).to_text()}

Analyse this person's career prospects for 2025."""