From 3751ee04967ad47b86be1167dab6b6ff4f8dcdca Mon Sep 17 00:00:00 2001 From: Christopher Atkins Date: Fri, 18 Oct 2024 16:46:46 +0000 Subject: [PATCH 1/4] initial draft --- .../20240118-Pulling-into-the-Station.md | 41 ++++++++++++++++++ docs/images/trolie-station.jpg | Bin 0 -> 66102 bytes 2 files changed, 41 insertions(+) create mode 100644 docs/community-events/20240118-Pulling-into-the-Station.md create mode 100644 docs/images/trolie-station.jpg 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..4de97148 --- /dev/null +++ b/docs/community-events/20240118-Pulling-into-the-Station.md @@ -0,0 +1,41 @@ +--- +title: Pulling into the Station--TROLIE 1.0 Nears Journey's End +parent: Community Events +--- + +{: .announcement } +Join us on Wednesday October 30th 2024 for the webinar [A Lap Around TROLIE 1.0](javascript:alert('TODO'))! + +# 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 + +TODO: copy use cases from previous announcements and add the balance + +## Call to Action + +TODO: +* Calling all vendors! Please reach out to the maintainers with questions +* Join the webinar +* ... \ No newline at end of file diff --git a/docs/images/trolie-station.jpg b/docs/images/trolie-station.jpg new file mode 100644 index 0000000000000000000000000000000000000000..2cf0c84d4d057535dcb02b73009b6d26aaadd62c GIT binary patch literal 66102 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�lO`Otn<>Sxnn5|#cz%qAydkBK>LaXLZ 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

EZ_WJ=9fJDfW8C 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 literal 0 HcmV?d00001 From aa754d200569da6945f35f6150efc10126cfd769 Mon Sep 17 00:00:00 2001 From: Christopher Atkins Date: Tue, 22 Oct 2024 16:51:49 +0000 Subject: [PATCH 2/4] updated article --- .../20240118-Pulling-into-the-Station.md | 80 +++++++++++++++++-- .../20240330-Forecasting-API-stable.md | 2 +- .../20240701-RealTime-API-stable.md | 2 +- 3 files changed, 76 insertions(+), 8 deletions(-) diff --git a/docs/community-events/20240118-Pulling-into-the-Station.md b/docs/community-events/20240118-Pulling-into-the-Station.md index 4de97148..5e4d4718 100644 --- a/docs/community-events/20240118-Pulling-into-the-Station.md +++ b/docs/community-events/20240118-Pulling-into-the-Station.md @@ -4,7 +4,7 @@ parent: Community Events --- {: .announcement } -Join us on Wednesday October 30th 2024 for the webinar [A Lap Around TROLIE 1.0](javascript:alert('TODO'))! +Join us on Wednesday November 20th, 2024 at 1:30pm ET for the webinar [A Lap Around TROLIE 1.0](javascript:alert('TODO'))! # Pulling into the Station--TROLIE 1.0 Nears Journey's End @@ -31,11 +31,79 @@ Since our last [Community Post](../community-events/), we've accomplished a lot. ## Supported Use Cases -TODO: copy use cases from previous announcements and add the balance +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 -TODO: -* Calling all vendors! Please reach out to the maintainers with questions -* Join the webinar -* ... \ No newline at end of file +* 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. From 19dd36d9f80cc92564548729240e417dccb41df6 Mon Sep 17 00:00:00 2001 From: Christopher Atkins Date: Tue, 22 Oct 2024 17:29:36 +0000 Subject: [PATCH 3/4] updated webinar link --- docs/community-events/20240118-Pulling-into-the-Station.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/community-events/20240118-Pulling-into-the-Station.md b/docs/community-events/20240118-Pulling-into-the-Station.md index 5e4d4718..03db8134 100644 --- a/docs/community-events/20240118-Pulling-into-the-Station.md +++ b/docs/community-events/20240118-Pulling-into-the-Station.md @@ -4,7 +4,7 @@ parent: Community Events --- {: .announcement } -Join us on Wednesday November 20th, 2024 at 1:30pm ET for the webinar [A Lap Around TROLIE 1.0](javascript:alert('TODO'))! +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 From 7cd14058ea8848c2dd6927db64b7efd8d5a08588 Mon Sep 17 00:00:00 2001 From: Christopher Atkins Date: Thu, 24 Oct 2024 20:17:00 +0000 Subject: [PATCH 4/4] update homepage --- docs/Gemfile.lock | 8 ++++---- docs/index.md | 7 +++---- 2 files changed, 7 insertions(+), 8 deletions(-) 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/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