energy-reports-pkg 0.6.14__py3-none-any.whl

mindsett_energy_reports_pkg/mdl/prepare_and_email_reports/prepare_report/generate_components/generate_daily_barchart_with_temp/plot_shifted_daily_barchart_with_temp/setup_y_tick_lim_label_zero_line/__init__.py

@@ -0,0 +1,23 @@
+
+import matplotlib.ticker as ticker
+
+def setup_y_tick_lim_label_zero_line(ax, ls_ylim, display_unit, formatter,
+                                     fontsize=None):
+
+    if fontsize is None:
+        fontsize = 13
+
+    # move the y_tick to the right
+    ax.yaxis.tick_right()
+    ax.yaxis.set_label_position("right")
+    ax.tick_params(axis='y', right=True, length=5, pad=9, labelsize=fontsize)
+    ax.set_ylim(ls_ylim)
+
+    # set y label
+    ax.set_ylabel(f"Daily Usage ({display_unit})", labelpad=18, fontsize=fontsize)
+
+    # set yaxis formatter
+    ax.yaxis.set_major_formatter(ticker.FormatStrFormatter(formatter))
+
+    # plot the zero value horizontal line
+    ax.axhline(y=0, color='k', linestyle=':', zorder=-1)

mindsett_energy_reports_pkg/mdl/prepare_and_email_reports/prepare_report/generate_components/generate_daily_barchart_with_temp/preprocessing_for_barchart/__init__.py

@@ -0,0 +1,21 @@
+from .patch_missing_dates import patch_missing_dates
+from .patch_missing_columns_for_ooh_and_sign import patch_missing_columns_for_ooh_and_sign
+from .groupby_date_and_ooh_current_period import groupby_date_and_ooh_current_period
+
+# from .groupby_date_and_ooh_current_period import groupby_date_and_ooh_current_period
+
+from cache_return import cache_return
+
+
+@cache_return
+def preprocessing_for_barchart(df_meta_with_value_bld):
+    
+    # main operation
+    df_pivot_working_hours_with_sign_sorted, period_current = groupby_date_and_ooh_current_period(df_meta_with_value_bld)
+
+    # patch the missing ooh columns and period index
+    df_pivot_working_hours_with_sign_sorted = patch_missing_columns_for_ooh_and_sign(df_pivot_working_hours_with_sign_sorted)
+    df_pivot_working_hours_with_sign_sorted = patch_missing_dates(df_pivot_working_hours_with_sign_sorted, period_current)
+
+    return df_pivot_working_hours_with_sign_sorted, period_current
+    # pass

mindsett_energy_reports_pkg/mdl/prepare_and_email_reports/prepare_report/generate_components/generate_daily_barchart_with_temp/preprocessing_for_barchart/groupby_date_and_ooh_current_period/__init__.py

@@ -0,0 +1,39 @@
+
+
+
+
+def groupby_date_and_ooh_current_period(df_meta_with_value):
+
+    # select data only for the current period
+
+    period_current = df_meta_with_value["period"].max()
+    df_meta_with_value_current = df_meta_with_value.loc[df_meta_with_value["period"]==period_current]
+
+    df_meta_with_value_current['neg_sign'] = df_meta_with_value_current['W'].lt(0)
+
+    # Conversion into MWh
+    w_to_mw_para = 1./1000/1000
+    min_to_hour_para = 1./60
+    reading_interval_in_mins=10
+
+    wm_to_mwh_parameter = w_to_mw_para * min_to_hour_para
+    reading_to_mwh_parameter = reading_interval_in_mins * wm_to_mwh_parameter
+
+    # Conversion into MWh
+    # reading_to_mwh_parameter = 1./1000
+
+    # todo: Better to change to df_meta_value_building
+    df_grouped_working_hours_current_period_with_sign = df_meta_with_value_current.groupby(['neg_sign', "date", 'out_of_hours'])["W"].sum() * reading_to_mwh_parameter  # Div 1000 for convertion to MWh
+
+    # df_grouped_working_hours_current_period = df_grouped_working_hours_current_period_with_sign.droplevel('neg_sign')
+    # # select only the maximum period
+    # df_grouped_working_hours_multiple_period_unstack = df_grouped_working_hours_multiple_period.unstack(["period"])
+    # period_current = df_grouped_working_hours_multiple_period_unstack.columns[-1]
+    # df_grouped_working_hours = df_grouped_working_hours_multiple_period_unstack.loc[:, period_current]
+
+    # todo: fill missing group index
+    df_pivot_working_hours_with_sign_sorted = df_grouped_working_hours_current_period_with_sign.unstack(['neg_sign', 'out_of_hours']).sort_index(axis=1, 
+                                                                                                                 level=1, 
+                                                                                                                 ascending=False)
+    
+    return df_pivot_working_hours_with_sign_sorted, period_current

