Vehicle Index

Vehicle Attributes

Name	Units	Default Value	Validation Rule	Description
Latitude	°	0		Latitude
Longitude	°	0		Longitude

Vehicle Input Properties

Name	Units	Multi-band	Default Value	Validation Rule	Key Property	Description
Auxiliary Consumption	kW	False	0	≥0	False	Axuiliary energy consumption for vehicle
Capacity	kWh	False	0	≥0	False	Capacity of the vehicle
Capacity Degradation	%	False	0		False	Degradation in capacity with age in number of cycles
Charge Efficiency	%	False	100	Between 0 And 100	False	Efficiency of charging
Charge Efficiency Degradation	%	False	0		False	Degradation in charge efficiency with age in number of cycles
Demand	km (Metric), m (U.S. Imperial)	False	0	≥0	False	Travel demand for vehicle
Discharge Efficiency	%	False	100	Between 0 And 100	False	Efficiency of discharging
Discharge Efficiency Degradation	%	False	0		False	Degradation in discharge efficiency with age in number of cycles
Disposal Cost	$	False	0		False	Cost of disposing of the vehicle
Economic Life	yr	False	30	≥0	False	Economic life of the vehicle (period over which fixed costs are recovered)
Efficiency	Wh/km (Metric), Wh/m (U.S. Imperial)	False	200	≥0	False	Electric vehicle efficiency
End Effects Method	-	False	2	In (1,2)	False	Method used to value or constrain end-of-period energy.
Energy Target	kWh	False	0	≥0	False	Vehicle stored energy target
Energy Target Day	kWh	False	0	≥0	False	End of day vehicle stored energy target
Energy Target Hour	kWh	False	0	≥0	False	End of hour vehicle stored energy target
Energy Target Month	kWh	False	0	≥0	False	End of month vehicle stored energy target
Energy Target Penalty	$/kWh	False	-1		False	Penalty for violating the vehicle stored energy target.
Energy Target Week	kWh	False	0	≥0	False	End of week vehicle stored energy target
Energy Target Year	kWh	False	0	≥0	False	End of year vehicle stored energy target
Expansion Optimality	-	False	2	In (0,2)	False	Expansion planning integerization scheme.
Fixed Load	kW	False	0		False	Fixed charging load
Fixed Load Global	-	False	0	In (0,-1)	False	If [Fixed Load] applies across all Vehicles or unit-by-unit
FO&M Charge	$	False	0		False	Annual fixed operation and maintenance charge
Inertia Constant	s	False	0	≥0	False	Stored energy per unit of power
Initial Age	cycles	False	0		False	Age of the vehicle battery in number of cycles at the start of the simulation horizon
Initial SoC	%	False	100	≥0	False	Initial state of charge
Integerization Horizon	yr	False	-1	≥-1	False	Number of years over which the expansion decisions are integerized
Max Charge Rate	kW	False	1E+30		False	Maximum charge rate
Max Cycles	cycles	False	1E+30		False	Number of cycles allowed each interval
Max Cycles Day	cycles	False	1E+30		False	Number of cycles allowed each day
Max Cycles Hour	cycles	False	1E+30		False	Number of cycles allowed each hour
Max Cycles Month	cycles	False	1E+30		False	Number of cycles allowed each month
Max Cycles Week	cycles	False	1E+30		False	Number of cycles allowed each week
Max Cycles Year	cycles	False	1E+30		False	Number of cycles allowed each year
Max Discharge Rate	kW	False	1E+30		False	Maximum discharge rate
Max Energy Charging	kWh	False	1E+30	≥0	False	Max Energy Discharging
Max Energy Charging Day	MWh	False	1E+30	≥0	False	Max Energy Discharging Day
Max Energy Charging Hour	kWh	False	1E+30	≥0	False	Max Energy Discharging Hour
Max Energy Charging Month	MWh	False	1E+30	≥0	False	Max Energy Discharging Month
Max Energy Charging Penalty	$/MWh	False	-1		False	Max Energy Discharging Penalty
Max Energy Charging Week	MWh	False	1E+30	≥0	False	Max Energy Discharging Week
Max Energy Charging Year	MWh	False	1E+30	≥0	False	Max Energy Discharging Year
Max Energy Discharging	kWh	False	1E+30	≥0	False	Max Energy Discharging
Max Energy Discharging Day	MWh	False	1E+30	≥0	False	Max Energy Discharging Day
Max Energy Discharging Hour	kWh	False	1E+30	≥0	False	Max Energy Discharging Hour
Max Energy Discharging Month	MWh	False	1E+30	≥0	False	Max Energy Discharging Month
Max Energy Discharging Penalty	$/MWh	False	-1		False	Max Energy Discharging Penalty
Max Energy Discharging Week	MWh	False	1E+30	≥0	False	Max Energy Discharging Week
Max Energy Discharging Year	MWh	False	1E+30	≥0	False	Max Energy Discharging Year
Max SoC	%	False	100	≥0	False	Allowable maximum state of charge
Max Units Built	-	False	0	≥0	False	Maximum number of units automatically constructed in aggregate over the planning horizon
Max Units Built in Year	-	False	1E+30	≥0	False	Maximum number of units automatically constructed in any single year of the planning horizon
Max Units Retired	-	False	0	≥0	False	Maximum number of units automatically retired in aggregate over the planning horizon
Max Units Retired in Year	-	False	1E+30	≥0	False	Maximum number of units automatically retired in any single year of the planning horizon
Min Energy Charging	kWh	False	0	≥0	False	Min Energy Discharging
Min Energy Charging Day	MWh	False	0	≥0	False	Min Energy Discharging Day
Min Energy Charging Hour	kWh	False	0	≥0	False	Min Energy Discharging Hour
Min Energy Charging Month	MWh	False	0	≥0	False	Min Energy Discharging Month
Min Energy Charging Penalty	$/MWh	False	10000000		False	Min Energy Discharging Penalty
Min Energy Charging Week	MWh	False	0	≥0	False	Min Energy Discharging Week
Min Energy Charging Year	MWh	False	0	≥0	False	Min Energy Discharging Year
Min Energy Discharging	kWh	False	0	≥0	False	Min Energy Discharging
Min Energy Discharging Day	MWh	False	0	≥0	False	Min Energy Discharging Day
Min Energy Discharging Hour	kWh	False	0	≥0	False	Min Energy Discharging Hour
Min Energy Discharging Month	MWh	False	0	≥0	False	Min Energy Discharging Month
Min Energy Discharging Penalty	$/MWh	False	10000000		False	Min Energy Discharging Penalty
Min Energy Discharging Week	MWh	False	0	≥0	False	Min Energy Discharging Week
Min Energy Discharging Year	MWh	False	0	≥0	False	Min Energy Discharging Year
Min SoC	%	False	0	≥0	False	Allowable minimum state of charge
Min Units Built	-	False	0	≥0	False	Minimum number of units automatically constructed in aggregate over the planning horizon
Min Units Built in Year	-	False	0	≥0	False	Minimum number of units automatically constructed in any single year of the planning horizon
Min Units Retired	-	False	0	≥0	False	Minimum number of units automatically retired in aggregate over the planning horizon
Min Units Retired in Year	-	False	0	≥0	False	Minimum number of units automatically retired in any single year of the planning horizon
Non-physical Charge Penalty	$/kW	False	-1		False	Penalty applied to non-physical charging of the vehicle. A value of -1 means none is allowed.
Non-physical Discharge Penalty	$/kW	False	-1		False	Penalty applied to non-physical discharging of the vehicle. A value of -1 means none is allowed.
Purchase Cost	$	True	0		False	Cost of purchasing the vehicle
Self Discharge Rate	%	False	0		False	Percentage of stored energy lost per hour due to self-discharge.
Simultaneous Charge and Discharge	Yes/No	False	-1	In (0,-1)	False	Vehicle can charge and discharge simultaneously
Technical Life	yr	False	1E+30	≥0	False	Technical lifetime of the vehicle
Units	-	False	0	≥0	True	Number of vehicles
VO&M Charge	$/km (Metric), $/m (U.S. Imperial)	False	0		False	Variable operation and maintenance charge
WACC	%	False	10	≥0	False	Weighted average cost of capital
x	-	True	0		False	Value to pass-through to solution
y	-	True	0		False	Value to pass-through to solution
z	-	True	0		False	Value to pass-through to solution

