Transmission Component

class aaem.components.transmission.component.Transmission(community_data, forecast, diag=None, prerequisites={})

Bases: aaem.components.annual_savings.annual_savings.AnnualSavings

Transmission and intertie component of the Alaska Affordable Energy Model: This module estimates the potential reduction in diesel fuel use from installation of transmission lines to another community with better generation infrastructure. Savings result from difference in generation costs between communities. The costs of new transmission lines are estimated based on distances between communities.

Parameters:

community_data : CommunityData

CommunityData Object for a community

forecast : Forecast

forecast for a community

diagnostics : diagnostics, optional

diagnostics for tracking error/warning messages

prerequisites : dictionary of components, optional

prerequisite component data this component has no prerequisites leave empty

See also

aaem.community_data

community data module, see information on CommunityData Object

aaem.forecast

forecast module, see information on Forecast Object

aaem.diagnostics

diagnostics module, see information on diagnostics Object

Attributes

diagnostics	(diagnostics) for tracking error/warning messages initial value: diag or new diagnostics object
forecast	(forecast) community forecast for estimating future values initial value: forecast
cd	(dictionary) general data for a community. Initial value: ‘community’ section of community_data
comp_specs	(dictionary) component specific data for a community. Initial value: ‘Transmission’ section of community_data

Methods

calc_annual_electric_savings()

Calculate annual electric savings created by the project.

Attributes

baseline_generation_cost	(np.array) current cost of generation ($/year)
proposed_generation_cost	(np.array) proposed cost of generation ($/year)
annual_electric_savings	(np.array) electric savings ($/year) are the difference in the base
and proposed fuel costs

calc_annual_heating_savings()

Calculate annual heating savings created by the project.

Attributes

annual_heating_savings

(np.array) heating savings ($/year)

calc_average_load()

Calculate the Average Diesel load of the current system

Attributes

average_load

(float) average diesel load of current system

calc_capital_costs()

Calculate the capital costs.

Attributes

capital_costs

(float) total cost of improvements ($), calculated from transmission and generation costs

calc_intertie_offset_generation()

Calculate the generation offset by connecting a transmission line to the community to connect to.

Attributes

annual_transmission_loss	(float) the percent electricity lost through transmission
intertie_offset_generation	(float) the generation offset in kWh
intertie_offset_generation_fuel_used	(float) is the fuel used in generation gallons

calc_lost_heat_recovery()

Calculate the heat recovery

Attributes: lost_heat_recovery : np.array

the heat recovery lost per year (gal of heating fuel)

calc_pre_intertie_generation()

Calculate the status quo generation in the community .

Attributes

pre_intertie_generation	(float) current generation per year in kWh
pre_intertie_generation_fuel_used	(float) the fuel used in generation (gallons)

get_fuel_total_saved()

Get total fuel saved.

Returns:

float

the total fuel saved in gallons

get_intertie_values()

Get values from the community being connected to (second community)

Note

the input_data for the second community should exist

Attributes

intertie_generation_efficiency	(float) the generator efficiency kWh/gal
intertie_diesel_prices	(np.array) diesel prices over the project lifetime

get_total_energy_produced()

Get total energy produced.

Returns:

float

the total energy produced

run(scalers={'capital costs': 1.0})

Runs the component. The Annual Total Savings,Annual Costs, Annual Net Benefit, NPV Benefits, NPV Costs, NPV Net Benefits, Benefit Cost Ratio, Levelized Cost of Energy, and Internal Rate of Return will all be calculated. There must be a known Heat Recovery project for this component to run.

Parameters:

scalers: dictionary of valid scalers, optional

Scalers to adjust normal run variables. See note on accepted scalers

Notes

Accepted scalers: capital costs.

Attributes

run	(bool) True in the component runs to completion, False otherwise
reason	(string) lists reason for failure if run == False

Transmission Configuration

Contains Transmission configuration info for community data yaml file, and other set-up requirements

aaem.components.transmission.config.load_other_community(community_data, community_config, global_config, scalers)

load info for other community

community_data community_config global_config scalers

Attributes

new_intertie_data	(CommunityData) community data for community to connect to. this attribute
is added to the main communities community data

Transmission Inputs

input functions for Transmission component

aaem.components.transmission.inputs.load_project_details(data_dir)

load details related to exitign projects

Parameters:

data_dir: path

path to data directory for community

Returns:

dict

a dictonary with the keys ‘phase’(str), ‘proposed capacity’(float), ‘proposed generation’(float), ‘distance to resource’(float), ‘generation capital cost’(float), ‘transmission capital cost’(float), ‘operational costs’(float), ‘expected years to operation’(int),

aaem.components.transmission.inputs.process_data_import(data_dir)

Load data from transmission_data.csv

Parameters:

data_dir: path

path to data directory for community

Returns:

dict

transmission data

Transmission Outputs

output functions for Transmission component

aaem.components.transmission.outputs.communities_summary(coms, res_dir)

Saves the component summary by community

Parameters:

coms : dictionary

results from the model, dictionary with each community or project as key

res_dir : path

location to save file

aaem.components.transmission.outputs.component_summary(results, res_dir)

Creates the regional and communities summary for the component in provided directory

Parameters:

results : dictionary

results from the model, dictionary with each community or project as key

res_dir : path

location to save file

aaem.components.transmission.outputs.create_regional_summary(results)

Creates the regional summary

Parameters:

results : dictionary

results from the model, dictionary with each community or project as key

Returns:

DataFrame

containing regional results

aaem.components.transmission.outputs.save_regional_summary(summary, res_dir)

Saves the summary by region

Parameters:

summary : DataFrame

compiled regional results

res_dir : path

location to save file

Transmission Preprocessing

preprocessing functions for The Transmission component

aaem.components.transmission.preprocessing.preprocess(preprocessor, **kwargs)

preprocess wind power data

Parameters:

preprocessor: preprocessor.Preprocessor

a preprocessor object

Returns:

dict

preprocessed data