mindsett_energy_reports_pkg/mdl/prepare_and_email_reports/prepare_report/generate_components/generate_daily_barchart_with_temp/preprocessing_for_barchart/patch_missing_columns_for_ooh_and_sign/__init__.py

@@ -0,0 +1,18 @@
+
+import pandas as pd
+
+def patch_missing_columns_for_ooh_and_sign(df_pivot_working_hours_with_sign):
+
+    columns_for_sign = [True, False]
+    columns_for_ooh = [True, False]
+
+    required_columns_for_ooh_and_sign = pd.MultiIndex.from_product([columns_for_sign, columns_for_ooh])
+
+    # required_columns_for_ooh = [True, False]
+    existing_columns_for_ooh_and_sign = df_pivot_working_hours_with_sign.columns
+
+    for column in required_columns_for_ooh_and_sign:
+        if column not in existing_columns_for_ooh_and_sign:
+            df_pivot_working_hours_with_sign[column] = 0
+
+    return df_pivot_working_hours_with_sign

mindsett_energy_reports_pkg/mdl/prepare_and_email_reports/prepare_report/generate_components/generate_daily_barchart_with_temp/preprocessing_for_barchart/patch_missing_dates/__init__.py

@@ -0,0 +1,28 @@
+import pandas as pd
+
+def patch_missing_dates(df_pivot_working_hours, period_current):
+
+    start_date = period_current.start_time.date()
+    end_date = period_current.end_time.date()
+
+    # firstly ensuring that the start and finish date are not missing
+    if start_date not in df_pivot_working_hours.index:
+        df_pivot_working_hours.loc[start_date] = 0
+
+    if end_date not in df_pivot_working_hours.index:
+        df_pivot_working_hours.loc[end_date] = 0
+
+    # convert the date index to full datetime, so it can be used to adjust frequency
+    df_pivot_working_hours.index = pd.to_datetime(df_pivot_working_hours.index)
+    df_pivot_working_hours_patched = df_pivot_working_hours.asfreq('1D', fill_value=0).fillna(0)
+
+    # convert the full datetime frequency to date following the original format
+    df_pivot_working_hours_patched.index = df_pivot_working_hours_patched.index.date
+
+    return df_pivot_working_hours_patched
+
+
+
+    
+    
+

mindsett_energy_reports_pkg/mdl/prepare_and_email_reports/prepare_report/generate_components/generate_energy_meter_with_benchmarking/__init__.py

@@ -0,0 +1,42 @@
+from pathlib import Path
+import matplotlib.pyplot as plt
+import io
+
+from .preprocessing_for_energy_meter_with_benchmarking import preprocessing_for_energy_meter_with_benchmarking
+from .energy_meter_with_benchmarking import energy_meter_with_benchmarking
+
+
+def generate_energy_meter_with_benchmarking(df_meta_with_value_building, floor_size,
+                                            industry = "office",
+                                            size_in_sqm = True,
+                                            conv_mwh_price = 190,
+                                            currency = 'GBP',
+                                            fontsize = 13,
+                                            directory_to_savefig=None):
+                                            
+    consumption_mwh_cur, consumption_mwh_pre, days_in_period = preprocessing_for_energy_meter_with_benchmarking(df_meta_with_value_building)
+
+    print('consumption_mwh_building_total: ', consumption_mwh_cur)  # debug
+    energy_meter_with_benchmarking(consumption_mwh_cur, consumption_mwh_pre, floor_size, 
+                                    industry=industry, 
+                                    period=days_in_period, 
+                                    size_in_sqm=size_in_sqm,
+                                    conv_mwh_price=conv_mwh_price,
+                                    currency=currency,
+                                    fontsize=fontsize)
+    
+    png_name = 'monthly_total_and_bm_latest.png'
+    if directory_to_savefig == None:
+        png_object = io.BytesIO()
+        plt.savefig(png_object, format='png', dpi=200,transparent=True, bbox_inches='tight', pad_inches=0)
+        plt.close()
+        return {png_name: png_object}
+    else:
+        png_path = directory_to_savefig + png_name
+        plt.savefig(png_path, format='png', dpi=200,transparent=True, bbox_inches='tight', pad_inches=0)
+        plt.close()
+        return {png_name: png_path}
+
+
+    # Path(directory_to_savefig).mkdir(parents=True, exist_ok=True)
+    # plt.savefig(directory_to_savefig+"monthly_total_and_bm_latest.png", format='png', dpi=200,transparent=True, bbox_inches='tight', pad_inches=0)

