diff --git a/glsk/glsk-document-cse/pom.xml b/glsk/glsk-document-cse/pom.xml index 053b92c7..e47d3b30 100644 --- a/glsk/glsk-document-cse/pom.xml +++ b/glsk/glsk-document-cse/pom.xml @@ -14,6 +14,32 @@ GLSK document - CSE format Model of GLSK according to CSE format with its importer. + + + + org.codehaus.mojo + jaxb2-maven-plugin + + + + xjc + + + + + + src/main/resources/xsd/etso-code-lists.xsd + src/main/resources/xsd/etso-core-cmpts.xsd + src/main/resources/xsd/gsk-document.xsd + + + src/main/resources/xjb/binding.xjb + + + + + + ${project.groupId} @@ -48,6 +74,15 @@ slf4j-simple test + + jakarta.xml.bind + jakarta.xml.bind-api + + + com.sun.xml.bind + jaxb-impl + runtime + \ No newline at end of file diff --git a/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/BlockWrapper.java b/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/BlockWrapper.java new file mode 100644 index 00000000..3c87a3c4 --- /dev/null +++ b/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/BlockWrapper.java @@ -0,0 +1,67 @@ +/* + * Copyright (c) 2023, RTE (http://www.rte-france.com) + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + */ +package com.powsybl.glsk.cse; + +import xsd.etso_core_cmpts.QuantityType; + +import java.math.BigDecimal; +import java.math.BigInteger; +import java.util.List; +import java.util.Optional; +import java.util.stream.Collectors; + +/** + * @author Vincent BOCHET {@literal } + */ +public final class BlockWrapper { + private final Object block; + + public BlockWrapper(Object block) { + this.block = block; + } + + public Object getBlock() { + return block; + } + + public Optional getOrder() { + try { + BigInteger order = (BigInteger) block.getClass().getDeclaredField("order").get(block); + return Optional.ofNullable(order); + } catch (NoSuchFieldException | IllegalAccessException e) { + return Optional.empty(); + } + } + + public Optional getMaximumShift() { + try { + QuantityType maximumShift = (QuantityType) block.getClass().getDeclaredField("maximumShift").get(block); + return Optional.ofNullable(maximumShift).map(QuantityType::getV); + } catch (NoSuchFieldException | IllegalAccessException e) { + return Optional.empty(); + } + } + + public Optional getFactor() { + try { + QuantityType factor = (QuantityType) block.getClass().getDeclaredField("factor").get(block); + return Optional.ofNullable(factor).map(QuantityType::getV); + } catch (NoSuchFieldException | IllegalAccessException e) { + return Optional.empty(); + } + } + + public Optional> getNodeList() { + try { + List objectList = (List) block.getClass().getDeclaredField("node").get(block); + return Optional.ofNullable(objectList) + .map(list -> list.stream().map(NodeWrapper::new).collect(Collectors.toList())); + } catch (NoSuchFieldException | IllegalAccessException e) { + return Optional.empty(); + } + } +} diff --git a/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskDocument.java b/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskDocument.java index ffc62f28..38f4a335 100644 --- a/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskDocument.java +++ b/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskDocument.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2020, RTE (http://www.rte-france.com) + * Copyright (c) 2023, RTE (http://www.rte-france.com) * This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. @@ -9,72 +9,156 @@ import com.powsybl.glsk.api.GlskDocument; import com.powsybl.glsk.api.GlskPoint; import com.powsybl.glsk.api.util.converters.GlskPointScalableConverter; +import com.powsybl.glsk.commons.CountryEICode; import com.powsybl.glsk.commons.GlskException; import com.powsybl.glsk.commons.ZonalData; import com.powsybl.glsk.commons.ZonalDataChronology; import com.powsybl.glsk.commons.ZonalDataImpl; import com.powsybl.iidm.modification.scalable.Scalable; +import com.powsybl.iidm.network.Country; import com.powsybl.iidm.network.Network; import com.powsybl.sensitivity.SensitivityVariableSet; +import jakarta.xml.bind.JAXBContext; +import jakarta.xml.bind.JAXBException; +import jakarta.xml.bind.JAXBIntrospector; +import jakarta.xml.bind.Unmarshaller; import org.apache.commons.lang3.NotImplementedException; -import org.w3c.dom.Document; -import org.w3c.dom.Element; -import org.w3c.dom.Node; -import org.w3c.dom.NodeList; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; import org.xml.sax.SAXException; import javax.xml.XMLConstants; -import javax.xml.parsers.DocumentBuilderFactory; -import javax.xml.parsers.ParserConfigurationException; -import java.io.IOException; +import javax.xml.validation.Schema; +import javax.xml.validation.SchemaFactory; import java.io.InputStream; +import java.net.URL; import java.time.Instant; -import java.util.*; +import java.util.ArrayList; +import java.util.Collections; +import java.util.Comparator; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.TreeMap; import java.util.stream.Collectors; /** * @author Sebastien Murgey {@literal } + * @author Vincent BOCHET {@literal } */ public final class CseGlskDocument implements GlskDocument { + private static final Logger LOGGER = LoggerFactory.getLogger(CseGlskDocument.class); private static final String LINEAR_GLSK_NOT_HANDLED = "CSE GLSK document does not handle Linear GLSK conversion"; + private static final String COUNTRIES_IN_AREA_KEY = "countriesInArea"; + private static final String COUNTRIES_OUT_AREA_KEY = "countriesOutArea"; /** * list of GlskPoint in the given Glsk document */ private final Map> cseGlskPoints = new TreeMap<>(); - public static CseGlskDocument importGlsk(Document document) { - return new CseGlskDocument(document); - } - - public static CseGlskDocument importGlsk(InputStream inputStream) { + public static CseGlskDocument importGlsk(InputStream inputStream, boolean useCalculationDirections) { try { - DocumentBuilderFactory documentBuilderFactory = DocumentBuilderFactory.newInstance(); - documentBuilderFactory.setAttribute(XMLConstants.ACCESS_EXTERNAL_DTD, ""); - documentBuilderFactory.setAttribute(XMLConstants.ACCESS_EXTERNAL_SCHEMA, ""); - documentBuilderFactory.setAttribute(XMLConstants.FEATURE_SECURE_PROCESSING, Boolean.TRUE); - documentBuilderFactory.setNamespaceAware(true); - - Document document = documentBuilderFactory.newDocumentBuilder().parse(inputStream); - document.getDocumentElement().normalize(); - return new CseGlskDocument(document); - } catch (IOException | SAXException | ParserConfigurationException e) { + JAXBContext jaxbContext = JAXBContext.newInstance(ObjectFactory.class); + Unmarshaller unmarshaller = jaxbContext.createUnmarshaller(); + + // Setup schema validator + SchemaFactory sf = SchemaFactory.newInstance(XMLConstants.W3C_XML_SCHEMA_NS_URI); + URL glskSchemaResource = CseGlskDocument.class.getResource("/xsd/gsk-document.xsd"); + if (glskSchemaResource != null) { + Schema glskSchema = sf.newSchema(glskSchemaResource); + unmarshaller.setSchema(glskSchema); + } else { + LOGGER.warn("Unable to find GLSK Schema definition file. GLSK file will be imported without schema validation."); + } + + // Unmarshal xml file + GSKDocument nativeGskDocument = (GSKDocument) JAXBIntrospector.getValue(unmarshaller.unmarshal(inputStream)); + return new CseGlskDocument(nativeGskDocument, useCalculationDirections); + } catch (SAXException e) { + throw new GlskException("Unable to import CSE GLSK file: Schema validation failed.", e); + } catch (JAXBException e) { throw new GlskException("Unable to import CSE GLSK file.", e); } } - private CseGlskDocument(Document document) { - NodeList timeSeriesNodeList = document.getElementsByTagName("TimeSeries"); - for (int i = 0; i < timeSeriesNodeList.getLength(); i++) { - if (timeSeriesNodeList.item(i).getNodeType() == Node.ELEMENT_NODE) { - Element timeSeriesElement = (Element) timeSeriesNodeList.item(i); - GlskPoint glskPoint = new CseGlskPoint(timeSeriesElement); - cseGlskPoints.computeIfAbsent(glskPoint.getSubjectDomainmRID(), area -> new ArrayList<>()); - cseGlskPoints.get(glskPoint.getSubjectDomainmRID()).add(glskPoint); - } + private CseGlskDocument(GSKDocument nativeGskDocument, boolean useCalculationDirections) { + // Computation of "standard" and "export" timeseries + Map> cseGlskPointsStandard = getGlskPointsFromTimeSeries(nativeGskDocument.getTimeSeries()); + Map> cseGlskPointsExport = getGlskPointsFromTimeSeries(nativeGskDocument.getTimeSeriesExport()); + + if (!useCalculationDirections || calculationDirectionsAbsent(nativeGskDocument)) { + // "default" mode : all countries are considered in full import (use TimeSeries for all) + this.cseGlskPoints.putAll(cseGlskPointsStandard); + } else { + // Extract CalculationDirections + List calculationDirections = nativeGskDocument.getCalculationDirections().get(0).getCalculationDirection(); + Map> countriesInAndOutArea = getCountriesInAndOutArea(calculationDirections); + + // Use data from cseGlskPointsStandard or cseGlskPointsExport depending on CalculationDirections + fillGlskPointsForExportCorner(cseGlskPointsStandard, cseGlskPointsExport, countriesInAndOutArea); } } + private static Map> getGlskPointsFromTimeSeries(List timeSeries) { + Map> cseGlskPointsPerArea = new TreeMap<>(); + if (timeSeries == null) { + return cseGlskPointsPerArea; + } + + timeSeries.stream() + .map(CseGlskPoint::new) + .forEach(glskPoint -> { + cseGlskPointsPerArea.computeIfAbsent(glskPoint.getSubjectDomainmRID(), area -> new ArrayList<>()); + cseGlskPointsPerArea.get(glskPoint.getSubjectDomainmRID()).add(glskPoint); + }); + return cseGlskPointsPerArea; + } + + private static boolean calculationDirectionsAbsent(GSKDocument nativeGskDocument) { + return nativeGskDocument.getCalculationDirections() == null + || nativeGskDocument.getCalculationDirections().isEmpty() + || nativeGskDocument.getCalculationDirections().get(0).getCalculationDirection() == null + || nativeGskDocument.getCalculationDirections().get(0).getCalculationDirection().isEmpty(); + } + + private static Map> getCountriesInAndOutArea(List calculationDirections) { + String italyEIC = new CountryEICode(Country.IT).getCode(); + List countriesInArea = new ArrayList<>(); + List countriesOutArea = new ArrayList<>(); + + calculationDirections.stream() + .map(cd -> cd.getInArea().getV()) + .filter(countryEIC -> !countryEIC.equals(italyEIC)) + .forEach(countriesInArea::add); + + countriesInArea.add(italyEIC); + + calculationDirections.stream() + .map(cd -> cd.getOutArea().getV()) + .filter(countryEIC -> !countryEIC.equals(italyEIC)) + .forEach(countriesOutArea::add); + + return Map.of(COUNTRIES_IN_AREA_KEY, countriesInArea, + COUNTRIES_OUT_AREA_KEY, countriesOutArea); + } + + private void fillGlskPointsForExportCorner(Map> cseGlskPointsStandard, + Map> cseGlskPointsExport, + Map> countriesInAndOutArea) { + countriesInAndOutArea.get(COUNTRIES_IN_AREA_KEY).forEach(eic -> { + List cseGlskPoint = cseGlskPointsExport.getOrDefault(eic, cseGlskPointsStandard.get(eic)); + this.cseGlskPoints.computeIfAbsent(eic, area -> new ArrayList<>()); + this.cseGlskPoints.get(eic).addAll(cseGlskPoint); + }); + + countriesInAndOutArea.get(COUNTRIES_OUT_AREA_KEY).forEach(eic -> { + List cseGlskPoint = cseGlskPointsStandard.get(eic); + this.cseGlskPoints.computeIfAbsent(eic, area -> new ArrayList<>()); + this.cseGlskPoints.get(eic).addAll(cseGlskPoint); + }); + } + @Override public List getZones() { return new ArrayList<>(cseGlskPoints.keySet()); diff --git a/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskDocumentImporter.java b/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskDocumentImporter.java index b99bc2e2..6ddf5942 100644 --- a/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskDocumentImporter.java +++ b/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskDocumentImporter.java @@ -24,10 +24,12 @@ public class CseGlskDocumentImporter extends AbstractGlskDocumentImporter implem @Override public GlskDocument importGlsk(InputStream inputStream) { - if (document != null) { - return CseGlskDocument.importGlsk(document); - } - return CseGlskDocument.importGlsk(inputStream); + return importGlsk(inputStream, false); + } + + @Override + public GlskDocument importGlsk(InputStream inputStream, boolean useCalculationDirections) { + return CseGlskDocument.importGlsk(inputStream, useCalculationDirections); } @Override diff --git a/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskPoint.java b/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskPoint.java index 94dadde9..1fa6f489 100644 --- a/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskPoint.java +++ b/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskPoint.java @@ -9,75 +9,67 @@ import com.powsybl.glsk.api.AbstractGlskPoint; import com.powsybl.glsk.commons.GlskException; import org.threeten.extra.Interval; -import org.w3c.dom.Element; -import org.w3c.dom.Node; -import org.w3c.dom.NodeList; +import xsd.etso_code_lists.BusinessTypeList; import java.util.ArrayList; +import java.util.List; import java.util.Objects; - -import static com.powsybl.glsk.api.util.Util.getUniqueNode; +import java.util.stream.Stream; /** * @author Sebastien Murgey {@literal } + * @author Vincent BOCHET {@literal } */ public class CseGlskPoint extends AbstractGlskPoint { - /** - * @param element Dom element - */ - public CseGlskPoint(Element element) { - Objects.requireNonNull(element); + + private static final List> STANDARD_BLOCK_CLASSES = List.of(ManualGSKBlockType.class, PropGSKBlockType.class, PropLSKBlockType.class, ReserveGSKBlockType.class); + + public CseGlskPoint(TimeSeriesType timeSeries) { + Objects.requireNonNull(timeSeries); this.position = 1; - this.pointInterval = Interval.parse(((Element) getUniqueNode(element, "TimeInterval")).getAttribute("v")); - this.subjectDomainmRID = ((Element) getUniqueNode(element, "Area")).getAttribute("v"); + this.pointInterval = Interval.parse(timeSeries.getTimeInterval().getV()); + this.subjectDomainmRID = timeSeries.getArea().getV(); this.curveType = "A03"; this.glskShiftKeys = new ArrayList<>(); - String businessType = ((Element) getUniqueNode(element, "BusinessType")).getAttribute("v"); - NodeList childNodes = element.getChildNodes(); - for (int i = 0; i < childNodes.getLength(); i++) { - Node childNode = childNodes.item(i); - if (childNode.getNodeType() == Node.ELEMENT_NODE) { - Element childElement = (Element) childNode; - try { - switch (childElement.getNodeName()) { - case "ManualGSKBlock": - case "PropGSKBlock": - case "PropLSKBlock": - case "ReserveGSKBlock": - importStandardBlock(childElement, businessType); - break; - case "MeritOrderGSKBlock": - importMeritOrderBlock(childElement, businessType); - break; - default: - break; - } - } catch (GlskException e) { - throw new GlskException(String.format("Impossible to import GLSK on area %s", subjectDomainmRID), e); - } - } + BusinessTypeList businessType = timeSeries.getBusinessType().getV(); + + try { + Stream.concat(Stream.ofNullable(timeSeries.getManualLSKBlockOrPropLSKBlock()), + Stream.ofNullable(timeSeries.getPropGSKBlockOrReserveGSKBlockOrMeritOrderGSKBlock())) + .flatMap(List::stream) + .filter(block -> STANDARD_BLOCK_CLASSES.stream().anyMatch(acceptedClass -> acceptedClass.isInstance(block))) + .map(BlockWrapper::new) + .forEach(block -> importStandardBlock(block, businessType)); + + Stream.ofNullable(timeSeries.getPropGSKBlockOrReserveGSKBlockOrMeritOrderGSKBlock()) + .flatMap(List::stream) + .filter(MeritOrderGSKBlockType.class::isInstance) + .map(BlockWrapper::new) + .forEach(block -> importMeritOrderBlock(block, businessType)); + + } catch (GlskException e) { + throw new GlskException(String.format("Impossible to import GLSK on area %s", subjectDomainmRID), e); } } - private void importMeritOrderBlock(Element blockElement, String businessType) { - Element upBlockElement = (Element) getUniqueNode(blockElement, "Up"); - NodeList upNodesList = upBlockElement.getElementsByTagName("Node"); - for (int j = 0; j < upNodesList.getLength(); j++) { + private void importMeritOrderBlock(BlockWrapper blockWrapper, BusinessTypeList businessType) { + MeritOrderGSKBlockType block = (MeritOrderGSKBlockType) blockWrapper.getBlock(); + List upNodes = block.getUp().getNode(); + for (int j = 0; j < upNodes.size(); j++) { // Up nodes have positive merit order position // First is 1 last is N to be easily recognized in GLSK point conversion. - glskShiftKeys.add(new CseGlskShiftKey(blockElement, businessType, pointInterval, subjectDomainmRID, j + 1)); + glskShiftKeys.add(new CseGlskShiftKey(blockWrapper, new NodeWrapper(upNodes.get(j)), businessType, pointInterval, subjectDomainmRID, j + 1)); } - Element downBlockElement = (Element) getUniqueNode(blockElement, "Down"); - NodeList downNodesList = downBlockElement.getElementsByTagName("Node"); - for (int j = 0; j < downNodesList.getLength(); j++) { + List downNodes = block.getDown().getNode(); + for (int j = 0; j < downNodes.size(); j++) { // Down nodes have negative merit order position // First is -1 last is -N to be easily recognized in GLSK point conversion. - glskShiftKeys.add(new CseGlskShiftKey(blockElement, businessType, pointInterval, subjectDomainmRID, -j - 1)); + glskShiftKeys.add(new CseGlskShiftKey(blockWrapper, new NodeWrapper(downNodes.get(j)), businessType, pointInterval, subjectDomainmRID, -j - 1)); } } - private void importStandardBlock(Element blockElement, String businessType) { - this.glskShiftKeys.add(new CseGlskShiftKey(blockElement, businessType, pointInterval, subjectDomainmRID)); + private void importStandardBlock(BlockWrapper blockWrapper, BusinessTypeList businessType) { + this.glskShiftKeys.add(new CseGlskShiftKey(blockWrapper, businessType, pointInterval, subjectDomainmRID)); } } diff --git a/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskRegisteredResource.java b/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskRegisteredResource.java index 24acdadb..b6ff31d9 100644 --- a/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskRegisteredResource.java +++ b/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskRegisteredResource.java @@ -7,39 +7,32 @@ package com.powsybl.glsk.cse; import com.powsybl.glsk.api.AbstractGlskRegisteredResource; -import org.w3c.dom.Element; +import java.math.BigDecimal; import java.util.Objects; import java.util.Optional; -import static com.powsybl.glsk.api.util.Util.getUniqueNode; - /** * @author Sebastien Murgey {@literal } */ public class CseGlskRegisteredResource extends AbstractGlskRegisteredResource { private final Double initialFactor; - public CseGlskRegisteredResource(Element element) { - Objects.requireNonNull(element); - this.name = ((Element) getUniqueNode(element, "Name")).getAttribute("v"); + public CseGlskRegisteredResource(NodeWrapper nodeWrapper) { + Objects.requireNonNull(nodeWrapper); + this.name = nodeWrapper.getName().orElse(""); this.mRID = this.name; - this.initialFactor = getContentAsDoubleOrNull(element, "Factor"); - this.maximumCapacity = negativeIfNotNull(getContentAsDoubleOrNull(element, "Pmax")); - this.minimumCapacity = negativeIfNotNull(getContentAsDoubleOrNull(element, "Pmin")); + this.initialFactor = nodeWrapper.getFactor().map(BigDecimal::doubleValue).orElse(null); + this.maximumCapacity = nodeWrapper.getPmax().map(CseGlskRegisteredResource::getNegativeDouble).orElse(null); + this.minimumCapacity = nodeWrapper.getPmin().map(CseGlskRegisteredResource::getNegativeDouble).orElse(null); } - void setParticipationFactor(double participationFactor) { - this.participationFactor = participationFactor; + private static Double getNegativeDouble(BigDecimal v) { + return v.negate().doubleValue(); } - private Double getContentAsDoubleOrNull(Element baseElement, String tag) { - return baseElement.getElementsByTagName(tag).getLength() == 0 ? null : - Double.parseDouble(((Element) baseElement.getElementsByTagName(tag).item(0)).getAttribute("v")); - } - - private Double negativeIfNotNull(Double value) { - return value == null ? null : -value; + void setParticipationFactor(double participationFactor) { + this.participationFactor = participationFactor; } @Override diff --git a/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskShiftKey.java b/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskShiftKey.java index 4679f0da..143a97df 100644 --- a/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskShiftKey.java +++ b/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/CseGlskShiftKey.java @@ -10,163 +10,111 @@ import com.powsybl.glsk.api.GlskRegisteredResource; import com.powsybl.glsk.commons.GlskException; import org.threeten.extra.Interval; -import org.w3c.dom.Element; -import org.w3c.dom.Node; -import org.w3c.dom.NodeList; +import xsd.etso_code_lists.BusinessTypeList; +import java.math.BigDecimal; +import java.math.BigInteger; import java.util.ArrayList; +import java.util.List; import java.util.Optional; -import java.util.OptionalDouble; - -import static com.powsybl.glsk.api.util.Util.getUniqueNode; /** * @author Sebastien Murgey {@literal } + * @author Vincent BOCHET {@literal } */ public class CseGlskShiftKey extends AbstractGlskShiftKey { - private static final int DEFAULT_ORDER = 0; - - private int order = DEFAULT_ORDER; - - public CseGlskShiftKey(Element glskBlockElement, String businessType, Interval pointInterval, String subjectDomainmRID) { - initCommonMemberVariables(glskBlockElement, businessType, pointInterval, subjectDomainmRID); - - switch (glskBlockElement.getTagName()) { - case "ManualGSKBlock": - this.businessType = "B43"; - NodeList nodesList = glskBlockElement.getElementsByTagName("Node"); - double currentFactorsSum = 0; - for (int i = 0; i < nodesList.getLength(); i++) { - Element nodeElement = (Element) nodesList.item(i); - CseGlskRegisteredResource cseRegisteredResource = new CseGlskRegisteredResource(nodeElement); - registeredResourceArrayList.add(cseRegisteredResource); - Optional initialFactor = cseRegisteredResource.getInitialFactor(); - if (initialFactor.isPresent()) { - currentFactorsSum += initialFactor.get(); - } - } - - if (currentFactorsSum == 0) { - throw new GlskException("Factors sum should not be 0"); - } + private int order = 0; + + public CseGlskShiftKey(BlockWrapper blockWrapper, BusinessTypeList businessType, Interval pointInterval, String subjectDomainmRID) { + initCommonMemberVariables(blockWrapper, businessType, pointInterval, subjectDomainmRID); + + if (blockWrapper.getBlock() instanceof ManualGSKBlockType) { + this.businessType = "B43"; + handleManualGskBlock(blockWrapper); + } else if (blockWrapper.getBlock() instanceof PropGSKBlockType) { + importImplicitProportionalBlock(blockWrapper, "B42"); + } else if (blockWrapper.getBlock() instanceof PropLSKBlockType) { + this.psrType = "A05"; // Enforce psrType that does not respect "official" format specification + importImplicitProportionalBlock(blockWrapper, "B42"); + } else if (blockWrapper.getBlock() instanceof ReserveGSKBlockType) { + importImplicitProportionalBlock(blockWrapper, "B44"); + } else { + throw new GlskException("Unknown UCTE Block type"); + } + } - for (GlskRegisteredResource registeredResource : registeredResourceArrayList) { - CseGlskRegisteredResource cseRegisteredResource = (CseGlskRegisteredResource) registeredResource; - Optional initialFactor = cseRegisteredResource.getInitialFactor(); - if (initialFactor.isPresent()) { - cseRegisteredResource.setParticipationFactor(initialFactor.get() / currentFactorsSum); - } + private void handleManualGskBlock(BlockWrapper blockWrapper) { + double factorsSum = 0; + Optional> nodeList = blockWrapper.getNodeList(); + + if (nodeList.isPresent()) { + for (NodeWrapper nodeWrapper : nodeList.get()) { + CseGlskRegisteredResource cseGlskRegisteredResource = new CseGlskRegisteredResource(nodeWrapper); + registeredResourceArrayList.add(cseGlskRegisteredResource); + Optional initialFactor = cseGlskRegisteredResource.getInitialFactor(); + if (initialFactor.isPresent()) { + factorsSum += initialFactor.get(); } - break; - case "PropGSKBlock": - importImplicitProportionalBlock(glskBlockElement, "B42"); - break; - case "PropLSKBlock": - this.psrType = "A05"; // Enforce psrType that does not respect "official" format specification - importImplicitProportionalBlock(glskBlockElement, "B42"); - break; - case "ReserveGSKBlock": - importImplicitProportionalBlock(glskBlockElement, "B44"); - break; - default: - throw new GlskException("Unknown UCTE Block type"); + } } - } - public CseGlskShiftKey(Element glskBlockElement, String businessType, Interval pointInterval, String subjectDomainmRID, int position) { - initCommonMemberVariables(glskBlockElement, businessType, pointInterval, subjectDomainmRID); - this.meritOrderPosition = position; + if (factorsSum == 0) { + throw new GlskException("Factors sum should not be 0"); + } - if ("MeritOrderGSKBlock".equals(glskBlockElement.getTagName())) { - this.businessType = "B45"; - Element nodeElement = getNodeElement(glskBlockElement, position); - CseGlskRegisteredResource cseRegisteredResource = new CseGlskRegisteredResource(nodeElement); - registeredResourceArrayList.add(cseRegisteredResource); - } else { - throw new GlskException("Unknown UCTE Block type"); + for (GlskRegisteredResource registeredResource : registeredResourceArrayList) { + CseGlskRegisteredResource cseRegisteredResource = (CseGlskRegisteredResource) registeredResource; + Optional initialFactor = cseRegisteredResource.getInitialFactor(); + if (initialFactor.isPresent()) { + cseRegisteredResource.setParticipationFactor(initialFactor.get() / factorsSum); + } } } - private Element getNodeElement(Element glskBlockElement, int position) { - if (position > 0) { - // Up scalable element - // Position is 1 to N for up scalable - // Though, in XML file, we have to get child position - 1 - Element upBlockElement = (Element) getUniqueNode(glskBlockElement, "Up"); - return (Element) upBlockElement.getElementsByTagName("Node").item(position - 1); - } else { - // Down scalable element - // Position is -1 to -N for down scalable - // Though, in XML file, we have to get child -position - 1 - Element downBlockElement = (Element) getUniqueNode(glskBlockElement, "Down"); - return (Element) downBlockElement.getElementsByTagName("Node").item(-position - 1); - } + public CseGlskShiftKey(BlockWrapper blockWrapper, NodeWrapper nodeWrapper, BusinessTypeList businessType, Interval pointInterval, String subjectDomainmRID, int position) { + initCommonMemberVariables(blockWrapper, businessType, pointInterval, subjectDomainmRID); + this.meritOrderPosition = position; + + this.businessType = "B45"; + CseGlskRegisteredResource cseRegisteredResource = new CseGlskRegisteredResource(nodeWrapper); + registeredResourceArrayList.add(cseRegisteredResource); } - private void initCommonMemberVariables(Element glskBlockElement, String businessType, Interval pointInterval, String subjectDomainmRID) { - if (businessType.equals("Z02")) { + private void initCommonMemberVariables(BlockWrapper blockWrapper, BusinessTypeList businessType, Interval pointInterval, String subjectDomainmRID) { + if (businessType.equals(BusinessTypeList.Z_02)) { this.psrType = "A04"; - } else if (businessType.equals("Z05")) { + } else if (businessType.equals(BusinessTypeList.Z_05)) { this.psrType = "A05"; } else { throw new GlskException("in GlskShiftKey UCTE constructor: unknown ucteBusinessType: " + businessType); } + this.glskShiftKeyInterval = pointInterval; this.subjectDomainmRID = subjectDomainmRID; this.registeredResourceArrayList = new ArrayList<>(); - if (isPartOfHybridShiftKey(glskBlockElement)) { - this.order = getOrder(glskBlockElement); - if (hasMaximumShift(glskBlockElement)) { - this.maximumShift = getMaximumShift(glskBlockElement); - } + + if (isPartOfHybridShiftKey(blockWrapper)) { + blockWrapper.getOrder().map(BigInteger::intValue) + .ifPresent(o -> this.order = o); + blockWrapper.getMaximumShift().map(BigDecimal::doubleValue) + .ifPresent(ms -> this.maximumShift = ms); } else { - getFactor(glskBlockElement).ifPresent(factor -> this.quantity = factor); + blockWrapper.getFactor().map(BigDecimal::doubleValue) + .ifPresent(q -> this.quantity = q); } } - private static boolean isPartOfHybridShiftKey(Element glskBlockElement) { - return glskBlockElement.getElementsByTagName("Order").getLength() != 0; - } - - private static int getOrder(Element glskBlockElement) { - return Integer.parseInt(getUniqueNode(glskBlockElement, "Order").getTextContent()); - } - - private static boolean hasMaximumShift(Element glskBlockElement) { - return glskBlockElement.getElementsByTagName("MaximumShift").getLength() != 0; + private static boolean isPartOfHybridShiftKey(BlockWrapper blockWrapper) { + return blockWrapper.getOrder().isPresent(); } - private static double getMaximumShift(Element glskBlockElement) { - //maximum shift in hybrid cse glsk - return Double.parseDouble(((Element) getUniqueNode(glskBlockElement, "MaximumShift")).getAttribute("v")); - } - - /* - Here we should only retrieve the tag at the level of the GlskShiftKey. So we cannot use the method - getElementsByTagName because it returns all the elements of the hierarchy -- with child tags. - */ - private static OptionalDouble getFactor(Element glskBlockElement) { - NodeList nodeList = glskBlockElement.getChildNodes(); - for (int i = 0; i < nodeList.getLength(); i++) { - if (nodeList.item(i).getNodeType() == Node.ELEMENT_NODE) { - Element element = (Element) nodeList.item(i); - if ("Factor".equals(element.getTagName())) { - return OptionalDouble.of(Double.parseDouble(element.getAttribute("v"))); - } - } - } - return OptionalDouble.empty(); - } - - private void importImplicitProportionalBlock(Element glskBlockElement, String businessType) { + private void importImplicitProportionalBlock(BlockWrapper blockWrapper, String businessType) { this.businessType = businessType; - NodeList nodesList = glskBlockElement.getElementsByTagName("Node"); - for (int i = 0; i < nodesList.getLength(); i++) { - Element nodeElement = (Element) nodesList.item(i); - CseGlskRegisteredResource cseRegisteredResource = new CseGlskRegisteredResource(nodeElement); - registeredResourceArrayList.add(cseRegisteredResource); - } + blockWrapper.getNodeList().ifPresent( + nodeList -> nodeList.stream() + .map(CseGlskRegisteredResource::new) + .forEach(registeredResourceArrayList::add)); } public int getOrder() { diff --git a/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/NodeWrapper.java b/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/NodeWrapper.java new file mode 100644 index 00000000..87187b98 --- /dev/null +++ b/glsk/glsk-document-cse/src/main/java/com/powsybl/glsk/cse/NodeWrapper.java @@ -0,0 +1,63 @@ +/* + * Copyright (c) 2023, RTE (http://www.rte-france.com) + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + */ +package com.powsybl.glsk.cse; + +import xsd.etso_core_cmpts.QuantityType; + +import java.math.BigDecimal; +import java.util.Optional; + +/** + * @author Vincent BOCHET {@literal } + */ +public final class NodeWrapper { + private final Object node; + + public NodeWrapper(Object node) { + this.node = node; + } + + public Object getNode() { + return node; + } + + public Optional getName() { + try { + NodeNameType name = (NodeNameType) node.getClass().getDeclaredField("name").get(node); + return Optional.ofNullable(name).map(NodeNameType::getV); + } catch (NoSuchFieldException | IllegalAccessException e) { + return Optional.empty(); + } + } + + public Optional getFactor() { + try { + QuantityType factor = (QuantityType) node.getClass().getDeclaredField("factor").get(node); + return Optional.ofNullable(factor).map(QuantityType::getV); + } catch (NoSuchFieldException | IllegalAccessException e) { + return Optional.empty(); + } + } + + public Optional getPmin() { + try { + QuantityType pmin = (QuantityType) node.getClass().getDeclaredField("pmin").get(node); + return Optional.ofNullable(pmin).map(QuantityType::getV); + } catch (NoSuchFieldException | IllegalAccessException e) { + return Optional.empty(); + } + } + + public Optional getPmax() { + try { + QuantityType pmax = (QuantityType) node.getClass().getDeclaredField("pmax").get(node); + return Optional.ofNullable(pmax).map(QuantityType::getV); + } catch (NoSuchFieldException | IllegalAccessException e) { + return Optional.empty(); + } + } +} diff --git a/glsk/glsk-document-cse/src/main/resources/xjb/binding.xjb b/glsk/glsk-document-cse/src/main/resources/xjb/binding.xjb new file mode 100644 index 00000000..f2dc0c18 --- /dev/null +++ b/glsk/glsk-document-cse/src/main/resources/xjb/binding.xjb @@ -0,0 +1,8 @@ + + + + + + + + \ No newline at end of file diff --git a/glsk/glsk-document-cse/src/main/resources/xsd/etso-code-lists.xsd b/glsk/glsk-document-cse/src/main/resources/xsd/etso-code-lists.xsd new file mode 100644 index 00000000..f8ba1860 --- /dev/null +++ b/glsk/glsk-document-cse/src/main/resources/xsd/etso-code-lists.xsd @@ -0,0 +1,10702 @@ + + + + + Current version 66 + Complete compilation of ENTSO-E Code Lists used by ENTSO-E XML electronic documents and CIM XML electronic documents. + Current Release: 0 + 2019-10-18 + + + + + + ET0040 + The identification of the method of allocation in an auction. + + + + + + + + Order by price with pro rata + The allocation method is by price with eventual pro rata. + + + + + + + + + Order by price with first come - first served + The allocation method is by price with eventual use of first come first served. + + + + + + + + + First come - First served + The allocation method is first come first served. + + + + + + + + + Pro rata + The allocation method is pro rata. + + + + + + + + + Continuous + The allocation method is continuous, i.e. there is no gate closure time when bids from the market participants are collected. Instead allocation procedure takes place immediately. + + + + + + + + + + MXM000 + The identification of an analog value. + + + + + + + + Flow + This is the computed flow for the monitored element in the constraint situation ("N situation", "N-1 situation" ...) after the capacity calculation. The flow is expressed in A, %, or MW. + + + + + + + + + Permanent admissible transmission limit (PATL) + The permanent load of transmission system elements which is allowed for an unlimited period and which does not cause physical damage to the transmission system elements as long as the defined threshold is respected. + + + + + + + + + Flow reliability margin + This is the flow reliability margin for a given critical network element. The amount of MW or A that is reserved for this critical network element and shall not be used for the computed outage situation, in order to secure the power network. + + + + + + + + + Spanning margin value + This is the margin that is taken into account when spanning (fall-back process) is applied. Spanning marginal value is an historical based parameter which specifies the amount of MW that reduces the RAM when spanning is applied. + + + + + + + + + Long term allocation margin + This is the amount of MW that is added to the capacity of the critical network element in order to automatically include the long term allocation domain into the flow based domain. + + + + + + + + + Final adjustment margin value + This is the margin that is manually added or subtracted to the capacity of the critical network element. A negative value for final adjustment value simulates the effect of an additional margin due to complex remedial actions (RA) which cannot be modeled and so calculated in the flow based parameter calculation. A positive value for FAV as a consequence of the verification phase of the flow based domain, leading to the need to reduce the margin on one or more CBs for system security reasons. + + + + + + + + + Transitory admissible transmission limit (TATL) + The temporary overload of transmission system elements which is allowed for a limited period and which does not cause physical damage to the transmission system elements as long as the defined duration and thresholds are respected. + + + + + + + + + Long admissible flow + This is the value, expressed in A or MW, that the overload flow in a network element shall not exceed for a duration no longer than the long duration. The long duration value depends on the TSO network operating rules. + + + + + + + + + Negative Final adjustment margin value + This is the margin that is manually added to the capacity of the critical network element in order to simulate the effect of an additional margin due to complex remedial actions (RA) which cannot be modeled and so calculated in the flow based parameter calculation. + + + + + + + + + Minimum voltage level + This is the minimum voltage that can be supported by a network element without involving a risk for the security of supply. + + + + + + + + + Maximum voltage level + This is the maximum voltage that can be supported by a network element without involving a risk for the security of supply. + + + + + + + + + TATL after automatic RA + The Transitory admissible transmission limit (TATL) which is allowed after an automatic Remedial Action (RA) has been applied. + + + + + + + + + TATL after curative RA + The Transitory admissible transmission limit (TATL) which is allowed after a curative Remedial Action (RA) has been applied. + + + + + + + + + Computed Voltage + This is the computed voltage for a given monitored element. + + + + + + + + + Zero-Balance flow + This is the amount of power affected by a contingency that reflects a situation with a scheduled exchange of zero. + + + + + + + + + Available margin after remedial actions + This is the available flow margin adjusted for the consideration of remedial actions in capacity calculation. + + + + + + + + + Loss Factor + This is the loss factor for an asset. + + + + + + + + + Adjustment for minimum RAM + This is the adjustment applied to the capacity of a branch to have a minimum RAM (Remaining Available Margin) available for commercial exchanges. + + + + + + + + + Tap changer + The position of a Tap changer. + + + + + + + + + Regulator mode + A measurement type indicating the control mode of a regulator, i.e. from voltage regulation to fixed MVAR regulation. + + + + + + + + + Regulator set-point + The set-point of a regulator. A regulator can be a tap changer, a synchronous machine, a SVC or a shunt. + + + + + + + + + Reference Flow + This is the amount of power affected by a contingency that reflects a situation with scheduled exchanges from a reference situation. + + + + + + + + + + ET0031 + The identification of the type of asset. + + + + + + + + Tieline + A high voltage line used for cross border energy interconnections. + + + + + + + + + Line + A specific electric line within a country. + + + + + + + + + Resource Object + A resource that can either produce or consume energy. + + + + + + + + + Generation + A resource that can produce energy. + + + + + + + + + Load + A resource that can consume energy. + + + + + + + + + Phase Shift Transformer + An electrical device for controlling the power flow through specific lines in a power transmission network. + + + + + + + + + Circuit Breaker + An electrical switch designed to protect an electrical circuit from damage caused by overcurrent/overload or short circuit. + + + + + + + + + Busbar + A specific element within a substation to connect grid elements for energy distribution purposes. + + + + + + + + + Capacitor + A transmission element designed to inject reactive power into the transmission network. + + + + + + + + + Inductor + A transmission element designed to compensate reactive power in the transmission network. + + + + + + + + + Power plant connection + All the network equipment that link the generating unit to the grid. + + + + + + + + + FACTS + Flexible Alternating Current Transmission System + + + + + + + + + Biomass + A resource using biomass for energy. + + + + + + + + + Fossil Brown coal/Lignite + A resource using Fossil Brown coal/Lignite for energy. + + + + + + + + + Fossil Coal-derived gas + A resource using Fossil Coal-derived gas for energy. + + + + + + + + + Fossil Gas + A resource using Fossil Gas for energy. + + + + + + + + + Fossil Hard coal + A resource using Fossil Hard coal for energy. + + + + + + + + + Fossil Oil + A resource using Fossil Oil for energy. + + + + + + + + + Fossil Oil shale + A resource using Fossil Oil shale for energy. + + + + + + + + + Fossil Peat + A resource using Fossil Peat for energy. + + + + + + + + + Geothermal + A resource using Geothermal for energy. + + + + + + + + + Hydro Pumped Storage + A resource using Hydro Pumped Storage for energy. + + + + + + + + + Hydro Run-of-river and pondage + A resource using Hydro Run-of-river and pondage for energy. + + + + + + + + + Hydro Water Reservoir + A resource using Hydro Water Reservoir for energy. + + + + + + + + + Marine + A resource using Marine for energy. + + + + + + + + + Nuclear + A resource using Nuclear for energy. + + + + + + + + + Other renewable + A resource using Other renewable for energy. + + + + + + + + + Solar + A resource using Solar for energy. + + + + + + + + + Waste + A resource using Waste for energy. + + + + + + + + + Wind Offshore + A resource using Wind Offshore for energy. + + + + + + + + + Wind Onshore + A resource using Wind Onshore for energy. + + + + + + + + + Other + A resource using other sources for producing energy. + + + + + + + + + AC Link + Overhead line or cable which is used to transmit electrical power via Alternative Current. + + + + + + + + + DC Link + Overhead line or cable which is used to transmit electrical power via Direct Current. + + + + + + + + + Substation + An assembly of equipment in an electric power system through which electric energy is passed for transmission, transformation, distribution or switching. + + + + + + + + + Transformer + Electrical device that transfers energy from one voltage level to another voltage level. + + + + + + + + + + ET0030 + The coded representation of different types of auction. + + + + + + + + Implicit + The auction is an implicit auction. + + + + + + + + + Explicit + The auction is an explicit auction. + + + + + + + + + Rule Based + The auction is a rule based auction. + + + + + + + + + Mixed + The auction is partially implicit and partially explicit. + + + + + + + + + Explicit/split + The auction concerns two explicit auctions on a split border. + + + + + + + + + Shadow auction + An explicit auction carried out in the case of the failure of an implicit auction. + + + + + + + + + Flow-based + The allocation is an implicit auction using flow-based capacity calculation. + + + + + + + + + + ET0017 + The exact business nature identifying the principal characteristic of a time series. + + + + + + + + Generation Shift Key + + + + + + + + + + Load Shift Key + + + + + + + + + + Production + The nature of the business being described is production details. + + + + + + + + + Internal trade + The nature of the business being described is internal trade details. + + + + + + + + + External trade explicit capacity + The nature of the business being described is external trade details between two areas with limited capacity requiring a capacity agreement identification. + + + + + + + + + Consumption + The nature of the business being described is consumption details. + + + + + + + + + External trade total + The nature of the business being described is external trade total. + + + + + + + + + External trade without explicit capacity + The nature of the business being described is external trade details between two areas without requiring capacity allocation information. + + + + + + + + + Net Production / Consumption + Net production/consumption - where signed values will be used. +With the following rules: In area=Out area, In party=Out party, + means production and - means consumption. + + + + + + + + + Net internal trade + Net internal trade - where the direction from out party (seller) to in party (buyer) is positive and the opposite direction is negative (with minus signs). + + + + + + + + + IPP (Independent Power Producer) + A time series concerning the production schedule from an IPP. + + + + + + + + + Tertiary control + A time series concerning tertiary reserve. + + + + + + + + + Primary control + A time series concerning primary reserve. + + + + + + + + + Secondary control + A time series concerning secondary reserve. + + + + + + + + + Load profile + A time series concerning a load profile as calculated by a metered data aggregator. + + + + + + + + + Aggregated energy data + A time series concerning adjusted metered readings received from a metered data collector and aggregated and validated by a metered data aggregator. + + + + + + + + + Losses + A time series concerning losses that have been calculated for a tieline or an area. + + + + + + + + + Transits (CBT) + A time series concerning inter area transit flows determined for CBT requirements. + + + + + + + + + Settlement deviation + A time series concerning the imbalance energy calculated by an imbalance settlement responsible. + + + + + + + + + Technical constraint deviation + A time series defining the imbalance between schedules accepted by the system operator due to technical constraints and schedules declared by the balance responsible party. + + + + + + + + + Balance energy deviation + A time series defining the imbalance between the schedule of a balance responsible party that has been corrected by the system operator after using balance energy bids and the schedule that was accepted by the system operator due to technical constraints. + + + + + + + + + Imbalance volume + A time series defining the imbalance between the actual meter readings and the schedule of the balance responsible party corrected by the system operator after using balance energy bids. + + + + + + + + + Inadvertent deviation + A time series concerning tieline deviation. + + + + + + + + + Frequency control + A time series concerning primary and secondary reserve. + + + + + + + + + Balance management + A time series concerning energy balancing services. + + + + + + + + + Total trade + A time series concerning the total of both the internal and external trades. + + + + + + + + + General Capacity Information + A time series providing the total capacity available on a TSO border. + + + + + + + + + Available transfer capacity (ATC) + Available transfer capacity for cross-border exchanges. + + + + + + + + + Net transfer capacity (NTC) + Net transfer capacity for cross-border exchanges. + + + + + + + + + Control Area Program + A time series providing the total exchanges between two TSOs (including the commercial transactions, the compensation program and the losses compensation program). +Note this definition might change when UCTE brings forward its coding requirements. + + + + + + + + + Already allocated capacity (AAC) + The already allocated capacity is the total amount of allocated transmission rights. + + + + + + + + + Internal inter area trade + A trade that occurs between internal areas within a market balance area. + + + + + + + + + Offered Capacity + The time series provides the offered capacity. + + + + + + + + + Capacity transfer notification + The time series provides information concerning the notification of the transfer of capacity to another market participant. + + + + + + + + + Authorised AAC + The time series in question provides the amount of transmission capacity rights to be nominated. + + + + + + + + + Capacity rights + The time series in question provides the capacity rights allocated for a given border. + + + + + + + + + Minimum authorised AAC + The time series in question provides the minimum amount of transmission capacity rights to be nominated. + + + + + + + + + Maximum authorised AAC + The time series in question provides the maximum amount of transmission capacity rights to be nominated. + + + + + + + + + Installed generation + The time series in question provides the installed generation. + + + + + + + + + Available generation + The time series in question provides the available generation. + + + + + + + + + Interconnection Trade Responsible Designation + The Time series in question provides the designation of the ITR that may nominate the capacity in question. + + + + + + + + + Released AAC + The already allocated capacity (AAC) that has been released for resale. + + + + + + + + + Requested capacity (with price) + The time series in question provides information concerning the requested capacity including price information. + + + + + + + + + Requested capacity (without price) + The time series in question provides information concerning the requested capacity but excludes price information. + + + + + + + + + Compensation program + Compensation of unintentional deviation is performed by exporting to / importing from the interconnected system during the compensation period by means of schedules as calculated during the accounting of unintentional deviations. + + + + + + + + + Schedule activated reserves + The cross border or internal reserves that are to be activated through schedule nomination. + + + + + + + + + System Operator redispatching + The cross border redispatching between System Operators that are to be activated through schedule nomination. + + + + + + + + + Market capacity price + The price of the capacity offered on a given market. + + + + + + + + + Market capacity price differential + The difference between the price of capacity in a Market Balance Area receiving the capacity (In Area) and the price of capacity in a Market Balance Area providing the capacity (Out Area), i.e. In Area Price - Out Area price. + + + + + + + + + Inflow + The volume of water that flows into a reservoir in a given interval. + + + + + + + + + Water extraction + The volume of water that can be extracted from a reservoir in a given interval. + + + + + + + + + Turbined water + The volume of water that can be turbined in a plant in a given interval. + + + + + + + + + Water spillage + The volume of water that is not turbined going through the spillway in a given interval. + + + + + + + + + Planned maintenance + Maintenance has been planned for the object in question with a forecast ending date. + + + + + + + + + Unplanned outage + An unplanned outage has occurred on the object in question. + + + + + + + + + Use it Or Sell it (UIOSI) pricing + The time series provides information on the capacity resold in the "use it or sell it" process and its corresponding price. + + + + + + + + + Compensation for auction cancellation where capacity is for resale + The time series provides information on the compensation of the capacity for resale following an auction cancellation. + + + + + + + + + Resale pricing + For each Physical Transmission Rights holder, this document contains the resold capacity and its corresponding price. + + + + + + + + + Curtailed capacity compensation + The time series provides information to compensate a party when curtailment is applied on the capacity obtained in a previous auction, resale or transfer. + + + + + + + + + Use it Or Sell it (UIOSI) compensation + The time series provides information on the compensation for the capacity following an auction cancellation. + + + + + + + + + Minimum possible + The time series provides a schedule of minimum possible values for a Resource Object. The nature of the flow could be defined by the attribute Direction. + + + + + + + + + Maximum available + The time series provides a schedule of maximum available values for a Resource Object. The nature of the flow could be defined by the attribute Direction. + + + + + + + + + Spot price + The time series provides the market spot prices from an auction. + + + + + + + + + Minimum ATC + The Available Transmission Capacity that must be guaranteed because of regulatory constraints. + + + + + + + + + Meter Measurement data + The data as provided for a meter measurement source. + + + + + + + + + Accounting Point Relevant data + The metered data that is to be considered relevant for accounting purposes. + + + + + + + + + Energy flow + Energy flow information. + + + + + + + + + Power plant energy Schedule + Energy flow scheduled for a power plant. + + + + + + + + + Compensation Requirements for the compensation period + The time series provides the compensation requirements for a given compensation period. + + + + + + + + + Market coupling results + The time series provides the results of a market coupling auction. + + + + + + + + + Production, unavailable + Production capacity that normally would be available, but due to maintenance or similar is temporarily unavailable. + + + + + + + + + Supplementary available generation + The supplementary generation that is available. + + + + + + + + + Interruptible consumption + The consumption that may be interrupted on request. + + + + + + + + + Summarised Market Balance Area Schedule + A time series providing the total exchanges based on commercial transactions between two Market Balance Areas. + + + + + + + + + Load Frequency Control Program Schedule + A time series providing the schedule information for the Load Frequency Control Program. + + + + + + + + + Timeframe Independent Schedule + A time series providing the total exchanges of Timeframe Independent Schedules between two System Operators. + + + + + + + + + Consumption curtailment + A time series providing the amount of voluntary consumption curtailed by the energy supplier of an end-consumer. + + + + + + + + + Production, dispatchable + The nature of the business being described is dispatchable production details, i.e. generation output that can be changed by a request (activation order) of the TSO according with the applicable Market Rules. + + + + + + + + + Consumption, dispatchable + The nature of the business being described is dispatchable consumption details, i.e. consumption output that can be changed by a request (activation order) of the TSO according with the applicable Market Rules. + + + + + + + + + Production, non-dispatchable + The nature of the business being described is non-dispatchable production details, i.e. generation output that cannot be modified by an activation order. + + + + + + + + + Consumption, non-dispatchable + The nature of the business being described is non-dispatchable consumption details, i.e. consumption output that cannot be modified by an activation order. + + + + + + + + + Total Transfer Capacity (TTC) + The Total Transfer Capacity is the maximum exchange program between two areas compatible with operational security standards applicable at each system if future network conditions, generation and load patterns were perfectly known in advance.). + + + + + + + + + Mutual Emergency Assistance Service (MEAS) + The cross border Mutual Emergency Assistance Service between System Operators that are to be activated through schedule nomination. + + + + + + + + + Auction cancelation + The time series covers auction cancellation right. + + + + + + + + + Nomination curtailment + The time series covers nomination curtailment rights + + + + + + + + + Internal redispatch + Redispatch to relieve Market Balance Area internal congestion. + + + + + + + + + Control area balance energy + A sum of secondary, tertiary control as well as other energy that was used to balance a control area. + + + + + + + + + Balancing energy price + Price of energy used to balance. + + + + + + + + + Economised secondary reserve + The activated secondary reserve that had been economised due to pooled reserve management. + + + + + + + + + Spinning reserve + The extra generating capacity that is available by increasing the production of generators that are already connected to the power system. + + + + + + + + + Solar + The business being described concerns solar power. + + + + + + + + + positive forecast margin + The business being described concerns a positive forecast margin. + + + + + + + + + Negative forecast margin + The business being described concerns a negative forecast margin. + + + + + + + + + Wind generation + The business being described concerns wind generation. + + + + + + + + + Solar generation + The business being described concerns solar generation. + + + + + + + + + Frequency containment reserve + The business being described concerns frequency containment reserve. + + + + + + + + + Automatic frequency restoration reserve + The business being described concerns automatic frequency restoration reserve. + + + + + + + + + Manual frequency restoration reserve + The business being described concerns manual frequency restoration reserve. + + + + + + + + + Replacement reserve + The business being described concerns replacement reserve. + + + + + + + + + Financial information + The business being described concerns financial information. + + + + + + + + + Interconnector network evolution + The business being described concerns interconnector network evolution. + + + + + + + + + Interconnector network dismantling + The business being described concerns interconnector network dismantling. + + + + + + + + + Counter trade + The business being described concerns counter trades. + + + + + + + + + Congestion costs + The business being described concerns congestion costs. + + + + + + + + + Capacity allocated (including price) + The business being described concerns capacity allocation and includes price information. + + + + + + + + + DC link constraint + The business being described concerns DC link constraints. + + + + + + + + + Auction revenue + The business being described concerns auction revenue. + + + + + + + + + Total nominated capacity + The business being described concerns the total nominated capacity. + + + + + + + + + Net position + The business being described concerns net position. + + + + + + + + + Congestion income + The business being described concerns congestion income. + + + + + + + + + Production unit + The business being described concerns a production unit. + + + + + + + + + Rounded market coupling results + Rounded outputs of the market coupling to be sent to TSOs and Market Participants. + + + + + + + + + Allocation Revenue + The time series provides information on the revenue generated by the allocations. + + + + + + + + + Production deviation + A time series concerning the imbalance energy between the metered production and the schedules calculated by an imbalance settlement responsible. + + + + + + + + + Consumption deviation + A time series concerning the imbalance energy between metered consumption and the forecasted consumption calculated by an imbalance settlement responsible. + + + + + + + + + Transmission asset + The business being described concerns a transmission asset. + + + + + + + + + Consumption unit + The business being described concerns a consumption unit. + + + + + + + + + In-feed ATC + Available Transfer Capacity at the in-feed side of a DC tieline. + + + + + + + + + Out-feed ATC + Available Transfer Capacity at the out-feed side of a DC tieline. + + + + + + + + + Balance up regulation price + A time series concerning balance regulation market prices for up regulation. + + + + + + + + + Balance down regulation price + A time series concerning balance regulation market prices for down regulation. + + + + + + + + + Main direction + A time series concerning the direction of balance regulations. + + + + + + + + + Consumption imbalance price + A time series concerning imbalance prices for consumption. + + + + + + + + + Production sales imbalance price + A time series concerning imbalance prices for production sales. + + + + + + + + + Production purchase imbalance price + A time series concerning imbalance prices for production purchase. + + + + + + + + + Average balance price between MBAs + A time series concerning the average prices between Market Balance Areas. + + + + + + + + + Pumped + A time series concerning the electricity consumption related to pumping. + + + + + + + + + Large installation consumption + A time series concerning consumption from large installation. + + + + + + + + + Metering Grid Area (MGA) imbalance + A time series concerning imbalance between reported consumption, production and exchange in a Metering Grid Area. + + + + + + + + + HVDC Link settings + The time series in question provides HVDC Link settings. + + + + + + + + + Transmission Reliability Margin (TRM) + A time series concerning Transmission Reliability Margin (TRM). + + + + + + + + + Imbalance component for a pool + This information is used to provide to a pool manager the combined imbalance of all the pool participants. + + + + + + + + + Area Control error (ACE) + The sum of the instantaneous difference between the actual and the set-point value of the measured total power value and Control Program including Virtual Tie-Lines for the power interchange of a LFC Area or a LFC Block and the frequency bias given by the product of the K-Factor of the LFC Area or the LFC Block and the Frequency Deviation. + + + + + + + + + Area Control Error after Imbalance Netting + A time series concerning the Area Control Error after applying the imbalance netting energy correction. + + + + + + + + + Implicit and explicit trade total + The sum of cross border schedules based on implicit and explicit trades including long term, yearly, monthly, weekly, daily processes. + + + + + + + + + Production units own consumption + The consumption of one or more production units. + + + + + + + + + Constraint situation + The timeseries describes the constraint situation for a given TimeInterval. +A constraint situation can be: +- composed of a list of network elements in outage associated for each outage to a list of network elements on which remedial actions have been carried out accordingly to contingency process +- or it can be an external constraint. + + + + + + + + + Initial domain + The timeseries describe the full flow based domain for a given TimeInterval. +Critical network elements are displayed in details and their impact on the market is quantified. + + + + + + + + + Flow based domain adjusted to long term schedules + The timeseries describe the full flow based domain for a given TimeInterval adjusted to the latest update of the schedules. +Critical network elements are displayed in details and their impact on the market is quantified. + + + + + + + + + Network element constraint + The timeSeries describes limiting elements which are overloaded. + + + + + + + + + Calculation opposition (Red Flag) + The timeSeries describes a party who is opposed to the calculation result and imposes its transfer capacity value. + + + + + + + + + Base case proportional shift key + The GSK or LSK are proportional to the base case generation or load. + + + + + + + + + Proportional to participation factors shift key + The GSK or LSK are proportional to the participation factors. + + + + + + + + + Proportional to the remaining capacity shift key + The GSK is proportional to the remaining available capacity. + + + + + + + + + Merit order shift key + The GSK is proportional to a merit order list. + + + + + + + + + Wind speed + The TimeSeries provides information on the wind speed. + + + + + + + + + Wind direction + The TimeSeries provides information on the wind direction. + + + + + + + + + Solar irradiance + The TimeSeries provides information on the power per unit area produced by the sun in the form of electromagnetic radiation. + + + + + + + + + Air temperature + The TimeSeries provides information on the air temperature. + + + + + + + + + Cloudiness + The TimeSeries provides information on the cloudiness, i.e. the level of coverage of the sky with clouds. + + + + + + + + + Air humidity + The TimeSeries provides information on the level of humidity of the air. + + + + + + + + + Atmospheric pressure + The TimeSeries provides information on the atmospheric pressure. + + + + + + + + + Precipitation + The TimeSeries provides information on the amount of rain, snow, etc. that falls on the ground. + + + + + + + + + Network constraint situation that constraints the market + The TimeSeries describes the network elements, that constraints the market, to be taken into account to simulate a network constraint during the network load flow studies. The network situation includes the contingencies, the remedial actions, the monitored network elements and the potential additional constraints. + + + + + + + + + Contingency + The TimeSeries describes the network elements part of the contingency to be simulated for a given TimeInterval. + + + + + + + + + Remedial Action + The TimeSeries describes a set of remedial actions for a given TimeInterval. + + + + + + + + + Monitored Network Element + The TimeSeries describes the network elements to be monitored during the network load flow studies. + + + + + + + + + Busbar + The TimeSeries describes the network elements that composed a busbar. + + + + + + + + + Network Element + The TimeSeries describes network elements. + + + + + + + + + SPS + The TimeSeries describes the network elements managed by a Special Protection System (automation). + + + + + + + + + Aggregated netted external market schedule + The aggregated netted external market schedules for a given border. + + + + + + + + + Aggregated netted external TSO schedule + The aggregated netted external TSO schedules for a given border. + + + + + + + + + Aggregated netted external schedule + The aggregated netted external schedules for a given border. + + + + + + + + + Netted area AC position + The AC position for a given area. + + + + + + + + + Netted area position + The AC and DC position for a given area. + + + + + + + + + Interconnection shift key + The shift key series describes the amount of power to be shifted from a border area. + + + + + + + + + + DC flow with losses + DC flow with losses refers to the values at the importing end of the DC line. + + + + + + + + + DC flow without losses + DC flow without losses refers to the values at the exporting end of the DC line. + + + + + + + + + minimum value of netted area position + That value which a netted area position must not fall below for a given area. + + + + + + + + + maximum value of netted area position + That value which a netted area position must not exceed for a given optimisation area. + + + + + + + + + maximum value of DC flow + That value which a balanced DC flow must not exceed for a given DC line on exporting end. When aligning DC flows CGMA algorithm will respect this constraint. + + + + + + + + + minimum value of DC flow + That value which a balanced DC flow must not fall below for a given DC line on exporting end. Currently this business type is only included for consistency reasons. It is always set to 0. This constraint might, however, be used in future. When aligning DC flows the CGMA algorithm will respect this constraint. + + + + + + + + + indicative AC flow + It is the hypothetical flow on the aggregate of all AC tie lines of an electrical border between two optimisation areas. It results from the adjustments to the preliminary netted area positions of all optimisation areas made by the CGMA algorithm. Indicative AC flows are an artefact of the CGMA algorithm, and do not correspond to physical flows + + + + + + + + + Offer + The time series provides an offer to provide reserves. + + + + + + + + + Need + The time series provides a requirement for reserves. + + + + + + + + + + Opportunity costs or benefits + The time series describes any opportunity costs or benefits. + + + + + + + + + Financial compensation or penalties + The time series describes any financial compensation or penalties + + + + + + + + + Global radiation + The total short-wave radiation from the Global radiation is the total short-wave radiation from the sky falling onto a horizontal surface on the ground. It includes both the direct solar radiation and the diffuse radiation resulting from reflected or scattered sunlight. + + + + + + + + + Diffuse radiation + Radiation resulting from reflected or scattered sunlight. + + + + + + + + + Direct solar radiation + Radiation resulting from direct sunlight + + + + + + + + + Outage (OUT) + Outage process: Element is out of operation due to planned maintenance or due to an unplanned/forced outage. Outage may be used as a synonym for unavailability. + + + + + + + + + Special switching state (SSS) + Outage Process: This state applies to grid elements which are in operation in an exceptional state (e.g. separated nodes operation). + + + + + + + + + Testing (TEST) + Outage process: TESTING means any element status is possible - ON or OUT. This status applies either between first connection and final commissioning of the relevant asset, or directly following maintenance of the relevant asset. + + + + + + + + + Auxiliary busbar operation + Outage process: Element is in operation but connected via auxiliary busbar + + + + + + + + + Automatic reclosing + Outage process: Protection function Automatic reclosing is switched off for electric line + + + + + + + + + Busbar protection + Protection function busbar protection is switched off + + + + + + + + + Phase Shift Angle + The maximum phase shift angle allowed between two network elements. + + + + + + + + + Base Case Network Situation + The TimeSeries describes the network elements to be taken into account to simulate a base case network situation during the network load flow studies, without any contingency. + + + + + + + + + Inter-TSO assistance + Cross border assistance schedule between TSOs not interconnected directly. + + + + + + + + + FlexibleNeed + The business type indicates that the need is optional. + + + + + + + + + GLSK Limitation + A constraint related to a GLSK maximum or minimum limitation in the production or/and consumption shift. + + + + + + + + + Capacity ramping limitation + A constraint related to a ramping limitation on the capacity offered at a given border. + + + + + + + + + interconnector capacity + The maximum capacity that can be exchanged on an interconnector, excluding external factor on both ends. + + + + + + + + + Must Run + A time series concerning must run generation. + + + + + + + + + Procured capacity + An accepted offer of balancing capacity. + + + + + + + + + Used capacity + The used cross-zonal balancing capacity. + + + + + + + + + Estimated costs + Estimated costs of the process. + + + + + + + + + Estimated benefits + Estimated benefits of the process. + + + + + + + + + Load Shedding + A time series concerning a load shedding used to avoid failure of the power system. + + + + + + + + + Remaining Capacity + A time series concerning the remaining capacity. + + + + + + + + + Indicator of generation capacity adequacy + Indicator of adequacy, it indicates if there is final generation remaining capacity after SMTA calculation. + + + + + + + + + Income from price divergence without congestions + The time series describes income due to price divergence without congestion between bidding zones. + + + + + + + + + Push-button + The cross-border Push-button service between System Operators. + + + + + + + + + Intertripping + The cross-border Intertripping service between System Operators. + + + + + + + + + Emergency instruction + The cross-border Emergency instruction service between System Operators. + + + + + + + + + Ramp management + The schedule resulting from cross-border Ramp management service between System Operators. + + + + + + + + + Profile smoothing + The schedule resulting from cross-border Profile smoothing service between System Operators. + + + + + + + + + Emergency reallocation deselection + The schedule resulting from cross-border Emergency reallocation deselection service between System Operators. + + + + + + + + + SO-SO-trade + The generic cross border trade between System Operators. + + + + + + + + + Production reduction + A time series providing the volume of production reduced by an energy provider / producer / supplier. + + + + + + + + + Maximum power exchange + The timeseries provides the maximum admissible power flow between two bidding zones respecting operational security limits taking into account N-1 criterion. + + + + + + + + + Maximum power exchange after remedial actions + The timeseries provides the maximum admissible power flow between two bidding zones after remedial actions. + + + + + + + + + Network constraint situation that cannot limit the market + The TimeSeries describes the network elements, that cannot limit the market, to be taken into account to simulate a network constraint during the network load flow studies. The network situation includes the contingencies, the remedial actions, the monitored network elements and the potential additional constraints. + + + + + + + + + Flat participation for all generators or loads + Flat GSK factors of all generators or loads, independently of the size. + + + + + + + + + Proportional to installed capacity of generators + Generators participate relative to their maximum (installed) capacity (MW). + + + + + + + + + Market price and total volume + A time series concerning market price and total volume. + + + + + + + + + Import price + A time series concerning import price (the volume-weighted price average of all accepted bids). + + + + + + + + + Capacity allocated (excluding price) + The business being described concerns capacity allocation and excludes price information. + + + + + + + + + Common Grid Model Equipment + The timeseries provides equipment related to the Common Grid Model (CGM). + + + + + + + + + Exchanged balancing reserve capacity + The balancing reserve capacity exchanged between areas. + + + + + + + + + Shared balancing reserve capacity + The balancing reserve capacity shared between areas. + + + + + + + + + Share of reserve capacity + A time series concerning the share of reserve capacity. + + + + + + + + + Actual reserve capacity + A timeseries concerning actual reserve capacity. + + + + + + + + + + ET0037 + The product category of an auction. + + + + + + + + Base + The auction is for a base period. + + + + + + + + + Peak + The auction is for a peak period. + + + + + + + + + Off peak + The auction is for an off peak period. + + + + + + + + + Hourly + The auction is for an hourly period. + + + + + + + + + + ET0013 + Indicates the classification mechanism used to group a set of objects together. The grouping may be of a detailed or a summary nature. + + + + + + + + Detail type + The Time Series content provides detailed information. + + + + + + + + + Summary type + The Time Series content provides aggregated information. + + + + + + + + + + ET0004 + Codification scheme used to identify the coding scheme used for the set of coded values to identify specific objects. + + + + + + + + EIC + The coding scheme is the Energy Identification Coding Scheme (EIC), maintained by ENTSO-E. + + + + + + + + + CGM + The coding scheme used for Common Grid Model Exchange Standard (CGMES). + + + + + + + + + GS1 + The coding scheme for the preceding attribute is the Global Location Number (GLN 13) or Global Service Relation Number (GSRN 18), maintained by GS1. + + + + + + + + + Andorra National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Albania National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Armenia National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Austria National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Azerbaijan National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Bosnia and Herzegovina National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Belgium National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Bulgaria National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Switzerland National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Serbia and Montenegro National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Czech Republic National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Germany National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Denmark National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Estonia National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Spain National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Finland National coding scheme + The National coding scheme of the country in question. + + + + + + + + + France National coding scheme + The National coding scheme of the country in question. + + + + + + + + + United Kingdom National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Georgia National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Gibraltar National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Greece National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Croatia National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Hungary National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Ireland National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Italy National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Kyrgyzstan National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Kazakhstan National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Liechtenstein National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Lithuania National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Luxembourg National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Latvia National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Morocco National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Moldavia National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Macedonia National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Netherlands National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Nordic Regional coding scheme + The coding scheme of the Nordic region which covers Denmark, Finland, Norway and Sweden. + + + + + + + + + Norway National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Poland National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Portugal National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Romania National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Russian Federation National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Sweden National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Slovenia National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Slovakia National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Turkey National coding scheme + The National coding scheme of the country in question. + + + + + + + + + Ukraine National coding scheme + The National coding scheme of the country in question. + + + + + + + + + + ET0108 + The identification of the coordinate system used for the location position. + + + + + + + + ED50 + ED 50 (European Datum 1950) is a geodetic datum which was defined after World War II for the international connection of geodetic networks. + + + + + + + + + OSGB36 + Ordinance Survey Great Britain 1936. The Ordinance Survey (OS) devised the national grid reference system, and it is heavily used in their survey data, and in maps (whether published by the Ordinance Survey or commercial map producers) based on those surveys. + + + + + + + + + WGS84 + The World Geodetic System version 1984. for use in cartography, geodesy, and navigation including by GPS. It comprises a standard coordinate system for the earth, a standard spheroidal reference surface (the datum or reference ellipsoid) for raw altitude data, and a gravitational equipotential surface (the geoid) that defines the nominal sea level. + + + + + + + + + GTRF + Galileo Terrestrial Reference Frame + + + + + + + + + + ET0010 + The contract type defines the conditions under which the capacity is allocated and handled, e.g. daily auction, weekly auction, monthly auction, yearly auction, etc. +The significance of this type is dependent on area specific coded working methods. + + + + + + + + Daily + The condition under which capacity is allocated and handled is by daily auction or a daily transmission allocation procedure. + + + + + + + + + Weekly + The condition under which capacity is allocated and handled is by weekly auction or a weekly transmission allocation procedure. + + + + + + + + + Monthly + The condition under which capacity is allocated and handled is by monthly auction or a monthly transmission allocation procedure. + + + + + + + + + Yearly + The condition under which capacity is allocated and handled is by yearly auction or a yearly transmission allocation procedure. + + + + + + + + + Total + This is the sum of all capacity contract types for the period covered. + + + + + + + + + Long term contract + The condition under which capacity is allocated and handled is by long term trade agreements according to European regulations (EU Directive 1228/2003). + + + + + + + + + Intraday contract + The condition under which the capacity is allocated and handled is through an intraday auction and allocation process. + + + + + + + + + Quarter yearly + The condition under which capacity is allocated and handled is by quarter yearly auction or a quarter yearly transmission allocation procedure. + + + + + + + + + Semestrial + The condition under which capacity is allocated and handled is by half yearly auction or a half yearly transmission allocation procedure. + + + + + + + + + Multiple year + The condition under which capacity is allocated and handled is by multiple year auctions. + + + + + + + + + Intraday balancing mechanism + The condition under which the capacity is allocated and handled is through intraday energy balancing services. + + + + + + + + + Historical contract + A Contract established before the EU directive that are valid until the term of the contract. + + + + + + + + + Hourly + The condition under which capacity is allocated and handled is by hourly auctions. + + + + + + + + + + ET0024 + The coded identification of legal tender using ISO 4217 3 alpha codes. + + + + + + + + Bosnian convertible marka + The Legal tender of Bosnia and Herzegovina. + + + + + + + + + Bulgarian lev + The Legal tender of Bulgaria. + + + + + + + + + Swiss Franc + The Legal tender of Switzerland. + + + + + + + + + Czech Koruna + The legal tender of the Czech Republic. + + + + + + + + + Danish Kroner + The Legal tender of Denmark. + + + + + + + + + EURO + The European legal tender. + + + + + + + + + Pound Sterling + The Legal tender of the United Kingdom. + + + + + + + + + Croatian kuna + The legal tender of Croatia. + + + + + + + + + Hungarian Forint + The Legal tender of Hungary. + + + + + + + + + Icelandic krona + The Legal tender of Iceland. + + + + + + + + + Albanian lek + The Legal tender of Albania. + + + + + + + + + Lithuanian litas + The Legal tender of Lithuania + + + + + + + + + Macedonian denar + The Legal tender of FYROM. + + + + + + + + + Norwegian Kroner + The Legal tender of Norway. + + + + + + + + + Polish zloty + The Legal tender of Poland. + + + + + + + + + Romanian Leu + The Legal tender of Romania. + + + + + + + + + Serbian dinar + The Legal tender of Serbian Republic. + + + + + + + + + Saudi Arabian Riyal + The Legal tender of Saudi Arabia. + + + + + + + + + Swedish kroner + The Legal tender of Sweden. + + + + + + + + + Slovak Koruna + The legal tender of Slovakia. + + + + + + + + + New Turkish Lira + The Legal tender of Turkey. + + + + + + + + + Ukrainian hryvnia + The legal tender of Ukraine. + + + + + + + + + US Dollar + The legal tender of the USA. + + + + + + + + + + ET0042 + The type of curve being defined in the time series. + + + + + + + + Sequential fixed size block + The curve is made of successive Intervals of time (Blocks) of constant duration (size), where the size of the Blocks is equal to the Resolution of the Period. + + + + + + + + + Point + The curve is made of successive instants of time (Points). + + + + + + + + + Variable sized Block + The curve is made of successive Intervals of time (Blocks) of variable duration (size), where the end date and end time of each Block are equal to the start date and start time of the next Interval. For the last Block the end date and end time of the last Interval would be equal to EndDateTime of TimeInterval. + + + + + + + + + Overlapping breakpoint + The curve is made of successive Intervals of time of variable duration (size), where the end date and end time of each interval are equal to the start date and start time of the next Interval. + + + + + + + + + Non-overlapping breakpoint + This curve is a restriction of the curve type A04, i.e. overlapping breakpoints. The restriction is that a single Period is allowed. + + + + + + + + + + ET0026 + The coded identification of the direction of energy flow. + + + + + + + + UP + Up signifies that the available power can be used by the Purchasing area to increase energy. + + + + + + + + + DOWN + Down signifies that the available power can be used by the Purchasing area to decrease energy. + + + + + + + + + UP and DOWN + Up and Down signifies that the UP and Down values are equal. + + + + + + + + + Stable + The direction at a given instant in time is considered to be stable. + + + + + + + + + + ET0028 + The coded identification of the type of an EIC code. + + + + + + + + Substation + An EIC code to substations. + + + + + + + + + Tieline + An EIC code to identify tielines. + + + + + + + + + Location + An EIC code to identify locations. + + + + + + + + + Resource Object + An EIC code to identify resource objects. + + + + + + + + + Party + An EIC code to identify parties. + + + + + + + + + Area or Domain + An EIC code to identify areas or domains. + + + + + + + + + Measurement point + An EIC code to identify measurement points. + + + + + + + + + + ET0008 + The identification of the nature of an energy product such as power, energy, reactive power, etc. + + + + + + + + Active power + The product of voltage and the in-phase component of alternating current measured in units of watts and standard multiples thereof. + + + + + + + + + Reactive power + The product of voltage and current and the sine of the phase angle between them, measured in units of voltamperes reactive and standard multiples thereof. (not used for planned schedules). + + + + + + + + + Active energy + The electrical energy produced, flowing or supplied by an electrical circuit during a time interval, being the integral with respect to time of instantaneous active power, measured in units of watt-hours, or standard multiples thereof. + + + + + + + + + Reactive energy + The integral with respect to time of reactive power (not used for planned schedules). + + + + + + + + + Capacitive reactive power + Capacitive reactive power. + + + + + + + + + Inductive reactive power + Inductive reactive power. + + + + + + + + + Capacitive Reactive energy + Capacitive reactive energy. + + + + + + + + + Inductive Reactive energy + Inductive reactive energy. + + + + + + + + + Water + For hydro power stations, this enables the identification of the quantity of water stored behind a dam (volume, head level, etc.), or the constraints in the flow of water. + + + + + + + + + + MXM000 + The coded identification of the HVDC mode. + + + + + + + + Setpoint schedule + The code for the "power setpoint" mode of operation of the HVDC link. + + + + + + + + + Proportional external signal + The code for the "Proportional external signal" mode of operation of the HVDC link. + + + + + + + + + AC emulation + The code for the "AC emulation" mode of operation of the HVDC link. + + + + + + + + + + ET0029 + A boolean indicator to express Yes or No or True or False. + + + + + + + + YES + A positive indication. + + + + + + + + + NO + A negative indication. + + + + + + + + + + ET0003 + The coded type of a document. The message type describes the principal characteristic of a document. +This enumeration is used in the XML instances based on IEC 62325. + + + + + + + + GSK document + Generation Shift Key + + + + + + + + + Balance responsible schedule + A schedule which has been prepared by a balance responsible party providing planned schedule information. + + + + + + + + + Allocated capacity schedule + A schedule which has been prepared by a capacity allocator providing allocated capacity. + + + + + + + + + Balance area schedule + A schedule that provides the planned schedule information for a balance area. + + + + + + + + + System Operator area schedule + A compilation of all external schedules concerning two System Operator areas or a connector concerning two System Operator of all balance responsible parties. + + + + + + + + + Control block area schedule + A compilation of all the exchange programs of all control areas for one control block with all neighbouring control areas of a neighbouring control block. + + + + + + + + + Coordination center area schedule + A compilation of the exchange programs of all exchange blocks divided into UCTE south and north. + + + + + + + + + Intermediate confirmation report + An intermediate confirmation report that may be produced between final cutoffs. + + + + + + + + + Final confirmation report + A final confirmation report that is produced after a final cutoff. + + + + + + + + + Finalised schedule + A compilation of a set of schedules that have been finalized after a given cutoff. + + + + + + + + + Regulation data report + A compilation of the time series employed on a given day to ensure the balance of the system. + + + + + + + + + Aggregated energy data report + A compilation of the time series of all the meter readings or their equivalent for a given period. + + + + + + + + + Imbalance report + The report containing the complete situation of a given period for a party and including the schedules, regulation data and actual or calculated readings. + + + + + + + + + Interconnection Capacity + Document for cross-border capacity exchanges. + + + + + + + + + Resource Provider Resource Schedule + A document providing the schedules for resource objects submitted by a resource provider. + + + + + + + + + Acquiring System Operator Reserve Schedule + A document providing reserve purchases submitted by an Acquiring System Operator. + + + + + + + + + Anomaly Report + A document providing anomaly information for the receiving party to correct. + + + + + + + + + Acknowledgement Document + A document providing acknowledgement information. + + + + + + + + + Confirmation report + A document providing confirmation information. + + + + + + + + + Capacity for Resale + A document providing information about capacity for resale. + + + + + + + + + Approved Capacity Transfer + A document to approve a capacity transfer. + + + + + + + + + Capacity transfer notification + A document notifying a capacity transfer. + + + + + + + + + Transmission rights portfolio + A document providing the portfolio of the transmission capacity rights of a market participant. + + + + + + + + + Allocations + A document providing the capacity allocations for a border. + + + + + + + + + Bid document + A document providing bid information. + + + + + + + + + Allocation result document + A document providing the allocation results of an auction. + + + + + + + + + Capacity document + A document providing capacity information. + + + + + + + + + Rights document + A document providing transmission capacity rights information. + + + + + + + + + Generation availability schedule + This document contains information related to energy availability. + + + + + + + + + Cross border schedule + This document contains the cross border schedules for all the borders of a given country where energy is exchanged. + + + + + + + + + Agreed capacity + The capacity agreed between parties. + + + + + + + + + Proposed capacity + The capacity proposed for agreement between parties. + + + + + + + + + System vertical load + The sum of all flows out of the transmission grid via directly connected transformers and lines to distribution grids and end consumers as known by the System Operator. + + + + + + + + + Escalation document + A document which requesting the escalation of a situation. + + + + + + + + + Trouble shooting document + A document providing trouble shooting information for the resolution of a problem. + + + + + + + + + Deactivation document + The capacity proposed for agreement between parties. + + + + + + + + + Reserve tender document + The document that is used for the tendering for reserves within the ERRP process. + + + + + + + + + Reserve Allocation Result Document + The document used to provide the results of a Reserve auction. + + + + + + + + + SATCR activation + The document is used to provide the activation of reserves through the SATCR process. + + + + + + + + + DATCR activation + The document is used to provide the activation of reserves through the DATCR process. + + + + + + + + + Activation response + The document is used to provide a response to a request to activate reserves. + + + + + + + + + Tender reduction + The document is used to provide information concerning the reduction of a previously submitted tender. + + + + + + + + + MOL Document + The document is used to provide Merit Order List information. + + + + + + + + + Price Document + The document is used to provide market spot price information. + + + + + + + + + Measurement Value Document + The document is used to provide measurement information from measurement devices. + + + + + + + + + SOAM Document + The document is used to provide system operator accounting data for matching. + + + + + + + + + SOVA Document + The document is used to provide system operator validated accounting data. + + + + + + + + + CCVA Document + The document is used to provide coordination center validated accounting data. + + + + + + + + + Daily settlement document + The document is used to provide daily settlement information. + + + + + + + + + Weekly settlement document + The document is used to provide weekly settlement information. + + + + + + + + + Capacity Auction Specification Document + The document is used to provide capacity auction specification information. + + + + + + + + + Market Coupling Results Document + The document is used to provide the results of a market coupling auction. + + + + + + + + + Outage publication Document + The document is used to provide the outage information for publication. + + + + + + + + + Forced generation outage Document + A document providing information on forced generation outages. + + + + + + + + + Summarised Market Schedule + A compilation of all external schedules concerning two Market Balance Areas of all balance responsible parties. + + + + + + + + + Compensation Program Schedule + A schedule that provides the schedule information for the compensation of unintended deviation. + + + + + + + + + Load Frequency Control Program Schedule + A schedule that provides the schedule information for the Load Frequency Control Program of a Control Area or a Control Block. + + + + + + + + + Timeframe Independent Schedule + A compilation of all external Timeframe Independent Schedules concerning two System Operators. + + + + + + + + + Status request for a status within a process + A status request being made concerning the status of information within the context of a specific ongoing process. + + + + + + + + + status request for a position independently from a specific process + A status request concerning the position of an object independently of any ongoing processes. + + + + + + + + + Estimated Net Transfer Capacity + The estimated net transfer capacity for a given border. + + + + + + + + + Compensation rights + The capacity rights that have been allocated as compensation. + + + + + + + + + Redispatch notice + A notice to confirm the actions agreed between System Operators to resolve a congestion situation through redispatch. + + + + + + + + + Tender reduction response + A response to a tender reduction request that provides corrections to the initial document. + + + + + + + + + System total load + Total load', including losses without power used for energy storage, is equal to generation deducted with exports, added with imports and deducted with power used for energy storage. + + + + + + + + + Final MOL + A document providing the information concerning the situation of the MOL at the end of an activation period. + + + + + + + + + Resource Provider Schedule for production/consumption + A document providing the schedules for production/consumption for resource objects submitted by a resource provider. + + + + + + + + + Installed generation per type + A document providing the installed generation per generation type. + + + + + + + + + Wind and solar forecast + A document providing the forecast of wind and solar generation. + + + + + + + + + Load forecast margin + A document providing the load forecast margin for a period. + + + + + + + + + Generation forecast + A document providing the generation forecast for a period. + + + + + + + + + Reservoir filling information + A document providing information concerning the filling of reservoirs. + + + + + + + + + Actual generation + A document providing the actual generation for a period. + + + + + + + + + Wind and solar generation + A document providing the generation of wind and solar energy for a period. + + + + + + + + + Actual generation per type + A document providing the actual generation per generation type for a period. + + + + + + + + + Load unavailability + A document providing the unavailability of units providing load on the network. + + + + + + + + + Production unavailability + A document providing the unavailability of production units providing energy to the network. + + + + + + + + + Transmission unavailability + A document providing the unavailability of transmission capacity on the network. + + + + + + + + + Offshore grid infrastructure unavailability + A document providing the unavailability of an offshore grid infrastructure to the network. + + + + + + + + + Generation unavailability + A document providing the unavailability of generation units providing energy to the network. + + + + + + + + + Contracted reserves + A document providing the reserves contracted for a period. + + + + + + + + + Accepted offers + A document providing the offers of reserves that have been accepted for a period. + + + + + + + + + Activated balancing quantities + A document providing the quantities of reserves that have been activated for balancing. + + + + + + + + + Activated balancing prices + A document providing the prices of the reserves that have been activated for balancing. + + + + + + + + + Imbalance prices + A document providing the prices of reserves due to imbalance for a period. + + + + + + + + + Imbalance volume + A document providing the volume of the imbalance for a period. + + + + + + + + + Financial situation + A document providing the financial situation for reserves. + + + + + + + + + Cross border balancing + A document providing the cross border balancing requirements for a period. + + + + + + + + + Contracted reserve prices + A document providing the price of reserves contracted for a period. + + + + + + + + + Interconnection network expansion + A document providing information on the expansion of the interconnection network. + + + + + + + + + Counter trade notice + A document providing information on counter trades for a period. + + + + + + + + + Congestion costs + A document providing the cost of congestion for a period. + + + + + + + + + DC link capacity + A document providing the DC links for a period. + + + + + + + + + Non EU allocations + A document providing allocations made to non EU member states. + + + + + + + + + Configuration document + A document providing configuration information. + + + + + + + + + Redispatch activation document + A document enabling the activation of a redispatch notice. + + + + + + + + + Detailed activation history document + A document enabling a detailed history of activations. + + + + + + + + + Aggregated activation history document + A document enabling an aggregated history of activations. + + + + + + + + + HVDC Link constraints + A document providing the information concerning the maximum and minimum active power flow through each link can limited. + + + + + + + + + HVDC Configuration + A document providing the information concerning the power set point. The mode in which the HVDC is managed. + + + + + + + + + HVDC Schedule + A document providing the information for operating DC links. + + + + + + + + + EIC code request + A document providing the information requesting a new EIC code. + + + + + + + + + EIC code information + A document providing EIC information in a central registry exchange or information to an EIC participant. + + + + + + + + + EIC code publication + A document providing EIC publication information in a web site publication of a limited set of information. + + + + + + + + + Critical network element determination + A document providing all the elements necessary for the capacity coordinator to determine the transfer capacity and the associated critical network elements. + + + + + + + + + Critical network element publication + A document providing all the elements necessary for the market information aggregator and TSOs to know the critical network elements which limit the transfer capacity. + + + + + + + + + Flow based domain + A document providing the capacity domain and its limits available for the TSO. + + + + + + + + + Flow based domain publication + A document providing the capacity domain and its limits available for the market. + + + + + + + + + Flow based domain market impact publication + A document providing the capacity domain and its impacts on the market to be published. + + + + + + + + + Anonymized flow based parameters publication + A document providing all the relevant flow based parameters in case of flow based capacity allocation. + + + + + + + + + Critical network element market impact publication + A document providing the critical network elements and its impacts on the market to be published. + + + + + + + + + Weather document + An estimation or prediction in advance of the weather by analysis of meteorological data and the results of what actually happened with the weather. + + + + + + + + + Energy prognosis document + A document to provide the prognosis of energy production/load for a given period. + + + + + + + + + Network constraint document + A document providing the network constraint situations used for the load flow studies. A network constraint situation includes contingencies, monitored elements and remedial actions. + + + + + + + + + Aggregated netted external market schedule document + A document used to report aggregated netted external market schedules for a given border. + + + + + + + + + Aggregated netted external TSO schedule document + A document used to report aggregated netted external TSO schedules for a given border. + + + + + + + + + Reporting status market document + A document used to report the status of aggregated netted external market schedules, aggregated netted external TSO schedules and compensation program schedules on a given border. + + + + + + + + + Reporting information market document + A document used to report the information concerning aggregated netted external schedules, aggregated netted external market schedules, aggregated netted external TSO schedules, compensation program schedules, netted area position schedules and netted area AC position schedules to an interested party. + + + + + + + + + Status request for a reporting information market document + A document requesting the provision of a reporting information document. + + + + + + + + + Reserve need document + Used by a TSO to send its reserve needs. + + + + + + + + + Generation and load shift keys document + A document providing the values of the generation and load shift keys to be used on network model. + + + + + + + + + Offers to be activated + A document containing the outcome of the process, with the list of offers that are to be activated by the TSO concerned and the results for its reserve needs. + + + + + + + + + Clearing price + A document containing the outcome of the process, with the clearing prices for a period. + + + + + + + + + Security analysis report + A document providing a report on a performed security analysis. + + + + + + + + + Aggregated netted external schedule document + A document used to report aggregated netted external schedules for a given border. + + + + + + + + + External TSO schedule + A document used to report external TSO schedules for a given border or interconnector. + + + + + + + + + Move of scheduled production + A document indication a move of scheduled production. + + + + + + + + + PS&LC results document + A document providing Pole Splitting &amp; Loss Calculation results. + + + + + + + + + Notification data market document + A document used to notify data to any information receiver. + + + + + + + + + Additional Constraint document + A document describing additional constraints for a capacity calculation process. + + + + + + + + + Operational state document + A document used for exchanging operational states for grid assets. + + + + + + + + + Published offered capacity + A document providing the most recent values of offered capacity. + + + + + + + + + Market result document + Published prices and volumes + + + + + + + + + Area Configuration document + A document containing the definition of areas. + + + + + + + + + Area Composition document + A document containing the relations between areas, i.e which Metering Grid Areas a Bidding Zone composed of. + + + + + + + + + Connected Areas document + A document containing which other areas an area is connected to i.e. which Metering Grid Areas a Metering Grid Area is connected to. + + + + + + + + + Settlement document + A document providing settlement information. + + + + + + + + + + ET0008 + The identification of the type of a product on a market view + + + + + + + + Standard balancing product + A harmonised balancing product defined by all TSOs for the exchange of balancing services. + + + + + + + + + Specific balancing product + A product different from a standard product. + + + + + + + + + Product from integrated scheduling process + From the EBGL Article 2 (19), means an iterative process that uses at least integrated scheduling process bids that contain commercial data, complex technical data of individual power generating facilities or demand facilities and explicitly includes the start-up characteristics, the latest control area adequacy analysis and the operational security limits as an input to the process. + + + + + + + + + + ET0018 + The identification of the domain that is the common dominator used to aggregate a time series. + + + + + + + + Area + The object being described concerns an area. + + + + + + + + + Metering point + The object being described concerns a metering point. + + + + + + + + + Party + The object being described concerns a party. + + + + + + + + + Agreement Identification + The object being described concerns an agreement identification. + + + + + + + + + Accounting point + The object being described concerns an accounting point. + + + + + + + + + Resource Object + The object being described concerns a resource object. + + + + + + + + + Tieline + The object being described concerns a tieline. + + + + + + + + + Resource type + The object being described concerns a resource type. + + + + + + + + + DC link + The object being described concerns a DC link. + + + + + + + + + AC link + The object being described concerns an AC link. + + + + + + + + + Merchant line + The object being described concerns a merchant line. + + + + + + + + + Bidding zone + The largest geographical area within which market participants are able to exchange energy without capacity allocation. + + + + + + + + + Virtual bidding zone + A non-geographical bidding zone to be able to apply extra constraints to Bidding Zones. + + + + + + + + + Metering grid area + 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. + + + + + + + + + + ET0041 + The identification of the different terms of payment. + + + + + + + + Pay as bid + The amount to be paid shall correspond to the amount bid. + + + + + + + + + Pay as cleared + The amount to be paid shall correspond to the amount calculated for clearing. + + + + + + + + + No payment terms + There are no payment terms to be used. + + + + + + + + + + ET0048 + Indicates the category of the calculation to be applied to a price. + + + + + + + + Category 1 + A category one price calculation is to be applied. + + + + + + + + + Category 2 + A category two price calculation is to be applied. + + + + + + + + + Category 3 + A category three price calculation is to be applied. + + + + + + + + + Excess balance + The category concerns excess balance. + + + + + + + + + Insufficient balance + A category concerns insufficient balance. + + + + + + + + + Average bid price + The average bid price for a given product. + + + + + + + + + Single marginal bid price + The downwards activated bid price or the upwards activated bid price for activated balancing reserves. + + + + + + + + + + ET0049 + The nature of a price, i.e. an impacted area system operator pays to internal market parties or inverse. + + + + + + + + Expenditure. + Expenditure, i.e. the Impacted Area System Operator pays to the internal Market Parties. + + + + + + + + + Income. + Income, i.e. The Impacted Area System Operator receives from the internal Market Parties. + + + + + + + + + + ET0020 + Indicates the nature of process that the document addresses. + + + + + + + + Shift Key Determination + + + + + + + + + + Day ahead + The information provided concerns a day ahead process. + + + + + + + + + Intra day incremental + The information provided concerns an intra day schedule. + + + + + + + + + Inter-area transit + The information provided concerns an inter area transit schedule. The rules governing this process are market dependent + + + + + + + + + System operation closure + The information provided concerns the closure of a given period of both scheduled and regulation information. + + + + + + + + + Metered data aggregation + The information provided concerns the aggregation process of metered information. + + + + + + + + + Imbalance settlement + The information provided concerns the imbalance settlement for a given period for a balance responsible party or parties. + + + + + + + + + Capacity allocation + The information provided concerns the capacity allocation process. + + + + + + + + + Central reconciliation + The process carried out to finalise the imbalance settlement based on actual metered values against provisional values from profiled metering points. + + + + + + + + + Released capacity allocation + The process concerns the notification of capacity rights that are being released. + + + + + + + + + Proposed capacity allocation + The process concerns the proposed capacity to be allocated for a given border. + + + + + + + + + Agreed capacity allocation + The process concerns the capacity that has been agreed for allocation for a border. + + + + + + + + + Long term + The process concerns scheduling all schedules except daily and intraday contracts. + + + + + + + + + Post scheduling adjustment + The process concerns the adjustments made to previous schedules after the period of execution. + + + + + + + + + Forecast + The data contained in the document are to be handled in short, medium, long term forecasting process. + + + + + + + + + Capacity determination + The process of determining the capacity for use. + + + + + + + + + Realised + The process for the treatment of realised data as opposed to forecast data. + + + + + + + + + Schedule day + The process concerns the day ahead, intraday and eventually ex-post scheduling in a single document. The schedule will be transferred within the total position including historic information. + + + + + + + + + Intraday total + This process concerns an intraday schedule which contains the accumulated day ahead and intraday current position. + + + + + + + + + Intraday accumulated + This process concerns a single intraday schedule process where only intraday evolutions occur through version changes. + + + + + + + + + SOMA process + System Operator meter alignment process. + + + + + + + + + SOVM process + System Operator validated measurement process. + + + + + + + + + RGCE accounting process + The document provides ENTSO-E Regional Group Continental Europe accounting process information. + + + + + + + + + CCSR RGCE Settlement + The process concerns the control center settlement report for the whole of the ENTSO-E Regional Group Continental Europe. + + + + + + + + + CBSR Settlement + The process concerns the control block settlement report. + + + + + + + + + CASR Settlement + The process concerns the control area settlement report. + + + + + + + + + Outage information + The process concerns TSO publication of outages on its power system. + + + + + + + + + Reserve resource process + The process being described is for general reserve resources. + + + + + + + + + Primary reserve process + The process being described is for primary reserves. + + + + + + + + + Secondary reserve process + The process being described is for secondary reserves. + + + + + + + + + Tertiary reserve process + The process being described is for tertiary reserves. + + + + + + + + + Week ahead + The process being described is for the week ahead. + + + + + + + + + Month ahead + The process being described is for the month ahead. + + + + + + + + + Year ahead + The process being described is for the year ahead. + + + + + + + + + Contracted + The process being described is for contracted information. + + + + + + + + + Network information + The process being described is for network information. + + + + + + + + + Creation + The process being described is for the creation of information. + + + + + + + + + Modification + The process being described is for the modification of information. + + + + + + + + + Deactivation process + The process being described is for deactivation of information. + + + + + + + + + Synchronisation process + The process being described is for the synchronisation of information. + + + + + + + + + Intraday process + The process being described is for intraday process. + + + + + + + + + Redispatch process + The process being described is for redispatch activation. + + + + + + + + + Activation history process + The process being described is for the provision of an activation history. + + + + + + + + + Flow based domain constraint day-ahead + The information provided concerns the flow-based process in day ahead. + + + + + + + + + Flow based domain constraint intraday + The information provided concerns the flow-based process in intraday. + + + + + + + + + Two days ahead + Two days ahead. + + + + + + + + + Replacement reserve + A process being described is for replacement reserves (RR) to restore or support the required level of frequency restoration reserves. + + + + + + + + + Manual frequency restoration reserve + A process being described is for manual frequency restoration reserves (mFRR). + + + + + + + + + Day-ahead capacity determination + The process run at the day-ahead timeframe to determine the capacity for use. + + + + + + + + + Intraday capacity determination + The process run at the intraday timeframe to determine the capacity for use. + + + + + + + + + Long term capacity determination + The process run at the long term timeframe to determine the capacity for use. + + + + + + + + + Automatic frequency restoration reserve + A process being described is for automatic frequency restoration reserves (aFRR). + + + + + + + + + Frequency containment reserve + A process being described is for frequency containment reserves (FCR). + + + + + + + + + Common Grid Model (CGM) merging process + The process for merging individual grid models to form the common grid model. + + + + + + + + + Coordinated operational security analysis + The process to perform an operational security analysis in a coordinated manner. + + + + + + + + + Exchange of master data + A process for exchanging master data. + + + + + + + + + Frequency restoration reserve + The process being described is for general frequency restoration reserve. + + + + + + + + + FSKAR settlement + The information provided concerns the Financial Settlement of K?f, ACE and ramping period settlement for a given period. + + + + + + + + + + ET0036 + The quality of an object. + + + + + + + + Adjusted + The contents of the object have been adjusted. + + + + + + + + + Not available + The contents of the object are not available. + + + + + + + + + Estimated + The contents of the object are estimated. + + + + + + + + + As provided + The contents of the object are as provided. + + + + + + + + + Incomplete + The contents of the object are calculated based on incomplete data. + + + + + + + + + + ET0015 + The coded motivation of an act. + + + + + + + + Errors not specifically identified + This code is used to identify errors that have not been specifically addressed in the Reason code list. It can be used at any level and refers to the level for which it has been identified. + + + + + + + + + Message fully accepted + The message has been fully accepted for application processing. + + + + + + + + + Message fully rejected + No part of the message has been accepted for application processing, e.g. Global position incomplete. + + + + + + + + + Message contains errors at the time series level + Part of the message contents, i.e. certain time series, has been accepted for application processing. It is necessary to look at the time series level to determine the time series that have been rejected. The time series is excluded from the global position. + + + + + + + + + Time interval incorrect + The schedule time interval is not within the contractual agreement or the period does not agree with the schedule time interval. + + + + + + + + + Sender without valid contract + The sender has no current valid contract with the TSO. The message consequently will be fully rejected. + + + + + + + + + Schedule accepted + The schedule of the recipient as presented has been completely accepted. + + + + + + + + + Schedule partially accepted + The schedule of the recipient as presented has been partially accepted. It is necessary to look at the time series level to determine the changes (time series rejected, modified, etc.). + + + + + + + + + Schedule rejected + The schedule of the recipient as presented has been totally rejected. The cause could be the non presentation of a counter part for the involved trades. + + + + + + + + + Time series not matching + Time series mismatches. + + + + + + + + + Credit limit exceeded + The contractual credit limit has been exceeded and as such the message has been rejected. + + + + + + + + + Time series fully rejected + The time series has been fully rejected. In the case of a confirmation report, this reason code is used in conjunction with either A26 or A30. + + + + + + + + + Time series accepted with specific time interval errors + The time series has been accepted but some time interval quantities have been rectified or zeroed out. + + + + + + + + + In party/Out party invalid + There is no contract for the parties indicated or the rules for cross border nominations are not being respected. The time series has been rejected. + + + + + + + + + Area invalid + The area is unknown or not allowed. The time series has been rejected. + + + + + + + + + A24 not applicable + This code is no longer applicable. + + + + + + + + + A25 not applicable + This code is no longer applicable. + + + + + + + + + Default time series applied + The time series has been rejected and replaced with a default time series profile. This reason code may not be used in conjunction with A30. + + + + + + + + + Cross border capacity exceeded + The cross border capacity has been exceeded. The time series has been rejected or adjusted. + + + + + + + + + Counterpart time series missing + This provides an indication that the time series has not got a counterpart time series. +In the case of an Intermediate Confirmation Report this is advising the recipient that the time series may be rejected at nomination closure if the counterpart time series is not received. +In the case of a Final Confirmation Report this is informing the recipient that the time series has been rejected because the counterpart time series has not been forthcoming. + + + + + + + + + Counterpart time series quantity differences + The time series has been rejected as it does not match that of the counterpart who is considered by market rules to be correct. + + + + + + + + + Imposed Time series from nominated party's time series (party identified in reason text) + The nominated party's time series has replaced the current time series. This reason code may not be used in conjunction with A26. + + + + + + + + + Resolution inconsistency + The resolution is not coherent with the time interval, or resolution not valid. + + + + + + + + + Quantity inconsistency + The quantity is not coherent. For example a time period with the same version number but different quantities or an non permitted number of digits after the decimal point, etc. + + + + + + + + + Quantity increased + The quantity has been increased in order to satisfy minimum constraints. + + + + + + + + + Quantity decreased + The quantity has been decreased in order to satisfy congestion constraints. + + + + + + + + + Default quantity applied + The default quantity has been applied as the current quantity does not satisfy contractual obligations. + + + + + + + + + Quantities must not be signed values + The quantity proposed is illegal since signed values are only permitted in specific circumstances. + + + + + + + + + A47 not applicable + This code is no longer applicable. + + + + + + + + + Modification reason + In an intraday transmission, the reason for the modification is as follows (in the reason text). + + + + + + + + + Position inconsistency + A position is missing or too many. + + + + + + + + + Senders time series version conflict + There is an error in the sender time series version, i.e. it could be superior to the message version or is inconsistent with the existing data. The time series has been rejected. + + + + + + + + + Message identification or version conflict + The message identification is already in the receiving system. Or a higher version already exists. Message rejected. + + + + + + + + + Time series missing from new version of message + A time series is not contained in a new version of the message. Message rejected. + + + + + + + + + Receiving party incorrect + The receiving party is incorrect. Message rejected. + + + + + + + + + Global position not in balance + The message does not balance out to zero. Market rules might require that the message is rejected. + + + + + + + + + Time series identification conflict + The identification of the time series is duplicated or incorrect. Time series will be rejected. + + + + + + + + + Corresponding Time series not netted + All corresponding time series must be netted. Time series rejected. + + + + + + + + + Deadline limit exceeded/Gate not open + The deadline for receiving schedule messages has passed. Message or time series rejected. + + + + + + + + + One to one nomination inconsistency + There is a one to one nomination inconstancy with the in/out parties or areas. Time series rejected. + + + + + + + + + Not compliant to local market rules + The level in which this is identified is not in compliance with local market rules. The level in question has been rejected. + + + + + + + + + Inter-area transit schedule exceeds nominated schedule + The inter-area transit schedule exceeds the nominated schedule for the same time interval. The inter-area transit schedule is rejected. + + + + + + + + + Currency invalid + The currency is not in compliance with ISO 4217. + + + + + + + + + Invalid business type + The business type does not belong to the valid set of business types for the process in question. + + + + + + + + + Time Series modified + The time series has been modified. + + + + + + + + + Resource Object Invalid + The Resource Object defined in the document is not valid. + + + + + + + + + Reserve object Technical limits exceeded + Reserve objects aggregated values are not within technical/prequalified limits + + + + + + + + + Planned reserves do not correspond with contractual data + Planned reserves do not correspond with contractual data. + + + + + + + + + Limit Data is not available + Limit Data is not available. + + + + + + + + + Reserve Object not qualified for reserve type + Reserve Object is not qualified for reserve type. + + + + + + + + + Mandatory attributes missing + Mandatory attributes missing. + + + + + + + + + Curtailment + The capacity in question has been curtailed. + + + + + + + + + Linked bid rejected due to associated bid unsuccessful + The bid in question has been rejected because an associated bid has been unsuccessful. + + + + + + + + + Original bid divided to permit acceptance + The original bid quantity has been divided to enable it to be accepted. + + + + + + + + + Bid accepted + The bid in question has been accepted. + + + + + + + + + Auction Status + The information in the Reason Text provides auction status information. + + + + + + + + + Right status information + The information in the Reason Text provides status information concerning the transmission rights in question. + + + + + + + + + Agreement identification inconsistency + There is an inconsistency between the contract type and the agreement identification. + + + + + + + + + Dependency matrix not respected + There is an inconsistency between the document contents and the dependency matrix. + + + + + + + + + Sender identification and/or role invalid + The identification of the sender or the sender/role combination is invalid. + + + + + + + + + Process type invalid + The process type does not figure in the list of valid process types for this document. + + + + + + + + + Domain invalid + The domain does not figure in the list of valid domains for this document and process. + + + + + + + + + Matching period invalid + The period is not within the expected limits. + + + + + + + + + In/Out area inconsistent with domain + The in and out area does not figure within the domain specified. + + + + + + + + + Disagree with matching results + The matching results provided are not consistent. + + + + + + + + + Confirmation ignored due to higher version already received + The report has been ignored since a higher version has been received. + + + + + + + + + Confirmation without adjustment (time series have been matched without change) + The report has been successfully matched without any changes. + + + + + + + + + Confirmation with adjustment (time series have been modified) + The report has been matched but required adjustment. + + + + + + + + + For action (only in intermediate confirmation - time series need mutual agreement and action) + The report in question is only for action in an intermediate stage. + + + + + + + + + Time series matched + The time series has been successfully matched. + + + + + + + + + Time series ignored (note: this can only apply to time series that are set to zero - see matching principles) + The time series has been ignored and not matched since it does not figure in a counterparty transmission. All are correctly equal to zero. + + + + + + + + + Modification proposal (intermediate confirmation) + The document is a proposal for change before finalization. + + + + + + + + + Expected document not received + The document that is expected has not been received within the expected timeframe. + + + + + + + + + Not possible to send document on time, but estimated delivery time is provided + The document that is due cannot be transmitted within the required timeframe. An estimated time of transmission is provided. + + + + + + + + + Not possible to send document on time, and furthermore no expected time of return to normal situation + The document that is due cannot be transmitted within the required timeframe. The time of transmission of the document is unknown. + + + + + + + + + Document cannot be processed by receiving system + The receiving system cannot process that document in question. + + + + + + + + + Complementary information + Additional text is provided in order to further explain a condition, for example to provide details of an outage. + + + + + + + + + Technical constraint + A technical constraint has been applied. + + + + + + + + + Force majeure curtailment + Curtailment due to Force Majeure. A code that enables the identification of the curtailment reason for settlement purposes. + + + + + + + + + Network security curtailment + Curtailment due to network security reasons A code that enables the identification of the curtailment reason for settlement purposes. + + + + + + + + + Auction cancelled + The auction has been cancelled. + + + + + + + + + Incomplete document + The document is incomplete and cannot be processed. + + + + + + + + + Accounting Point (tie-line) Time Series missing + The document is incomplete as a time series for an accounting point is missing. + + + + + + + + + Meter data Time series missing + The document is incomplete as a time series for meter data is missing. + + + + + + + + + Estimated values not allowed in first transmission + The document is in its initial form and estimated values are not allowed. + + + + + + + + + No quantity values allowed for a quality that is not available + No quantity values are allowed for a quality that is not available. + + + + + + + + + Time series accepted + Time series accepted. + + + + + + + + + Auction without bids being entered + The auction has terminated without any bids being submitted. The ReasonText may provide the identification of the auction in question. + + + + + + + + + Data not yet available + It is not possible to perform the necessary action since the required data for this action is not yet available. + + + + + + + + + Bid not accepted + The bid in question has not been accepted. + + + + + + + + + Initiator area problem + The problem concerns the initiator area. + + + + + + + + + Cooperating area problem + The problem concerns the cooperating area. + + + + + + + + + Communication status currently active + The status within the system indicates that the communication capability is currently active. + + + + + + + + + Communication status currently inactive + The status within the system indicates that the communication capability is currently inactive. + + + + + + + + + Communication status currently restricted + The status within the system indicates that the communication capability is currently restricted. + + + + + + + + + Problem associated with both areas + The problem concerns both areas. + + + + + + + + + Tender unavailable in MOL list + A tender that has been requested is no longer available in the MOL. + + + + + + + + + Price based on preliminary exchange rate + The price is based on a preliminary exchange rate. + + + + + + + + + Failure + A failure has occurred. + + + + + + + + + Foreseen maintenance + Maintenance is foreseen. + + + + + + + + + Shutdown + A shutdown has occurred. + + + + + + + + + Official exchange rate approved + The official exchange rate has been approved. + + + + + + + + + System regulation + The information provided regards a regulation for system purposes. + + + + + + + + + Frequency regulation + The information provided regards a regulation for frequency purposes. + + + + + + + + + Load flow overload + Situation in the grid, where loading of a certain grid element, e.g. overhead line, is above defined technical limits. + + + + + + + + + Voltage level adjustment + A TSO activity to maintain an acceptable voltage profile throughout the network. This is achieved by balancing of the respective reactive power requirements of the network and the customers. + + + + + + + + + Emergency situation curtailment + Curtailment due to emergency situation. A code that enables the identification of the curtailment reason for settlement purposes. + + + + + + + + + Calculation process failed + The calculation has not been performed. + + + + + + + + + No capacity constraint impact on the market + The market position is such as no capacity constraint is applied to limit the cross border exchanges. + + + + + + + + + Special Condition + Special condition need to be fulfilled. + + + + + + + + + Unverified + Missing or not validated data. + + + + + + + + + Verified + Data has successfully passed the verification process. + + + + + + + + + CGM inconsistency + Describes an element which was not found in the CGM. + + + + + + + + + Network dictionary inconsistency + Describes an element which was not found in the network dictionary. + + + + + + + + + Capacity reduced by TSO + Describes a capacity that was reduced by a TSO. + + + + + + + + + Overload + Describes an N-k or N state overload. + + + + + + + + + GLSK limitation + Describes a situation in which there is not enough power adjustment in the GLSK file to cover the capacity. + + + + + + + + + Voltage constraint + Describes an N-k or N state voltage violation. + + + + + + + + + Angle constraint + Describes an N-k or N state angle violation. + + + + + + + + + Stability + Describes a situation in which the dynamic behaviour of the network violated. + + + + + + + + + Loadflow divergence + Describes a network situation in which the provided capacity values are part of a load flow divergence situation. + + + + + + + + + Exclusion for SoS reasons + This is the adjustment applied to the capacity of a branch to have a minimum RAM (Remaining Available Margin) available for commercial exchanges. + + + + + + + + + Constraint by the market + A constraint due to market restrictions. + + + + + + + + + Ordinary + The contingency is ordinary (methodology for coordinating operational security analysis, article 6). + + + + + + + + + Exceptional + The contingency is exceptional (methodology for coordinating operational security analysis, article 6). + + + + + + + + + Out of range + The contingency is out of range (methodology for coordinating operational security analysis, article 6). + + + + + + + + + Internal congestion + A temporary congestion within a bidding zone or scheduling area. + + + + + + + + + Operational security constraints + Operational security constraints identified by TSOs. + + + + + + + + + Estimated value + Describes a situation where a calculation process has failed and extrapolated or interpolated values will be applied. + + + + + + + + + Balancing + Activated for balancing purposes. + + + + + + + + + Values shared + Values of this time series are also valid for counter-party. + + + + + + + + + + ET0938 + The rights of use that is accorded to what is acquired in an auction. + + + + + + + + Use It Or Lose It + Any rights not nominated shall be lost. + + + + + + + + + Use It Or Sell It + Any rights that are not nominated shall be sold. + + + + + + + + + Allocation curtailment possible + Rights acquired may be curtailed. + + + + + + + + + Nomination curtailment possible + Rights acquired may be curtailed at nomination. + + + + + + + + + Resale possible + Acquired rights may be resold. + + + + + + + + + Transfer possible + Acquired rights may be transferred. + + + + + + + + + + ET0005 + Identification of the role played by a party. + + + + + + + + Trade responsible party + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Consumption responsible party + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Combined power exchange (not to be used) + This role is no longer in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + System operator + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Imbalance settlement responsible + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Production responsible party + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Transmission capacity allocator + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Balance responsible party + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Metered data aggregator + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Billing agent + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Market operator + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Balance supplier + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Consumer + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Control area operator + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Control block operator + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Coordination center operator + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Grid access provider + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Grid operator + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Meter administrator + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Party connected to grid + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Producer + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Profile maintenance party + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Meter operator + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Metered data collector + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Metered data responsible + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Metering point administrator + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Resource Provider + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Scheduling coordinator + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Capacity Trader + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Interconnection Trade Responsible + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Nomination Validator + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. + + + + + + + + + Market information aggregator + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. +A party that collects information from different sources and assembles it to provide a summary of the market. + + + + + + + + + Information receiver + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. +A party, not necessarily a market participant, which receives information about the market. + + + + + + + + + Reserve Allocator + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. +A party that informs the market of reserve requirements, receives tenders against the requirements and in compliance with the prequalification criteria, determines what tenders meet requirements and assigns tenders. + + + + + + + + + MOL Responsible + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. +A party that Informs the market of reserve requirements, receives tenders against the requirements and in compliance with the prequalification criteria, determines what tenders meet requirements and assigns tenders. + + + + + + + + + Capacity Coordinator + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. +A party, acting on behalf of the SOs involved, responsible for establishing a coordinated Offered Capacity and/or NTC and/or ATC between several Market Balance Areas. + + + + + + + + + Reconciliation Accountable + Refer to role model definitions in the ENTSO-E Harmonised Role Model Document. +A party that is financially accountable for the reconciled volume of energy products for a profiled local metering point. + + + + + + + + + Reconciliation Responsible + A party that is responsible for reconciling, within a metering grid area, the volumes used in the imbalance settlement process for profiled metering points and the actual metered quantities. + + + + + + + + + Data provider + A party that is responsible for providing information to a central authority. + + + + + + + + + Local Issuing Office (LIO) + A party that is responsible for operating a Local Issuing Office (LIO). + + + + + + + + + Central Issuing Office (CIO) + A party that is responsible for operating a Central Issuing Office (CIO). + + + + + + + + + EIC Participant + A party that participates in the EIC environment. + + + + + + + + + Weather analyser + A party that analyses the current and forecast weather situation and establishes a prognosis of its impact on the renewable energy environment as well as the overall load. + + + + + + + + + Regional Security Coordinator (RSC) + The RSC as defined in the System Operation guideline. + + + + + + + + + Energy Service Company (ESCO) + A party offering energy-related services to the Party Connected to Grid, but not directly active in the energy value chain or the physical infrastructure itself. The ESCO may provide insight services as well as energy management services. + + + + + + + + + Balancing Service Provider + A party with reserve-providing units or reserve-providing groups able to provide balancing services to LFC Operators. + + + + + + + + + + ET0025 + The condition or position of an object with regard to its standing. + + + + + + + + Intermediate + The document is in a non finalized state. + + + + + + + + + Final + The document is in a definitive state. + + + + + + + + + Deactivated + The object being reported has been deactivated. + + + + + + + + + Reactivated + The object being reported has been reactivated. + + + + + + + + + Active + The object being reported is currently active. + + + + + + + + + Available + The volumes (one or more) are available. + + + + + + + + + Activated + The quantities in the time series have been activated. + + + + + + + + + In process + The quantities in the time series are in the process of activation (an activation request has been made). + + + + + + + + + Cancelled + The tender indicated in the time series has been completely cancelled. +In this case the resources are no longer available to all Acquiring System Operators + + + + + + + + + Ordered + The quantities in the time series are to be activated. + + + + + + + + + Unavailable + The volumes (one or more) are unavailable. + + + + + + + + + RGCE agreed + The information has been agreed within the ENTSO-E Regional Group Continental Europe process. + + + + + + + + + Withdrawn + The information has been withdrawn by the submitter. + + + + + + + + + Creation + The action requested to be carried out is the creation of a new object. + + + + + + + + + Update + The action requested to be carried out is the update an existing object. + + + + + + + + + Deactivation + The action requested to be carried out is to deactivate an existing object. + + + + + + + + + Reactivation + The action requested to be carried out is to reactivate a previously deactivated object. + + + + + + + + + Preventive + The remedial action is applied to prevent an outage. + + + + + + + + + Curative + The remedial action is applied after an outage has occurred, in order to maintain the operational security. + + + + + + + + + Automatic + The remedial action being described is applied by an automation when an outage occurs. + + + + + + + + + Open + The action being described consists of disconnecting the network element to the transmission network. + + + + + + + + + Close + The action being described consists of connecting the network element to the transmission network. + + + + + + + + + Stop + The action being described consists of stopping the production or consumption connected to a network element. + + + + + + + + + Start + The action being described consists of starting the production or consumption connected to a network element. + + + + + + + + + Relative + The quantity being described is a relative value to an initial state. + + + + + + + + + Absolute + The quantity being described is an absolute value. + + + + + + + + + Curative or preventive + The remedial action can be applied to prevent an outage or after an outage has occurred in order to maintain the operational security. + + + + + + + + + Unshared bid + Used to indicate that the bid cannot be shared. + + + + + + + + + Pre Processed + to be process + + + + + + + + + Substituted + Substituted pre-processing data. + + + + + + + + + Modified + Modified pre-processing data by RSC or CGMA platform. + + + + + + + + + Result + Result + + + + + + + + + Not satisfied + The need described in the time series cannot be satisfied. + + + + + + + + + Rejected + The document rejected by one or more parties. + + + + + + + + + Preliminary + Indicative information only for initial planning purposes. + + + + + + + + + Planned + Is planned. + + + + + + + + + Confirmed + The status is confirmed. + + + + + + + + + Shall Be Used + The object defined in the series shall be used. + + + + + + + + + Could Be Used + The object defined in the series could be used. + + + + + + + + + Proposed + The status of the information is proposed. + + + + + + + + + Individual Network Data + The network data provided in the document or series concerns the the unique TSO area describes by the document or series. + + + + + + + + + Common Network Data + The network data provided in the document or series concerns the whole area describes by the document or series. + + + + + + + + + Setpoint schedule + The code for the power setpoint mode of operation of the HVDC link. + + + + + + + + + Proportional external signal + The code for the proportional external signal mode of operation of the HVDC link. + + + + + + + + + AC emulation + The code for the AC emulation mode of operation of the HVDC link. + + + + + + + + + Importing element + An importing network element in which the flow measurement enters. + + + + + + + + + Exporting element + An exporting network element from which the flow measurement comes out. + + + + + + + + + To be optimized + Describes an element which needs to be optimized by an optimization process. + + + + + + + + + To be monitored + Describes an element which needs to be monitored by an optimization process. + + + + + + + + + To be included in capacity calculation + Describes an element which needs to be taken into account in a capacity calculation process. + + + + + + + + + Relative to previous point in time + The quantity being described is a relative value to a previous point in time. + + + + + + + + + For flow optimization + Describes an element which needs to be optimized by a flow optimization process. + + + + + + + + + For voltage optimization + Describes an element which needs to be optimized by a voltage optimization process. + + + + + + + + + Presolved + Describes an active constraint that limits the exchanges. It is part of the presolved domain. + + + + + + + + + + ET0039 + The standard tariff types as defined in the RGCE policies. + + + + + + + + Winter HT + Winter HT tariff. + + + + + + + + + Winter HHT + Winter HHT tariff. + + + + + + + + + Winter NT + Winter NT tariff. + + + + + + + + + Summer HT + Summer HT tariff. + + + + + + + + + Summer HHT1 + Summer HHT1 tariff. + + + + + + + + + Summer HHT2 + Summer HHT2 tariff. + + + + + + + + + Summer NT + Summer NT tariff. + + + + + + + + + + MXM001 + The unit multipliers defined for the CIM. + + + + + + + + none + No multiplier or equivalently multiply by 1. + + + + + + + + + + ET0011 + (synonym MeasurementUnit) The unit of measure that is applied to a quantity. The measurement units shall be in compliance with UN/ECE Recommendation 20. + + + + + + + + OKTA unit + A unit of measurement of the cloudiness expressed in OKTA or OCTA, i.e. A unit of count defining the number of eighth-parts as a measure of the celestial dome cloud coverage. + + + + + + + + + gigawatt + GW unit as per UN/CEFACT recommendation 20. + + + + + + + + + hectopascal + A unit of measurement of the pressure expressed in hectopascal. + + + + + + + + + ampere + The unit of electrical current in the International system of Units (SI) equivalent to one Coulomb per second. + + + + + + + + + One + A unit for dimensionless quantities, also called quantities of dimension one. + + + + + + + + + Celsius + A unit of measurement of temperature expressed in degree Celsius. + + + + + + + + + watt per square meter + A unit of measurement of the density of heat flow rate expressed in watt per square meter. + + + + + + + + + degree (unit of angle) + A unit of measurement of angles expressed in a 0 to 360 degree gradient. + + + + + + + + + gigawatt hour + GWh unit as per UN/CEFACT recommendation 20. + + + + + + + + + cubic hectometres + A unit of volume equal to one million cubic metres. + + + + + + + + + K (Kelvin) + Temperature unit refer ISO 80000-5 (Quantities and units, Part 5: Thermodynamics). + + + + + + + + + kilometre + km unit as per UN/CEFACT recommendation 20. + + + + + + + + + kilovolt ampere reactive + A unit of electrical reactive power represented by a current of one thousand amperes flowing due to a potential difference of one thousand volts where the sine of the phase angle between them is 1. The unity power factor is expressed in thousands of a volt ampere reactive. + + + + + + + + + kilovolt + kV unit as per UN/CEFACT recommendation 20. + + + + + + + + + kilowatt hour + A total amount of electrical energy transferred or consumed in one hour. + + + + + + + + + kilowatt + A unit of bulk power flow, which can be defined as the rate of energy transfer /consumption when a current of 1000 amperes flows due to a potential of 1000 volts at unity power factor expressed in thousands of a watt. + + + + + + + + + megavolt ampere reactive hours + Total amount of reactive power across a power system. + + + + + + + + + megavolt ampere reactive + A unit of electrical reactive power represented by a current of one thousand amperes flowing due to a potential difference of one thousand volts where the sine of the phase angle between them is 1. + + + + + + + + + megawatt + A unit of bulk power flow, which can be defined as the rate of energy transfer /consumption when a current of 1000 amperes flows due to a potential of 1000 volts at unity power factor expressed in millions of a watt. + + + + + + + + + millimeter + A unit of measurement of length expressed in millimeter. + + + + + + + + + cubic metres per second + The volume flow rate of cubic metre per second. + + + + + + + + + cubic metre + A Cubic metre. + + + + + + + + + metre + The length of a metre. + + + + + + + + + meter per second + A unit of measurement of the speed expressed in m/s. + + + + + + + + + megavolt-ampere + MVA unit as per UN/CEFACT recommendation 20. + + + + + + + + + megawatt hours + The total amount of bulk energy transferred or consumed. + + + + + + + + + percent + A unit of proportion equal to 0.01. + + + + + + + + + watt + The watt is the International System of Units (SI) standard unit of power (energy per unit time), the equivalent of one joule per second. + + + + + + + + + + MXM000 + The coded representation of different units from IEC 61970. + + + + + + + + Ampere + The unit of electrical current in the International system of Units (SI) equivalent to one Coulomb per second. + + + + + + + + + One + A unit for dimensionless quantities, also called quantities of dimension one. + + + + + + + + + degree (unit of angle) + A unit of measurement of angles expressed in a 0 to 360 degree gradient. + + + + + + + + + Hertz + HTZ unit as per UN/CEFACT recommendation 20 + + + + + + + + + kV + The symbol of kV + + + + + + + + + MVAr + The symbol of MVAr + + + + + + + + + MW + The symbol of MW + + + + + + + + + megavolt-ampere + MVA unit as per UN/CEFACT recommendation 20 + + + + + + + + + Ohm + The symbol of Ohm Unit + + + + + + + + + Percent + A unit of proportion equal to 0.01. + + + + + + + + + + ET0003 + The DocumentTypeList is only used in XML instances using deprecated ENTSO-E schema; otherwise for XML instances based CIM, the codelist is MessageTypeList. +Therefore, you are kindly advised to refer to the MessageType enumeration, which includes the same enumeration codes. + + + + + + + + Balance responsible schedule + A schedule which has been prepared by a balance responsible party providing planned schedule information. + + + + + + + + + Allocated capacity schedule + A schedule which has been prepared by a capacity allocator providing allocated capacity. + + + + + + + + + Balance area schedule + A schedule that provides the planned schedule information for a balance area. + + + + + + + + + System Operator area schedule + A compilation of all external schedules concerning two System Operator areas of all balance responsible parties. + + + + + + + + + Control block area schedule + A compilation of all the exchange programs of all control areas for one control block with all neighbouring control areas of a neighbouring control block. + + + + + + + + + Coordination center area schedule + A compilation of the exchange programs of all exchange blocks divided into UCTE south and north. + + + + + + + + + Intermediate confirmation report + An intermediate confirmation report that may be produced between final cutoffs. + + + + + + + + + Final confirmation report + A final confirmation report that is produced after a final cutoff. + + + + + + + + + Finalised schedule + A compilation of a set of schedules that have been finalized after a given cutoff. + + + + + + + + + Regulation data report + A compilation of the time series employed on a given day to ensure the balance of the system. + + + + + + + + + Aggregated energy data report + A compilation of the time series of all the meter readings or their equivalent for a given period. + + + + + + + + + Imbalance report + The report containing the complete situation of a given period for a party and including the schedules, regulation data and actual or calculated readings. + + + + + + + + + Interconnection Capacity + Document for cross-border capacity exchanges. + + + + + + + + + Resource Provider Resource Schedule + A document providing the schedules for resource objects submitted by a resource provider. + + + + + + + + + Acquiring System Operator Reserve Schedule + A document providing reserve purchases submitted by an Acquiring System Operator. + + + + + + + + + Anomaly Report + A document providing anomaly information for the receiving party to correct. + + + + + + + + + Acknowledgement Document + A document providing acknowledgement information. + + + + + + + + + Confirmation report + A document providing confirmation information. + + + + + + + + + Capacity for Resale + A document providing information about capacity for resale. + + + + + + + + + Approved Capacity Transfer + A document to approve a capacity transfer. + + + + + + + + + Capacity transfer notification + A document notifying a capacity transfer. + + + + + + + + + Transmission rights portfolio + A document providing the portfolio of the transmission capacity rights of a market participant. + + + + + + + + + Allocations + A document providing the capacity allocations for a border. + + + + + + + + + Bid document + A document providing bid information. + + + + + + + + + Allocation result document + A document providing the allocation results of an auction. + + + + + + + + + Capacity document + A document providing capacity information. + + + + + + + + + Rights document + A document providing transmission capacity rights information. + + + + + + + + + Generation availability schedule + This document contains information related to energy availability. + + + + + + + + + Cross border schedule + This document contains the cross border schedules for all the borders of a given country where energy is exchanged. + + + + + + + + + Agreed capacity + The capacity agreed between parties. + + + + + + + + + Proposed capacity + The capacity proposed for agreement between parties. + + + + + + + + + System vertical load + The sum of all flows out of the transmission grid via directly connected transformers and lines to distribution grids and end consumers as known by the System Operator. + + + + + + + + + Escalation document + A document which requesting the escalation of a situation. + + + + + + + + + Trouble shooting document + A document providing trouble shooting information for the resolution of a problem. + + + + + + + + + Deactivation document + The capacity proposed for agreement between parties. + + + + + + + + + Reserve tender document + The document that is used for the tendering for reserves within the ERRP process. + + + + + + + + + Reserve Allocation Result Document + The document used to provide the results of a Reserve auction. + + + + + + + + + SATCR activation + The document is used to provide the activation of reserves through the SATCR process. + + + + + + + + + DATCR activation + The document is used to provide the activation of reserves through the DATCR process. + + + + + + + + + Activation response + The document is used to provide a response to a request to activate reserves. + + + + + + + + + Tender reduction + The document is used to provide information concerning the reduction of a previously submitted tender. + + + + + + + + + MOL Document + The document is used to provide Merit Order List information. + + + + + + + + + Price Document + The document is used to provide market spot price information. + + + + + + + + + Measurement Value Document + The document is used to provide measurement information from measurement devices. + + + + + + + + + SOAM Document + The document is used to provide system operator accounting data for matching. + + + + + + + + + SOVA Document + The document is used to provide system operator validated accounting data. + + + + + + + + + CCVA Document + The document is used to provide coordination center validated accounting data. + + + + + + + + + Daily settlement document + The document is used to provide daily settlement information. + + + + + + + + + Weekly settlement document + The document is used to provide weekly settlement information. + + + + + + + + + Capacity Auction Specification Document + The document is used to provide capacity auction specification information. + + + + + + + + + Market Coupling Results Document + The document is used to provide the results of a market coupling auction. + + + + + + + + + Outage publication Document + The document is used to provide the outage information for publication. + + + + + + + + + Forced generation outage Document + A document providing information on forced generation outages. + + + + + + + + + Summarised Market Schedule + A compilation of all external schedules concerning two Market Balance Areas of all balance responsible parties. + + + + + + + + + Compensation Program Schedule + A schedule that provides the schedule information for the compensation of unintended deviation. + + + + + + + + + Load Frequency Control Program Schedule + A schedule that provides the schedule information for the Load Frequency Control Program of a Control Area or a Control Block. + + + + + + + + + Timeframe Independent Schedule + A compilation of all external Timeframe Independent Schedules concerning two System Operators. + + + + + + + + + Status request for a status within a process + A status request being made concerning the status of information within the context of a specific ongoing process. + + + + + + + + + status request for a position independently from a specific process + A status request concerning the position of an object independently of any ongoing processes. + + + + + + + + + Estimated Net Transfer Capacity + The estimated net transfer capacity for a given border. + + + + + + + + + Compensation rights + The capacity rights that have been allocated as compensation. + + + + + + + + + Redispatch notice + A notice to confirm the actions agreed between System Operators to resolve a congestion situation through redispatch. + + + + + + + + + Tender reduction response + A response to a tender reduction request that provides corrections to the initial document. + + + + + + + + + System total load + Total load', including losses without power used for energy storage, is equal to generation deducted with exports, added with imports and deducted with power used for energy storage. + + + + + + + + + Final MOL + A document providing the information concerning the situation of the MOL at the end of an activation period. + + + + + + + + + Resource Provider Schedule for production/consumption + A document providing the schedules for production/consumption for resource objects submitted by a resource provider. + + + + + + + + + Installed generation per type + A document providing the installed generation per generation type. + + + + + + + + + Wind and solar forecast + A document providing the forecast of wind and solar generation. + + + + + + + + + Load forecast margin + A document providing the load forecast margin for a period. + + + + + + + + + Generation forecast + A document providing the generation forecast for a period. + + + + + + + + + Reservoir filling information + A document providing information concerning the filling of reservoirs. + + + + + + + + + Actual generation + A document providing the actual generation for a period. + + + + + + + + + Wind and solar generation + A document providing the generation of wind and solar energy for a period. + + + + + + + + + Actual generation per type + A document providing the actual generation per generation type for a period. + + + + + + + + + Load unavailability + A document providing the unavailability of units providing load on the network. + + + + + + + + + Production unavailability + A document providing the unavailability of production units providing energy to the network. + + + + + + + + + Transmission unavailability + A document providing the unavailability of transmission capacity on the network. + + + + + + + + + Offshore grid infrastructure unavailability + A document providing the unavailability of an offshore grid infrastructure to the network. + + + + + + + + + Generation unavailability + A document providing the unavailability of generation units providing energy to the network. + + + + + + + + + Contracted reserves + A document providing the reserves contracted for a period. + + + + + + + + + Accepted offers + A document providing the offers of reserves that have been accepted for a period. + + + + + + + + + Activated balancing quantities + A document providing the quantities of reserves that have been activated for balancing. + + + + + + + + + Activated balancing prices + A document providing the prices of the reserves that have been activated for balancing. + + + + + + + + + Imbalance prices + A document providing the prices of reserves due to imbalance for a period. + + + + + + + + + Imbalance volume + A document providing the volume of the imbalance for a period. + + + + + + + + + Financial situation + A document providing the financial situation for reserves. + + + + + + + + + Cross border balancing + A document providing the cross border balancing requirements for a period. + + + + + + + + + Contracted reserve prices + A document providing the price of reserves contracted for a period. + + + + + + + + + Interconnection network expansion + A document providing information on the expansion of the interconnection network. + + + + + + + + + Counter trade notice + A document providing information on counter trades for a period. + + + + + + + + + Congestion costs + A document providing the cost of congestion for a period. + + + + + + + + + DC link capacity + A document providing the DC links for a period. + + + + + + + + + Non EU allocations + A document providing allocations made to non EU member states. + + + + + + + + + Configuration document + A document providing configuration information for the network. + + + + + + + + + Redispatch activation document + A document enabling the activation of a redispatch notice. + + + + + + + + + Detailed activation history document + A document enabling a detailed history of activations. + + + + + + + + + Aggregated activation history document + A document enabling an aggregated history of activations. + + + + + + + + + HVDC Link constraints + A document providing the information concerning the maximum and minimum active power flow through each link can limited. + + + + + + + + + HVDC Configuration + A document providing the information concerning the power set point. The mode in which the HVDC is managed. + + + + + + + + + HVDC Schedule + A document providing the information for operating DC links. + + + + + + + + + EIC code request + A document providing the information requesting a new EIC code. + + + + + + + + + EIC code information + A document providing EIC information in a central registry exchange or information to an EIC participant. + + + + + + + + + EIC code publication + A document providing EIC publication information in a web site publication of a limited set of information. + + + + + + + \ No newline at end of file diff --git a/glsk/glsk-document-cse/src/main/resources/xsd/etso-core-cmpts.xsd b/glsk/glsk-document-cse/src/main/resources/xsd/etso-core-cmpts.xsd new file mode 100644 index 00000000..819ff38a --- /dev/null +++ b/glsk/glsk-document-cse/src/main/resources/xsd/etso-core-cmpts.xsd @@ -0,0 +1,631 @@ + + + + + + + + + + + List of ETSO Core Components which are used in the development of ETSO XML Messages + Current Version: 22 + Current Release: 0 + ET0050 + + + + + + + ET0009 + A domain covering a number of related objects, such as balance area, grid area, etc. + + + + + + + + + + + + + + + + ET0022 + The monetary value of an object + + + + + + + + + + + + + + + ET0023 + the coded representation of an object. + + + + + + + + + + + + + + + ET0046 + The identification of an attribute for a given Component. + + + + + + + + + + + + + + + ET0047 + The value of a given component. + + + + + + + + + + + + + + + + ET0035 + The gregorian date that must be expressed as: YYYY-MM-DD + + + + + + + + + ET0001 + A code to uniquely distinguish one occurrence of an entity from another. + + + + + + + + + + + + + + ET0050 + the identification of a line that may be physical or virtual. + + + + + + + + + + + + + + + + ET0043 + A code to uniquely distinguish one occurrence of an entity from another with a long identifier. + + + + + + + + + + + + + + ET0006 + (Synonym "Document Date Time") Date and time of the preparation of a document. The time must be expressed in UTC as: YYYY-MM-DDTHH:MM:SSZ + + + + + + + + + ET0044 + Date and time of a given time point. The time must be expressed in UTC as: YYYY-MM-DDTHH:MM:SSZ + + + + + + + + + ET0027 + A domain covering a number of related objects, such as metering point and accounting point, etc. + + + + + + + + + + + + + + + + ET0014 + The identification of an actor in the Energy market. + + + + + + + + + + + + + + + + ET0021 + (Synonym "pos") A sequential value representing the relative position of an entity within a space such as a time interval + + + + + + + + + + + + + + + + ET0012 + (Synonym "qty") The quantity of an energy product. Positive quantities shall not have a sign. + + + + + + + + + ET0016 + The textual explanation of an act. + + + + + + + + + + + + + + + ET0019 + Defines the number of units of time that compose an individual step within a period. The resolution is expressed in compliance with ISO 8601 in the following format:PnYnMnDTnHnMnS.Where nY expresses a number of years, nM a number of months, nD a number of days.The letter "T" separates the date expression from the time expression and after it nH identifies a number of hours, nM a number of minutes and nS a number of seconds. + + + + + + + + + ET0034 + The identification of a resource object in the Energy market. + + + + + + + + + + + + + + + + ET0036 + The partial identification of an object, which associated with another value provides the complete identification. + + + + + + + + + + + ET0032 + A textual string + + + + + + + + + + + + + + + ET0033 + The time within a 24 hour day that must be expressed as: HH:MM:SS + + + + + + + + + ET0007 + The start date and time and the end date and time of an event. The time interval must be expressed in a form respecting ISO 8601 : YYYY-MM-DDTHH:MMZ/YYYY-MM-DDTHH:MMZ.ISO 8601 rules for reduction may apply. The time must always be expressed in UTC. + + + + + + ISO 8601 time intervals are always expressed in the form + yyyy-mm-ddThh:mmZ/yyyy-mm-ddThh:mmZ + Note: The minimum XML form of dateTime is yyyy-mm-ddThh:mm:ssZ + + + + + + + + + + + + + + ET0002 + A code that distinguishes one evolution of an identified object from another. Information about a specific object may be sent several times, each transmission being identified by a different version number. + + + + + + + + + + + + + + + + + + ET0040 + Identification of the method of allocation in an auction. + + + + + + + + + ET0031 + Identification of the type of asset + + + + + + + + + ET0030 + The coded representation of different types of auction. + + + + + + + + + ET0017 + The exact business nature identifying the principal characteristic of a time series. + + + + + + + + + ET0037 + The product category of an auction. + + + + + + + + + ET0013 + Indicates the classification mechanism used to group a set of objects together. The grouping may be of a detailed or a summary nature + + + + + + + + + ET0010 + The contract type defines the conditions under which the capacity is allocated and handled. EG: daily auction, weekly auction, monthly auction, yearly auction, etc. The significance of this type is dependent on area specific coded working methods + + + + + + + + + ET0024 + The coded identification of legal tender using ISO 4217 3 alpha codes + + + + + + + + + ET0042 + The type of curve being defined in the time series. + + + + + + + + + ET0026 + The coded identification of the direction of energy flow. + + + + + + + + + ET0045 + (Synonym "Message Type") The coded type of a document. The document type describes the principal characteristic of a document + + + + + + + + + ET0028 + The coded identification of the type of an EIC code. + + + + + + + + + ET0008 + The identification of the nature of an energy product such as Power, energy, reactive power, etc. + + + + + + + + + ET0029 + A boolean indicator to express Yes or No or True or False. + + + + + + + + ET0003 + (Synonym "Document Type") The coded type of a document. The document type describes the principal characteristic of a document. note this code is decrecated and should no longer be used in new messages (use documentType instead)) + + + + + + + + + ET0018 + The identification of the domain that is the common dominator used to aggregate a time series. + + + + + + + + + ET0041 + The terms which dictate the determination of the bid payment price. + + + + + + + + + ET0048 + The category of a price to be used in a price calculation. Note: the price category is mutually agreed between System Operators + + + + + + + + + ET0049 + The nature of a price (i.e.an Impacted Area System Operator pays to internal Market Parties or inverse). + + + + + + + + + ET0020 + Indicates the nature of process that the document addresses. + + + + + + + + + ET0036 + The quality of an object. + + + + + + + + + ET0015 + The coded motivation of an act.> + + + + + + + + + ET0038 + The rights of use that is accorded to what is acquired in an auction..> + + + + + + + + + ET0005 + Identification of the role played by a party. + + + + + + + + + ET0039 + The standard tarif types as defined in the UCTE policies. + + + + + + + + + ET0025 + The condition or position of an object with regard to its standing. + + + + + + + + + ET0011 + (synonym MeasurementUnit) The unit of measure that is applied to a quantity. The measurement units shall be in compliance with UN/ECE Recommendation 20. + + + + + + + diff --git a/glsk/glsk-document-cse/src/main/resources/xsd/gsk-document.xsd b/glsk/glsk-document-cse/src/main/resources/xsd/gsk-document.xsd new file mode 100644 index 00000000..f55f4b60 --- /dev/null +++ b/glsk/glsk-document-cse/src/main/resources/xsd/gsk-document.xsd @@ -0,0 +1,238 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/glsk/glsk-document-cse/src/test/java/com/powsybl/glsk/cse/BlockWrapperTest.java b/glsk/glsk-document-cse/src/test/java/com/powsybl/glsk/cse/BlockWrapperTest.java new file mode 100644 index 00000000..dd604b04 --- /dev/null +++ b/glsk/glsk-document-cse/src/test/java/com/powsybl/glsk/cse/BlockWrapperTest.java @@ -0,0 +1,73 @@ +/* + * Copyright (c) 2023, RTE (http://www.rte-france.com) + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + */ +package com.powsybl.glsk.cse; + +import org.junit.jupiter.api.Test; +import xsd.etso_core_cmpts.QuantityType; + +import java.math.BigDecimal; +import java.math.BigInteger; +import java.util.Optional; + +import static org.junit.jupiter.api.Assertions.assertEquals; + +/** + * @author Vincent Bochet {@literal } + */ +class BlockWrapperTest { + @Test + void checkGetOrderReturnsValue() { + PropGSKBlockType block = new PropGSKBlockType(); + block.setOrder(BigInteger.TEN); + assertEquals(Optional.of(BigInteger.TEN), new BlockWrapper(block).getOrder()); + } + + @Test + void checkGetOrderReturnsEmptyWhenBlockHasNoOrderAttribute() { + assertEquals(Optional.empty(), new BlockWrapper(new Object()).getOrder()); + } + + @Test + void checkGetMaximumShiftReturnsValue() { + PropGSKBlockType block = new PropGSKBlockType(); + QuantityType quantity = new QuantityType(); + quantity.setV(BigDecimal.TEN); + block.setMaximumShift(quantity); + assertEquals(Optional.of(BigDecimal.TEN), new BlockWrapper(block).getMaximumShift()); + } + + @Test + void checkGetMaximumShiftReturnsEmptyWhenBlockHasNoMaximumShiftAttribute() { + assertEquals(Optional.empty(), new BlockWrapper(new Object()).getMaximumShift()); + } + + @Test + void checkGetFactorReturnsValue() { + PropGSKBlockType block = new PropGSKBlockType(); + QuantityType quantity = new QuantityType(); + quantity.setV(BigDecimal.TEN); + block.setFactor(quantity); + assertEquals(Optional.of(BigDecimal.TEN), new BlockWrapper(block).getFactor()); + } + + @Test + void checkGetFactorReturnsEmptyWhenBlockHasNoFactorAttribute() { + assertEquals(Optional.empty(), new BlockWrapper(new Object()).getFactor()); + } + + @Test + void checkGetNodeListReturnsList() { + PropGSKBlockType block = new PropGSKBlockType(); + block.getNode().add(new PropGSKNodeType()); + assertEquals(1, new BlockWrapper(block).getNodeList().get().size()); + } + + @Test + void checkGetNodeListReturnsEmptyWhenBlockHasNoNodeListAttribute() { + assertEquals(Optional.empty(), new BlockWrapper(new Object()).getNodeList()); + } +} diff --git a/glsk/glsk-document-cse/src/test/java/com/powsybl/glsk/cse/CseGlskDocumentImporterTest.java b/glsk/glsk-document-cse/src/test/java/com/powsybl/glsk/cse/CseGlskDocumentImporterTest.java index 959df9e6..efd64e76 100644 --- a/glsk/glsk-document-cse/src/test/java/com/powsybl/glsk/cse/CseGlskDocumentImporterTest.java +++ b/glsk/glsk-document-cse/src/test/java/com/powsybl/glsk/cse/CseGlskDocumentImporterTest.java @@ -8,6 +8,8 @@ import com.powsybl.glsk.api.GlskDocument; import com.powsybl.glsk.api.GlskPoint; +import com.powsybl.glsk.api.GlskRegisteredResource; +import com.powsybl.glsk.api.GlskShiftKey; import com.powsybl.glsk.api.io.GlskDocumentImporters; import com.powsybl.glsk.commons.GlskException; import com.powsybl.glsk.commons.ZonalData; @@ -18,7 +20,10 @@ import java.io.InputStream; import java.util.List; -import static org.junit.jupiter.api.Assertions.*; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; /** * @author Sebastien Murgey {@literal } @@ -28,7 +33,7 @@ class CseGlskDocumentImporterTest { @Test void checkCseGlskDocumentImporterCorrectlyImportManualGskBlocks() { - CseGlskDocument cseGlskDocument = CseGlskDocument.importGlsk(getClass().getResourceAsStream("/testGlsk.xml")); + CseGlskDocument cseGlskDocument = CseGlskDocument.importGlsk(getClass().getResourceAsStream("/testGlsk.xml"), false); List list = cseGlskDocument.getGlskPoints("FR_MANUAL"); assertFalse(list.isEmpty()); assertEquals(1, list.size()); @@ -53,7 +58,7 @@ void checkCseGlskDocumentImporterCorrectlyConvertManualGskBlocks() { @Test void checkCseGlskDocumentImporterCorrectlyImportReserveGskBlocks() { - CseGlskDocument cseGlskDocument = CseGlskDocument.importGlsk(getClass().getResourceAsStream("/testGlsk.xml")); + CseGlskDocument cseGlskDocument = CseGlskDocument.importGlsk(getClass().getResourceAsStream("/testGlsk.xml"), false); List list = cseGlskDocument.getGlskPoints("FR_RESERVE"); assertFalse(list.isEmpty()); assertEquals(1, list.size()); @@ -125,7 +130,7 @@ void checkCseGlskDocumentImporterCorrectlyConvertReserveGskBlocksUpWithReachingL @Test void checkCseGlskDocumentImporterCorrectlyImportPropGskBlocks() { - CseGlskDocument cseGlskDocument = CseGlskDocument.importGlsk(getClass().getResourceAsStream("/testGlsk.xml")); + CseGlskDocument cseGlskDocument = CseGlskDocument.importGlsk(getClass().getResourceAsStream("/testGlsk.xml"), false); List list = cseGlskDocument.getGlskPoints("FR_PROPGSK"); assertFalse(list.isEmpty()); assertEquals(1, list.size()); @@ -152,13 +157,13 @@ void checkCseGlskDocumentImporterCorrectlyConvertPropGskBlocks() { @Test void checkCseGlskDocumentImporterCorrectlyImportPropGlskBlocks() { - CseGlskDocument cseGlskDocument = CseGlskDocument.importGlsk(getClass().getResourceAsStream("/testGlsk.xml")); + CseGlskDocument cseGlskDocument = CseGlskDocument.importGlsk(getClass().getResourceAsStream("/testGlsk.xml"), false); List list = cseGlskDocument.getGlskPoints("FR_PROPGLSK"); assertFalse(list.isEmpty()); assertEquals(1, list.size()); assertEquals(2, list.get(0).getGlskShiftKeys().size()); - assertEquals(3, list.get(0).getGlskShiftKeys().get(0).getRegisteredResourceArrayList().size()); - assertEquals(2, list.get(0).getGlskShiftKeys().get(1).getRegisteredResourceArrayList().size()); + assertEquals(2, list.get(0).getGlskShiftKeys().get(0).getRegisteredResourceArrayList().size()); + assertEquals(3, list.get(0).getGlskShiftKeys().get(1).getRegisteredResourceArrayList().size()); } @Test @@ -195,7 +200,7 @@ void checkCseGlskDocumentImporterCorrectlyConvertPropLskBlocksWithPassingLoadsAs @Test void checkCseGlskDocumentImporterCorrectlyImportMeritOrderGskBlocks() { - CseGlskDocument cseGlskDocument = CseGlskDocument.importGlsk(getClass().getResourceAsStream("/testGlsk.xml")); + CseGlskDocument cseGlskDocument = CseGlskDocument.importGlsk(getClass().getResourceAsStream("/testGlsk.xml"), false); List list = cseGlskDocument.getGlskPoints("FR_MERITORDER"); assertFalse(list.isEmpty()); assertEquals(1, list.size()); @@ -247,7 +252,7 @@ void checkCseGlskDocumentImporterCorrectlyConvertMeritOrderGskBlocksUp() { void checkCseGlskDocumentImporterCorrectlyConvertMeritOrderGskBlocksWithTargetPIssueDown() { Network network = Network.read("testCase.xiidm", getClass().getResourceAsStream("/testCase.xiidm")); GlskDocument glskDocument = GlskDocumentImporters.importGlsk(getClass().getResourceAsStream("/testGlsk.xml")); - Scalable meritOrderGskScalable = glskDocument.getZonalScalable(network).getData("FR_MERITORDER_ISSUE_PC"); + Scalable meritOrderGskScalable = glskDocument.getZonalScalable(network).getData("FR_MERIT_ISSUE_PC"); assertNotNull(meritOrderGskScalable); assertEquals(2000., network.getGenerator("FFR1AA1 _generator").getTargetP(), EPSILON); @@ -264,7 +269,7 @@ void checkCseGlskDocumentImporterCorrectlyConvertMeritOrderGskBlocksWithTargetPI void checkCseGlskDocumentImporterCorrectlyConvertMeritOrderGskBlocksWithTargetPIssueUp() { Network network = Network.read("testCase.xiidm", getClass().getResourceAsStream("/testCase.xiidm")); GlskDocument glskDocument = GlskDocumentImporters.importGlsk(getClass().getResourceAsStream("/testGlsk.xml")); - Scalable meritOrderGskScalable = glskDocument.getZonalScalable(network).getData("FR_MERITORDER_ISSUE_PC"); + Scalable meritOrderGskScalable = glskDocument.getZonalScalable(network).getData("FR_MERIT_ISSUE_PC"); assertNotNull(meritOrderGskScalable); assertEquals(2000., network.getGenerator("FFR1AA1 _generator").getTargetP(), EPSILON); @@ -355,7 +360,7 @@ void checkRemainingCapacityWithDifferentKindOfInitialLimitations() { void checkFactorTagIsOptional() { Network network = Network.read("testCase.xiidm", getClass().getResourceAsStream("/testCase.xiidm")); InputStream is = getClass().getResourceAsStream("/testGlskWithMissingFactorTag.xml"); - ZonalData zs = CseGlskDocument.importGlsk(is).getZonalScalable(network); + ZonalData zs = CseGlskDocument.importGlsk(is, false).getZonalScalable(network); assertEquals(4, zs.getDataPerZone().size()); } @@ -363,6 +368,78 @@ void checkFactorTagIsOptional() { @Test void checkGlskExceptionWhenMissingTag() { InputStream is = getClass().getResourceAsStream("/testGlskMissingTag.xml"); - assertThrows(GlskException.class, () -> CseGlskDocument.importGlsk(is)); + assertThrows(GlskException.class, () -> CseGlskDocument.importGlsk(is, false)); + } + + @Test + void checkCseGlskDocumentImporterCorrectlyImportMergedGlsk() { + CseGlskDocument cseGlskDocument = CseGlskDocument.importGlsk(getClass().getResourceAsStream("/testGlskMerged.xml"), true); + assertNotNull(cseGlskDocument); + assertEquals(5, cseGlskDocument.getZones().size()); + + List atPoints = cseGlskDocument.getGlskPoints("10YAT-APG------L"); + assertEquals(1, atPoints.size()); + List atGlskShiftKeys = atPoints.get(0).getGlskShiftKeys(); + assertEquals(1, atGlskShiftKeys.size()); + assertEquals(0.95, atGlskShiftKeys.get(0).getQuantity()); + List atRegisteredResources = atGlskShiftKeys.get(0).getRegisteredResourceArrayList(); + assertEquals(2, atRegisteredResources.size()); + assertEquals("AT01AA01", atRegisteredResources.get(0).getName()); + assertEquals(0.7, atRegisteredResources.get(0).getParticipationFactor()); + assertEquals("AT02AA01", atRegisteredResources.get(1).getName()); + assertEquals(0.3, atRegisteredResources.get(1).getParticipationFactor()); + + List chPoints = cseGlskDocument.getGlskPoints("10YCH-SWISSGRIDZ"); + assertEquals(1, chPoints.size()); + List chGlskShiftKeys = chPoints.get(0).getGlskShiftKeys(); + assertEquals(1, chGlskShiftKeys.size()); + assertEquals(1.2, chGlskShiftKeys.get(0).getQuantity()); + List chRegisteredResources = chGlskShiftKeys.get(0).getRegisteredResourceArrayList(); + assertEquals(1, chRegisteredResources.size()); + assertEquals("CH01AA01", chRegisteredResources.get(0).getName()); + assertEquals(200.0, chRegisteredResources.get(0).getMaximumCapacity().get()); + assertEquals(-10.0, chRegisteredResources.get(0).getMinimumCapacity().get()); + + List frPoints = cseGlskDocument.getGlskPoints("10YFR-RTE------C"); + assertEquals(1, frPoints.size()); + List frGlskShiftKeys = frPoints.get(0).getGlskShiftKeys(); + assertEquals(1, frGlskShiftKeys.size()); + assertEquals(1.05, frGlskShiftKeys.get(0).getQuantity()); + List frRegisteredResources = frGlskShiftKeys.get(0).getRegisteredResourceArrayList(); + assertEquals(3, frRegisteredResources.size()); + assertEquals("FR01AA01", frRegisteredResources.get(0).getName()); + assertEquals("FR02AA01", frRegisteredResources.get(1).getName()); + assertEquals("FR03AA01", frRegisteredResources.get(2).getName()); + + List itPoints = cseGlskDocument.getGlskPoints("10YIT-GRTN-----B"); + assertEquals(1, itPoints.size()); + List itGlskShiftKeys = itPoints.get(0).getGlskShiftKeys(); + assertEquals(2, itGlskShiftKeys.size()); + assertEquals(1.15, itGlskShiftKeys.get(0).getQuantity()); + assertEquals(1, itGlskShiftKeys.get(0).getMeritOrderPosition()); + List itFirstRegisteredResources = itGlskShiftKeys.get(0).getRegisteredResourceArrayList(); + assertEquals(1, itFirstRegisteredResources.size()); + assertEquals("IT01AA01", itFirstRegisteredResources.get(0).getName()); + assertEquals(1000, itFirstRegisteredResources.get(0).getMaximumCapacity().get()); + assertEquals(1.15, itGlskShiftKeys.get(1).getQuantity()); + assertEquals(-1, itGlskShiftKeys.get(1).getMeritOrderPosition()); + List itSecondRegisteredResources = itGlskShiftKeys.get(1).getRegisteredResourceArrayList(); + assertEquals(1, itSecondRegisteredResources.size()); + assertEquals("IT01AA02", itSecondRegisteredResources.get(0).getName()); + assertEquals(0, itSecondRegisteredResources.get(0).getMinimumCapacity().get()); + + List siPoints = cseGlskDocument.getGlskPoints("10YSI-ELES-----O"); + assertEquals(1, siPoints.size()); + List siGlskShiftKeys = siPoints.get(0).getGlskShiftKeys(); + assertEquals(2, siGlskShiftKeys.size()); + assertEquals(0.3, siGlskShiftKeys.get(0).getQuantity()); + List siFirstRegisteredResources = siGlskShiftKeys.get(0).getRegisteredResourceArrayList(); + assertEquals(2, siFirstRegisteredResources.size()); + assertEquals("SI02AA01", siFirstRegisteredResources.get(0).getName()); + assertEquals("SI02AA02", siFirstRegisteredResources.get(1).getName()); + assertEquals(0.7, siGlskShiftKeys.get(1).getQuantity()); + List siSecondRegisteredResources = siGlskShiftKeys.get(1).getRegisteredResourceArrayList(); + assertEquals(1, siSecondRegisteredResources.size()); + assertEquals("SI01AA01", siSecondRegisteredResources.get(0).getName()); } } diff --git a/glsk/glsk-document-cse/src/test/java/com/powsybl/glsk/cse/NodeWrapperTest.java b/glsk/glsk-document-cse/src/test/java/com/powsybl/glsk/cse/NodeWrapperTest.java new file mode 100644 index 00000000..cc37f92f --- /dev/null +++ b/glsk/glsk-document-cse/src/test/java/com/powsybl/glsk/cse/NodeWrapperTest.java @@ -0,0 +1,82 @@ +/* + * Copyright (c) 2023, RTE (http://www.rte-france.com) + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + */ +package com.powsybl.glsk.cse; + +import org.junit.jupiter.api.Test; +import xsd.etso_core_cmpts.QuantityType; + +import java.math.BigDecimal; +import java.util.Optional; + +import static org.junit.jupiter.api.Assertions.assertEquals; + +/** + * @author Vincent Bochet {@literal } + */ +class NodeWrapperTest { + @Test + void checkGetNodeReturnsValue() { + MeritOrderUpNodeType node = new MeritOrderUpNodeType(); + assertEquals(node, new NodeWrapper(node).getNode()); + } + + @Test + void checkGetOrderReturnsValue() { + MeritOrderUpNodeType node = new MeritOrderUpNodeType(); + NodeNameType nodeName = new NodeNameType(); + nodeName.setV("name"); + node.setName(nodeName); + assertEquals(Optional.of("name"), new NodeWrapper(node).getName()); + } + + @Test + void checkGetOrderReturnsEmptyWhenNodeHasNoOrderAttribute() { + assertEquals(Optional.empty(), new NodeWrapper(new Object()).getName()); + } + + @Test + void checkGetFactorReturnsValue() { + ManualGSKNodeType node = new ManualGSKNodeType(); + QuantityType quantity = new QuantityType(); + quantity.setV(BigDecimal.TEN); + node.setFactor(quantity); + assertEquals(Optional.of(BigDecimal.TEN), new NodeWrapper(node).getFactor()); + } + + @Test + void checkGetFactorReturnsEmptyWhenNodeHasNoFactorAttribute() { + assertEquals(Optional.empty(), new NodeWrapper(new Object()).getFactor()); + } + + @Test + void checkGetPmaxReturnsValue() { + MeritOrderUpNodeType node = new MeritOrderUpNodeType(); + QuantityType quantity = new QuantityType(); + quantity.setV(BigDecimal.TEN); + node.setPmax(quantity); + assertEquals(Optional.of(BigDecimal.TEN), new NodeWrapper(node).getPmax()); + } + + @Test + void checkGetPmaxReturnsEmptyWhenNodeHasNoPmaxAttribute() { + assertEquals(Optional.empty(), new NodeWrapper(new Object()).getPmax()); + } + + @Test + void checkGetPminReturnsValue() { + MeritOrderUpNodeType node = new MeritOrderUpNodeType(); + QuantityType quantity = new QuantityType(); + quantity.setV(BigDecimal.TEN); + node.setPmin(quantity); + assertEquals(Optional.of(BigDecimal.TEN), new NodeWrapper(node).getPmin()); + } + + @Test + void checkGetPminReturnsEmptyWhenNodeHasNoPminAttribute() { + assertEquals(Optional.empty(), new NodeWrapper(new Object()).getPmin()); + } +} diff --git a/glsk/glsk-document-cse/src/test/resources/testGlsk.xml b/glsk/glsk-document-cse/src/test/resources/testGlsk.xml index 4f393ac0..a555a5ed 100644 --- a/glsk/glsk-document-cse/src/test/resources/testGlsk.xml +++ b/glsk/glsk-document-cse/src/test/resources/testGlsk.xml @@ -143,8 +143,8 @@ - - + + @@ -164,11 +164,11 @@ + - diff --git a/glsk/glsk-document-cse/src/test/resources/testGlskMerged.xml b/glsk/glsk-document-cse/src/test/resources/testGlskMerged.xml new file mode 100644 index 00000000..8a94817d --- /dev/null +++ b/glsk/glsk-document-cse/src/test/resources/testGlskMerged.xml @@ -0,0 +1,181 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/glsk/glsk-document-cse/src/test/resources/testGlskWithMissingFactorTag.xml b/glsk/glsk-document-cse/src/test/resources/testGlskWithMissingFactorTag.xml index 9a1012c8..a2759346 100644 --- a/glsk/glsk-document-cse/src/test/resources/testGlskWithMissingFactorTag.xml +++ b/glsk/glsk-document-cse/src/test/resources/testGlskWithMissingFactorTag.xml @@ -75,7 +75,7 @@ - + @@ -96,7 +96,7 @@ - + diff --git a/glsk/glsk-document-io-api/src/main/java/com/powsybl/glsk/api/io/GlskDocumentImporter.java b/glsk/glsk-document-io-api/src/main/java/com/powsybl/glsk/api/io/GlskDocumentImporter.java index 02fd9d99..3ec59e4a 100644 --- a/glsk/glsk-document-io-api/src/main/java/com/powsybl/glsk/api/io/GlskDocumentImporter.java +++ b/glsk/glsk-document-io-api/src/main/java/com/powsybl/glsk/api/io/GlskDocumentImporter.java @@ -8,6 +8,7 @@ package com.powsybl.glsk.api.io; import com.powsybl.glsk.api.GlskDocument; +import org.apache.commons.lang3.NotImplementedException; import java.io.InputStream; @@ -21,5 +22,9 @@ public interface GlskDocumentImporter { GlskDocument importGlsk(InputStream inputStream); + default GlskDocument importGlsk(InputStream inputStream, boolean useCalculationDirections) { + throw new NotImplementedException("This importer does not handle CalculationDirections"); + } + boolean canImport(InputStream inputStream); } diff --git a/glsk/glsk-document-io-api/src/main/java/com/powsybl/glsk/api/io/GlskDocumentImporters.java b/glsk/glsk-document-io-api/src/main/java/com/powsybl/glsk/api/io/GlskDocumentImporters.java index 1c6bce90..aab61871 100644 --- a/glsk/glsk-document-io-api/src/main/java/com/powsybl/glsk/api/io/GlskDocumentImporters.java +++ b/glsk/glsk-document-io-api/src/main/java/com/powsybl/glsk/api/io/GlskDocumentImporters.java @@ -59,6 +59,16 @@ public static GlskDocument importGlsk(InputStream inputStream) { return importer.importGlsk(new ByteArrayInputStream(bytes)); } + public static GlskDocument importGlskWithCalculationDirections(InputStream inputStream) { + byte[] bytes = getBytesFromInputStream(inputStream); + + GlskDocumentImporter importer = findImporter(new ByteArrayInputStream(bytes)); + if (importer == null) { + throw new GlskException("No importer found for this file"); + } + return importer.importGlsk(new ByteArrayInputStream(bytes), true); + } + public static GlskDocumentImporter findImporter(InputStream inputStream) { byte[] bytes = getBytesFromInputStream(inputStream); diff --git a/pom.xml b/pom.xml index 5f64cd5f..53c94532 100644 --- a/pom.xml +++ b/pom.xml @@ -67,6 +67,9 @@ 0.41 1.9.0 + 3.1.0 + 4.0.0 + 4.0.0 @@ -80,6 +83,18 @@ commons + + + + + org.codehaus.mojo + jaxb2-maven-plugin + ${maven.jaxb2.version} + + + + + @@ -161,6 +176,17 @@ powsybl-glsk-quality-check-ucte ${project.version} + + jakarta.xml.bind + jakarta.xml.bind-api + ${jakarta.xml.bind.version} + + + com.sun.xml.bind + jaxb-impl + ${jaxb.impl.version} + runtime +