From fba0358f4c8f47f239a786d401627556bc16b895 Mon Sep 17 00:00:00 2001 From: Stephen Suffian Date: Tue, 3 Oct 2023 11:00:33 -0400 Subject: [PATCH] Update website and readme to remove old specs --- README.md | 4 +- specifications/cdsc-wg2-01.md | 175 -------------------- specifications/cdsc-wg2-02.md | 1 - website/_includes/spec_list.md | 6 +- website/specs/cdsc-wg2-01/index.markdown | 23 --- website/specs/cdsc-wg2-01/overview.markdown | 11 -- website/specs/cdsc-wg2-02/index.markdown | 23 --- website/specs/cdsc-wg2-02/overview.markdown | 11 -- 8 files changed, 3 insertions(+), 251 deletions(-) delete mode 100644 specifications/cdsc-wg2-01.md delete mode 100644 specifications/cdsc-wg2-02.md delete mode 100644 website/specs/cdsc-wg2-01/index.markdown delete mode 100644 website/specs/cdsc-wg2-01/overview.markdown delete mode 100644 website/specs/cdsc-wg2-02/index.markdown delete mode 100644 website/specs/cdsc-wg2-02/overview.markdown diff --git a/README.md b/README.md index 14b2b38..03b1f9c 100644 --- a/README.md +++ b/README.md @@ -18,11 +18,9 @@ A good place to start is to look at our website: [https://powersystemsdata.carbo ## Specifications -* [CDSC-WG2-01 - Grid Topologies](https://powersystemsdata.carbondataspec.org/specs/cdsc-wg2-01/) -* [CDSC-WG2-02 - Data types](https://powersystemsdata.carbondataspec.org/specs/cdsc-wg2-02/) * [CDSC-WG2-03 - API Interface](https://powersystemsdata.carbondataspec.org/specs/cdsc-wg2-03/) -`CDSC-WG2-01 - Grid Topologies` is used to develop a shared terminology for various levels of granularity of grid entities and a convention for describing how those entities relate to each other. `CDSC-WG2-02 - Data Types` describes consensus around data fields that are either required or recommended in order to adequately describe the state of various grid entities. These two specifications are used in the development of `CDSC-WG2-03 - API Interface`, which describes an interface for power systems operators when sharing power system data. +`CDSC-WG2-03 - API Interface` is a specification that describes how power system data can be shared across varying levels of spatial granularity. ### Join the Working Group diff --git a/specifications/cdsc-wg2-01.md b/specifications/cdsc-wg2-01.md deleted file mode 100644 index d0af05d..0000000 --- a/specifications/cdsc-wg2-01.md +++ /dev/null @@ -1,175 +0,0 @@ - - -# _CDSC-WG2-01 - Topology_ - -Version: _0.0.1_ - -Status: Draft - -ยฉ _________________ - -This specification is subject to the Community Specification License 1.0, available at [https://github.com/CommunitySpecification/1.0](https://github.com/CommunitySpecification/1.0). - -## Contents -* [1. Foreword](#foreword) -* [2. Introduction](#introduction) -* [3. Terms and Definitions](#terms-and-definitions) -* [4. Topology](#topology) - * [4.1 Topology Relationship](#topology--relationship) - * [4.2 Granularity Levels](#topology--granularity-levels) - * [4.2 Graph Edges](#topology--graph-edges) - -## 1. Foreword - -Attention is drawn to the possibility that some of the elements of this document may be the subject of patent rights. No party shall not be held responsible for identifying any or all such patent rights. - -Any trade name used in this document is information given for the convenience of users and does not constitute an endorsement. - -This document was prepared by the Carbon Data Specification Working Group 2 - Power Systems Data. - -Known patent licensing exclusions are available in the specificationโ€™s repositoryโ€™s Notices.md file. - -THESE MATERIALS ARE PROVIDED โ€œAS IS.โ€ The Contributors and Licensees expressly disclaim any warranties (express, implied, or otherwise), including implied warranties of merchantability, non-infringement, fitness for a particular purpose, or title, related to the materials. The entire risk as to implementing or otherwise using the materials is assumed by the implementer and user. IN NO EVENT WILL THE CONTRIBUTORS OR LICENSEES BE LIABLE TO ANY OTHER PARTY FOR LOST PROFITS OR ANY FORM OF INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER FROM ANY CAUSES OF ACTION OF ANY KIND WITH RESPECT TO THIS DELIVERABLE OR ITS GOVERNING AGREEMENT, WHETHER BASED ON BREACH OF CONTRACT, TORT (INCLUDING NEGLIGENCE), OR OTHERWISE, AND WHETHER OR NOT THE OTHER MEMBER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - -## 1. Introduction -This specification was developed as part of the global effort to combat the climate crisis. Specifically, in order to scalably measure carbon emissions of organizations and calculate the impact of deploying and operating clean energy technologies, companies need an efficient means to discover the details and capabilities of energy utilities and other similar entities. - -This specification offers a topological graph model of electricity grids that has been defined by this working group, which is to be used for subsequent specifications. This specification is intended to be a starting point for defining the necessary terms of structure for developing a data streaming specification. - -### Normative references - -The following documents are referred to in the text in such a way that some or all of their content constitutes requirements of this document. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments) applies. - -- IEC 61968/61970: Common Information Model -- [Glossary of Terms Used in NERC Reliability Standards 2023](https://www.nerc.com/pa/Stand/Glossary%20of%20Terms/Glossary_of_Terms.pdf) -- [Glossary of Terms Used by PJM](https://www.pjm.com/Glossary) -- [EBIX Harmonised Role Model 2022-01](https://mwgstorage1.blob.core.windows.net/public/Ebix/Harmonised_Role_Model_2022-01.pdf) - -## 2. Terms and definitions - -For the purposes of this document, the following terms and definitions apply. - -ISO and IEC maintain terminological databases for use in standardization at the following addresses: - -- ISO Online browsing platform: available at https://www.iso.org/obp -- IEC Electropedia: available at http://www.electropedia.org/ - -This specification was informed through conversations with multiple Transmission System Operators as well as consulting IEC-61968 and IEC-61970 and the NERC Glossary of Terms. The following terms will be specifically used (definitions taken from the standard). - -### CIM -- PowerSystemResource: A power system resource (PSR) can be an item of equipment such as a switch, an equipment container containing many individual items of equipment such as a substation, or an organisational entity such as sub-control area. Power system resources can have measurements associated. -- GeographicalRegion: A geographical region of a power system network model. -- SubGeographicalRegion: A subset of a geographical region of a power system network model. -- Substation: A collection of equipment for purposes other than generation or utilization, through which electric energy in bulk is passed for the purposes of switching or modifying its characteristics. -- Feeder:A collection of equipment for organizational purposes, used for grouping distribution resources. The organization a feeder does not necessarily reflect connectivity or current operation state. -- GeneratingUnit: A single or set of synchronous machines for converting mechanical power into alternating-current power. For example, individual machines within a set may be defined for scheduling purposes while a single control signal is derived for the set. In this case there would be a GeneratingUnit for each member of the set and an additional GeneratingUnit corresponding to the set. - -*** -### Europe -#### EBIX Harmonised Role Model -- Synchronous Area:An area covered by synchronously interconnected LFC blocks (Examples of Synchronous Areas are Continental Europe, Great Britain, Ireland-Northern Ireland, Nordic and the power systems of Lithuania, Latvia and Estonia, together referred to as โ€˜Balticโ€™ which are part of a wider synchronous area (IPS/UPS)) -- LFC Block:A part of a synchronous area or an entire synchronous area, physically demarcated by points of measurement at interconnectors to other LFC Blocks, consisting of one or more LFC Areas, operated by one or more TSOs fulfilling the obligations of load-frequency control. -- LFC Area: A part of a synchronous area or an entire synchronous area, physically demarcated by points of measurement at interconnectors to other LFC Areas, operated by one or more TSOs fulfilling the obligations of load-frequency control. -- Bidding Zone: The largest geographical area within which market participants are able to exchange energy without capacity allocation. -- Control Area: A coherent part of the interconnected system, operated by a single System Operator and shall include connected physical loads and/or generation units if any. -- Metering Grid Area: A Metering Grid Area is a physical area where consumption, production and exchange can be measured. It is delimited by the placement of meters for continuous measurement for input to, and withdrawal from the area. -- Scheduling Area: An area within which the TSOs' obligations regarding scheduling apply due to operational or organisational needs. This area consists of one or more Metering Grid Areas with common market rules for which the settlement responsible party carries out an imbalance settlement and which has the same price for imbalance. -- Metering Point: An entity where energy products are measured or computed. - -*** -### US -#### NERC -- Balancing Authority: The responsible entity that integrates resource plans ahead of time, maintains Demand and -resource balance within a Balancing Authority Area, and supports Interconnection frequency in real time. -- Balancing Authority Area:The collection of generation, transmission, and loads within the metered boundaries of the -Balancing Authority. The Balancing Authority maintains load-resource balance within this area. -- Interconnection: A geographic area in which the operation of Bulk Power System components is synchronized -such that the failure of one or more of such components may adversely affect the ability of the operators of other components within the system to maintain Reliable Operation of the Facilities within their control. When capitalized, any one of the four major electric system networks in North America: Eastern, Western, ERCOT and Quebec. -- Generating Plant: One or more generators at a single physical location whereby any single -contingency can affect all the generators at that location. - -Additional terminology was taken from PJM, a Balancing Authority on the US Grid, which has its own set of glossary terms that are helpful for the purposes of this specification. - -#### PJM -- Zone: A transmission owner's area within the PJM Region. (We use this to generally define an area with a shared price/ability to bid). -- Substation: A substation changes energy from one amount of voltage to another, often in the direction of a higher voltage to a lower voltage. A high-voltage transmission line will connect to a substation to move electricity into a low-voltage distribution system on its way to consumers. -- Generator: A machine that converts different forms of energy into electrical energy. A generator or power plant might burn coal, capture the sun's energy through solar panels, convert moving air into electricity through windmills or transform the movement of water into energy as hydroelectric power. PJM has a diverse generation fuel mix that includes nuclear power, natural gas, fossil fuels coal and renewable generation such as wind and solar. - -## 3. Topology - -### Topology Relationship -We envision that any electric power grid can be described as a directed graph where nodes are different components of the power system elements and edges are connections between them. - -```mermaid -flowchart TB - subgraph node1[Node 3 - Transmission Line] - subgraph node1metadata[Metadata] - node1id[ID] - node1name[Name] - node1etc[...] - end - subgraph node1dynamic[Dynamic] - node1gen[Generation mix] - node1capacity[Capacity] - node1dynamicetc[...] - end - end - subgraph node2[Node 2 - Coal Power Plant] - subgraph node2metadata[Metadata] - node2metadataid[ID] - node2metadataname[Name] - node2metadataetc[...] - end - subgraph node2dynamic[Dynamic] - node2gen[Generation mix] - node2capacity[Capacity] - node2dynamicetc[...] - end - end - subgraph node3[Node 1 - Wind Farm] - subgraph node3metadata[Metadata] - node3metadataid[ID] - node3metadataname[Name] - node3metadataetc[...] - end - subgraph node3dynamic[Dynamic] - node3gen[Generation mix] - node3capacity[Capacity] - node3dynamicetc[...] - end - end - nodeetc[...] - node3dynamic-->node1dynamic - node2dynamic-->node1dynamic - node1dynamic-->nodeetc -``` -To describe a power system topology we therefore need to enumerate the possible nodes, and edges, as well as their definitions. - -### Granularity Levels - -Named levels are not part of the specification, since each grid might be structured slightly differently, but implementers SHOULD use these numbered granularity levels. There can be a different number of levels for each region, but we should make sure that equivalent structures in each region use the same level numbers (this may mean that in some regions, certain levels are skipped). - -|Level|US Grid|European Grid|CIM| -|--|--|--|--| -|0|Interconnection|Synchronous area|GeographicalRegion | -|1|Balancing Authority Area|LFC block/LFC area|GeographicalRegion, SubGeographicalRegion| -|2|Zone|Bidding zone|SubGeographicalRegion | -|3|Transmission Node/Substation|Control area|Substation | -|4|Generating Plant|Scheduling Area/Sub scheduling area|Feeder,GeneratingUnit| -|5|Meter (Generator or Load)|Metering Grid Area, MeteringPoint|GeneratingUnit | - -### Graph Edges - -|Level or Inter-level|Description|Type|Data| -|--|--|--|--| -|0|Between Interconnects|Physical: DC transmission lines|Line capacity, etc| -|0-1|Balancing Area to Interconnect Mapping|Virtual|Mapping table| -|1|Between Balancing Areas|Physical: Transmission lines | | -|1-2|Hubs to BAs|Virtual|Mapping table| -|2|Between Trading Hubs / Transmission-congested zones|Physical: Transmission lines | | -|2-3|Transmission Substation to Hub|Virtual|Mapping table| -|3|Between Transmission Nodes/Substation|Physical: Transmission lines | | -|3-4|Distribution Substations/Plants to Transmission Nodes|Physical: Transmission lines|| -|4|Between Distribution Node/Substation or Power Plant|N/A | | -|4-5|Meters to substations/plants|Physical: distribution lines|| -|5|Between Meters (Generator or Load)|N/A| | diff --git a/specifications/cdsc-wg2-02.md b/specifications/cdsc-wg2-02.md deleted file mode 100644 index 7886077..0000000 --- a/specifications/cdsc-wg2-02.md +++ /dev/null @@ -1 +0,0 @@ -[No main draft available yet] See Other Drafts section for in-progress and alternative drafts diff --git a/website/_includes/spec_list.md b/website/_includes/spec_list.md index 26a724d..e026ed7 100644 --- a/website/_includes/spec_list.md +++ b/website/_includes/spec_list.md @@ -1,8 +1,6 @@ -* `CDSC-WG2-01` - Grid Topologies [[Overview]({{ "/specs/cdsc-wg2-01/overview" | relative_url }})] [[Specification]({{ "/specs/cdsc-wg2-01" | relative_url }})] `(v0.0.1)` -* `CDSC-WG2-02` - Data Types [[Overview]({{ "/specs/cdsc-wg2-02/overview" | relative_url }})] [[Specification]({{ "/specs/cdsc-wg2-02" | relative_url }})] `(v0.0.1)` -* `CDSC-WG2-03` - API Interface [[Overview]({{ "/specs/cdsc-wg2-03/overview" | relative_url }})] [[Specification]({{ "/specs/cdsc-wg2-03" | relative_url }})] `(in progress)` +* `CDSC-WG2-03` - API Interface [[Overview]({{ "/specs/cdsc-wg2-03/overview" | relative_url }})] [[Specification]({{ "/specs/cdsc-wg2-03" | relative_url }})] `(v0.0.1)` * `CDSC-WG2-*` - Additional specifications will be added in the future -`CDSC-WG2-01 - Grid Topologies` is used to develop a shared terminology for various levels of granularity of grid entities and a convention for describing how those entities relate to each other. `CDSC-WG2-02 - Data Types` describes consensus around data fields that are either required or recommended in order to adequately describe the state of various grid entities. These two specifications are used in the development of `CDSC-WG2-03 - API Interface`, which describes an interface for power systems operators when sharing power system data. +`CDSC-WG-03` is the current spec that encapsulates the topology, decisions around fuel types and technologies, and the proposed endpoints for a specification around providing power systems energy data at different spatial granularities. If you would like to contribute to these specifications, please see our docs on [Contributing]({{ "/" | relative_url }}#contributing). diff --git a/website/specs/cdsc-wg2-01/index.markdown b/website/specs/cdsc-wg2-01/index.markdown deleted file mode 100644 index 408500a..0000000 --- a/website/specs/cdsc-wg2-01/index.markdown +++ /dev/null @@ -1,23 +0,0 @@ ---- -layout: base -nav: specs -title: CDSC-WG2 - 01 Grid Topology - Specification -meta_description: Linux Foundation Energy - Carbon Data Specification Consortium (CDSC) - Power Systems Data Working Group (WG2) - Specifications - cdsc-wg2-01 - Grid Topology ---- -[Home]({{ "/" | relative_url }}) / [Specifications]({{ "/specs" | relative_url }}) / `cdsc-wg2-01` - Grid Topology - -# Grid Topology - -Looking for a more human-readable summary of this specification? Check out our [overview]({{ "/specs/cdsc-wg2-01/overview" | relative_url }}). - -Below is a rendering of the original specification source: [{{ site.github_specs_base_url }}/cdsc-wg2-01.md]({{ site.github_specs_base_url }}/cdsc-wg2-01.md) - ---- - -{% include spec_copies/placeholder_cdsc-wg2-01.md %} - ---- - -# Other Drafts - -* No drafts currently in progress. diff --git a/website/specs/cdsc-wg2-01/overview.markdown b/website/specs/cdsc-wg2-01/overview.markdown deleted file mode 100644 index b9bf931..0000000 --- a/website/specs/cdsc-wg2-01/overview.markdown +++ /dev/null @@ -1,11 +0,0 @@ ---- -layout: base -nav: specs -title: CDSC-WG2 - 01 Grid Topology - Overview -meta_description: Linux Foundation Energy - Carbon Data Specification Consortium (CDSC) - Customer DataWorking Group (WG2) - Specifications - cdsc-wg2-01 - Grid Topology - Overview ---- -[Home]({{ "/" | relative_url }}) / [Specifications]({{ "/specs" | relative_url }}) / [`cdsc-wg2-01` - Grid Topology]({{ "/specs/cdsc-wg2-01" | relative_url }}) / Overview - -# Grid Topology - Overview - -This overview has not yet been completed and approved by the working group. diff --git a/website/specs/cdsc-wg2-02/index.markdown b/website/specs/cdsc-wg2-02/index.markdown deleted file mode 100644 index 389fe83..0000000 --- a/website/specs/cdsc-wg2-02/index.markdown +++ /dev/null @@ -1,23 +0,0 @@ ---- -layout: base -nav: specs -title: CDSC-WG2 - 02 Data Types - Specification -meta_description: Linux Foundation Energy - Carbon Data Specification Consortium (CDSC) - Power Systems Data Working Group (WG2) - Specifications - cdsc-wg2-02 - Data Types ---- -[Home]({{ "/" | relative_url }}) / [Specifications]({{ "/specs" | relative_url }}) / `cdsc-wg2-02` - Data Types - -# Data Types - -Looking for a more human-readable summary of this specification? Check out our [overview]({{ "/specs/cdsc-wg2-02/overview" | relative_url }}). - -Below is a rendering of the original specification source: [{{ site.github_specs_base_url }}/cdsc-wg2-02.md]({{ site.github_specs_base_url }}/cdsc-wg2-02.md) - ---- - -{% include spec_copies/placeholder_cdsc-wg2-02.md %} - ---- - -# Other Drafts - -* Draft in progress: [[Website](https://github.com/carbon-data-specification/Power-Systems-Data/blob/ssuffian-02-draft/specifications/cdsc-wg2-02.md)] [[Code](https://github.com/carbon-data-specification/Power-Systems-Data/pull/68/files)] diff --git a/website/specs/cdsc-wg2-02/overview.markdown b/website/specs/cdsc-wg2-02/overview.markdown deleted file mode 100644 index c972007..0000000 --- a/website/specs/cdsc-wg2-02/overview.markdown +++ /dev/null @@ -1,11 +0,0 @@ ---- -layout: base -nav: specs -title: CDSC-WG2 - 02 Data Types - Overview -meta_description: Linux Foundation Energy - Carbon Data Specification Consortium (CDSC) - Power Systems Data Working Group (WG2) - Specifications - cdsc-wg2-02 - Data Types - Overview ---- -[Home]({{ "/" | relative_url }}) / [Specifications]({{ "/specs" | relative_url }}) / [`cdsc-wg2-02` - Data Types]({{ "/specs/cdsc-wg2-02" | relative_url }}) / Overview - -# Data Types - Overview - -This overview has not yet been completed and approved by the working group.