siat 3.0.10__py3-none-any.whl → 3.0.20__py3-none-any.whl

siat/financials_china.py

@@ -4,7 +4,7 @@
 所属工具包：证券投资分析工具SIAT 
 SIAT：Security Investment Analysis Tool
 创建日期：2020年9月8日
-最新修订日期：2020年9月15日
+最新修订日期：2024年4月21日
 作者：王德宏 (WANG Dehong, Peter)
 作者单位：北京外国语大学国际商学院
 作者邮件：wdehong2000@163.com
@@ -45,7 +45,7 @@ plt.rcParams['axes.unicode_minus'] = False
 import pandas as pd
 import akshare as ak
 
-#STOCK_SUFFIX_CHINA=['SS','SZ','BJ','NQ']
+#SUFFIX_LIST_CN=['SS','SZ','BJ','NQ']
 #==============================================================================
 #==============================================================================
 if __name__=='__main__':
@@ -67,7 +67,7 @@ def get_fin_stmt_ak(ticker):
     print("  Searching financial statements for",ticker,"...")
     #是否中国股票
     result,prefix,suffix=split_prefix_suffix(ticker)
-    if not (suffix in STOCK_SUFFIX_CHINA):
+    if not (suffix in SUFFIX_LIST_CN):
         print("  #Error(get_fin_stmt_ak): not a stock in China",ticker)
         return None        
     
@@ -275,11 +275,17 @@ def get_fin_stmt_ak(ticker):
         
     if not ('短期现金偿债能力%' in fslist):
         #fs4['短期现金偿债能力%']=round((fs4['经营活动现金流净额'] / fs4['流动负债合计'])*100,2)
-        fs4['短期现金偿债能力%']=fs4.apply(lambda x: round((x['经营活动现金流净额'] / x['流动负债合计'])*100,2),axis=1)        
+        try:
+            fs4['短期现金偿债能力%']=fs4.apply(lambda x: round((x['经营活动现金流净额'] / x['流动负债合计'])*100,2),axis=1)        
+        except:
+            fs4['短期现金偿债能力%']=np.nan
         
     if not ('长期现金偿债能力%' in fslist):
-        #fs4['长期现金偿债能力%']=round((fs4['经营活动现金流净额'] / fs4['负债合计'])*100,2)          
-        fs4['长期现金偿债能力%']=fs4.apply(lambda x: round((x['经营活动现金流净额'] / x['负债合计'])*100,2),axis=1)
+        #fs4['长期现金偿债能力%']=round((fs4['经营活动现金流净额'] / fs4['负债合计'])*100,2)     
+        try:
+            fs4['长期现金偿债能力%']=fs4.apply(lambda x: round((x['经营活动现金流净额'] / x['负债合计'])*100,2),axis=1)
+        except:
+            fs4['长期现金偿债能力%']==np.nan
 
     if not ('流通股股数' in fslist):
         for gs in ['实收资本(或股本)','股本']:
@@ -648,7 +654,8 @@ if __name__=='__main__':
     hatchlist=['.', 'o', '\\']
 
 def compare_dupont_china(tickerlist,fsdate='latest',scale1 = 10,scale2 = 10, \
-                         hatchlist=['.', 'o', '\\'],printout=True,sort='PM'):
+                         hatchlist=['.', 'o', '\\'],printout=True,sort='PM', \
+                         facecolor='papayawhip'):
     """
     功能：获得tickerlist中每只股票的杜邦分析项目，绘制柱状叠加比较图
     tickerlist：股票代码列表，建议在10只以内
@@ -792,8 +799,11 @@ def compare_dupont_china(tickerlist,fsdate='latest',scale1 = 10,scale2 = 10, \
         footnote1="2、表中数值基于期末数字直接计算，而非期初期末均值，可能与公告数字存在差异。"
         footnote2="*** 数据来源：sina/EM，"+str(today)
         footnote=footnote0+'\n'+footnote1+'\n'+footnote2
-        df_directprint(df,title_txt,footnote)
+        
         #print(df.to_string(index=False))
+        #df_directprint(df,title_txt,footnote)
+        df_display_CSS(df=df,titletxt=title_txt,footnote=footnote, \
+                       facecolor=facecolor,decimals=4)
         
         
     #合并所有历史记录
@@ -832,7 +842,7 @@ def get_fin_abstract_ak(ticker):
 
     #是否中国股票
     result,prefix,suffix=split_prefix_suffix(ticker)
-    if not (suffix in STOCK_SUFFIX_CHINA):
+    if not (suffix in SUFFIX_LIST_CN):
         print("  #Warning(get_fin_abstract_ak): not a stock in China",ticker)
         return None        
     
@@ -900,7 +910,7 @@ def get_fin_indicator_ak(ticker):
 
     #是否中国股票
     result,prefix,suffix=split_prefix_suffix(ticker)
-    if not (suffix in STOCK_SUFFIX_CHINA):
+    if not (suffix in SUFFIX_LIST_CN):
         print("  #Warning(get_fin_indicator_ak): not a stock in China",ticker)
         return None        
     
@@ -991,7 +1001,7 @@ def get_fin_performance_ak(ticker,endDate):
     """
     #是否中国股票
     result,prefix,suffix=split_prefix_suffix(ticker)
