Generator Resource Parameters
Generator Resource Parameters
The following diagram defines the structure of a Generator Resource Parameters that could be included within a ResParametersSet, using the GenResourceParameters tag:
New with RTC+B Implementation
The error tag is used to return one or more errors that may be the consequence of the failure of business or syntax validation rules for Generator Resource Parameter change submittals.
On submission, the following table describes the items used for a ResParametersSet change request.
Element Req? Datatype Description Values mRID N String ERCOT assigned externalId N String External ID QSE supplied status N String Return status SUBMITTED, ACCEPTED, or ERRORS Error/severity N String Error if any Error text Error/area N String Error if any Error text Error/interval N String Error if any Error text Error/text N String Error if any Error text resource Y String Resource name normalRrCurve/rrPoint/rampRateUp Y float MW/min normalRrCurve/rrPoint/rampRateDown Y float MW/min normalRrCurve/rrPoint/breakPoint Y float emergencyRrCurve/rrPoint/rampRateUp Y float MW/min emergencyRrCurve/rrPoint/rampRateDown Y float MW/min emergencyRrCurve/rrPoint/breakPoint Y float Details/minOnlineTime Y float time in hours Details/minOfflineTime Y float time in hours Details/maxOnlineTime Y float time in hours Details/maxDailyStarts Y Integer time in hours Details/hotStartTime Y float time in hours Details/intermediateStartTime Y float time in hours Details /coldStartTime Y float time in hours Details /hotToIntermediateTime Y float time in hours Details / intermediateToColdTime Y float time in hours Details /maxWeeklyStarts Y Integer Details /maxWeeklyEnergy Y Integer max amount of energy a Resource is allowed to produce per week MWh value Details /reason Y String text reason for changing parameters Description in plain text
Element Req? Datatype Description Values mRID N String ERCOT assigned externalId N String External ID QSE supplied status N String Return status SUBMITTED, ACCEPTED, or ERRORS Error/severity N String Error if any Error text Error/area N String Error if any Error text Error/interval N String Error if any Error text Error/text N String Error if any Error text resource Y String Resource name normalRrCurve/rrPoint/rampRateUp Y float MW/min normalRrCurve/rrPoint/rampRateDown Y float MW/min normalRrCurve/rrPoint/breakPoint Y float emergencyRrCurve/rrPoint/rampRateUp Y float MW/min emergencyRrCurve/rrPoint/rampRateDown Y float MW/min emergencyRrCurve/rrPoint/breakPoint Y float Details/minOnlineTime Y float time in hours Details/minOfflineTime Y float time in hours Details/maxOnlineTime Y float time in hours Details/maxDailyStarts Y Integer time in hours Details/hotStartTime Y float time in hours Details/intermediateStartTime Y float time in hours Details/coldStartTime Y float time in hours Details/hotToIntermediateTime Y float time in hours Details/intermediateToColdTime Y float time in hours Details/maxWeeklyStarts Y Integer Details/maxWeeklyEnergy Y Integer max amount of energy a Resource is allowed to produce per week MWh value Details/reason Y String text reason for changing parameters Description in plain text SOC/minSOC N Decimal Minimum state of charge MWh value SOC/maxSOC N Decimal Maximum state of charge MWh value SOC/roundTripEfficiency N float Round trip efficiency of ESR Percent value
The following is an XML example of a GenResourceParameters:
<GenResourceParameters> <mRID>String</mRID> <externalId>String</externalId> <status>SUBMITTED</status> <error> <severity>ERROR</severity> <area>String</area> <interval>String</interval> <text>String</text> </error> <resource>String</resource> <normalRrCurve> <rrPoint> <rampRateUp>0</rampRateUp> <rampRateDown>0</rampRateDown> <breakPoint>0</breakPoint> </rrPoint> </normalRrCurve> <emergencyRrCurve> <rrPoint> <rampRateUp>0</rampRateUp> <rampRateDown>0</rampRateDown> <breakPoint>0</breakPoint> </rrPoint> </emergencyRrCurve> <Details> <minOnlineTime>0</minOnlineTime> <minOfflineTime>0</minOfflineTime> <maxOnlineTime>0</maxOnlineTime> <maxDailyStarts>0</maxDailyStarts> <hotStartTime>0</hotStartTime> <intermediateStartTime>0</intermediateStartTime> <coldStartTime>0</coldStartTime> <hotToIntermediateTime>0</hotToIntermediateTime> <intermediateToColdTime>0</intermediateToColdTime> <maxWeeklyStarts>0</maxWeeklyStarts> <maxWeeklyEnergy>0</maxWeeklyEnergy> </Details> <reason>String</reason> </GenResourceParameters>
<GenResourceParameters> <externalId>3885</externalId> <resource>RES1</resource> <normalRrCurve> <rrPoint> <rampRateUp>2.0</rampRateUp> <rampRateDown>2.0</rampRateDown> <breakPoint>1.0</breakPoint> </rrPoint> <rrPoint> <rampRateUp>5.0</rampRateUp> <rampRateDown>5.0</rampRateDown> <breakPoint>25.0</breakPoint> </rrPoint> </normalRrCurve> <emergencyRrCurve> <rrPoint> <rampRateUp>2.0</rampRateUp> <rampRateDown>2.0</rampRateDown> <breakPoint>1.0</breakPoint> </rrPoint> <rrPoint> <rampRateUp>5.0</rampRateUp> <rampRateDown>5.0</rampRateDown> <breakPoint>25.0</breakPoint> </rrPoint> </emergencyRrCurve> <Details> <minOnlineTime>1.0</minOnlineTime> <minOfflineTime>1.0</minOfflineTime> <maxOnlineTime>17520.0</maxOnlineTime> <maxDailyStarts>2</maxDailyStarts> <hotStartTime>1.2</hotStartTime> <intermediateStartTime>5.3</intermediateStartTime> <coldStartTime>1446.1</coldStartTime> <hotToIntermediateTime>18.0</hotToIntermediateTime> <intermediateToColdTime>232.0</intermediateToColdTime> <maxWeeklyStarts>14</maxWeeklyStarts> <maxWeeklyEnergy>67704</maxWeeklyEnergy> </Details> <SOC> <minSOC>1</minSOC> <maxSOC>20</maxSOC> <roundTripEfficiency>0</roundTripEfficiency> </SOC> <reason>QSE Update</reason> </GenResourceParameters>