File	Date	Author	Commit
Birthtime GanZhi Analysis for TCM Constitution	2015-04-01	founderfan	[7142e0] v0
Chinese Characters Hexagram Generation	2015-04-01	founderfan	[3e8803] v0.0
HuangJiJingShi Epoch Hexagram Generation	2015-04-01	founderfan	[7142e0] v0
.gitattributes	2015-04-01	founderfan	[db8ca9] :octocat: Added .gitattributes & .gitignore files
.gitignore	2015-04-01	founderfan	[db8ca9] :octocat: Added .gitattributes & .gitignore files
readme.txt	2015-04-01	founderfan	[7142e0] v0

Read Me

Chinese I Ching R Algorithms, v0 (2015-4-1)

    I Ching offers an idea to summary the world by constructing functional mappings in finite groups. Much of ancient Chinese natural and social science grew from its concepts as root. The derived theories like "Eight Diagrams", "Five Elements" became the foundation of nearly all academic fields in acient Chinese. As a result, the theories are also the high concentration of many practical and statistical experience in China during her thousands-of-year history.

    This project tries to realize these algorithms with statistical programming. Overcoming the long span has important meanings. First, we can verify the validity of algorithm with big data. Second, we can put them into unprecedented wide application in the age of data. Third, the unique inspection of I Ching that linked "all the universe" open new eyes for us in thought and methodology about interdisciplinary use of data. 

    This program is open-source for human. If you are interested in it, welcome to discuss and work together.
    
Now there are 3 projects here: 

    1. Birthtime GanZhi Analysis for TCM Constitution

        Analysis for one's congenital constitution with birth time from "Gan Zhi" and "Five Elements" theory

        Version:
            v0 (2015-4-1): first released

        Reference:
            Zhong Guo Ming Li Xue Shi Lun, Lu Zhiji, 2008
            You Yi Zhong "Ji Yin" De Tan Suo, Lu Zhiji, 2012

    2. HuangJiJingShi Epoch Hexagram Generation

        Analysis for the historical laws of human by years with algorithms of ancient I Ching book "Huang Ji Jing Shi"(Shao Yong)

        Version:
            v0 (2015-4-1): first released

        Reference:
            Huang Ji Jing Shi, [Song]Shao Yong
            "Huang Ji Jing Shi" Dao Du, Chang Bingyi, 2009

    3. Chinese Characters Hexagram Generation
        
        Analysis for the inside meaning of Chinese words by the strokes of (traiditional Chinese) characters

        Version:
            v0 (2015-4-1): first released

        Reference:
            Mei Hua Yi Shu, [Song]Shao Yong
            Xiang Shu Yi Xue Yu Ying Yong, Zhang Yansheng, 2012

Requirements for operation:
    
    1. R environment (suggested together with Rstudio):
    
        R is the statistical programming environment which our ".R" codes run in, and you can download R and Rstudio here:
            R: http://cran.rstudio.com/
            Rstudio: http://www.rstudio.com/products/rstudio/download/
    
    2. Some basic knowledge in R programming
    
        To accomplish the functions, we need to know some basic R operations, such as how to set working directory, download and install package, run R code, and input parameters in right formation.
    
    3. Some knowledge about Chinese I Ching concepts such as "Yin Yang", "Eight Diagrams (Ba Gua)", "Five Elements (Wu Xing)"
    
        Compared with using calculation to get a symbolic result from I Ching algorithms, it is harder for most people (including myself) to explain the result in the real world. The difficulty come from the complexity in analyzing interrelation of operators, and the ambiguity in explaining the concepts of symbols to the real world. So relative knowledge about I Ching are suggested, such as traditional Chinese medicine theory, "Four Pillars(Ba Zi)" Chinese astrology and "The Book of Change(Zhou Yi)".