Glossary of Auto-Complete Smart Tokens

The following terms can be typed into proposal text fields to automatically pull in HelioScope data directly into the report. Typing a curly bracket "{" will bring up a list of available terms. As you start typing you will see a list of matching Smart Tokens. Below is a complete list of the currently available terms. Please let us know if there are any values you would like added to the list.

Consumption

Smart Token	Definition
avg_bill_monthly	Pre-solar monthly electricity costs
avg_bill_monthly_with_solar	Post-solar monthly electricity costs
total_bill_yearly	Pre-solar annual electricity costs
total_bill_yearly_with_solar	Post-solar annual electricity costs
total_bill_lifetime	Total electricity costs across system lifetime
total_savings_yearly	Annual electricity costs savings
total_savings_monthly	Monthly electricity costs savings
lifetime_savings	Total electricity cost savings across system lifetime
avg_cost_per_kwh	Pre-solar electricity costs on a per kWh basis
avg_cost_per_kwh_lifetime	Pre-solar electricity costs on a per kWh basis adjusted for utility cost inflation
avg_consumption_monthly	Average pre-solar electricity consumption in kWh
total_consumption_yearly	Total pre-solar electricity consumption in kWh

Design

Smart Token	Definition
annual_production	Annual solar array energy generation
design_name	Design name
design_nameplate_ac	System size in AC
design_nameplate_dc	System size in DC
system_yield	Specific yield, calculated as the total simulation energy generation divided by the system DC nameplate power.
system_performance_ratio	Performance Ratio (PR) shows the percentage of total potential energy for the array that is converted to AC energy ( read more here)
annual_degradation	Annual system degradation
cost_per_watt_ac	System price in $ / AC Watt
cost_per_watt_dc	System price in $ / DC Watt

Equipment

Please note, currently, HelioScope smart tokens for equipment are limited to one inverter type and one module type per design.

Smart Token	Definition
inverter_manufacturer	Inverter manufacturer brand name
inverter_model	Inverter model name
inverter_quantity	Count of inverters in the design
inverter_wattage	Inverter nominal output power
module_manufacturer	Module manufacturer brand name
module_model	Module model name
module_power	Module STC rated power
module_quantity	Count of modules in the design

Financials

Smart Token	Definition
avg_full_cost_monthly	Monthly cost of solar financing + remaining electricity bill
financing_costs_monthly	Monthly cost of solar financing
IRR	Internal Rate of Return ( Investopedia definition)
LCOE	Levelized Cost of Energy: calculated as the net present value of all costs over the life of the system divided by the net present value of energy generation over the life of the system
incentives_total	The sum of all incentives received over the life of the system
offset_bill	Percentage of electricity costs ($) offset by solar production
offset_energy	Percentage of electricity consumption (kWh) offset by solar production
ROI	Return on Investment: value from electricity savings divided by investment cost
system_net_costs	Net system price after incentives
system_total_cost	Total system price before incentives
system_npv_cash	Net Present Value of cash inflows and outflows over the life of the system. Adjust future cash flows to today's dollars to adjust for the time value of money ( Investopedia definition)
system_npv_energy	Net Present Value of energy outflows over the life of the system. Adjusts future energy generation to account for the time value of money

Project

Smart Token	Definition
project_created	Date of project creation
project_creator_company	Company name associated with the project creator's account
project_creator_email	Project creator's email address
project_creator_firstname	Project creator's first name
project_creator_fullname	Project creator's full name
project_creator_lastname	Project creator's last name
project_name	Name of the project

Environmental

The environmental metrics come from the EPA Greenhouse Gas Equivalencies Calculator. All the values are structured on a per kWh basis. For example, 1 kWh of electricity is equal to 1.6 pounds of Carbon Dioxide emissions. In the financial template, setting the Carbon Dioxide field to 1.6 equivalent then your HelioScope reports will show 1.6 x system kWh generation to calculate the total carbon dioxide offset in pounds. The table below provides the per kWh equivalencies in both metric and imperial units.

Smart Token	Name	Metric	Imperial
co2_kg	Carbon Dioxide	0.707 (kg / kWh)	1.6 (lbs / kWh)
driven_vehicle	Passenger Vehicles Driven for 1 Year	0.0002 (cars / kWh)	0.0002 (cars / kWh)
driven_km	Passenger Vehicle Distance Driven	2.73588 (km / kWh)	1.7 (miles / kWh)
recycled_ton	Waste Recycled Instead of Landfilled	0.00025 (tons / kWh)	0.00025 (tons / kWh)
recycled_truck	Waste Recycled Instead of Landfilled (truckload)	0.00004 (trucks / kWh)	0.00004 (trucks / kWh)
gasoline_liter	Gasoline Consumed	0.3028 (liters / kWh)	.08 (gallons / kWh)
gasoline_tanker	Gasoline Consumed (Tanker Truck)	0.000009 (trucks / kWh)	0.000009 (trucks / kWh)
energy_annual_home	Home Annual Energy Usage	0.00008 (homes / kWh)	0.00008 (homes / kWh)
electricity_annual_home	Home Annual Electricity Usage	0.00012 (homes / kWh)	0.00012 (homes / kWh)
led_bulb	Incandescent Lamps Switched to LEDs	0.027 (bulbs / kWh)	0.027 (bulbs / kWh)
oil_barrel	Barrels of Oil Consumed	0.00164 (barrels / kWh)	0.00164 (barrels / kWh)
propane_can	Propane Used for Home Barbecues	0.029 (cylinders / kWh)	0.029 (cylinders / kWh)
coal_kg	Coal Burned	0.3506 (kg / kWh)	0.773 (lbs / kWh)
coal_railcar	Coal Burned (Railcars)	0.00004 (railcars / kWh)	0.00004 (railcars / kWh)
seedling_ten_year	Tree Seedlings Grown for 10 Years	0.117 (seedling / kWh)	0.117 (seedling / kWh)
forest_hectare	Hectares of Forest Preserved for 1 Year	0.00832 (hectares / kWh)	0.00832 (hectares / kWh)