-    if not (suffix in STOCK_SUFFIX_CHINA):
+    if not (suffix in SUFFIX_LIST_CN):
         print("  #Warning(get_fin_performance_ak): not a stock in China",ticker)
         return None        
     
@@ -1378,7 +1388,7 @@ def industry_rank_em2(tickers,rates=['eps','naps'],industry="银行",top=10):
     for t in tickers_selected:
         #是否中国股票
         result,prefix,suffix=split_prefix_suffix(t)
-        if not (suffix in STOCK_SUFFIX_CHINA) and not (tickers == ''):
+        if not (suffix in SUFFIX_LIST_CN) and not (tickers == ''):
             print("  #Warning(industry_rank_em2): not a stock in China",t)
             error_flag=True
         stocks_selected=stocks_selected+[prefix]
@@ -1597,7 +1607,7 @@ def get_fin_performance_akm(tickers,endDate):
     prefix_list=[]
     for t in tickers:
         result,prefix,suffix=split_prefix_suffix(t)
-        if not (suffix in STOCK_SUFFIX_CHINA):
+        if not (suffix in SUFFIX_LIST_CN):
             print("  #Warning(get_fin_performance_akm): not a stock in China",t)
             return None  
         prefix_list=prefix_list+[prefix]
@@ -1945,7 +1955,7 @@ def prepare_fin_rate1t2r_china(ticker,rate1,rate2,start,end,period_type='all'):
 
     #是否中国股票
     result,prefix,suffix=split_prefix_suffix(ticker)
-    if not (suffix in STOCK_SUFFIX_CHINA):
+    if not (suffix in SUFFIX_LIST_CN):
         print("  #Warning(prepare_fin_rate1t2r_china): not a stock in China",ticker)
         return None,None        
 
@@ -2066,7 +2076,7 @@ def prepare_fin_rate1tmr_china(ticker,rates,start,end,period_type='all'):
 
     #是否中国股票
     result,prefix,suffix=split_prefix_suffix(ticker)
-    if not (suffix in STOCK_SUFFIX_CHINA):
+    if not (suffix in SUFFIX_LIST_CN):
         print("  #Warning(prepare_fin_rate1tmr_china): not a stock in China",ticker)
         return None       
     
@@ -2177,7 +2187,7 @@ def prepare_fin_ratemt1r_china(tickers,rate,start,end,period_type='all'):
     prefix_list=[]
     for t in mticker_list:
         result,prefix,suffix=split_prefix_suffix(t)
-        if not (suffix in STOCK_SUFFIX_CHINA):
+        if not (suffix in SUFFIX_LIST_CN):
             print("  #Warning(prepare_fin_ratemt1r_china): not a stock in China",ticker)
             return None  
         prefix_list=prefix_list+[prefix]
