Feng Shui

These operations count on the Luo Shu from the year and a compass bearing. They say where the traditional stars fall. They give no cures or advice, because those vary by practitioner and we have not had any reviewed.

Feng Shui is a tradition, and these results are not a measure of how a building performs.

Kua and Eight Mansions

The digits of the year are summed down to one digit. A male's number is 11 minus that digit, and a female's is that digit plus 4, each reduced to one digit. A 5 becomes 2 for a male and 8 for a female. Some sites stop at 5.

The year turns at Li Chun by default. Some practitioners use Lunar New Year, so year_boundary lets you choose, and boundaries_agree says when it makes no difference. The traditional formula needs gender, which we use for the response and do not store.

/v1/feng-shui/house gives a building the gua of the palace it sits in. Pass an occupant's kua to see which of their mansions the front and back fall in. The English and Hindi mansion names are translations, and other books use other words, so rely on the id.

Flying stars

Pass the facing bearing and either period or built_year. Periods last 20 years, and Period 9 runs from Li Chun 2024 to Li Chun 2044. built_year can't tell which side of Li Chun a building was finished, so pass period for buildings finished in a period's first weeks.

• Base stars: the period star at the center, flying forward along the Luo Shu path.
• Mountain and water stars: the base stars at the sitting and facing palaces move to the center. Each flies forward or in reverse according to the polarity of the sitting or facing mountain, taken at the same position in that star's home palace. A 5 takes the polarity of the period star's palace.

structure names the chart when the period star stands in a recognised place: wang_shan_wang_xiang, shang_shan_xia_shui, double_at_facing or double_at_sitting. timeliness is current for the period star, next and future for the two after it, retreating for the one before, and past otherwise. That grouping is a simplification, and schools vary.

We do not calculate replacement charts (ti gua), because schools disagree on when they apply. near_boundary is true within 3° of a mountain's edge, where a practitioner might use one or re-measure. replacement_chart is always false.

Annual and monthly stars

The year's center star comes from the digits of the year, and runs from Li Chun to Li Chun. The first month's star is 8, 5 or 2 according to the year's branch, and falls by one each month. Tai Sui is the year's branch, Sui Po is opposite it, and San Sha follows the three-harmony group of the branch. Months start at the jie, and /v1/chinese/annual gives their dates.

How it was checked

Sources are practitioner websites, not classical texts.

• Three whole charts, star for star: Period 8 S2, Period 8 SW1 and Period 9 N2. Skillon labels the SW1 chart "Up Water Up Mountain". Its 8s stand at the sitting and facing, which is the prosperous arrangement, so we return wang_shan_wang_xiang, and fengshuied.com names the matching chart that way.
• The Five Yellow, Tai Sui, Sui Po and San Sha for 2025 and 2026, and the month centers for 2026, against Master Sean Chan's charts, plus one published month chart.
• Ten published Kua examples, and the Eight Mansions table, which a second site matches.
• The 24 mountains against published degrees. Some calculators start each range 0.1° later.

Bearings are compass readings, so check for magnetic interference on site.

Language

Set options.lang to hi for Hindi direction and mansion names. Star numbers and ids don't change.