Metadata-Version: 2.1
Name: ichingshifa
Version: 2.6.2
Summary: A package of iching stalk divination (texts written in Traditional Chinese)
Home-page: https://github.com/kentang2017/iching_shifa
Author: Ken Tang
Author-email: kinyeah@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown

# 周易筮法卜卦 Iching Shifa (stalk divination)

![alt text](https://upload.wikimedia.org/wikipedia/commons/a/af/French_Polished_Yarrow_stalks_from_LPKaster.jpg "Stalk divination")

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

整個起卦過程是要求得十八次的隨機數目，當中包括"六次"(即六根爻)的"三變"。

**1. 大衍之數、太一、分二、掛一、揲四、歸奇**︰

```python
n=2
stalks = 50-1 #50根蓍草，一根是太一，太一拿走，分二象
division = np.random.multinomial(stalks_first, np.ones(n)/2, size=1)[0] #一變的過程 (分二、掛一、揲四、歸奇)
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 這裡的掛一可以拿走，不用加上。
```
上述為一變，一變重複三次，49策 - 一變 - 二變 - 三變 = 爻。(建議三變不要以for loop做；for loop做出來的六爻動概率稍高。)

而每一根爻的數值可以是**6(老陰)、7(少陽)、8(少陰)或者 9(老陽)**。

上述求爻數值重複六次，第一爻為初爻，從底而上，形成本卦，然後依據卦的變爻多寡求出占卜結果。

**2. 處理變爻的方法︰**

1. 凡卦六爻皆不變則占本卦彖辭而以內卦為貞外卦為悔彖辭為卦下之辭

2. 一爻變則以本卦變爻辭

3. 二爻變則以本卦二變爻辭占仍以上爻為主

4. 三爻變則占本卦及之卦之彖辭即以本卦為貞之卦為悔前十卦主貞後十卦主悔

5. 四爻變則以之卦二不變爻占仍以下爻為主經 亦無文今以例推之當如此

6. 五爻變則以之卦不變爻占

7. 六爻變則乾坤占二用餘卦占之卦彖辭

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


**3. 安裝套件**:
```
pip install --upgrade numpy
pip install --upgrade ichingshifa
```

**4. 快速起卦**:
```
from ichingshifa import ichingshifa
ichingshifa.bookgua_details() 
```

ichingshifa.bookgua_details() 包括以下資訊︰

1. 顯示六爻組合(ichingshifa.bookgua_details()[0])

2. 本卦 (ichingshifa.bookgua_details()[1])

3. 卦辭、初爻、爻二、爻三、爻四、爻五、上爻、彖辭 (ichingshifa.bookgua_details()[2])

4. 動(變)爻數目 (ichingshifa.bookgua_details()[3])

5. 之卦 (如有) 及 卦爻解釋 (ichingshifa.bookgua_details()[4])