@@ -2257,11 +2267,11 @@ def cn_codetranslate(ticker):
     注意：既能转换带后缀的股票代码，也能转换不带后缀的股票代码
     """
     result,prefix,suffix=split_prefix_suffix(ticker)
-    if suffix in STOCK_SUFFIX_CHINA:
+    if suffix in SUFFIX_LIST_CN:
         name=ticker_name(ticker)
 
     if suffix =='':
-        for s in STOCK_SUFFIX_CHINA:
+        for s in SUFFIX_LIST_CN:
             ticker_try=ticker+'.'+s
             name=ticker_name(ticker_try)
             print('\b'*99," Looking for the short name of stock",ticker)
@@ -2805,7 +2815,7 @@ if __name__=='__main__':
     
     g=dupont_decompose_china(ticker,fsdate)
 
-def dupont_decompose_china(ticker,fsdate,gview=False):
+def dupont_decompose_china(ticker,fsdate,gview=False,facecolor='papayawhip'):
     """
     功能：杜邦分析分解图
     ticker: 股票代码
@@ -2965,7 +2975,7 @@ def dupont_decompose_china(ticker,fsdate,gview=False):
     """
     #是否中国股票
     result,prefix,suffix=split_prefix_suffix(ticker)
-    if not (suffix in STOCK_SUFFIX_CHINA):
+    if not (suffix in SUFFIX_LIST_CN):
         print("  #Error(dupont_decompose_china): not a stock in China",ticker)
         return None        
     
@@ -3529,7 +3539,7 @@ if __name__=='__main__':
     tickers=['000002.SZ','600048.SS','001979.SZ','600325.SS','000069.SZ','600383.SS','600895.SS','601155.SS']
     fsdates='2022-12-31'
     
-def compare_fin_summary_china(tickers,fsdates):
+def compare_fin_summary_china(tickers,fsdates,facecolor='whitesmoke'):
     """
     功能：分类别显示财报摘要中的指标
     """        
@@ -3614,14 +3624,14 @@ def compare_fin_summary_china(tickers,fsdates):
 
     # 注释
     notesdict={'常用指标': \
-               '\n注：\n'+ \
+               '注：\n'+ \
                '1. 毛利率=毛利润 / 营业(总)收入 ×100% \n'+ \
                '2. 毛利润=营业(总)收入-营业(总)成本 \n'+ \
                '3. 销售净利率=净利润 / 营业(总)收入 ×100% \n'+ \
                '4. 期间费用率=期间费用 / 营业(总)收入 ×100%，期间费用包括管理费用，销售费用和财务费用。 \n', \
               
               '每股指标': \
-               '\n注：\n'+ \
+               '注：\n'+ \
                '1. 稀释每股指标:假设企业所有发行在外的稀释性潜在普通股期间内均转换为普通股，导致普通股股数增加 \n'+ \
                '2. 潜在普通股：指赋予其持有者在报告期或以后期间享有取得普通股权利的金融工具或者其他合同，例如公司可转债、认股权证、股份期权等 \n'+ \
                '3. 摊薄每股指标：使用期末数值计算，而非期初期末均值，其结果更能反应期末情况，可能大于、小于或等于每股指标 \n'+ \
@@ -3639,13 +3649,13 @@ def compare_fin_summary_china(tickers,fsdates):
                '15.(企业)自由现金流可以理解为归属于股东与债权人的最大现金流，而股东(股权)自由现金流则是归属于股东的最大现金流。 \n', \
 
               '营运能力': \
-               '\n注：\n'+ \
+               '注：\n'+ \
                '1. 指标周转率/周转次数：营业(总)收入 / 指标的起初期末均值。一般来说数值越大越好 \n'+ \
                '2. 指标周转天数：360/周转率(或周转次数)。一般来说数值越小越好 \n'+ \
                '3. 注意：本表指标主要针对非金融行业，部分指标不适用于金融行业。 \n', \
               
               '盈利能力': 
-               '\n注：\n'+ \
+               '注：\n'+ \
                '1. 毛利润=营业(总)收入-营业(总)成本 \n'+ \
                '2. 营业利润=毛利润-营业税金及附加-期间费用-资产减值损失+公允价值变动损益+投资损益 \n'+ \
                '3. 营业利润率=营业利润 / 营业(总)收入 x100% \n'+ \
@@ -3669,18 +3679,18 @@ def compare_fin_summary_china(tickers,fsdates):
                '21.投入资本回报率的意义：更多地从投资而非财务角度看，每单位投资的资本所能赚取息税前利润的多少。 \n', \
               
               '收益质量':
-               '\n注：\n'+ \
+               '注：\n'+ \
                '1. 销售成本率=营业(总)成本 / 营业(总)收入 x100%，=1-毛利润 \n'+ \
                '2. 成本费用率=(营业(总)成本+期间费用) / 营业(总)收入 x100%，=销售成本率+期间费用率，可评价企业对成本费用的控制能力 \n'+ \
                '3. 期间费用率=期间费用 / 营业(总)收入 x100% \n',
               
               '成长能力':
-                '\n注：\n'+ \
+                '注：\n'+ \
               '1. 扣费(后)净利润=净利润-非经常性损益，即扣除了偶然的不可持续或不常发生的收益，可持续性更强，可能大于或小于净利润 \n'+ \
                '2. 归属母公司净利润：简称归母净利润，指企业合并报表中归属控股公司(母公司)的利润，不包括归属子公司中非控股股东的利润。 \n',
               
               '财务风险':
-               '\n注：\n'+ \
+               '注：\n'+ \
                '1. 保守速动比率：又称超速动比率，=(现金+短期证券投资+应收账款净额) / 流动负债，比速动比能够更好地评价企业短期偿债能力 \n'+ \
                '2. 应收账款净额:指应收账款和其他应收款减去备抵坏账的净额，实质即为信誉高客户的应收款净额 \n'+ \
                '3. 产权比率(equity ratio)=负债总额 / 所有者权益总额(净资产) x100%，从一个方面说明企业长期偿债能力，越高越弱 \n'+ \
@@ -3691,8 +3701,11 @@ def compare_fin_summary_china(tickers,fsdates):
     # 一只股票情形：多日期
     if len(tickers_found) == 1:
         ticker1=tickers[0]
+        """
         titletxt="\n===== 上市公司财务报表摘要："+ticker_name(ticker1)+" ====="    
         print(titletxt)    