Vehicle Charging Stations Input Properties

Name	Units	Multi-band	Default Value	Validation Rule	Key Property	Description
Share	%	False	100	Between 0 And 100	False	Time the vehicle is at the charging station

Vehicle Fleets Input Properties

Name	Units	Multi-band	Default Value	Validation Rule	Key Property	Description
Share	%	False	100	Between 0 And 100	False	Fleet share of Vehicle

Vehicle Commodities Input Properties

Name	Units	Multi-band	Default Value	Validation Rule	Key Property	Description
Ratio	-	False	0		False	Proportion of energy provided by the Commodity

Vehicle Constraints Input Properties

Name	Units	Multi-band	Default Value	Validation Rule	Key Property	Description
Cycles Coefficient	cycles	False	0		False	Coefficient of cycles
Distance Coefficient	km (Metric), m (U.S. Imperial)	False	0		False	Coefficient of distance travelled by the vehicle
Energy Coefficient	kWh	False	0		False	Coefficient of energy stored in the vehicle
Generation Coefficient	kW	False	0		False	Coefficient of generation from vehicle to grid
Load Coefficient	kW	False	0		False	Coefficient of load drawn by vehicle charging

Vehicle Objectives Input Properties

Name	Units	Multi-band	Default Value	Validation Rule	Key Property	Description
Distance Coefficient	km (Metric), m (U.S. Imperial)	False	0		False	Coefficient of distance travelled by the vehicle

