Python IchingShifa Python 周易筮法六爻卜卦 (stalk divination)

"筮"是傳統的周易起卦方式。古人以50根蓍草作為占卜工具，名為策，故此法亦稱"籌策"占卜。《周易系辭上傳》辭曰："大衍之數五十，其用四十有九。分而為二以像兩，掛一以像三，揲之以四以像四時，歸奇於扐以像閏，五歲再閏，故再扐而後掛。天一地二，天三地四，天五地六，天七地八，天九地十。天數五，地數五，五位相得而各有合。天數二十有五，地數三十，凡天地之數五十有五。此所以成變化而行鬼神也。"整個起卦過程是要求得十八個隨機數目，當中包括"六次"(即六根爻)的"三變"。

"Shi"(筮) or so-called Stalk divination, one of the oldest IChing divination method in the Chinese society, in which the ancient Chinese used 50 sticks of yarrow stalks to do divination or prediction. According to Zhouyi 周易, the number of "Da Yan" (大衍) is 50 while 1 is taken away and 49 sticks of yarrow stalks were used in divination. 49 stalks were seperated into 2 bunches respectively held by both left hand and right hand, and then one stick would be extracted from the right hand, the bunch of stalks held by right hand was divided by four, until the remainder comes, that is called the change (or 'bian'), repeating thrice. The whole process of this divination includes getting 18 random numbers. The value of Line may come after "Three Changes", that is (49 stalks - first change - second change - third change) divided by 4, it will be either 6(old yin 老陰), 7(young yang 少陽), 8(young yin 少陰), or 9(old yang 老陽). The BenGua (本卦) is formed when the value of Line is formed from the bottom to the top. If the line with value of either 6 or 9, meaning that line must have a change, like 6(old yin) change to 7(young yang), and 9 (old yang) change to 8 (old yin). Each of the lines has its own meaning or explantion. BianGua (變卦) or ZhiGua (之卦) is also formed after BenGua with value 6 or 9 has been changed.

1. 大衍之數、太一、分二、掛一、揲四、歸奇 The number of DaYan︰

#一變的過程
n=2
stalks_first = 50-1  #把太一拿走
dividers = sorted(random.sample(range(24, stalks_first), n - 1)) #分二
division  = [a - b for a, b in zip(dividers + [stalks_first+10], [10] + dividers)]
guayi = 1 #掛一
right = division[0] - guayi 
left_extract = division[1] % 4  #揲四
if left_extract == 0:
    left_extract = 4
right_extract = right % 4
if right_extract == 0:
    right_extract = 4 #歸奇
bian  = left_extract + right_extract + guayi #一變，其餘二變倣效此法，如果做for loop 這裡的掛一可以拿走，不用加上。

2. 處理變(動)爻的方法︰The way in handling the change of line(s)(yao(s))

凡卦六爻皆不變，則占本卦彖辭，而以內卦為貞，外卦為悔，彖辭為卦下之辭。
一爻變，則以本卦變爻辭
二爻變，則以本卦二變爻辭占，仍以上爻為主
三爻變，則占本卦及之卦之彖辭，即以本卦為貞，之卦為悔，前十卦(初爻出現變爻)主貞，後十卦(非初爻出現變爻)主悔
四爻變，則以之卦二不變爻占，仍以下爻為主經，亦無文，今以例推之當如此。
五爻變，則以之卦不變爻占。
六爻變，則乾、坤占二用，餘卦占之卦彖辭。

參考自【宋】‧朱熹、蔡元定《易學啟蒙》卷下考變占︰

If the Six lines without any changed lines, the explantion of Gua is based on the general explanation of BenGua.
If the Six lines with one line changed, the explanation is depended on there.
If the Six lines with two lines changed, the upper one is the main explanation.
If the Six lines with three lines changed, the explanation is lied on the BenGua's general explanation if the change line starts from the first line, while the explantion is base on BianGua's general explanation if the change line starts from the second line.
If the Six lines with four lines changed, the explanation is upon the lower line of BianGua.
If the Six lines with five lines changed, the explanation is upon the one line without change on BianGua.
If the Six lines with six lines changed, except for QianGua and KunGua with explanation on 用, use the general explanation
The above method is advocated by ZhuXi, a Confucian of Song Dynasty

3. 納甲 Najia

其後漢元帝師從梁人焦延壽的京房開創京氏易學，把筮法加入干支納甲，後世學者再加以五行、五星、六親及二十八宿等加以詳推。

Later on, an iching expert Jing Fang during the Han Dynasty created a najia method of hexagram interpretation among iching. which correlates their separate lines with elements of the Chinese calendar.

4. 安裝套件 Installation:

pip install sxtwl
pip install --upgrade ichingshifa

5. 快速起卦 Quick Start:

from ichingshifa import ichingshifa #導入周易筮法套件庫 Import ichingshifa


ichingshifa.Iching().mget_bookgua_details() #手動起卦，從下而上，適合以蓍草起卦者使用，譬如 "初爻7, 二爻8, 三爻9, 四爻7, 五爻8, 上爻9"，即 ichingshifa.mget_bookgua_details('789789') Manually input each of lines' value, e.g. Iching().mget_bookgua_details('789789')
ichingshifa.Iching().bookgua_details() #顯示隨機起卦結果 Making divination randomly
ichingshifa.Iching().datetime_bookgua('年', '月', '日', '時') #指定年月日時起卦 make divination with the specific datetime
ichingshifa.Iching().current_bookgua() #按現在的年月日時起卦，此法只有一動爻 make divination with the current datetime
ichingshifa.Iching().decode_gua("787987", "庚寅") #手動起卦，從下而上，起本卦之卦納甲
ichingshifa.Iching().qigua_now() #{'日期': '辛丑年戊戌月庚寅日甲申時', '大衍筮法': ['887888', '謙', '謙', {0: '亨，君子有終。', 1: '初六：謙謙君子，用涉大川，吉。', 2: '六二，鳴謙，貞吉。', 3: '九三，勞謙，君子有終，吉。', 4: '**：無不利，撝謙。', 5: '六五：不富，以其鄰，利用侵伐，無不利。', 6: '上六：鳴謙，利用行師，征邑國。', 7: '彖︰謙，亨，天道下濟而光明，地道卑而上行。天道虧盈而益謙，地道變盈而流謙，鬼神害盈而福謙，人道惡盈而好謙。謙尊而光，卑而不可踰，君子之終也。'}, ('動爻有【0】根。', '主要看【謙】卦彖辭。', '謙，亨，天道下濟而光明，地道卑而上行。天道虧盈而益謙，地道變盈而流謙，鬼神害盈而福謙，人道惡盈而好謙。謙尊而光，卑而不可踰，君子之終也。')], '本卦': {'卦': '謙', '五星': '太白', '世應卦': '五世卦', '星宿': ['亢', '角', '軫', '翼', '張', '星'], '天干': ['丙', '丙', '丙', '癸', '癸', '癸'], '地支': ['辰', '午', '申', '丑', '亥', '酉'], '五行': ['土', '火', '金', '土', '水', '金'], '世應爻': ['初', '應', '三', '四', '世', '六'], '身爻': '兄癸酉金', '六親用神': ['父', '官', '兄', '父', '子', '兄'], '伏神': {'伏神所在爻': '官', '伏神六親': '妻', '伏神排爻數字': 1, '本卦伏神所在爻': '官丙午火', '伏神爻': '妻丁卯木'}, '六獸': ['虎', '武', '龍', '雀', '陳', '蛇'], '納甲': ['丙辰', '丙午', '丙申', '癸丑', '癸亥', '癸酉'], '建月': ['庚申', '辛酉', '壬戌', '癸亥', '甲子', '乙丑'], '積算': [['乙丑', '丙寅', '丁卯', '戊辰', '己巳', '庚午'], ['辛未', '壬申', '癸酉', '甲戌', '乙亥', '丙子'], ['丁丑', '戊寅', '己卯', '庚辰', '辛巳', '壬午'], ['癸未', '甲申', '乙酉', '丙戌', '丁亥', '戊子'], ['己丑', '庚寅', '辛卯', '壬辰', '癸巳', '甲午'], ['乙未', '丙申', '丁酉', '戊戌', '己亥', '庚子'], ['辛丑', '壬寅', '癸卯', '甲辰', '乙巳', '丙午'], ['丁未', '戊申', '己酉', '庚戌', '辛亥', '壬子'], ['癸丑', '甲寅', '乙卯', '丙辰', '丁巳', '戊午'], ['己未', '庚申', '辛酉', '壬戌', '癸亥', '甲子']]}, '之卦': {'卦': '謙', '五星': '太白', '世應卦': '五世卦', '星宿': ['亢', '角', '軫', '翼', '張', '星'], '天干': ['丙', '丙', '丙', '癸', '癸', '癸'], '地支': ['辰', '午', '申', '丑', '亥', '酉'], '五行': ['土', '火', '金', '土', '水', '金'], '世應爻': ['初', '應', '三', '四', '世', '六'], '身爻': '兄癸酉金', '六親用神': ['父', '官', '兄', '父', '子', '兄'], '伏神': {'伏神所在爻': '官', '伏神六親': '妻', '伏神排爻數字': 1, '本卦伏神所在爻': '官丙午火', '伏神爻': '妻丁卯木'}, '六獸': ['虎', '武', '龍', '雀', '陳', '蛇'], '納甲': ['丙辰', '丙午', '丙申', '癸丑', '癸亥', '癸酉'], '建月': ['庚申', '辛酉', '壬戌', '癸亥', '甲子', '乙丑'], '積算': [['乙丑', '丙寅', '丁卯', '戊辰', '己巳', '庚午'], ['辛未', '壬申', '癸酉', '甲戌', '乙亥', '丙子'], ['丁丑', '戊寅', '己卯', '庚辰', '辛巳', '壬午'], ['癸未', '甲申', '乙酉', '丙戌', '丁亥', '戊子'], ['己丑', '庚寅', '辛卯', '壬辰', '癸巳', '甲午'], ['乙未', '丙申', '丁酉', '戊戌', '己亥', '庚子'], ['辛丑', '壬寅', '癸卯', '甲辰', '乙巳', '丙午'], ['丁未', '戊申', '己酉', '庚戌', '辛亥', '壬子'], ['癸丑', '甲寅', '乙卯', '丙辰', '丁巳', '戊午'], ['己未', '庚申', '辛酉', '壬戌', '癸亥', '甲子']]}, '飛神': ''}