+        """
+        titletxt=ticker_name(ticker1)+'：'+"财报摘要"
         
         fsdf1=fsdf[fsdf['ticker']==ticker1]
         for ty in typelist:
@@ -3707,11 +3720,15 @@ def compare_fin_summary_china(tickers,fsdates):
             dft.index=dft.index + 1
             dft2=dft.drop(labels=['选项','ticker'],axis=1)
             
+            """
             print("\n***",ty+'：')
             colalign=['center','left']+['right']*(len(list(dft2)) - 1)
             print(dft2.to_markdown(tablefmt='Simple',index=True,colalign=colalign))
             print(notesdict[ty])
-            
+            """
+            titletxt1=titletxt+'，'+ty
+            df_display_CSS(df=dft2,titletxt=titletxt1,footnote=notesdict[ty], \
+                           facecolor=facecolor,decimals=2)
     
     # 多只股票情形：单日期
     import pandas as pd
@@ -3723,9 +3740,12 @@ def compare_fin_summary_china(tickers,fsdates):
     fsdates3=sorted(fsdates2,reverse=True)                
     
     if len(tickers_found) > 1:
+        """
         titletxt="\n===== 上市公司财务报表摘要对比：报表日期"+fsdates3[0]+" ====="
         print('\n'+titletxt)    
-    
+        """
+        titletxt="财报摘要：报表日"+fsdates3[0]
+        
         mdf=pd.DataFrame()
         for t in tickers_found:
             dft=fsdf[fsdf['ticker']==t]
@@ -3752,12 +3772,16 @@ def compare_fin_summary_china(tickers,fsdates):
             dft.reset_index(drop=True,inplace=True)
             dft.index=dft.index + 1
             dft2=dft.drop(labels=['选项'],axis=1)
-            
+            """
             print("\n***",ty+'：')
             colalign=['center','left']+['right']*(len(list(dft2)) - 1)
             print(dft2.to_markdown(tablefmt='Simple',index=True,colalign=colalign))
             print(notesdict[ty])