Vehicle Output Properties

Name	Summary Name	Property Group	Phases	Multi-band	Description
Age - cycles	Age - cycles	Expansion	LT Plan, MT Schedule, ST Schedule	False	Number of cycles completed
Annualized Purchase Cost - $000	Annualized Purchase Cost - $000	Expansion	LT Plan	False	Annualized cost of vehicle purchases
Auxiliary Consumption - kW	Auxiliary Consumption - MWh	Production	LT Plan, MT Schedule, ST Schedule	False	Energy consumption from auxiliary sources
Capacity Added - kWh	Capacity Added - kWh	Expansion	LT Plan	False	Battery capacity added
Capacity Removed - kWh	Capacity Removed - kWh	Expansion	LT Plan	False	Battery capacity removed
Charge Cost - $	Charge Cost - $000	Production	LT Plan, MT Schedule, ST Schedule	False	Cost of charging
Charge Efficiency - %	Charge Efficiency - %	Production	LT Plan, MT Schedule, ST Schedule	False	Efficiency of charging
Charge Price - c/kWh	Charge Price - c/kWh	Production	LT Plan, MT Schedule, ST Schedule	False	Price paid charging
Charge Units Shutdown	Charge Units Shutdown	Production	LT Plan, MT Schedule, ST Schedule	False	Number of charge units shutdown
Charge Units Started	Charge Units Started	Production	LT Plan, MT Schedule, ST Schedule	False	Number of charge units started
Charging - kW	Charging - MWh	Production	LT Plan, MT Schedule, ST Schedule	False	Charge rate/energy
Discharge Efficiency - %	Discharge Efficiency - %	Production	LT Plan, MT Schedule, ST Schedule	False	Efficiency of discharging
Discharge Price - c/kWh	Discharge Price - c/kWh	Production	LT Plan, MT Schedule, ST Schedule	False	Price received discharging
Discharge Revenue - $	Discharge Revenue - $000	Production	LT Plan, MT Schedule, ST Schedule	False	Revenue from discharging
Discharge Units Shutdown	Discharge Units Shutdown	Production	LT Plan, MT Schedule, ST Schedule	False	Number of discharge units shutdown
Discharge Units Started	Discharge Units Started	Production	LT Plan, MT Schedule, ST Schedule	False	Number of discharge units started
Discharging - kW	Discharging - MWh	Production	LT Plan, MT Schedule, ST Schedule	False	Discharge rate/energy
Disposal Cost - $000	Disposal Cost - $000	Expansion	LT Plan	False	Cost of disposing of vehicles
Distance - km (Metric), m (U.S. Imperial)	Distance - km (Metric), m (U.S. Imperial)	Production	LT Plan, MT Schedule, ST Schedule	False	Distance travelled
Efficiency - Wh/km (Metric), Wh/m (U.S. Imperial)	Efficiency - Wh/km (Metric), Wh/m (U.S. Imperial)	Production	LT Plan, MT Schedule, ST Schedule	False	Energy used per unit travelled
Energy - kWh	Energy - kWh	Production	LT Plan, MT Schedule, ST Schedule	False	Energy stored
Energy Consumption - kWh	Energy Consumption - MWh	Production	LT Plan, MT Schedule, ST Schedule	False	Energy consumed
Energy Target Violation - kWh	Energy Target Violation - kWh	Production	LT Plan, MT Schedule, ST Schedule	False	Violation of the [Energy Target] constraint.
Energy Target Violation Cost - $	Energy Target Violation Cost - $000	Production	LT Plan, MT Schedule, ST Schedule	False	Cost of [Energy Target] constraint violations.
FO&M Cost - $	FO&M Cost - $000	Production	LT Plan, MT Schedule, ST Schedule	False	Fixed operation and maintenance cost
Hours Charging - h	Hours Charging - h	Production	LT Plan, MT Schedule, ST Schedule	False	Number of hours in charging state
Hours Discharging - h	Hours Discharging - h	Production	LT Plan, MT Schedule, ST Schedule	False	Number of hours in discharging state
Hours Idle - h	Hours Idle - h	Production	LT Plan, MT Schedule, ST Schedule	False	Number of hours in idle state
Hours in Use - h	Hours in Use - h	Production	LT Plan, MT Schedule, ST Schedule	False	Number of hours in use
Inertia - MW·s	Inertia - GW·s	Production	LT Plan, MT Schedule, ST Schedule	False	Provision of inertia
Installed Capacity - kWh	Installed Capacity - kWh	Production	LT Plan, PASA, MT Schedule, ST Schedule	False	Total battery capacity
Losses - kW	Losses - MWh	Production	LT Plan, MT Schedule, ST Schedule	False	Total charge and discharge losses
Lower Reserve - kW	Lower Reserve - MWh	Production	LT Plan, MT Schedule, ST Schedule	False	Provision of lower (spin down) reserve
Net Charge Cost - $	Net Charge Cost - $000	Production	LT Plan, MT Schedule, ST Schedule	False	Net of cost of charging and revenue from discharging
Non-physical Charge Adjustments - kW	Non-physical Charge Adjustments - MWh	Production	LT Plan, MT Schedule, ST Schedule	False	Non-physical charge adjustments required to maintain feasible states of charge.
Non-physical Discharge Adjustments - kW	Non-physical Discharge Adjustments - MWh	Production	LT Plan, MT Schedule, ST Schedule	False	Non-physical discharge adjustments required to maintain feasible states of charge.
Purchase Cost - $000	Purchase Cost - $000	Expansion	LT Plan	False	Cost of vehicles purchased
Raise Reserve - kW	Raise Reserve - MWh	Production	LT Plan, MT Schedule, ST Schedule	False	Provision of raise (spin up) reserve
Range - km (Metric), m (U.S. Imperial)	Range - km (Metric), m (U.S. Imperial)	Production	LT Plan, MT Schedule, ST Schedule	False	Remaining range
Regulation Lower Reserve - kW	Regulation Lower Reserve - MWh	Production	LT Plan, MT Schedule, ST Schedule	False	Provision of regulation lower reserve
Regulation Raise Reserve - kW	Regulation Raise Reserve - MWh	Production	LT Plan, MT Schedule, ST Schedule	False	Provision of regulation raise reserve
Replacement Reserve - kW	Replacement Reserve - MWh	Production	LT Plan, MT Schedule, ST Schedule	False	Provision of replacement reserve
Reserves Revenue - $	Reserves Revenue - $000	Production	LT Plan, MT Schedule, ST Schedule	False	Revenue from provision of reserves
Self Discharge Losses - kW	Self Discharge Losses - MWh	Production	LT Plan, MT Schedule, ST Schedule	False	Losses due to self-discharge
SoC - %	SoC - %	Production	LT Plan, MT Schedule, ST Schedule	False	State of charge
Total Cost - $000	Total Cost - $000	Expansion	LT Plan	False	Total of fixed and variable costs
Units	Units	Production	LT Plan, MT Schedule, ST Schedule	False	Number of vehicles
Units Charging	Units Charging	Production	LT Plan, MT Schedule, ST Schedule	False	Number of units charging
Units Discharging	Units Discharging	Production	LT Plan, MT Schedule, ST Schedule	False	Number of units discharging
Units Disposed	Units Disposed	Expansion	LT Plan	False	Number of vehicles disposed of
Units Purchased	Units Purchased	Expansion	LT Plan	False	Number of vehicles purchased
UoS Cost - $	UoS Cost - $000	Production	LT Plan, MT Schedule, ST Schedule	False	Total use of system cost
VO&M Cost - $	VO&M Cost - $000	Production	LT Plan, MT Schedule, ST Schedule	False	Total variable operation and maintenance cost
x	x	Pass-through	LT Plan, MT Schedule, ST Schedule	True	Value to pass-through to solution
y	y	Pass-through	LT Plan, MT Schedule, ST Schedule	True	Value to pass-through to solution
z	z	Pass-through	LT Plan, MT Schedule, ST Schedule	True	Value to pass-through to solution

Vehicle.Commodities Output Properties

Name	Summary Name	Property Group	Phases	Multi-band	Description
Consumption	Consumption	Production	LT Plan, MT Schedule, ST Schedule	False	Consumption of the Commodity
Cost - $	Cost - $000	Production	LT Plan, MT Schedule, ST Schedule	False	Cost for Energy from the Commodity
Energy Consumption - kWh	Energy Consumption - MWh	Production	LT Plan, MT Schedule, ST Schedule	False	Energy from the Commodity