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:





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 |
| 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>
<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>