siat 3.8.20__py3-none-any.whl → 3.8.25__py3-none-any.whl

siat/economy2.py

@@ -170,25 +170,29 @@ if __name__ =="__main__":
     
     indicator_name_wb(indicator)
 
-def indicator_name_wb(indicator='NY.GDP.MKTP.KN'):
+def indicator_name_wb(indicator):
     """
     ===========================================================================
     功能：抓取World Bank网页上指标的名称
-    indicator：WB指标名称，默认'NY.GDP.MKTP.KN'
+    indicator：WB指标名称，例如'NY.GDP.MKTP.KN'
     """
+    # 优先查询本地词典
+    indicator_name=economic_translate(indicator)
     
-    # 构造 API 请求 URL
-    url = f"https://api.worldbank.org/v2/indicator/{indicator}?format=json"
-    
-    # 发送请求
-    response = requests.get(url)
-    data = response.json()
-    
-    # 提取指标名称
-    try:
-        indicator_name = data[1][0]['name']
-    except:
-        indicator_name = ''
+    # 查询WB网页
+    if indicator_name == indicator:
+        # 构造 API 请求 URL
+        url = f"https://api.worldbank.org/v2/indicator/{indicator}?format=json"
+        
+        # 发送请求
+        response = requests.get(url)
+        data = response.json()
+        
+        # 提取指标名称
+        try:
+            indicator_name = data[1][0]['name']
+        except:
+            indicator_name = indicator
     
     return indicator_name
 
