siat 3.7.24__py3-none-any.whl → 3.7.25__py3-none-any.whl

siat/grafix.py

@@ -243,7 +243,7 @@ def plot_line(df0,colname,collabel,ylabeltxt,titletxt,footnote,datatag=False, \
         x_end = df_end[colname].idxmin() # 末端值的x坐标 
         
         #y1=str(int(y_end)) if y_end >= 100 else str(round(y_end,2))
-        y1=str(round(y_end,2)) if abs(y_end) >= 100 else str(round(y_end,2)) if abs(y_end) >= 10 else str(round(y_end,4)) 
+        y1=str(round(y_end,2)) if abs(y_end) >= 100 else str(round(y_end,2)) if abs(y_end) >= 1 else str(round(y_end,3)) 
         plt.annotate(text=' '+y1, 
                      xy=(x_end, y_end),
                      xytext=(x_end, y_end),fontsize=annotate_size)
@@ -1614,7 +1614,7 @@ def draw_lines(df0,y_label,x_label,axhline_value,axhline_label,title_txt, \
             
             if annotate_value: #在标记曲线名称的同时标记其末端数值
                 #y1=str(int(y_end)) if y_end >= 100 else str(round(y_end,2))
-                y1=str(round(y_end,2)) if abs(y_end) >= 100 else str(round(y_end,2)) if abs(y_end) >= 10 else str(round(y_end,3))
+                y1=str(round(y_end,2)) if abs(y_end) >= 100 else str(round(y_end,2)) if abs(y_end) >= 1 else str(round(y_end,3))
                 plt.annotate(text=c+':'+y1, 
                              xy=(x_end, y_end),
                              xytext=(x_end, y_end),fontsize=annotate_size,
@@ -1669,7 +1669,7 @@ def draw_lines(df0,y_label,x_label,axhline_value,axhline_label,title_txt, \
             x_end = df_end[c].idxmin() # 末端值的x坐标 
             
             #y1=str(int(y_end)) if y_end >= 100 else str(round(y_end,2))
-            y1=str(round(y_end,2)) if abs(y_end) >= 100 else str(round(y_end,2)) if abs(y_end) >= 10 else str(round(y_end,4))
+            y1=str(round(y_end,2)) if abs(y_end) >= 100 else str(round(y_end,2)) if abs(y_end) >= 1 else str(round(y_end,3))
             plt.annotate(text=' '+y1, 
                          xy=(x_end, y_end),
                          xytext=(x_end, y_end),fontsize=annotate_size,
@@ -2004,7 +2004,7 @@ def draw_lines2(df0,y_label,x_label,axhline_value,axhline_label,title_txt, \
             x_end = df_end[c].idxmin() # 末端值的x坐标 
             
             #y1=str(int(y_end)) if y_end >= 100 else str(round(y_end,2))
-            y1=str(round(y_end,2)) if abs(y_end) >= 100 else str(round(y_end,2)) if abs(y_end) >= 10 else str(round(y_end,3))
+            y1=str(round(y_end,2)) if abs(y_end) >= 100 else str(round(y_end,2)) if abs(y_end) >= 1 else str(round(y_end,3))
             plt.annotate(text=y1, 
                          xy=(x_end, y_end),
                          xytext=(x_end, y_end),fontsize=annotate_size,

siat/stock_technical.py

@@ -2485,30 +2485,49 @@ if __name__ =="__main__":
 
 def security_technical(ticker,technical=['MACD'],indicator='Close', \
                        start='default',end='default', \
-                         MA_days=[5,20],EMA_days=[5,20], \
-                         MACD_fastperiod=12,MACD_slowperiod=26,MACD_signalperiod=9, \
+                       MA_days=[5,20],EMA_days=[5,20], \
+                       MACD_fastperiod=12,MACD_slowperiod=26,MACD_signalperiod=9, \
                              
-                         #RSI参数个数必须为3个，否则出错
-                         RSI_days=[6,12,24],RSI_lines=[20,50,80], \
-                         KDJ_days=[9,3,3],matypes=[0,0],KDJ_lines=[20,50,80], \
-                         boll_days=20,boll_years=7, \
+                       #RSI参数个数必须为3个，否则出错
+                       RSI_days=[6,12,24],RSI_lines=[20,50,80], \
+                       KDJ_days=[9,3,3],matypes=[0,0],KDJ_lines=[20,50,80], \
+                       boll_days=20,boll_years=7, \
                              
-                         resample_freq='6H',smooth=True,linewidth=1.5, \
-                         loc1='best',loc2='best', \
-                         graph=['ALL'],printout=False, \
-                         date_range=False,date_freq=False,annotate=False, \
-                         ticker_type='auto',source='auto', \
-                         price_line_color='red', \
-                         facecolor='k'):
+                       resample_freq='6H',smooth=True,linewidth=1.5, \
+                       loc1='best',loc2='best', \
+                       graph=['ALL'],printout=False, \
+                       date_range=False,date_freq=False,annotate=False, \
+                       ticker_type='auto',source='auto', \
+                       price_line_color='red', \
+                       facecolor='k'):
     
     """
-    功能：技术分析中的MACD/RSI/KDJ/布林带，支持教学演示，支持参数调节。
+    ===========================================================================
+    功能：技术分析指标的深度分析，适用于MACD/RSI/KDJ/Bollinger，支持金叉/死叉分析等。
     支持的产品：全球股票，债券（限中国内地的上市债券），基金（支持中国和美国的上市基金）。
+    主要参数：
     ticker：证券代码
-    start/end：起止日期。支持简洁方式，仅需使用start指定近期的期间长度。
-    简洁方式：mrw（近1周），l2w（近2周），l3w（近3周），mrm（近1个月），l2m（近2个月），
-    mrq（近3个月），mrh（近6个月），mry（近1年），l2y（近2年），l3y（近3年），
-    l5y（近5年），l8y（近8年），l10y（近10年），l20y（近20年），l30y（近30年），ytd（今年以来）
+    technical：技术分析指标，仅支持'MACD'、'RSI'、'KDJ'、'Bollinger'，可一次指定多个。
+    start/end：起止日期。支持简洁方式，仅需使用start指定近期的期间长度。简洁方式如下：
+        mrw（近1周），l2w（近2周），l3w（近3周），mrm（近1个月），l2m（近2个月），
+        mrq（近3个月），mrh（近6个月），mry（近1年），l2y（近2年），l3y（近3年），
+        l5y（近5年），l8y（近8年），l10y（近10年），l20y（近20年），l30y（近30年），
+        ytd（今年以来）
+    技术分析指标的参数，可手动调节，默认如下：
+        MACD_fastperiod=12,MACD_slowperiod=26,MACD_signalperiod=9
+        MA_days=[5,20],EMA_days=[5,20]
+        RSI_days=[6,12,24],RSI_lines=[20,50,80]
+        KDJ_days=[9,3,3],matypes=[0,0],KDJ_lines=[20,50,80]
+        boll_days=20,boll_years=7
+    loc1/loc2：第1和第2图例的位置，默认'best'。如果发生重合或位置不合适，可手动调节。
+    graph：显示的结果图，默认'ALL'。分析MACD时若只希望看到MACD图，可指定'MACD'。
+    annotate：是否希望将图例标示在曲线末端，默认False，防止标示文字重叠。
+    ticker_type：证券种类，默认'auto'。可强制指定股票'stock'、债券'bond'、基金'fund'。
+    source：证券价格数据源，默认'auto'。若指定'yahoo'需要特别连接互联网。
+    price_line_color：价格曲线颜色，默认'red'。
+    facecolor：背景颜色，默认黑色。
+        注意：白色背景可能遮盖部分曲线，不建议；
+        黑色背景可能与布林带中线文字标示颜色冲突，可手动指定其他颜色，例如'whitesmoke'。
     
     其他说明：套壳函数security_MACD/RSI/KDJ/Bollinger
     """
@@ -2751,7 +2770,7 @@ def security_technical2(ticker,start='default',end='default',technical='MACD', \
         resample_freq='2H',smooth=True,linewidth=1.5, \
         date_range=False,date_freq=False, \
             
-        #启用
+        #启用，替代loc1图例
         annotate=True, \
         
         #除了MACD外，其他指标均应为ALL
@@ -2770,21 +2789,82 @@ def security_technical2(ticker,start='default',end='default',technical='MACD', \
         marker_sizes=[30,120,250], \
         ):
     """
-    功能：计算和绘制证券技术分析指标的简易图，仅供进一步探索使用，仅用于单个证券(股债基)
-    
-    支持的技术分析指标：
-    OBV、SAR、VOL、PSY、ARBR、CR、EMV、TRIX、DMA、BIAS、CCI、W%R、ROC、DMI
-    支持的其他指标：不如单独的指令功能强
-    MACD、RSI、KDJ、BOLL
-    
-    关注的阈值：默认[0,25,50,75,100]，attention_values=[0,25,50,75,100], 可以自定义。
-    收盘价折线：默认红色虚线，price_line_color='red'
+    ===========================================================================
+    功能：技术分析指标的短线德宏图，建议两个月内，适合观察日差价和价量关系变化，图示简洁。
+    主要参数：
+    ticker：证券代码，除美股外需要交易所后缀，例如港股小米'01810.HK'，美股苹果'AAPL'
+    start：开始日期，格式YYYY-MM-DD，默认一个月前
+    end：结束日期，格式与start相同，默认已收盘的最近交易日
+    technical：技术分析指标，默认为MACD，单次仅可指定一个指标。支持的指标如下：
+        Bollinger：布林带
+        MACD：移动异同平均线
+        RSI：相对强弱
+        KDJ：随机指标
+        OBV：能量潮
+        SAR：抛物线/停损转向指标
+        VOL：成交量指标
+        ARBR：人气(AR)/意愿(BR)指标
+        CR：中间意愿指标
+        EMV：简易波动
+        TRIX：三重指数平滑均线
+        DMA：均线差
+        BIAS：乖离率
+        CCI：顺势指标
+        W%R：威廉超买/超卖指标
+        ROC：变动率
+        DMI：动向指标
+        PSY：心理线
+        MFI：资金流向指标
+        MOM：动量指标
+        BETA：移动贝塔系数
+        TSF：时间序列分析
+        AD：集散指标
+        MA：移动平均
+        EMA：指数移动平均
+
+    RSI_days：默认[6,14]        
+    OBV_days：默认[5,10]    
+    MA_days：默认[5,20]
+    EMA_days：默认[5,20]；EMV_day：默认14：EMV_madays：默认[9]    
+    MACD_fastperiod：默认12；MACD_slowperiod：默认26；MACD_signalperiod：默认9      
+    KDJ_fastk_period：默认9；KDJ_slowk_period：默认5；KDJ_slowk_matype：默认1
+    KDJ_slowd_period：默认5；KDJ_slowd_matype：默认1    
+    VOL_fastperiod：默认5；VOL_slowperiod：默认10        
+    PSY_days：默认[6,12]        
+    ARBR_days：默认[26]        
+    CR_day：默认30；CR_madays：默认[10,20,40,60]    
+    BULL_day：默认20；BULL_nbdevup：默认2；BULL_nbdevdn：默认2；BULL_matype：默认0    
+    DMA_fastperiod：默认10；DMA_slowperiod：默认50；DMA_madays：默认[10]
+    TRIX_day：默认12；TRIX_madays：默认[20]        
+    BIAS_days：默认[6,12,24]        
+    CCI_days：默认[6,12]        
+    WR_days：默认[13,34,89]        
+    ROC_day：默认12；ROC_madays：默认[65,12,18]        
+    DMI_DIdays：默认7；DMI_ADXdays：默认6    
+    MFI_day：默认14；MFI_madays：默认[6]
+    MOM_day：默认12；MOM_madays：默认6        
+    SAR_day：默认4；SAR_madays：默认[5,20]        
+    BETA_day：默认5；BETA_madays：默认[5,20]    
+    TSF_day：默认14；TSF_madays：默认[5,10]        
+    AD_madays：默认[]
+    
+    more_details：显示指标本身，如果原来未显示的话。默认不显示
+    attention_values：显示关注值水平线，每个技术指标可能不同，可使用列表自定义多个关注值
+    ticker_type：证券类别，默认'auto'。如果识别错误,可强制指定'stock'、'bond'、'fund'
+    source：证券价格来源，默认'auto'。特殊来源可自行指定
+
+    loc1：第1个图例的位置，默认'best'。当annotate=True时被替代
+    loc2：第2个图例的位置，默认'best'。可手动指定9个位置，例如'upper left'左上角等
+    facecolor：图形上下半区的背景颜色，默认['whitesmoke','papayawhip']
+    attention_values：关注的阈值，默认[0,25,50,75,100], 可以自定义
+    
+    下列指标可以使用强化指令security_technical：MACD、RSI、KDJ、Bollinger
     """
     # 检查ta-lib是否安装，避免浪费后续的处理
     try:
         import talib  
     except:
-        print("  #Error(security_technical2): lack of necessary package, talib")
+        print("  #Error(security_technical2): lack of necessary package - talib")
         talib_install_method()
         return None
     

siat/translate.py

@@ -935,7 +935,8 @@ def codetranslate0(code):
         
         ['005930.KS','三星电子'],
         
-        ['TCS.NS','印度塔塔咨询'],['ULVR.UK','英国联合利华'],['LOR.DE','法国欧莱雅'],
+        ['TCS.NS','印度塔塔咨询'],['ULVR.UK','英国联合利华'],
+        ['LOR.DE','巴黎欧莱雅'],['OR.PA','巴黎欧莱雅'],
         
         ['002594.SZ','比亚迪A股'],['01211.HK','比亚迪港股'],['81211.HK','比亚迪港股(人民币)'],
         ['00700.HK','腾讯港股'],['80700.HK','腾讯港股(人民币)'],
@@ -1925,6 +1926,8 @@ def codetranslate1(code):
         
         ['CDI.PA','Dior(F)'],['DIO.F','Dior(F)'],['HMI.F','Hermes(F)'],
         
+        ['LOR.DE','L\'Oréal'],['OR.PA','L\'Oréal'],
+        
         #股票：其他
         ['PG','P&G'],['KO','Coca Cola'],['PEP','Pepsi-Cola'],
         ['BRK.A','Berkshire A'],['BRK.B','Berkshire B'],['Berkshire','伯克希尔'],

{siat-3.7.24.dist-info → siat-3.7.25.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: siat
-Version: 3.7.24
+Version: 3.7.25
 Summary: Securities Investment Analysis Tools (siat)
 Home-page: https://pypi.org/project/siat/
 Author: Prof. WANG Dehong, International Business School, Beijing Foreign Studies University
@@ -8,15 +8,15 @@ Author-email: wdehong2000@163.com
 License: Copyright (C) WANG Dehong, 2024. For educational purpose only!
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: pandas-datareader
+Requires-Dist: pandas_datareader
 Requires-Dist: yfinance
 Requires-Dist: tqdm
-Requires-Dist: plotly-express
+Requires-Dist: plotly_express
 Requires-Dist: akshare
 Requires-Dist: urllib3
 Requires-Dist: mplfinance
 Requires-Dist: statsmodels
-Requires-Dist: yahoo-earnings-calendar
+Requires-Dist: yahoo_earnings_calendar
 Requires-Dist: yahooquery
 Requires-Dist: pypinyin
 Requires-Dist: seaborn
@@ -33,12 +33,20 @@ Requires-Dist: graphviz
 Requires-Dist: luddite
 Requires-Dist: pendulum
 Requires-Dist: itables
-Requires-Dist: py-trans
+Requires-Dist: py_trans
 Requires-Dist: bottleneck
 Requires-Dist: translate
 Requires-Dist: translators
 Requires-Dist: nbconvert
 Requires-Dist: playwright
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: summary
 
 
 # What is siat?

{siat-3.7.24.dist-info → siat-3.7.25.dist-info}/RECORD

@@ -63,7 +63,7 @@ siat/future_china.py,sha256=F-HsIf2Op8Z22RzTjet1g8COzldgnMjFNSXsAkeGyWo,17595
 siat/future_china_test.py,sha256=BrSzmDVaOHki6rntOtosmRn-6dkfOBuLulJNqh7MOpc,1163
 siat/global_index_test.py,sha256=hnFp3wqqzzL-kAP8mgxDZ54Bd5Ijf6ENi5YJlGBgcXw,2402
 siat/google_authenticator.py,sha256=ZUbZR8OW0IAKDbcYtlqGqIpZdERpFor9NccFELxg9yI,1637
-siat/grafix.py,sha256=OJ7FYYvnd9V3zvycg_BKF65InLnUhGwdVdkJciD_8pk,110461
+siat/grafix.py,sha256=-ewwyFBXP4qbe7HY9RGowtfC3zXb-DkByIdqMj2k_C0,110457
 siat/grafix_test.py,sha256=kXvcpLgQNO7wd30g_bWljLj5UH7bIVI0_dUtXbfiKR0,3150
 siat/holding_risk.py,sha256=G3wpaewAKF9CwEqRpr4khyuDu9SU2EGyQUHdk7cmHOA,30693
 siat/holding_risk_test.py,sha256=FRlw_9wFG98BYcg_cSj95HX5WZ1TvkGaOUdXD7-V86s,474
@@ -120,7 +120,7 @@ siat/stock_prices_kneighbors.py,sha256=WfZvo5EyeBsm-T37zDj7Sl9dPSRq5Bx4JxIJ9IUum
 siat/stock_prices_linear.py,sha256=-OUKRr27L2aStQgJSlJOrJ4gay_G7P-m-7t7cU2Yoqk,13991
 siat/stock_profile.py,sha256=B3eIwzEmiCqiCaxIlhfdEPsQBoW1PFOe1hkiY3mVF6Y,26038
 siat/stock_technical-20240620.py,sha256=A4x18mZgYSA8SSiDz4u_O3gd5oVRgbI6JIiBfFY0tVw,116013
-siat/stock_technical.py,sha256=VX6qSBotTOzXaX1XHyDz3KBYEHlaxcPdBIOacB8T9no,136309
+siat/stock_technical.py,sha256=xzrWu_s-6kz34RxrNjSUasRI3WSirX_XKUDBJbgLCU0,140884
 siat/stock_test.py,sha256=E9YJAvOw1VEGJSDI4IZuEjl0tGoisOIlN-g9UqA_IZE,19475
 siat/stooq.py,sha256=SiRnSUu92pfzIZQ8N4Yo-9VOVSwUSqQE0wqXhF-4y9g,2493
 siat/temp.py,sha256=gbJ0ioauuo4koTPH6WKUkqcXiQPafnbhU5eKJ6lpdLA,1571
@@ -134,7 +134,7 @@ siat/transaction_test.py,sha256=Z8g1LJCN4-mnUByXMUMoFmN0t105cbmsz2QmvSuIkbU,1858
 siat/translate-20230125.py,sha256=NPPSXhT38s5t9fzMvl_fvi4ckSB73ThLmZetVI-xGdU,117953
 siat/translate-20230206.py,sha256=-vtI125WyaJhmPotOpDAmclt_XnYVaWU9ByLWZ6FyYE,118133
 siat/translate-20230215.py,sha256=TJgtPE3n8IjljmZ4Pefy8dmHoNdFF-1zpML6BhA9FKE,121657
-siat/translate.py,sha256=hZljXo8Wlee9DQPHnn6Pwt2shl1Ky-yuAIpmNDTdsHA,251884
+siat/translate.py,sha256=RHBWBL_MLZS3txK_hTs8_VyUvVZmU862MYB-ZKeqYNY,251987
 siat/translate_20240606.py,sha256=63IyHWEU3Uz9mjwyuAX3fqY4nUMdwh0ICQAgmgPXP7Y,215121
 siat/translate_241003_keep.py,sha256=un7Fqe1v35MXsja5exZgjmLzrZtt66NARZIGlyFuGGU,218747
 siat/universal_test.py,sha256=CDAOffW1Rvs-TcNN5giWVvHMlch1w4dp-w5SIV9jXL0,3936
@@ -143,8 +143,8 @@ siat/valuation_china.py,sha256=CVp1IwIsF3Om0J29RGkyxZLt4n9Ug-ua_RKhLwL9fUQ,69624
 siat/valuation_market_china_test.py,sha256=gbJ0ioauuo4koTPH6WKUkqcXiQPafnbhU5eKJ6lpdLA,1571
 siat/var_model_validation.py,sha256=R0caWnuZarrRg9939hxh3vJIIpIyPfvelYmzFNZtPbo,14910
 siat/yf_name.py,sha256=laNKMTZ9hdenGX3IZ7G0a2RLBKEWtUQJFY9CWuk_fp8,24058
-siat-3.7.24.dist-info/LICENSE,sha256=NTEMMROY9_4U1szoKC3N2BLHcDd_o5uTgqdVH8tbApw,1071
-siat-3.7.24.dist-info/METADATA,sha256=hBqKjbbQcLQQWREZYGZNHB5Ge5n1A-wdUI178kn2z6E,8117
-siat-3.7.24.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-siat-3.7.24.dist-info/top_level.txt,sha256=r1cVyL7AIKqeAmEJjNR8FMT20OmEzufDstC2gv3NvEY,5
-siat-3.7.24.dist-info/RECORD,,
+siat-3.7.25.dist-info/LICENSE,sha256=NTEMMROY9_4U1szoKC3N2BLHcDd_o5uTgqdVH8tbApw,1071
+siat-3.7.25.dist-info/METADATA,sha256=_SvLWhZRgnZNxBRP5z-3ZIsRKwd9pXO1GA4Gyi3rTg4,8294
+siat-3.7.25.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+siat-3.7.25.dist-info/top_level.txt,sha256=r1cVyL7AIKqeAmEJjNR8FMT20OmEzufDstC2gv3NvEY,5
+siat-3.7.25.dist-info/RECORD,,

{siat-3.7.24.dist-info → siat-3.7.25.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.43.0)
+Generator: setuptools (75.8.0)
 Root-Is-Purelib: true
 Tag: py3-none-any