Commodity Index

Commodity Attributes

Name	Units	Default Value	Validation Rule	Description
Energy Density	MJ	0		Energy per unit of the Commodity
Intrinsic	-	0	In (0,1,2,3,4)	Intrinsic Commodity
Unit	-	0		Unit the Commodity is measured in
Unit Type	-	0	In (0,1)	Convention for reporting of Commodity at the interval level

Commodity Input Properties

Name	Units	Multi-band	Default Value	Validation Rule	Key Property	Description
Acceptable Risk	$	False	0		False	Acceptable risk around target net profit
Balance Period	-	False	0	In (0,1,2,3,4,5,6)	False	Frequency of inventory balance
Build Cost	$	True	0		False	Cost of building a unit
Build Cost Multiplier	-	False	0	In (0,2)	False	Sets the unit for the input Build Cost
Build Non-anticipativity	$	False	-1		False	Price for violating build non-anticipativity constraints
Decomposition Bound Penalty	$	False	1000000	≥0	False	Penalty applied to violation of inventory bounds when the decomposition implies possible violations
Decomposition Method	-	False	1	In (0,1,2)	False	Method used to pass the optimal inventory trajectory from one simulation phase to the next
Decomposition Penalty a	-	False	0.0489		False	Decomposition inventory target penalty function 'a' term
Decomposition Penalty b	-	False	0.6931		False	Decomposition inventory target penalty function 'b' term
Decomposition Penalty c	-	False	0		False	Decomposition inventory target penalty function 'c' term
Decomposition Penalty x	-	False	1.1		False	Decomposition inventory target penalty function 'x' term
Delivery	~	False	0		False	Amount of the Commodity added to inventory
Delivery Charge	$/~	False	0		False	Cost of deliveries of the Commodity to inventory
Economic Life	yr	False	30	≥0	False	Economic life of the unit (period over which fixed costs are recovered)
End Effects Method	-	False	1	In (1,2)	False	Method used to value or constrain end-of-period inventory
Expansion Optimality	-	False	2	In (0,2)	False	Expansion planning integerization scheme
FO&M Charge	$	False	0		False	Annual fixed operation and maintenance charge
Formulate Risk	Yes/No	False	0	In (0,-1)	False	If constraint should be formulated to bound net profit risk
Hint Units Built	-	False	0	≥0	False	Capacity expansion solution to be passed to the optimizer as a hint or initial solution
Injection Charge	$/~	False	0		False	Cost of adding the Commodity to inventory
Injection Efficiency	%	True	100		False	Proportion of injected commodity reaching storage net of losses
Integerization Horizon	yr	False	-1	≥-1	False	Number of years over which the expansion decisions are integerized
Inventory Charge	$/~	False	0		False	Cost of keeping the Commodity in inventory
Max Consumption	~	False	1E+30		False	Maximum consumption per interval
Max Consumption Custom	~	False	1E+30		False	Maximum consumption over custom timeframe
Max Consumption Day	~	False	1E+30		False	Maximum consumption per day
Max Consumption Hour	~	False	1E+30		False	Maximum consumption per hour
Max Consumption Month	~	False	1E+30		False	Maximum consumption per month
Max Consumption Penalty	$/~	False	-1		False	Penalty for violation of [Max Consumption] constraints
Max Consumption Week	~	False	1E+30		False	Maximum consumption per week
Max Consumption Year	~	False	1E+30		False	Maximum consumption per year
Max Injection	~	False	1E+30	≥0	False	Maximum amount of the Commodity that can be put into inventory in any interval
Max Injection Day	~	False	1E+30	≥0	False	Maximum amount of the Commodity that can be put into inventory in any day
Max Injection Hour	~	False	1E+30	≥0	False	Maximum amount of the Commodity that can be put into inventory in any hour
Max Injection Month	~	False	1E+30	≥0	False	Maximum amount of the Commodity that can be put into inventory in any month
Max Injection Week	~	False	1E+30	≥0	False	Maximum amount of the Commodity that can be put into inventory in any week
Max Injection Year	~	False	1E+30	≥0	False	Maximum amount of the Commodity that can be put into inventory in any year
Max Inventory	~	False	0		False	Maximum amount of the Commodity allowed in inventory
Max Inventory Change	~	False	1E+30	≥0	False	Maximum rate of change in inventory in any interval
Max Inventory Change Day	~	False	1E+30	≥0	False	Maximum rate of change in inventory in any day
Max Inventory Change Hour	~	False	1E+30	≥0	False	Maximum rate of change in inventory in any hour
Max Inventory Change Month	~	False	1E+30	≥0	False	Maximum rate of change in inventory in any month
Max Inventory Change Penalty	$/~	False	-1		False	Penalty for violating the [Max Ramp] constraints
Max Inventory Change Week	~	False	1E+30	≥0	False	Maximum rate of change in inventory in any week
Max Inventory Change Year	~	False	1E+30	≥0	False	Maximum rate of change in inventory in any year
Max Production	~	False	1E+30		False	Maximum production per interval
Max Production Custom	~	False	1E+30		False	Maximum production over custom timeframe
Max Production Day	~	False	1E+30		False	Maximum production per day
Max Production Hour	~	False	1E+30		False	Maximum production per hour
Max Production Month	~	False	1E+30		False	Maximum production per month
Max Production Penalty	$/~	False	-1		False	Penalty for violation of [Max Production] constraints
Max Production Week	~	False	1E+30		False	Maximum production per week
Max Production Year	~	False	1E+30		False	Maximum production per year
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
Max Withdrawal	~	False	1E+30	≥0	False	Maximum amount of the Commodity that can be taken from inventory in any interval
Max Withdrawal Day	~	False	1E+30	≥0	False	Maximum amount of the Commodity that can be taken from inventory in a day
Max Withdrawal Hour	~	False	1E+30	≥0	False	Maximum amount of the Commodity that can be taken from inventory in a hour
Max Withdrawal Month	~	False	1E+30	≥0	False	Maximum amount of the Commodity that can be taken from inventory in a month
Max Withdrawal Week	~	False	1E+30	≥0	False	Maximum amount of the Commodity that can be taken from inventory in a week
Max Withdrawal Year	~	False	1E+30	≥0	False	Maximum amount of the Commodity that can be taken from inventory in a year
Min Consumption	~	False	0		False	Minimum consumption per interval
Min Consumption Custom	~	False	0		False	Minimum consumption over custom timeframe
Min Consumption Day	~	False	0		False	Minimum consumption per day
Min Consumption Hour	~	False	0		False	Minimum consumption per hour
Min Consumption Month	~	False	0		False	Minimum consumption per month
Min Consumption Penalty	$/~	False	-1		False	Penalty for violation of [Min Consumption] constraints
Min Consumption Week	~	False	0		False	Minimum consumption per week
Min Consumption Year	~	False	0		False	Minimum consumption per year
Min Injection	~	False	0	≥0	False	Amount of the Commodity that must be added to inventory in any interval
Min Injection Day	~	False	0	≥0	False	Amount of the Commodity that must be added to inventory in any day
Min Injection Hour	~	False	0	≥0	False	Amount of the Commodity that must be added to inventory in any hour
Min Injection Month	~	False	0	≥0	False	Amount of the Commodity that must be added to inventory in any month
Min Injection Week	~	False	0	≥0	False	Amount of the Commodity that must be added to inventory in any week
Min Injection Year	~	False	0	≥0	False	Amount of the Commodity that must be added to inventory in any year
Min Inventory	~	False	0		False	Minimum amount of the Commodity required in inventory
Min Production	~	False	0		False	Minimum production per interval
Min Production Custom	~	False	0		False	Minimum production over custom timeframe
Min Production Day	~	False	0		False	Minimum production per day
Min Production Hour	~	False	0		False	Minimum production per hour
Min Production Month	~	False	0		False	Minimum production per month
Min Production Penalty	$/~	False	-1		False	Penalty for violation of [Min Production] constraints
Min Production Week	~	False	0		False	Minimum production per week
Min Production Year	~	False	0		False	Minimum production per year
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
Min Withdrawal	~	False	0	≥0	False	Amount of the Commodity that must be taken from inventory each interval
Min Withdrawal Day	~	False	0	≥0	False	Amount of the Commodity that must be taken from inventory each day
Min Withdrawal Hour	~	False	0	≥0	False	Amount of the Commodity that must be taken from inventory each hour
Min Withdrawal Month	~	False	0	≥0	False	Amount of the Commodity that must be taken from inventory each month
Min Withdrawal Week	~	False	0	≥0	False	Amount of the Commodity that must be taken from inventory each week
Min Withdrawal Year	~	False	0	≥0	False	Amount of the Commodity that must be taken from inventory each year
Opening Inventory	~	False	0	≥0	False	Initial amount of the Commodity in inventory
Price	$/~	False	0		False	Price of the Commodity for the given level of Net Consumption
Project Start Date	-	False	36526	≥0	False	Start date of project, for expansion planning
Reservation Charge	$/~	False	0		False	Cost applied to unused inventory capacity
Retire Non-anticipativity	$	False	-1		False	Price for violating retire non-anticipativity constraints
Retirement Cost	$	False	0		False	Cost of retiring a unit
Risk Level	-	False	0.1	Between 0 and 1	False	Risk level for risk-constrained optimization
Target	~	False	0	≥0	False	Target level of inventory at the end of the interval
Target Custom	~	False	0	≥0	False	Target level of inventory at the end of the horizon
Target Day	~	False	0	≥0	False	Target level of inventory at the end of the day
Target Hour	~	False	0	≥0	False	Target level of inventory at the end of the hour
Target Month	~	False	0	≥0	False	Target level of inventory at the end of the month
Target Penalty	$/~	False	-1		False	Penalty for violating the target inventory
Target Week	~	False	0	≥0	False	Target level of inventory at the end of the week
Target Year	~	False	0	≥0	False	Target level of inventory at the end of the year
Technical Life	yr	False	1E+30	≥0	False	Technical lifetime of the unit
Units	-	False	1	≥0	True	Number of Commodity 'units' where zero switches the Commodity out of the simulation
WACC	%	False	10	≥0	False	Weighted average cost of capital
Withdrawal Charge	$/~	False	0		False	Cost of taking the Commodity out of inventory
Withdrawal Efficiency	%	True	100		False	Proportion of commodity withdrawn from storage net of losses
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