-    
+            """
+            titletxt1=titletxt+'，'+ty
+            df_display_CSS(df=dft2,titletxt=titletxt1,footnote=notesdict[ty], \
+                           facecolor=facecolor,decimals=2)
+            
     return dft2
 
 #==============================================================================
@@ -3952,7 +3976,7 @@ if __name__=='__main__':
          '2018-12-31',
         ]
     
-def compare_fin_indicator_china(tickers,fsdates):
+def compare_fin_indicator_china(tickers,fsdates,facecolor='papayawhip'):
     """
     功能：分类别显示财报摘要中的指标
     """        
@@ -4077,12 +4101,12 @@ def compare_fin_indicator_china(tickers,fsdates):
     
     # 注释
     notesdict={'规模指标': \
-               '\n注：\n'+ \
+               '注：\n'+ \
                '1. 短期=一年以内，长期=一年以上 \n'+ \
                '2. 非经常性损益=非经常性或偶然活动带来的损益，一般不可持续。 \n', \
               
               '利润回报': \
-               '\n注：\n'+ \
+               '注：\n'+ \
                '1. 销售毛利率=毛利率=毛利润/营业(总)收入*100%，毛利润=营业(总)收入-营业(总)成本 \n'+ \
                '2. 主营业务利润率=主营业务利润/主营业务收入*100%，主营业务利润=主营业务收入-主营业务成本-主营业务税金及附加 \n'+ \
                '3. 营业利润率=营业利润/营业(总)收入*100%，营业利润=主营业务利润+其他业务利润-期间费用+其他损益 \n'+ \
@@ -4106,7 +4130,7 @@ def compare_fin_indicator_china(tickers,fsdates):
                '21.股息发放率=股利支付率=股利/净利润*100%，反映公司的股利分配政策，比例高表明公司不需更多的资金进行再投入。 \n', \
 
               '每股指标': \
-               '\n注：\n'+ \
+               '注：\n'+ \
                '1. 每股收益=净利润/流通股数量，其中流通股数量按期初期末均值计算 \n'+ \
                '2. 扣除非经常性损益后的每股收益=扣除非经常性损益后的净利润/流通股数量 \n'+ \
                '3. 加权每股收益=净利润/加权流通股数量，加权流通股数量含期间内流通股数量的变化(增发新股、送股、转增股本或配股等) \n'+ \
@@ -4118,20 +4142,20 @@ def compare_fin_indicator_china(tickers,fsdates):
                '9. 每股资本公积金=资本公积金/流通股数量，资本公积金含发行股份的溢价、资产重估增值、接受捐赠等，仅可用于转增股本。 \n', \
               
               '营运能力': 
-               '\n注：\n'+ \
+               '注：\n'+ \
                '1. 指标周转率/周转次数：营业(总)收入 / 指标的起初期末均值，从企业自身角度来说越大越好，但若涉及供应商则可能相反 \n'+ \
                '2. 指标周转天数：360/周转率(或周转次数)，从企业自身角度来说越小越好，但若涉及供应商则可能相反 \n'+ \
                '3. 注意：本表指标主要针对非金融行业，部分指标不适用于金融行业。 \n', \
               
               '现金指标':
-               '\n注：\n'+ \
+               '注：\n'+ \
                '1. 现金流量比率=经营活动产生的现金净流量/期末流动负债*100%，反映企业短期偿债能力 \n'+ \
                '2. 经营现金净流量对销售收入比率=销售现金比率，与赊销政策有关，若企业有虚假收入，也会使该指标过低 \n'+ \
                '3. 资产的经营现金流量回报率=经营现金流量净额/总资产*100%,体现企业经营活动的收现能力 \n'+ \
                '4. 经营现金净流量与净利润的比率=净现比=经营现金流量净额/净利润*100%。比率越大,企业盈利质量越高。 \n',
                
               '偿债能力':
-               '\n注：\n'+ \
+               '注：\n'+ \
                '1. 流动比率=流动资产/流动负债，反映企业的短期偿债能力，属于宽松指标 \n'+ \
                '2. 速动比率=(流动资产-存货)/流动负债，反映企业的短期偿债能力，属于较严的指标 \n'+ \
                '3. 现金比率=(货币资金+短期有价证券)/流动负债*100%，反映企业的短期偿债能力，属于严厉的指标 \n'+ \
@@ -4146,17 +4170,17 @@ def compare_fin_indicator_china(tickers,fsdates):
                '12. 经营现金净流量对负债比率=现金流量负债比=经营活动现金流量净额/负债总额*100%，比率越高，财务弹性越好。 \n',
               
               '应收账款':
-               '\n注：\n'+ \
+               '注：\n'+ \
                '1. 使用账龄法对应收账款/其他应收款分类 \n'+ \
                '2. 一般而言，应收款项的账龄越长，成为呆坏账的可能性就越大。 \n',
               
               '预付账款':
-               '\n注：\n'+ \
+               '注：\n'+ \
                '1. 一般而言，预付款项数额越大，企业在供应链中的地位越低 \n'+ \
                '2. 一般而言，预付款项的账龄越长，企业在供应链中的地位越低。 \n',
               
               '其他指标':
-                '\n注：\n'+ \
+                '注：\n'+ \
                '1. 长期资产与长期资金比率=非流动资产/(长期负债+股东权益)*100%，长期资金少，流动负债较多，财务风险较大 \n'+ \
                '2. 资本化比率=长期负债/(长期负债+股东权益)*100%，指标值越小，负债的资本化程度就越低，长期偿债压力就越小 \n'+ \
                '3. 固定资产净值率=(固定资产原值-累计折旧)/固定资产原值*100%，反映企业全部固定资产平均新旧程度 \n'+ \
@@ -4173,8 +4197,11 @@ def compare_fin_indicator_china(tickers,fsdates):
     # 一只股票情形：多日期
     if len(tickers_found) == 1:
         ticker1=tickers[0]
+        """
         titletxt="\n===== 上市公司主要财务比率和重要指标："+ticker_name(ticker1)+" ====="    
         print(titletxt)    