mindsett_energy_reports_pkg/mdl/prepare_and_email_reports/prepare_report/generate_components/generate_energy_meter_with_benchmarking/energy_meter_with_benchmarking/__init__.py

@@ -0,0 +1,66 @@
+
+import matplotlib.pyplot as plt
+
+from os import path
+
+from .energy_meter_design import energy_meter_design
+from .benchmarking_design import benchmarking_design
+
+
+def energy_meter_with_benchmarking(consumption_mwh_cur, consumption_mwh_pre, floor_size, 
+                                   image_folder=None,
+                                    size_in_sqm = True,
+                                    industry = "office",
+                                    period = 30,
+                                    conv_mwh_co2 = 0.233,
+                                    conv_mwh_price = 190,
+                                    fx = 0.2, # fancy box x-axis value
+                                    fy = 0.3, # fancy box y-axis value
+                                    fs  = 0.6, # fancy box scale factor
+                                    kwh_per_sqm_good = 10.33,
+                                    kwh_per_sqm_typical = 14.5,
+                                    currency = 'GBP',
+                                    fontsize=13, # please note that the other fontsizes haven't been tested yet
+                                    # directory_to_savefig = './figures/'
+                                  ):
+    
+    if image_folder == None:
+        image_folder = path.join(path.dirname(__file__), '_assets_/')
+
+    plt.style.use('seaborn-white')
+    fig, ax = plt.subplots(figsize=(5, 5.5))
+
+    if size_in_sqm:
+        floor_sqm = floor_size
+    else:
+        floor_sqm = floor_size * 0.0929
+
+    if industry == "office":
+        floor_sqm_as_office = floor_sqm
+    elif industry == "food service":
+        # (not working on 26 Nov 24): https://cdn2.hubspot.net/hubfs/5055051/Offers/Energy%20Benchmarking%20Report%20-%20Iota.pdf?utm_campaign=Offer%3A%20Energy%20Benchmarking%20Report&utm_medium=email&_hsmi=72631957&_hsenc=p2ANqtz-8urx_6ejMPQ25rp-u0vAHPq0cmKPTvL18SQTEf22gtrdDV2x7wGnd5kkP40_bx3M5hOWp3tysnbPI4JjWriJEp2fb5o7PzNF5D9VFqQNjYVLVxKtE&utm_content=72631957&utm_source=hs_automation
+        # added on 26 Nov 24: https://www.betterbuildingspartnership.co.uk/sites/default/files/media/attachment/REEB%202023%20Benchmarks_0.pdf
+        floor_sqm_as_office = floor_sqm * 56/15 # 56/15 food service/office
+
+    floor_sqm_as_office_for_month = floor_sqm_as_office * period / 30 # default days in a month
+
+    
+    energy_meter_design(ax, consumption_mwh_cur, consumption_mwh_pre, image_folder,
+                        conv_mwh_co2=conv_mwh_co2,
+                        conv_mwh_price=conv_mwh_price,
+                        fx=fx, fy=fy, fs=fs,
+                        currency=currency,
+                        fontsize=fontsize)
+    benchmarking_design(ax, consumption_mwh_cur, floor_sqm_as_office_for_month,
+                        fx=fx, fy=fy-0.12, fs=fs,
+                        kwh_per_sqm_good=kwh_per_sqm_good,
+                        kwh_per_sqm_typical=kwh_per_sqm_typical,
+                        fontsize=fontsize
+                       )
+    ax.set_xlim(0, 1) # shouldn't be modified
+    ax.set_ylim(-1, 2)
+
+    plt.axis('off')
+    # Specify the directory to save figures, if it does not exist, create it
+    # Path(directory_to_savefig).mkdir(parents=True, exist_ok=True)
+    # plt.savefig(directory_to_savefig+"Monthly_total_and_bm_latest.png", format='png', dpi=200,transparent=True, bbox_inches='tight', pad_inches=0)