Commodity Constraints Input Properties

Name	Units	Multi-band	Default Value	Validation Rule	Key Property	Description
Acceptable Risk Coefficient	-	False	0		False	Coefficient of entity acceptable risk
Build Cost Coefficient	$	False	0		False	Coefficient of total build cost
Built Coefficient	-	False	0		False	Coefficient on binary variable indicating if any capacity is built to date
Built in Year Coefficient	-	False	0		False	Coefficient on binary variable indicating if any capacity is built in the year
Capacity Built Coefficient	-	False	0		False	Coefficient of capacity built
Capacity Retired Coefficient	-	False	0		False	Coefficient of capacity retired
Closing Inventory Coefficient	~	False	0		False	Coefficient of Commodity in inventory
Consumption Coefficient	~	False	0		False	Coefficient of Commodity consumption in the Constraint
Delivery Coefficient	~	False	0		False	Coefficient of additions of the Commodity to inventory
Injection Coefficient	~	False	0		False	Coefficient of injection of the Commodity into inventory
Inventory Change Coefficient	~	False	0		False	Coefficient of change in the amount of the Commodity in inventory
Net Profit Coefficient	$	False	0		False	Coefficient of net profit
Net Revenue Coefficient	$	False	0		False	Coefficient of net revenue
Production Coefficient	~	False	0		False	Coefficient of Commodity production in the Constraint
Units Built Coefficient	-	False	0		False	Coefficient of number of units built
Units Built in Year Coefficient	-	False	0		False	Coefficient of number of units built in the year
Units Retired Coefficient	-	False	0		False	Coefficient of number of units retired
Units Retired in Year Coefficient	-	False	0		False	Coefficient of number of units retired in the year
Withdrawal Coefficient	~	False	0		False	Coefficient of withdrawal of the Commodity from inventory

