Kua number and Bat Trach directions

What the columns mean

id (string)

Stable row identifier, unchanged across versions

nam_sinh (int)

Solar year of birth

gioi_tinh (string)

Male or Female

cung_phi (int)

Cung phi number, also called Kua number, from 1 to 9 and excluding 5

que_menh (string)

Menh que corresponding to the cung phi

nhom_menh (string)

East four menh or West four menh

huong_tot (string)

Four favorable directions, ordered from best, separated by semicolons

huong_xau (string)

Four directions to avoid, ordered from least unfavorable, separated by semicolons

nguon (string)

Kind of source for this row, one or more parts separated by semicolons, each being tinh-toan (computed by the engine), quy-uoc-truyen-thong, quy-uoc-he-hien-dai (convention of a tradition or of a modern system), van-ban (with the work after a colon) or bien-tap (with details); static details are also in the metadata nguon_chi_tiet, and the two largest datasets give them only there; which column belongs to which part is given by each column's loai_bang_chung in the metadata

ghi_chu (string)

Where the schools disagree on this row; empty when they do not

Release

Data release ID

2026.10.27-cd6fca71 · manifest.json

Dataset version

1.2.2

Dataset last changed

2026-10-27

Generated

2026-10-27 08:07 UTC

Rows

400 rows, 10 columns

Schema hash

81a2fd72acef43ae…Copysha256 of each column's name and type

Download this exact release

• cung-phi-bat-trach.csv · 106.1 KB · sha256 b865098afb063404…Copy
• cung-phi-bat-trach.json · 181 KB · sha256 2c31a7c46ea9e57a…Copy
• cung-phi-bat-trach.meta.json · 18.7 KB · sha256 3f652fd9127250a7…Copy

The “CSV for Excel” button at the top serves a copy with a BOM, so its hash differs from the CSV here.

Changes

Version 1.2.2 (2026-10-27), type provenance: The source book's Sino-Vietnamese reading is corrected to Bát Trạch Minh Kính (八宅明鏡), not Minh Cảnh; the source id src.bat-trach-minh-canh is kept. The data is unchanged byte for byte.

Changelog of every dataset (CHANGELOG on GitHub)

Method

This dataset goes through no calendar model.

Engine version of the release: 2.0.0.

Verification

Invariants checked on the released file itself:

• cung_phi is fully determined by nam_sinh, gioi_tinh
• que_menh is fully determined by cung_phi
• nhom_menh is fully determined by cung_phi
• huong_tot is fully determined by cung_phi
• huong_xau is fully determined by cung_phi

Evidence types in this dataset, and how far each can be checked:

• A. Recomputable: an astronomical, calendrical or arithmetic algorithm yields the value, anyone with the algorithm can recompute it, and the engine has been checked against independent sources where they exist (model profile).
• C. Convention of a tradition or of a modern system: correct by that convention, neither true nor false in an empirical sense; where schools differ is recorded in the diem-bat-dong-giua-cac-phai dataset.

Provenance

Traditional lookup rules applied by the engine to computed dates, years or stem-branch pairs, producing a table no book prints as such.

• A. Recomputable: nam_sinh
• C. Convention of a tradition or of a modern system: gioi_tinh, cung_phi, que_menh, nhom_menh, huong_tot, huong_xau

Cite this dataset

Nhật Nguyệt (2026). Kua number and Bat Trach directions (version 1.2.2, data release 2026.10.27-cd6fca71) [Data set]. CC BY 4.0. DOI 10.5281/zenodo.23009396. https://nhatnguyet.org/en/bang/cung-phi-bat-trachCopy

The concept DOI always resolves to the latest release. Zenodo mints a DOI for each release after it is published, and the next release records it in the manifest.

Licence and limitations

Released under CC BY 4.0: reuse commercially, adapt freely, attribution is all that is asked.

Source: Nhật Nguyệt (nhatnguyet.org), CC BY 4.0

This dataset records cultural and calendrical conventions, not scientific claims. It is suitable for cultural research, NLP, and calendar applications. It is not intended for predicting events, evaluating people, or making decisions that affect anyone.

Source texts: Bát Trạch Minh Kính.

Other reference tables

• The ten heavenly stems
• Compatibility matrix of the 12 earthly branches
• The twelve earthly branches
• The twelve day officers (Thap Nhi Truc)
• The 22 Major Arcana of the Tarot
• The 24 solar terms
• The 56 Minor Arcana cards
• Sexagenary cycle table (60 Hoa Giap)
• The 64 hexagrams of the I Ching
• The nine presiding stars (Cuu Dieu)
• Zodiac sign boundaries year by year, 1950 to 2050
• Retrieval evaluation set for Vietnamese folk belief and calendar
• Letter to number tables, Pythagorean and Chaldean
• Where the schools disagree
• Auspicious hours across the sixty-day stem-branch cycle
• The sixty stem-branch pairs crossed: sounds, harmony, clash and element relation
• Questions and answers on Vietnamese offering rites
• Things to avoid and practical notes for Vietnamese offering rites
• Vietnamese festivals mapped to solar dates, 2026 to 2030
• Festivals and folk beliefs of the 54 ethnic groups of Vietnam
• Vietnamese festivals, seasonal feasts and public holidays
• Vietnamese ritual offerings
• Vietnamese lunisolar calendar, 1900 to 2100
• Types of Vietnamese offering rites
• Start moments of the 24 solar terms, 1900 to 2100
• Folk inauspicious days mapped onto solar dates, 2026 to 2035
• Vietnamese offering procedures
• Daily hexagram by the Gua Qi method, 1900 to 2100
• Tam Tai, Kim Lau and Hoang Oc by birth year and year in question
• Order of the sixty Gua Qi hexagrams
• Segments of the three Lo Ban rules
• Vietnamese offering prayers (văn cúng)

See every reference table