Diesel Efficiency Component

class aaem.components.diesel_efficiency.component.DieselEfficiency(community_data, forecast, diag=None, prerequisites={})[source]

Bases: aaem.components.annual_savings.annual_savings.AnnualSavings

Diesel Efficiency component of the Alaska Affordable Energy Model: This module estimates the potential reduction in diesel fuel use from improvements to the efficiency of a community’s diesel generation systems. Financial savings are from an assumed decrease in diesel oil used in generation. Costs of the improvements are based on the assumed capacity of the improved system.

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: ‘Diesel Efficiency’ section of community_data

Methods

calc_annual_electric_savings()[source]

calculate annual electric savings created by the project

Attributes

annual_electric_savings (np.array) electric savings ($/year) are the difference in the base
and proposed fuel costs  
calc_annual_heating_savings()[source]

calculate annual heating savings created by the project

Attributes

annual_heating_savings (flaot) no savings from heating
calc_average_load()[source]

calculate the average load of the system

Attributes

generation: array array of diesel generation values per year (kWh/year)
average_load: float average diesel generation load in first year of project (kW)
calc_baseline_generation_fuel_use()[source]

calculates baseline generation fuel use

Attributes

baseline_diesel_efficiency (float) the diesel generation efficiency before any improvements are made (Gal/kWh) [
baseline_generation_fuel_use (np.array) fuel used per year before improvements (gal)
calc_capital_costs()[source]

calculate the capital costs

Attributes

capital_costs (float) total cost of improvements ($), calculated from max_capacity
calc_max_capacity()[source]

calculate max load and capacity

Attributes

max_load (float) maximum load over project lifetime (KWh)
max_capacity: float proposed max capacity (KWh)
calc_oppex()[source]

calculate the operational costs

Attributes

oppex (float) operational costs per year ($) read from o&m costs table
calc_proposed_generation_fuel_use()[source]

calculates proposed generation fuel use

Attributes

proposed_diesel_efficiency (float) the diesel generation efficiency before any improvements are made (Gal/kWh)
proposed_generation_fuel_use (np.array) fuel used per year after improvements (gal)
get_fuel_total_saved()[source]

get total fuel saved

Returns:

float

the total fuel saved in gallons

get_total_energy_produced()[source]

get total energy produced

Returns:

float

the total energy produced

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

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
save_component_csv(directory)[source]

Save the component output csv in directory

Parameters:

directory : path

output directory

Diesel Efficiency Configuration

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

Diesel Efficiency inputs

input functions for Diesel Efficiency component

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

reads input data from “diesel_data.csv”

Parameters:

data_dir : path

the path to the input data directory

Returns:

dict

diesel power house data

Diesel Efficiency Outputs

output functions for Diesel Efficiency component

aaem.components.diesel_efficiency.outputs.communities_summary(coms, res_dir)[source]

Saves the summary by: community diesel_efficiency_summary.csv

Parameters:

coms : dictionary

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

res_dir : path

location to save file

aaem.components.diesel_efficiency.outputs.component_summary(results, res_dir)[source]

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.diesel_efficiency.outputs.create_regional_summary(results)[source]

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.diesel_efficiency.outputs.save_regional_summary(summary, res_dir)[source]

Saves the summary by region: __regional_diesel_efficiency_summary.csv

Parameters:

summary : DataFrame

compiled regional results

res_dir : path

location to save file

Diesel Efficiency preprocessing

preprocessing functions for Diesel Efficiency component

aaem.components.diesel_efficiency.preprocessing.preprocess(preprocessor, **kwargs)[source]

preprocess data related to existing projects

Parameters:

preprocessor: preprocessor.Preprocessor

a preprocessor object

Returns:

list

project names