+        """
+        titletxt="主要财务比率和指标："+ticker_name(ticker1)
         
         fsdf1=fsdf[fsdf['ticker']==ticker1]
         for ty in typelist:
@@ -4199,16 +4226,19 @@ def compare_fin_indicator_china(tickers,fsdates):
             dft2.reset_index(drop=True,inplace=True)
             dft2.index=dft2.index + 1
             dft3=dft2.drop(labels=['选项','ticker'],axis=1)
-            
+            """
             print("\n***",ty+'：')
             colalign=['center','left']+['right']*(len(list(dft3)) - 1)
             print(dft3.to_markdown(tablefmt='Simple',index=True,colalign=colalign))
+            print(notesdict[ty])
+            """
             """
             注意：若dft3为空，则会出现错误：list assignment index out of range
             无论如何修改colalign都没用
             """
-            
-            print(notesdict[ty])
+            titletxt1=titletxt+'，'+ty
+            df_display_CSS(df=dft3,titletxt=titletxt1,footnote=notesdict[ty], \
+                           facecolor=facecolor,decimals=2)
         
         return dft3
             
@@ -4238,9 +4268,11 @@ def compare_fin_indicator_china(tickers,fsdates):
                 mdf=dft2
             else:
                 mdf=mdf.merge(dft2,how='outer',left_on=['选项','指标'], right_on=['选项','指标'])
-        
+        """
         titletxt="\n===== 上市公司财务报表主要比率和重要项目对比：报表日期"+fsdates3[0]+" ====="
         print('\n'+titletxt)    
+        """
+        titletxt="主要财务比率和指标：报表日"+fsdates3[0]
         
         for ty in typelist:
             dft=mdf[mdf['选项']==ty]
@@ -4256,11 +4288,15 @@ def compare_fin_indicator_china(tickers,fsdates):
             dft2.reset_index(drop=True,inplace=True)
             dft2.index=dft2.index + 1
             dft3=dft2.drop(labels=['选项'],axis=1)
-            
+            """
             print("\n***",ty+'：')
             colalign=['center','left']+['right']*(len(list(dft3))-2)
             print(dft3.to_markdown(tablefmt='Simple',index=True,colalign=colalign))
             print(notesdict[ty])
+            """
+            titletxt1=titletxt+'，'+ty
+            df_display_CSS(df=dft3,titletxt=titletxt1,footnote=notesdict[ty], \
+                           facecolor=facecolor,decimals=2)
     
         return dft3