Commodity Objectives Input Properties

Name	Units	Multi-band	Default Value	Validation Rule	Key Property	Description
Acceptable Risk Coefficient	-	False	0		False	Coefficient of entity acceptable risk
Build Cost Coefficient	$	False	0		False	Coefficient of total build cost
Built Coefficient	-	False	0		False	Coefficient on binary variable indicating if any capacity is built to date
Built in Year Coefficient	-	False	0		False	Coefficient on binary variable indicating if any capacity is built in the year
Capacity Built Coefficient	-	False	0		False	Coefficient of capacity built
Capacity Retired Coefficient	-	False	0		False	Coefficient of capacity retired
Closing Inventory Coefficient	~	False	0		False	Coefficient of Commodity in inventory
Consumption Coefficient	~	False	0		False	Coefficient of Commodity consumption in the Objective
Delivery Coefficient	~	False	0		False	Coefficient of additions of the Commodity to inventory
Injection Coefficient	~	False	0		False	Coefficient of injection of the Commodity into inventory
Inventory Change Coefficient	~	False	0		False	Coefficient of change in the amount of the Commodity in inventory
Net Profit Coefficient	$	False	0		False	Coefficient of net profit
Net Revenue Coefficient	$	False	0		False	Coefficient of net revenue
Production Coefficient	~	False	0		False	Coefficient of Commodity production
Units Built Coefficient	-	False	0		False	Coefficient of number of units built
Units Built in Year Coefficient	-	False	0		False	Coefficient of number of units built in the year
Units Retired Coefficient	-	False	0		False	Coefficient of number of units retired
Units Retired in Year Coefficient	-	False	0		False	Coefficient of number of units retired in the year
Withdrawal Coefficient	~	False	0		False	Coefficient of withdrawal of the Commodity from inventory