mindsett_energy_reports_pkg/mdl/prepare_and_email_reports/prepare_report/generate_components/generate_energy_meter_with_benchmarking/energy_meter_with_benchmarking/benchmarking_design/__init__.py

@@ -0,0 +1,194 @@
+
+import matplotlib.patches as mpatches
+import matplotlib.text as mpltext
+
+from .ruler_anno_shink_cf import ruler_anno_shink_cf
+
+
+cd = {"tomato": '#FF836A',"aquablue": '#6DC2B3',"peach": '#FED6D2',"darkgrey": '#9F9D9C',"potato": '#FEF8C8',
+      "cyan": '#B6E4E1',"dimgray":'#696969',"Seafoam":'#87e0cf',"gainsboro":'#DCDCDC'}
+
+
+def benchmarking_design(ax, consumption_mwh_cur, floor_sqm,
+                        kwh_per_sqm_good = 10.33,
+                        kwh_per_sqm_typical = 14.5,
+                        fx = 0.2, # fancy box x-axis value
+                        fy = 0.18, # fancy box y-axis value
+                        fs = 0.6, # fancy box scale factor
+                        fontsize = 13
+                        ):
+
+
+        mwh_good = floor_sqm * kwh_per_sqm_good / 1000
+        mwh_typical = floor_sqm * kwh_per_sqm_typical / 1000
+        
+        mwh_btw_good_typical = mwh_typical - mwh_good
+        
+        key_values_list = [mwh_typical + mwh_btw_good_typical,
+                           mwh_good - mwh_btw_good_typical,
+                           consumption_mwh_cur + mwh_btw_good_typical/2,
+                           consumption_mwh_cur - mwh_btw_good_typical/2]
+        
+        ticks_max = max(key_values_list)
+        ticks_min = min(key_values_list)
+        
+        ticks_values_list = [ticks_min, mwh_good, mwh_typical, ticks_max]
+        ticks_range = ticks_max - ticks_min
+        
+        ## ruler settings
+        ru_x = 0  # the x-axis of benchmarking ruler
+        ru_y = 0  # the x-axis of benchmarking ruler
+        ru_w = 1  # the width of benchmarking ruler
+        ru_h = 0.08  # the height of benchmarking ruler
+        
+        rp_edgecolor = 'k' # edgecolor of the ruler body parts
+        rp_note_fontsize = fontsize - 5 # the fontsize of notes on ruler parts # please note that the other sizes except default 13 haven't been tested yet
+
+        # ruler body - part one - good
+        rp_x = ru_x         # the x-axis value of this part
+        rp_y = ru_y - 0.07      # the y-axis value of this part
+        rp_w = ru_w * (ticks_values_list[1]-ticks_values_list[0])/ticks_range   # the width value of this part
+        rp_h = ru_h
+        rp_c = cd["aquablue"]
+        ruler_body_part_one = mpatches.Rectangle([fx+rp_x*fs, fy+rp_y*fs], 
+                                             rp_w*fs, rp_h*fs, facecolor=rp_c, edgecolor=rp_edgecolor, lw=1)
+        
+      #   print('ruler_body_part_one rp_w*fs, rp_h*fs: ', rp_w*fs, rp_h*fs)
+        rpa_x = rp_x + rp_w/2.0 # ruler body part annotation - x axis
+        rpa_y = rp_y  # ruler body part annotation - y axis
+        bar_width = rp_w*fs
+        part = 'part_one'
+        rpa_text = ruler_anno_shink_cf(bar_width, part)
+        
+
+        ax.annotate(rpa_text, (fx+fs*rpa_x, fx+fs*rpa_y), color='w', weight='bold', 
+                    fontsize=rp_note_fontsize, ha='center', va='center')
+
+        # ruler body - part two - normal
+        rp_x = rp_x + rp_w     # the x-axis value of this part
+        rp_y = ru_y - 0.07      # the y-axis value of this part
+        rp_w = ru_w * (ticks_values_list[2]-ticks_values_list[1])/ticks_range   # the width value of this part
+        rp_h = ru_h
+        rp_c = cd["potato"]
+        ruler_body_part_two = mpatches.Rectangle([fx+rp_x*fs, fy+rp_y*fs], 
+                                             rp_w*fs, rp_h*fs, facecolor=rp_c, edgecolor=rp_edgecolor, lw=1)
+        
+      #   print('ruler_body_part_two rp_w*fs, rp_h*fs: ', rp_w*fs, rp_h*fs)
+        rpa_x = rp_x + rp_w/2.0 # ruler body part annotation - x axis
+        rpa_y = rp_y  # ruler body part annotation - y axis
+        bar_width = rp_w*fs
+        part = 'part_two'
+        rpa_text = ruler_anno_shink_cf(bar_width, part)
+
+        ax.annotate(rpa_text, (fx+fs*rpa_x, fx+fs*rpa_y), color='#9F9D9C', weight='bold', 
+                    fontsize=rp_note_fontsize, ha='center', va='center')
+
+        # ruler body - part three - poor
+        rp_x = rp_x + rp_w     # the x-axis value of this part
+        rp_y = ru_y - 0.07      # the y-axis value of this part
+        rp_w = ru_w * (ticks_values_list[3]-ticks_values_list[2])/ticks_range   # the width value of this part
+        rp_h = ru_h
+        rp_c = cd["tomato"]
+        ruler_body_part_thr = mpatches.Rectangle([fx+rp_x*fs, fy+rp_y*fs], 
+                                             rp_w*fs, rp_h*fs, facecolor=rp_c, edgecolor=rp_edgecolor, lw=1)
+        
+      #   print('ruler_body_part_three rp_w*fs, rp_h*fs: ', rp_w*fs, rp_h*fs)
+        rpa_x = rp_x + rp_w/2.0 # ruler body part annotation - x axis
+        rpa_y = rp_y  # ruler body part annotation - y axis
+        bar_width = rp_w*fs
+        part = 'part_three'
+        rpa_text = ruler_anno_shink_cf(bar_width, part)
+
+        ax.annotate(rpa_text, (fx+fs*rpa_x, fx+fs*rpa_y), color='w', weight='bold', 
+                    fontsize=rp_note_fontsize, ha='center', va='center')
+
+        ax.add_artist(ruler_body_part_one)
+        ax.add_artist(ruler_body_part_two)
+        ax.add_artist(ruler_body_part_thr)
+
+
+        # ruler ticks labels
+        
+        rt_fs = fontsize  # the fontsize of ruler ticks labels
+        rt_c = "grey"  # the font color of ruler ticks labels
+        rt_va = u'bottom' 
+        rt_ha = u'center' 
+        rt_fontweight = "light"
+        
+        ru_rt_y = -0.18 # ruler ticks y-axis in relation to the ruler y-axis
+        
+        tick = ticks_values_list[0]
+        rt_x = ru_x + (tick-ticks_min)/ticks_range
+        rt_y = ru_y + ru_rt_y
+        tick_value = f"{tick:1.1f}"
+        tick_label_one = mpltext.Text(x=fx+rt_x*fs, y=fy+rt_y*fs, text=f'{tick_value}', 
+                                  va=rt_va, color=rt_c, ha=rt_ha, fontweight=rt_fontweight, fontsize=rt_fs)
+
+        tick = ticks_values_list[1]
+        tick_pct = (tick-ticks_min)/ticks_range
+        rt_x = ru_x + tick_pct
+        rt_y = ru_y + ru_rt_y
+
+        # conditionally remove the tick_value label when it's too close to the edges
+        if (tick_pct < 0.2) or (tick_pct > 0.8):
+            tick_value = ''
+        else:
+            tick_value = f"{tick:1.1f}"
+        tick_label_two = mpltext.Text(x=fx+rt_x*fs, y=fy+rt_y*fs, text=f'{tick_value}', 
+                                  va=rt_va, color=rt_c, ha=rt_ha, fontweight=rt_fontweight, fontsize=rt_fs)
+
+        tick = ticks_values_list[2]
+        tick_pct = (tick-ticks_min)/ticks_range
+        rt_x = ru_x + tick_pct
+        rt_y = ru_y + ru_rt_y
+
+        # conditionally remove the tick_value label when it's too close to the edges
+        if (tick_pct < 0.2) or (tick_pct > 0.8):
+            tick_value = ''
+        else:
+            tick_value = f"{tick:1.1f}"
+        tick_label_thr = mpltext.Text(x=fx+rt_x*fs, y=fy+rt_y*fs, text=f'{tick_value}', 
+                                  va=rt_va, color=rt_c, ha=rt_ha, fontweight=rt_fontweight, fontsize=rt_fs)
+
+        tick = ticks_values_list[3]
+        rt_x = ru_x + (tick-ticks_min)/ticks_range
+        rt_y = ru_y + ru_rt_y
+        tick_value = f"{tick:1.1f}"
+        tick_label_four = mpltext.Text(x=fx+rt_x*fs, y=fy+rt_y*fs, text=f'{tick_value}', 
+                                  va=rt_va, color=rt_c, ha=rt_ha, fontweight=rt_fontweight, fontsize=rt_fs)
+
+        ax.add_artist(tick_label_one)
+        ax.add_artist(tick_label_two)
+        ax.add_artist(tick_label_thr)
+        ax.add_artist(tick_label_four)
+
+        # ruler indicator
+        indicator_value = consumption_mwh_cur
+        rih_x = ru_x + (indicator_value-ticks_min)/ticks_range # x-axis value of the ruler indicator head
+        rih_y = ru_y + 0.084  # y-axis value of the ruler indicator head
+        rih_r = 0.045
+
+        indicator_head = mpatches.Circle((fx+(rih_x)*fs, fy+rih_y*fs), rih_r*fs, 
+                                         fc="w", color = "w", ec="k", lw=1.3, zorder=10
+                                         ) #path_effects=[path_effects.withSimplePatchShadow()]
+
+        rib_x = ru_x + (indicator_value-ticks_min)/ticks_range # x-axis value of the ruler indicator head
+        rib_y = ru_y - 0.09  # y-axis value of the ruler indicator head
+        rib_w = 0.02
+        rib_h = ru_h * 2
+
+        indicator_body = mpatches.Rectangle([fx+(rib_x-rib_w/2)*fs, fy+rib_y*fs], rib_w*fs, rib_h*fs, 
+                                            fc="w", ec="k", lw=1.3,  zorder=10) #path_effects=[path_effects.withSimplePatchShadow()]
+        ax.add_artist(indicator_body)
+        ax.add_artist(indicator_head)
+        
+        ## title
+
+        tt_x = ru_x + ru_w/2
+        tt_y = ru_y - 0.26
+        #title = f"BBP Benchmarking (REEB)"
+        #tt_c = '#9F9D9C'
+        #title_text = mpltext.Text(x=fx+tt_x*fs, y=fy+tt_y*fs, text=f'{title}', 
+                                  #va="center", ha="center", color=tt_c, fontweight="normal", fontsize=12) #fontfamily='serif'
+        
+        #ax.add_artist(title_text)

