diff --git a/docs/Gemfile.lock b/docs/Gemfile.lock index 4fda6123..9ebdd8fd 100644 --- a/docs/Gemfile.lock +++ b/docs/Gemfile.lock @@ -1,7 +1,7 @@ GEM remote: https://rubygems.org/ specs: - activesupport (7.2.1.1) + activesupport (7.2.1.2) base64 bigdecimal concurrent-ruby (~> 1.0, >= 1.3.1) @@ -34,7 +34,7 @@ GEM ethon (0.16.0) ffi (>= 1.15.0) eventmachine (1.2.7) - execjs (2.9.1) + execjs (2.10.0) faraday (2.12.0) faraday-net_http (>= 2.0, < 3.4) json @@ -212,7 +212,7 @@ GEM gemoji (>= 3, < 5) html-pipeline (~> 2.2) jekyll (>= 3.0, < 5.0) - json (2.7.2) + json (2.7.3) just-the-docs (0.10.0) jekyll (>= 3.8.5) jekyll-include-cache @@ -248,7 +248,7 @@ GEM rb-fsevent (0.11.2) rb-inotify (0.11.1) ffi (~> 1.0) - rexml (3.3.8) + rexml (3.3.9) rouge (3.30.0) rubyzip (2.3.2) safe_yaml (1.0.5) diff --git a/docs/community-events/20240118-Pulling-into-the-Station.md b/docs/community-events/20240118-Pulling-into-the-Station.md new file mode 100644 index 00000000..03db8134 --- /dev/null +++ b/docs/community-events/20240118-Pulling-into-the-Station.md @@ -0,0 +1,109 @@ +--- +title: Pulling into the Station--TROLIE 1.0 Nears Journey's End +parent: Community Events +--- + +{: .announcement } +Join us on Wednesday November 20th, 2024 at 1:30pm ET for the webinar [A Lap Around TROLIE 1.0](https://community.linuxfoundation.org/events/details/lfhq-lf-energy-presents-a-lap-around-trolie-10/)! + +# Pulling into the Station--TROLIE 1.0 Nears Journey's End + + + +The TROLIE 1.0 feature scope is essentially complete. We still have some tasks +to wrap up, including [documentation improvements](https://github.com/trolie/spec/milestone/8) +and [some small refinements to the media types](https://github.com/trolie/spec/milestone/7), +but the [use cases in 1.0 scope](#supported-use-cases) are satisfied by the current [spec](https://trolie.energy/spec). + +Since our last [Community Post](../community-events/), we've accomplished a lot. + +* Defined [RC-to-RC rating reconciliation](../articles/RC-to-RC-reconciliation.md) and the underlying + [monitoring set reconciliation pattern](../articles/peer-monitoring-sets.md) + which utilizes the affordances for [reading monitoring sets](https://trolie.energy/spec#tag/Monitoring-Sets) + +* Defined a ["slim" media type pattern](../articles/media-types.md#slim-media-types) that optimizes the most + common ratings and limits exchanges + +* Defined operations for [temporary AAR exceptions](https://trolie.energy/spec#tag/Temporary-AAR-Exceptions) + and [seasonal overrides](https://trolie.energy/spec#tag/Seasonal-Overrides) + +* Incorporated myriad fixes and documentation improvements based on reviews with vendors. + +## Supported Use Cases + +Let's discuss these changes in terms of the use cases they support, starting with the +simplest conceptually, but perhaps the most difficult to specify. + +### Seasonal Ratings + +The concept of a [seasonal rating](../concepts.md#seasonal-ratings) differs +significantly from one grid operator to the next: Some operate to a seasonal +rating that changes monthly, while others are obliged to newly develop four +uniquely determined seasonal ratings per Order 881. Moreover, the calendar dates and times +that bracket these seasons can occur at any time in the calendar. Clearly there is +no canonical "Fall" when it comes to seasonal ratings. In fact, one Transmission Owner's Fall season +may begin and end at different times of year depending on the location of the transmission facility. + +By examining the invariants of seasonal ratings, the TROLIE specification has +defined both a slim and detailed format for seasonal ratings proposals and +seasonal limits snapshots that is sufficiently general to address all of these +scenarios. + +### Managing Temporary AAR Exceptions and Seasonal Overrides + +Quoting the [specification](https://trolie.energy/spec#tag/Seasonal-Overrides): + +> A Seasonal Override is an instruction to use a temporary static rating set in +> lieu of any concurrent Seasonal Rating for a given segment. +> +> A typical use case is a so-called "de-rate" due to temporary clearance issue +> for a transmission facility that is exempt from providing AARs. Exempt +> facilities normally operate against a seasonal rating, yet rather than provide a +> seasonal ratings schedule update, the Ratings Provider could send a Seasonal +> Override. During the provided duration of the override, the Transmission +> Provider would operate to the Seasonal Override rather than any ratings that +> would have been used from the seasonal rating schedule. +> +> In contrast, for a segment that is not exempt from providing AARs, the Ratings +> Provider would issue a Temporary AAR Exception to the Clearinghouse Provider to +> address a clearance issue or other temporary operating condition that calls for +> a static rating. + +In previous community updates, we've called out Forecast and Real-Time use cases. +We include those here along with additional scenarios that have been addressed. + +### Regional Clearing + +On interties between Transmission Providers (TP), there is an additional timing +consideration. While each TP will obtain the [locally-limiting ratings](../concepts.md#locally-limiting-rating) for their end of the tie on +their own time, in order to operate to the same [limits along the seam](../concepts.md#globally-limiting-rating), the TPs must exchange their +[regionally-limiting ratings](../concepts.md#regionally-limiting-rating)(RLRs) as soon as possible +after they've determined those RLRs. + +TROLIE calls this [RC-to-RC Reconciliation](../articles/RC-to-RC-reconciliation.md). + +### Forecasting Use Cases + +* Submitting Forecast Ratings Proposals +* Obtaining Forecast Ratings Proposal Status +* Obtaining Forecast Limits Snapshots, including: + - Normal snapshots that provide just the determined limits + - Detailed snapshots that provide all of the inputs used by the Clearinghouse + Provider to determine the limits, including all proposals and overrides. +* Slim proposals and snapshots that leverage information in the header to reduce the verbosity of the ratings / limits. + +### Real-Time Use Cases + +* Submitting Real-Time Ratings Proposals +* Obtaining Real-Time Ratings Proposal Status +* Obtaining Real-Time Limits Snapshots, including: + - Normal snapshots that provide just the determined limits + - Detailed snapshots that provide all of the inputs used by the Clearinghouse + Provider to determine the limits, including all proposals and overrides. +* Slim proposals and snapshots that leverage information in the header to reduce the verbosity of the ratings / limits. + + +## Call to Action + +* Calling all vendors! Please reach out to the maintainers with questions. +* Join the webinar on November 20th and bring your questions / concerns. diff --git a/docs/community-events/20240330-Forecasting-API-stable.md b/docs/community-events/20240330-Forecasting-API-stable.md index a1e7c165..15c11d48 100644 --- a/docs/community-events/20240330-Forecasting-API-stable.md +++ b/docs/community-events/20240330-Forecasting-API-stable.md @@ -26,7 +26,7 @@ Implementors should consider the specification stable in its support of the foll * Submitting Forecast Ratings Proposals * Obtaining Forecast Ratings Proposal Status * Obtaining Forecast Limits Snapshots, including: - - "Slim" snapshots that provide just the determined limits + - ~~Slim~~ Normal snapshots that provide just the determined limits - Detailed snapshots that provide all of the inputs used by the Clearinghouse Provider to determine the limits, including all proposals and overrides. diff --git a/docs/community-events/20240701-RealTime-API-stable.md b/docs/community-events/20240701-RealTime-API-stable.md index 4d337c6c..40effaab 100644 --- a/docs/community-events/20240701-RealTime-API-stable.md +++ b/docs/community-events/20240701-RealTime-API-stable.md @@ -29,7 +29,7 @@ Implementors should consider the specification stable in its support of the foll * Submitting Real-Time Ratings Proposals * Obtaining Real-Time Ratings Proposal Status * Obtaining Real-Time Limits Snapshots, including: - - "Slim" snapshots that provide just the determined limits + - ~~Slim~~ Normal snapshots that provide just the determined limits - Detailed snapshots that provide all of the inputs used by the Clearinghouse Provider to determine the limits, including all proposals and overrides. diff --git a/docs/images/trolie-station.jpg b/docs/images/trolie-station.jpg new file mode 100644 index 00000000..2cf0c84d Binary files /dev/null and b/docs/images/trolie-station.jpg differ diff --git a/docs/index.md b/docs/index.md index 149b5495..8d389d62 100644 --- a/docs/index.md +++ b/docs/index.md @@ -21,11 +21,10 @@ class="fa-solid fa-envelope">](https://lists.lfenergy.org/g/trolie-general). {: .announcement } > **Latest Updates** +> +> Join us on Wednesday November 20th, 2024 at 1:30pm ET for the webinar [A Lap Around TROLIE 1.0](https://community.linuxfoundation.org/events/details/lfhq-lf-energy-presents-a-lap-around-trolie-10/)! > -> The TROLIE maintainers are pleased to announce that the [Real-Time API](/spec#tag/Real-Time) specification is stable. -> Read more in the [milestone announcement](./community-events/20240701-RealTime-API-stable). -> -> If you are new to the project, consider watching the replay of the [Intro to TROLIE webinar](./community-events/20240221-Intro-to-TROLIE) +> Read more in the [latest status update](./community-events/20240118-Pulling-into-the-Station.md). # Introduction