Commodity Output Properties

Name	Summary Name	Property Group	Phases	Multi-band	Description
Annualized Build Cost - $000	Annualized Build Cost - $000	Expansion	LT Plan	False	Annualized cost of units built
Average Utilization - %	Average Utilization - %	Storage	LT Plan, MT Schedule, ST Schedule	False	Average inventory capacity utilization
Average Working Utilization - %	Average Working Utilization - %	Storage	LT Plan, MT Schedule, ST Schedule	False	Average working inventory capacity utilization
Build Cost - $000	Build Cost - $000	Expansion	LT Plan	False	Cost of units built
Capacity Built	Capacity Built	Expansion	LT Plan	False	Capacity built
Capacity Retired	Capacity Retired	Expansion	LT Plan	False	Capacity retired
Closing Inventory - ~	Closing Inventory - ~	Storage	LT Plan, MT Schedule, ST Schedule	False	Amount of the Commodity in inventory
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 incurred by consumption of the Commodity
Delivery - ~	Delivery - ~	Storage	LT Plan, MT Schedule, ST Schedule	False	Amount of the Commodity added to inventory
Delivery Cost - $	Delivery Cost - $000	Storage	LT Plan, MT Schedule, ST Schedule	False	Cost of additions to inventory
Electric Energy Consumption - MW	Electric Energy Consumption - GWh	Production	LT Plan, MT Schedule, ST Schedule	False	Equivalent electric energy consumption
Electric Energy Production - MW	Electric Energy Production - GWh	Production	LT Plan, MT Schedule, ST Schedule	False	Equivalent electric energy production
Energy Consumption - GJ (Metric), MMBtu (U.S. Imperial)	Energy Consumption - TJ (Metric), BBtu (U.S. Imperial)	Production	LT Plan, MT Schedule, ST Schedule	False	Equivalent energy consumption
Energy Production - GJ (Metric), MMBtu (U.S. Imperial)	Energy Production - TJ (Metric), BBtu (U.S. Imperial)	Production	LT Plan, MT Schedule, ST Schedule	False	Equivalent energy production
Fixed Costs - $	Fixed Costs - $000	Production	LT Plan, MT Schedule, ST Schedule	False	Total fixed costs including amortized build costs
FO&M Cost - $	FO&M Cost - $000	Production	LT Plan, MT Schedule, ST Schedule	False	Fixed operation and maintenance cost
Injection - ~	Injection - ~	Storage	LT Plan, MT Schedule, ST Schedule	False	Amount of the Commodity added to inventory
Injection Cost - $	Injection Cost - $000	Storage	LT Plan, MT Schedule, ST Schedule	False	Cost of injections to the inventory
Injection Losses - ~	Injection Losses - ~	Storage	LT Plan, MT Schedule, ST Schedule	False	Losses from injections
Inventory Change - ~	Inventory Change - ~	Storage	LT Plan, MT Schedule, ST Schedule	False	Change in Commodity in inventory
Inventory Cost - $	Inventory Cost - $000	Storage	LT Plan, MT Schedule, ST Schedule	False	Cost of holding the Commodity in inventory
Levelized Cost - $/~	Levelized Cost - $/~	Expansion	LT Plan	False	Levelized cost of production
Max Inventory - ~	Max Inventory - ~	Storage	LT Plan, MT Schedule, ST Schedule	False	Maximum amount of the Commodity allowed in inventory
Min Inventory - ~	Min Inventory - ~	Storage	LT Plan, MT Schedule, ST Schedule	False	Minimum amount of the Commodity required in inventory
Net Consumption - ~	Net Consumption - ~	Production	LT Plan, MT Schedule, ST Schedule	False	Net of consumption and production of the Commodity
Net Cost - $	Net Cost - $000	Production	LT Plan, MT Schedule, ST Schedule	False	Net of Cost and Revenue from consumption and production of the Commodity
Net Electric Energy Consumption - MW	Net Electric Energy Consumption - GWh	Production	LT Plan, MT Schedule, ST Schedule	False	Net equivalent electric energy consumption
Net Energy Consumption - GJ (Metric), MMBtu (U.S. Imperial)	Net Energy Consumption - TJ (Metric), BBtu (U.S. Imperial)	Production	LT Plan, MT Schedule, ST Schedule	False	Net equivalent energy consumption
Net New Capacity	Net New Capacity	Expansion	LT Plan	False	Capacity net of build and retire
Net Withdrawal - ~	Net Withdrawal - ~	Storage	LT Plan, MT Schedule, ST Schedule	False	Net of withdrawal and injection
Opening Inventory - ~	Opening Inventory - ~	Storage	LT Plan, MT Schedule, ST Schedule	False	Initial amount of the Commodity in inventory
Price - $/~	Price - $/~	Production	LT Plan, MT Schedule, ST Schedule	False	Price of the Commodity for the given level of Net Consumption
Production - ~	Production - ~	Production	LT Plan, MT Schedule, ST Schedule	False	Production of the Commodity
Reservation Cost - $	Reservation Cost - $000	Storage	LT Plan, MT Schedule, ST Schedule	False	Cost of unused inventory capacity
Retirement Cost - $000	Retirement Cost - $000	Expansion	LT Plan	False	Cost of retiring a unit
Revenue - $	Revenue - $000	Production	LT Plan, MT Schedule, ST Schedule	False	Revenue earned from production of the Commodity
Shadow Price - $/~	Shadow Price - $/~	Production	LT Plan, MT Schedule, ST Schedule	False	Shadow price of the Commodity from binding constraints
Total Cost - $000	Total Cost - $000	Expansion	LT Plan	False	Total of fixed and variable costs from all facilities involved in production of the commodity
Units	Units	Production	LT Plan, MT Schedule, ST Schedule	False	Number of units
Units Built	Units Built	Expansion	LT Plan	False	Number of units built
Units Retired	Units Retired	Expansion	LT Plan	False	Number of units retired
Utilization - %	Utilization - %	Storage	LT Plan, MT Schedule, ST Schedule	False	Inventory capacity utilization
Withdrawal - ~	Withdrawal - ~	Storage	LT Plan, MT Schedule, ST Schedule	False	Amount of the Commodity withdrawn from inventory
Withdrawal Cost - $	Withdrawal Cost - $000	Storage	LT Plan, MT Schedule, ST Schedule	False	Cost of withdrawals from inventory
Withdrawal Losses - ~	Withdrawal Losses - ~	Storage	LT Plan, MT Schedule, ST Schedule	False	Losses from withdrawals
Working Inventory - ~	Working Inventory - ~	Storage	LT Plan, MT Schedule, ST Schedule	False	Working inventory capacity at the end of the period
Working Utilization - %	Working Utilization - %	Storage	LT Plan, MT Schedule, ST Schedule	False	Working inventory capacity utilization
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