@@ -291,8 +295,8 @@ def economy_indicator_wb(ticker='CN',indicator='NY.GDP.MKTP.KN', \
     """
     # 检测指标是否存在，并取得指标名称
     indicator_name=indicator_name_wb(indicator)
-    if indicator_name == '':
-        print(f"  #Error(economy_indicator_wb): no indicator found for {indicator}")
+    if indicator_name == indicator:
+        print(f"  #Error(economy_indicator_wb): indicator {indicator} not found")
         return None
     
     # 日期具体化    
@@ -302,20 +306,20 @@ def economy_indicator_wb(ticker='CN',indicator='NY.GDP.MKTP.KN', \
     try:
         pricedf=wb.download(indicator=indicator,country=ticker,start=start,end=end)
     except:
-        print(f"  #Error(economy_indicator_wb): either {indicator} deprecated or {ticker} does not exist")
+        print(f"  #Error(economy_indicator_wb): {indicator} deprecated or {ticker} not found")
         return None
 
     # 是否返回None
     if pricedf is None:
-        print(f"  #Error(economy_indicator_wb): no data found on {indicator} for {ticker}")
+        print(f"  #Error(economy_indicator_wb): no data found on {indicator} in {ticker}")
         return None
     # 是否返回空的数据表
     if len(pricedf) == 0:
-        print(f"  #Error(economy_indicator_wb): zero data found on {indicator} for {ticker}")
+        print(f"  #Error(economy_indicator_wb): zero data found on {indicator} in {ticker}")
         return None
     # 是否返回数据表但内容均为NaN
     if pricedf[indicator].isnull().all():
-        print(f"  #Error(economy_indicator_wb): all empty data found on {indicator} for {ticker}")
+        print(f"  #Error(economy_indicator_wb): empty data found on {indicator} in {ticker}")
         return None
 
     pricedf.reset_index(inplace=True)  
@@ -360,8 +364,8 @@ def economy_indicator_wb(ticker='CN',indicator='NY.GDP.MKTP.KN', \
     if ind_max * ind_min <0:
         zeroline=True
     
-    titletxt1=text_lang("经济趋势分析","Economic Trend Analysis")
-    titletxt=titletxt1+': '+country+', '+indicator_name
+    titletxt1=text_lang("经济分析","Economic Analysis")
+    titletxt=titletxt1+': '+country_translate(country)+', '+indicator_name
     if unit != '':
         titletxt=titletxt+', '+unit
     
@@ -530,7 +534,7 @@ def economy_mindicators_wb(ticker='CN',indicator=['NY.GDP.MKTP.CN','NY.GDP.MKTP.
         return None
         
     # 绘图
-    titletxt=text_lang("经济趋势分析","Economic Trend Analysis")+': '+country    
+    titletxt=text_lang("经济趋势分析","Economic Trend Analysis")+': '+country_translate(country)    
 
     y_label=text_lang('经济指标',"Economic Indicator")
     import datetime; todaydt = datetime.date.today()
@@ -573,6 +577,10 @@ def economy_mindicators_wb(ticker='CN',indicator=['NY.GDP.MKTP.CN','NY.GDP.MKTP.
     
     # 为避免绘图出错，对空值进行插值
     df.interpolate(method='linear',limit_direction='both',inplace=True)
+
+    # 翻译指标名称
+    for c in list(df):
+        df.rename(columns={c:economic_translate(c)},inplace=True)
     
     draw_lines2(df,y_label,x_label,axhline_value,axhline_label,titletxt, \
                data_label=False,resample_freq='1D',smooth=smooth, \
@@ -695,15 +703,15 @@ def economy_mtickers_wb(ticker=['CN','US','JP'],indicator='NY.GDP.MKTP.PP.CD', \
     dfs=pd.DataFrame(); have_data=False
     country_list=[]; unit_list=[]
     for t in tickers:
-        print(f"  Looking indicator info for {t} ... ...")
+        print(f"  Looking for {measure} info in {t} ... ...")
         with HiddenPrints():
             df_tmp=economy_indicator_wb(ticker=t,indicator=measure, \
                                   start=start,end=end,graph=False)
         if df_tmp is None:
-            print(f"  #Warning(economy_mticker_wb): indicator info not found for {t}")
+            print(f"  #Warning(economy_mticker_wb): {measure} info not found in {t}")
             continue
         if len(df_tmp)==0:
-            print(f"  #Warning(economy_mticker_wb): zero info found for {t} between {start} and {end}")
+            print(f"  #Warning(economy_mticker_wb): zero info found for {measure} in {t}")
             continue
 
         have_data=True
@@ -714,7 +722,10 @@ def economy_mtickers_wb(ticker=['CN','US','JP'],indicator='NY.GDP.MKTP.PP.CD', \
         unit_list=unit_list+[unit]    
         df_tmp.drop(columns=['country','unit'],inplace=True)
         indicator_name=list(df_tmp)[0]
-         
+        
+        if DEBUG:
+            print(f"DEBUG: t={t}, band_area={band_area}, df_tmp={list(df_tmp)}")
+            
         if t in band_area:
             band_area = [country if x == t else x for x in band_area]
          
@@ -724,12 +735,15 @@ def economy_mtickers_wb(ticker=['CN','US','JP'],indicator='NY.GDP.MKTP.PP.CD', \
             dfs=df_tmp
         else:
             dfs=pd.concat([dfs,df_tmp],axis=1,join='outer')
-            
+    
+    # 翻译band_area
+    band_area=[country_translate(x) for x in band_area]        
+    
     if dfs is None:
         print(f"  #Error(economy_mticker_wb): no records found for {measure}")
         return None
     if len(dfs)==0:
-        print("  #Error(economy_mticker_wb): zero records found for {measure}")
+        print(f"  #Error(economy_mticker_wb): zero records found for {measure}")
         return None
 
     # 若不绘图则返回原始数据
@@ -740,11 +754,12 @@ def economy_mtickers_wb(ticker=['CN','US','JP'],indicator='NY.GDP.MKTP.PP.CD', \
         return None
 
     # 绘图
-    titletxt=text_lang("经济趋势分析","Economic Trend Analysis")+': '+indicator_name    
-    y_label=indicator_name
+    titletxt=text_lang("经济分析","Economic Analysis")+': '+indicator_name    
+    #y_label=indicator_name
+    y_label=text_lang("经济指标","Economic Indicator")
     
     import datetime; todaydt = datetime.date.today()
-    footnote2=text_lang("数据来源：WB/IMF/FRED","Data source: World Bank")+', '+str(todaydt)
+    footnote2=text_lang("数据来源：WB/IMF/FRED","Data source: WB/IMF/FRED")+', '+str(todaydt)
 
     one_unit=False
     if len(set(unit_list)) == 1: one_unit=True
@@ -801,6 +816,10 @@ def economy_mtickers_wb(ticker=['CN','US','JP'],indicator='NY.GDP.MKTP.PP.CD', \
         if axhline_label=='':
             axhline_label='零线'
 
+    # 翻译国家名称
+    for c in list(dfs2):
+        dfs2.rename(columns={c:country_translate(c)},inplace=True)
+
     draw_lines(dfs2,y_label,x_label,axhline_value,axhline_label,titletxt, \
                data_label=False,resample_freq='D',smooth=smooth,linewidth=linewidth, \
                band_area=band_area,loc=loc, \
@@ -973,5 +992,210 @@ def economy_trend2(ticker='CN',indicator='NY.GDP.MKTP.KN', \
 #==============================================================================
 #==============================================================================
 #==============================================================================
+
+
+def economic_translate(indicator):
+    """
+    ===========================================================================
+    功能：翻译宏观经济指标术语
+    参数：
+    indicator: 指标编码，主要是世界银行编码。
+    注意：部分编码已放弃，可能无数据或无最新数据。
+    返回值：是否找到，基于语言环境为中文或英文解释。
+    语言环境判断为check_language()
+    
+    数据结构：['指标编码','中文解释','英文解释']
+    """
+    DEBUG=False
+    
+    import pandas as pd
+    trans_dict=pd.DataFrame([
+        
+        # NE.CON.PRVT:家庭及NPISH最终消费=======================================
+        ['NE.CON.PRVT.CD','家庭及NPISH最终消费(美元时价)',
+         'Household & NPISHs Final Consumption (current US$)',
+         'Households and NPISHs Final consumption expenditure (current US$)'],
+        
+        ['NE.CON.PRVT.KD','家庭及NPISH最终消费(2015美元不变价格)',
+         'Household & NPISHs Final Consumption (constant 2015 US$)',
+         'Households and NPISHs Final consumption expenditure (constant 2015 US$)'],
+        
+        ['NE.CON.PRVT.CN','家庭及NPISH最终消费(本币时价)',
+         'Household & NPISHs Final Consumption (current LCU)',
+         'Households and NPISHs Final consumption expenditure (current LCU)'],
+        
+        ['NE.CON.PRVT.KN','家庭及NPISH最终消费(本币不变价格)',
+         'Household & NPISHs Final Consumption (constant LCU)',
+         'Households and NPISHs Final consumption expenditure (constant LCU)'],
+
+        ['NE.CON.PRVT.ZS','家庭及NPISH最终消费(占GDP%)',
+         'Household & NPISHs Final Consumption (GDP%)',
+         'Households and NPISHs Final consumption expenditure (% of GDP)'],
+
+        ['NE.CON.PRVT.KD.ZG','家庭及NPISH最终消费(年增速%)',
+         'Household & NPISHs Final Consumption (annual % growth)',
+         'Households and NPISHs Final consumption expenditure (annual % growth)'],
+
+        ['NE.CON.PRVT.PP.CD','家庭及NPISH最终消费(购买力平价，国际美元时价)',
+         'Household & NPISHs Final Consumption (PPP, current intl $)',
+         'Households and NPISHs Final consumption expenditure, PPP (current international $)'],
+
+        ['NE.CON.PRVT.PP.KD','家庭及NPISH最终消费(购买力平价，2021国际美元不变价格)',
+         'Household & NPISHs Final Consumption (PPP, constant 2021 intl $)',
+         'Households and NPISHs Final consumption expenditure, PPP (constant 2021 international $)'],
+
+        ['NE.CON.PRVT.PC.KD.ZG','人均家庭及NPISH最终消费(年增速%)',
+         'Household & NPISHs Final Consumption per capita growth (annual %)',
+         'Households and NPISHs Final consumption expenditure per capita growth (annual %)'],
+
+        ['NE.CON.PRVT.PC.KD','人均家庭及NPISH最终消费(2015美元不变价格)',
+         'Household & NPISHs Final Consumption per capita (constant 2015 US$)',
+         'Households and NPISHs Final consumption expenditure per capita (constant 2015 US$)'],
+
+        ['NE.CON.PRVT.CN.AD','家庭及NPISH最终消费(统计口径调整后，本币时价)',
+         'Household & NPISHs Final Consumption (linked series, current LCU)',
+         'Households and NPISHs Final consumption expenditure: linked series (current LCU)'],
+        
+        # 币种指标：CD=current US$, KD=constant 2015 US$, CN=current LCU
+        # KN=constant LCU, ZS=% of GDP, PC=per capita, PP=PPP
+        
+        
+        
+        
+        
+        
+        ], columns=['indicator','cword','eword','original_eword'])
+
+    found=False; result=indicator
+    try:
+        dict_word=trans_dict[trans_dict['indicator']==indicator]
+        found=True
+    except:
+        #未查到翻译词汇，返回原词
+        pass
+    
+    if dict_word is None:
+        found=False    
+    elif len(dict_word) == 0:
+        found=False
+    
+    if found:
+        lang=check_language()
+        
+        if DEBUG:
+            print(f"DEBUG: indicator={indicator}, lang={lang}, dict_word={dict_word}")
+        
+        if lang == 'Chinese':
+            result=dict_word['cword'].values[0]
+        else:
+            result=dict_word['eword'].values[0]
+            
+    return result
+
+if __name__=='__main__': 
+    indicator='NE.CON.PRVT.CD'
+    indicator='NE.CON.PRVT.KD'
+
+    indicator='NE.CON.PRVT.CN'
+    indicator='NE.CON.PRVT.KN'
+    
+    result=economic_translate(indicator)
+    economic_translate(indicator)[1]
+
+#==============================================================================
+
+
+def country_translate(country):
+    """
+    ===========================================================================
+    功能：翻译国家名称
+    参数：
+    country: 国家名称英文，并非国家代码。
+    返回值：是否找到，基于语言环境为中文或英文解释。
+    语言环境判断为check_language()
+    
+    数据结构：['国家名称英文','国家名称中文','国家代码2位','国家代码3位']
+    """
+    
+    import pandas as pd
+    trans_dict=pd.DataFrame([
+        
+        ['China','中国','CN','CHN'],
+        ['United States','美国','US','USA'],
+        ['Japan','日本','JP','JPN'],
+        ['Germany','德国','DE','DEU'],
+        ['India','印度','IN','IND'],
+        ['Brazil','巴西','BR','BRA'],
+        
+        ['France','法国','FR','FRA'],
+        ['United Kingdom','英国','GB','GBR'],
+        ['Russia','俄罗斯','RU','RUS'],
+        ['Canada','加拿大','CA','CAN'],
+        ['Australia','澳大利亚','AU','AUS'],
+        ['South Korea','韩国','KR','KOR'],
+        
+        ['Italy','意大利','IT','ITA'],
+        ['Mexico','墨西哥','MX','MEX'],
+        ['South Africa','南非','ZA','ZAF'],
+        ['Saudi Arabia','沙特阿拉伯','SA','SAU'],
+        ['Indonesia','印度尼西亚','ID','IDN'],
+        ['Turkey','土耳其','TR','TUR'],
+        
+        ['Argentina','阿根廷','AR','ARG'],
+        ['Egypt','埃及','EG','EGY'],
+        ['European Union','欧盟','EU','EUU'],
+        ['Hong Kong','中国香港','HK','HKG'],
+        ['Hong Kong, China','中国香港','HK','HKG'],
+        ['Taiwan','中国台湾','TW','TWN'],
+        ['Taiwan, China','中国台湾','TW','TWN'],
+        ['World','全球','1W','WLD'],
+        
+        ['Singapore','新加坡','SG','SGP'],
+        ['Malaysia','马来西亚','MY','MYS'],
+        ['Thailand','泰国','TH','THA'],
+        ['Israel','以色列','IL','ISR'],
+        ['Vietnam','越南','VN','VNM'],
+        ['Philippines','菲律宾','PH','PHL'],
+        ['Brunei','文莱','BN','BRN'],
+        ['Cambodia','柬埔寨','KH','KHM'],
+        
+        ['Laos','老挝','LA','LAO'],
+        ['Myanmar','缅甸','MM','MMR'],
+        
+        
+        
+        
+        
+        ], columns=['ecountry','ccountry','country code2','country code3'])
+
+    found=False; result=country
+    try:
+        dict_word=trans_dict[trans_dict['ecountry']==country]
+        found=True
+    except:
+        #未查到翻译词汇，返回原词
+        pass
+    
+    if dict_word is None:
+        found=False    
+    elif len(dict_word) == 0:
+        found=False
+    
+    if found:
+        lang=check_language()
+        if lang == 'Chinese':
+            result=dict_word['ccountry'].values[0]
+        else:
+            #result=dict_word['ecountry'].values[0]
+            pass
+            
+    return result
+
+if __name__=='__main__': 
+    country='China'
+    country='United States'
+    
+    result=country_translate(country)
+
 #==============================================================================
     

{siat-3.8.20.dist-info → siat-3.8.25.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: siat
-Version: 3.8.20
+Version: 3.8.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

{siat-3.8.20.dist-info → siat-3.8.25.dist-info}/RECORD

@@ -30,7 +30,7 @@ siat/cryptocurrency_test.py,sha256=3AikTNJ7j-HwLGLIYEfyXZ3bLVuLeru9mwiwHQi2SdA,2
 siat/derivative.py,sha256=qV8n09799eqLc26ojR6vN5n_X-xd7rGwdYjgq-wBih8,41483
 siat/economy-20230125.py,sha256=vxZZlPnLkh7SpGMVEPLwxjt0yYLSVmdZrO-s2NYLyoM,73848
 siat/economy.py,sha256=BFVQDxOTbuizyumpCgpZIauH6sqnwUXebpqRMmQCzys,84198
-siat/economy2.py,sha256=FOVf5WxKnge3dVEV2CEf--CupXhFtlRUc5k5FUMTD-Q,39857
+siat/economy2.py,sha256=paLZWJFa5in5Pl_isyb-7qnT8EUkvLGvg0G3s-eUONE,48275
 siat/economy_test.py,sha256=6vjNlPz7W125pJb7simCddobSEp3jmLIMvVkLRZ7zW8,13339
 siat/esg.py,sha256=GMhaonIKtvOK83rhpQUH5aJt2OL3HQBSVfD__Yw-0oo,19040
 siat/esg_test.py,sha256=Z9m6GUt8O7oHZSEG9aDYpGdvvrv2AiRJdHTiU6jqmZ0,2944
@@ -144,8 +144,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.8.20.dist-info/LICENSE,sha256=NTEMMROY9_4U1szoKC3N2BLHcDd_o5uTgqdVH8tbApw,1071
-siat-3.8.20.dist-info/METADATA,sha256=I4TQUc7XHrSbbQkDRTd2Glcb1hcYKeIyhmUBp3KxMao,8144
-siat-3.8.20.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-siat-3.8.20.dist-info/top_level.txt,sha256=r1cVyL7AIKqeAmEJjNR8FMT20OmEzufDstC2gv3NvEY,5
-siat-3.8.20.dist-info/RECORD,,
+siat-3.8.25.dist-info/LICENSE,sha256=NTEMMROY9_4U1szoKC3N2BLHcDd_o5uTgqdVH8tbApw,1071
+siat-3.8.25.dist-info/METADATA,sha256=pWsYGwjmUvMD1r3g1lU0Ijl4V_Pif_RRtuBGhrcLw3A,8144
+siat-3.8.25.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+siat-3.8.25.dist-info/top_level.txt,sha256=r1cVyL7AIKqeAmEJjNR8FMT20OmEzufDstC2gv3NvEY,5
+siat-3.8.25.dist-info/RECORD,,