4.9. fuel_costs module

fuel_costs.get_orvr_adjustment(settings, vehicle, alt, program)

Parameters:

settings: The SetInputs class.

vehicle: Tuple; represents a sourcetype_regclass_fueltype vehicle.

alt: Numeric; the Alternative or option ID.

program: String; represents which program is being run, CAP or GHG.

Returns:

A single value representing the milliliter per gram adjustment to be applied to total hydrocarbon emission reductions to estimate the gallons of fuel saved.

fuel_costs.calc_thc_reduction(settings, vehicle, alt, calendar_year, model_year, totals_dict)

Parameters:

settings: The SetInputs class.

vehicle: Tuple; represents a sourcetype_regclass_fueltype vehicle.

alt: Numeric; the Alternative or option ID.

calendar_year: Numeric; the calendar year.

model_year: Numeric; the model year of the passed vehicle.

totals_dict: Dictionary; provides fleet total hydrocarbon (THC) tons by vehicle.

Returns:

A single THC reduction for the given model year vehicle in the given year.

fuel_costs.calc_captured_gallons(settings, vehicle, alt, calendar_year, model_year, totals_dict, program)

Parameters:

settings: The SetInputs class.

vehicle: Tuple; represents a sourcetype_regclass_fueltype vehicle.

alt: Numeric; the Alternative or option ID.

calendar_year: Numeric; the calendar year.

model_year: Numeric; the model year of the passed vehicle.

totals_dict: Dictionary; provides fleet total hydrocarbon (THC) tons by vehicle. program: String; represents which program is being run, CAP or GHG.

Returns:

The gallons captured by ORVR that would have otherwise evaporated during refueling.

fuel_costs.calc_fuel_costs(settings, totals_dict, fuel_arg, program)

Parameters:

settings: The SetInputs class.

totals_dict: Dictionary; provides the fleet Gallons consumed by all vehicles.

fuel_arg: String; specifies the fuel attribute to use (e.g., “Gallons” or “Gallons_withTech”)

program: String; represents which program is being run, CAP or GHG.

Returns:

The passed dictionary updated to reflect fuel consumption (Gallons) adjusted to account for the fuel saved in association with ORVR. The dictionary is also updated to include the fuel costs associated with the gallons consumed (Gallons * $/gallon fuel).

Note:

Note that gallons of fuel captured are not included in the MOVES runs that serve as the input fleet data for the tool although the inventory impacts are included in the MOVES runs.

fuel_costs.calc_average_fuel_costs(totals_dict, averages_dict, vpop_arg, vmt_arg)

Parameters:

totals_dict: Dictionary; provides fleet fuel costs for all vehicles.

averages_dict: Dictionary; the destination for fuel costs/vehicle and costs/mile results.

vpop_arg: String; specifies the population attribute to use (e.g., “VPOP” or “VPOP_withTech”)

vmt_arg: String; specifies the VMT attribute to use (e.g., “VMT” or “VMT_withTech”)

Returns:

The passed averages_dict updated to include fuel costs/vehicle and costs/mile.