skip to main content
Objects and Methods : Generator : User Methods : Diversion and Consumption Request
Diversion and Consumption Request
This category is used to specify how the Diversion and Depletion Requested will be computed.
* None
No diversion or depletion requested will be computed. You can input the requests as needed.
* Power Generator Requests
The Power Generator Requests method is executed at the beginning of the run—on each timestep in the run—to compute the diversion and depletion requests based on temperature lookups to get the capacity and request slot values.
Slots Specific to This Method
 Generator Operating Factors
Type: Table
Units: Temperature, Temperature, Fraction, Fraction
Description: A table relating Dry Bulb Temperature (C), Wet Bulb Temperature (C) versus Capacity Percentage (%) and Efficiency (%).
Information: This is a three-dimensional table, with two Y columns, of the following form.
 
Dry Bulb Temperature (C)
Wet Bulb Temperature (C)
Capacity Fraction (%)
Efficiency (%)
20
20
70
60
20
30
65
50
20
40
60
50
25
20
70
59
25
30
64
50
25
40
59
50
30
20
69
51
30
30
63
49
30
40
57
48
I/O: Required input
 Generator Maximum Rates
Type: Table
Units: Temperature, Vol/Energy, Vol/Energy
Description: A table relating Dry Bulb Temperature (C), Max Withdrawal Rate (Vol/Energy), and Max Consumption Rate (Vol/Energy)
Information: This is a two-dimensional table, with two Y columns.
I/O: Required input
 Name Plate Rating
Type: Scalar
Units: Power
Description: Maximum power that can be produced
Information:  
I/O: Required input
 Wet Bulb Temperature
Type: Series
Units: Temperature
Description: Average wet bulb temperature (Celsius) for the timestep.
Information:  
I/O: Specified as input or via a rule
 Dry Bulb Temperature
Type: Series
Units: Temperature
Description: Average dry bulb temperature (Celsius) for the timestep.
Information:  
I/O: Specified as input or via a rule
 Specified Withdrawal Request
Type: Series
Units: Volume per Energy
Description: Specified withdrawal request. If specified, this value overrides the computed max withdrawal request.
Information:  
I/O: Optional input or specified via rule. Can remain unspecified.
 Specified Consumption Request
Type: Series
Units: Volume per Energy
Description: Specified consumption request. If specified, this value overrides the computed max consumption request.
Information:  
I/O: Optional input or specified via rule. Can remain unspecified.
 Capacity Fraction
Type: Series
Units: Fraction
Description: The computed fraction of the capacity.
Information:  
I/O: Output only
 Efficiency
Type: Series
Units: Fraction
Description: The computed power efficiency
Information: This value is presented for information only. It is not used in any calculations.
I/O: Output only
 Adjusted Capacity
Type: Series
Units: Power
Description: The maximum power that can be produced by this generator, after adjusting for capacity fraction.
Information: This slot is not set if Specified Adjusted Capacity is known.
I/O: Output only
 Specified Adjusted Capacity
Type: Series
Units: Power
Description: The specified power capacity that can be produced by this generator.
Information:  
I/O: Optional input or specified via (init) rule. It can remain unspecified.
 Max Withdrawal Request
Type: Series
Units: Volume per Energy
Description: The maximum volume per energy for this generator.
Information:  
I/O: Output only
 Max Consumption Request
Type: Series
Units: Volume per Energy
Description: The maximum consumption rate for this generator.
Information:  
I/O: Output only
Method Details  
This method is executed at the beginning of the run for all timestep in the run period. The computations at each timestep include:
1. Look up the specified Wet Bulb Temperature and Dry Bulb Temperature on the Generator Operating Factors table to get the Capacity Fraction and Efficiency.
2. If the Specified Adjusted Capacity is valid (input or set by a rule), set a local variable adjustedCapacityToUse:
adjustedCapacityToUse = Specified Adjusted Capacity
Else
Adjusted Capacity = Name Plate Rating * Capacity Fraction
adjustedCapacityToUse = Adjusted Capacity
3. Look up the specified Dry Bulb Temperature on the Generator Maximum Rates table to get Max Withdrawal Request and Max Consumption Request.
4. Next, compute the Diversion Requested.
If the Specified Withdrawal Request is valid,
Diversion Requested =
adjustedCapacityToUse * Specified Withdrawal Request * timeConversion
Else
Diversion Requested =
adjustedCapacityToUse * Max Withdrawal Request * timeConversion
5. Similarly, compute the Depletion Requested.
If the Specified Consumption Request is valid,
Depletion Requested =
adjustedCapacityToUse * Specified Consumption Request * timeConversion
Else
Depletion Requested =
adjustedCapacityToUse * Max Consumption Request * timeConversion
The time conversion is necessary because the internal units for the requests is m3/MWH while the internal volume for flow is cms. Thus, the timeConversion = 1hr/3600s.
 
Revised: 01/05/2024