print(Iching().display_pan(2023,5,27,16,0))
起卦時間︰2023年5月27日16時0分
農曆︰二零二三年四月九日
干支︰癸卯年  丁巳月  乙酉日  甲申時
旬空︰          午未    午未
月建︰丁巳
日干支長生十二運︰子  丑  寅  卯  辰  巳  午  未  申  酉  戌  亥  
         病  衰  帝旺 臨冠 冠帶 沐浴 長生 養  胎  絕  墓  死  

                 夬卦                               革卦                
六神     伏神         本卦                      伏神       之卦
 武          角 兄丁未土  ▅▅ ▅▅                       虛 官丁未土 應▅▅ ▅▅   
 虎          亢 子丁酉金 世▅▅▅▅▅                       危 父丁酉金  ▅▅▅▅▅    
 蛇          氐 妻丁亥水  ▅▅▅▅▅   身                   室 兄丁亥水 世▅▅▅▅▅    
 陳          房 兄甲辰土  ▅▅▅▅▅                妻戊午火   壁 兄己亥水  ▅▅▅▅▅    
 雀   父乙巳火   心 官甲寅木 應▅▅▅▅▅ O                     奎 官己丑土  ▅▅ ▅▅    
 龍          尾 妻甲子水  ▅▅▅▅▅                       婁 子己卯木  ▅▅▅▅▅    


【大衍筮法】
求得【夬之革】，動爻有【1】根。主要看【九二】九二：惕號，莫夜有戎，勿恤。

夬卦
【卦辭】︰揚於王庭，孚號，有厲，告自邑，不利即戎，利有攸往。
【彖】︰夬，決也，剛決柔也。健而說，決而和，揚于王庭，柔乘五剛也。孚號有厲，其危乃光也。告自邑，不利即戎，所尚乃窮也。利有攸往，剛長乃終也。
上六：無號，終有凶。
九五：莧陸夬夬，中行無咎。
九四：臀無膚，其行次且。 牽羊悔亡，聞言不信。
九三：壯於頄，有凶。 君子夬夬，獨行遇雨，若濡有慍，無咎。
九二：惕號，莫夜有戎，勿恤。
初九：壯於前趾，往不勝為咎。

【斷主客勝負】
1.客隊下卦為【乾金】，主隊上卦為【兌金】，主客關係為【比和】。
2.主隊世爻為【子丁酉金】，原神持世，費心，客隊應爻為【官甲寅木】，泄神持應，有利，主客關係為【我尅】。 
3.動爻在下卦，即客隊，變為【離火】，主客關係為【我尅】。 
4.動爻【官甲寅木】，主隊世爻【子丁酉金】，關係為【我尅】。 
5.動爻【官甲寅木】，客隊應爻【官甲寅木】，關係為【比和】 
6.伏神爻【父乙巳火】，飛神【寅木】在【官甲寅木】，伏神【巳火】，飛伏關係為【我生我生】。 
7.日干下主隊世爻臨【絕 】，客隊應爻臨【帝旺】。

6. 軟件 Application

A streamlit application Kinliuyao (堅六爻) is launched. 堅六爻排盤 https://iching.streamlitapp.com (欲窮千里目，麻煩國內朋友擔條梯子看。)

A mobile app of Ichingshifa written in Kivy https://github.com/kentang2017/iching_shifa/blob/master/kinshifa-0.2-release.apk

lichuanlong/ichingshifa