mindsett_energy_reports_pkg/mdl/prepare_and_email_reports/prepare_report/generate_components/generate_energy_meter_with_benchmarking/energy_meter_with_benchmarking/benchmarking_design/ruler_anno_shink_cf/__init__.py

@@ -0,0 +1,24 @@
+
+
+# ruler annotation shinking config
+
+config_dict = {'full_name': {'size_lim': 0.11, 'names': {'part_one': "GOOD", 'part_two': 'NORM', 'part_three': 'POOR'}},
+                       'shrink_name':  {'size_lim': 0.08, 'names': {'part_one': "GD", 'part_two': 'NR', 'part_three': 'PR'}},
+                       'short_name':  {'size_lim': 0.06, 'names': {'part_one': "G", 'part_two': 'N', 'part_three': 'P'}},
+                       'null_name':  {'size_lim': 0.05, 'names': {'part_one': "", 'part_two': '', 'part_three': ''}},
+}
+
+def ruler_anno_shink_cf(bar_width, part):
+
+    if bar_width > config_dict['full_name']['size_lim']:
+        rpa_text = config_dict['full_name']['names'][part]
+    elif bar_width > config_dict['shrink_name']['size_lim']:
+        rpa_text = config_dict['shrink_name']['names'][part]
+    elif bar_width > config_dict['short_name']['size_lim']:
+        rpa_text = config_dict['short_name']['names'][part]
+    else:
+        rpa_text = config_dict['null_name']['names'][part]
+    
+    return rpa_text
+
+