| ### Showing:
Annotations
Attributes
Diagrams
Facets
Instances
Model
Properties
Source
Used by

## Table of Contents

Main schema dpgsimgridschema_2.43.xsd

Annotations |
    ================== Grid Simulations with Adaptricity - Required Grid Data ==================

    ================== 1. Purpose of this Document ==================

    This document gives an overview over the kind of grid data that is required for grid simulations within the Adaptricity platform. It serves to clarify the data situation at a grid operator with respect to the requirements such that a data converter can be constructed.

    ================== 2. Adaptricity Grid Model Format ==================

    The internal grid model format of Adaptricity is XML-based with a defined data model. An XSD file is available which formally specifies the format/data model and allows to validate an existing XML file against the specification. For viewing the XSD in a graphical form and validating XML files, there are several freely available tools, e.g., http://qxmledit.org/.
    Please note that the XSD is the formal specification of the file format and this document is meant as a high-level overview for simplified initial understanding. In case of any contradictions, the XSD takes precedence over this document.

    ================== 3. Possible Segmentation of the Grid Model ==================

    A real grid area of a grid operator (e.g., the perimeter of a primary substation including low-voltage connections) can be contained in one comprehensive grid model. Alternatively, it can be segmented into different grid models in order to speed up certain computation tasks (e.g., connection requests).
    One XML file is currently imported as one grid model in the Adaptricity platform. This means that, if a segmented representation of the grid is desired, segmented grid models must be exported from the source system and separately imported into the Adaptricity platform.
    As of mid-2019, a feature is available in the Adaptricity platform that can segment imported grid models and link them back together according to the user’s computation needs.

    ================== 4. Elements of the Node-Branch Model ==================

    Grid models in the Adaptricity platform consist of a node-branch model of the topology with defined parameters for the various grid elements.
    Possible types of nodes are house connection points, busbars, cable sleeves etc. The branches can be lines (overhead or underground), transformers (possibly with tap-changer), lines with voltage regulators, switches (load switches, circuit breakers, disconnect switches). At a node (generally referred to as bus in the Adaptricity platform), further elements can be connected: Network feeder, load, or generator. Line voltage regulators and fuses are attached to an existing line element. For the fuse, it must be specified to which end of the line it belongs to.
    The network feeder has a special meaning in the grid model: It represents the connection of the simulated grid to the overlying grid level by pointing to the so-called slack bus in the load flow model. A slack bus is a grid node that supplies or consumes the exact amount of active and reactive power such that the power balance of the simulated grid is fulfilled. In doing so, the slack bus maintains a defined voltage magnitude and angle. While the angle can be set to an arbitrary value, the voltage magnitude (defined in per-unit) has a strong impact on the behavior of the grid since it sets the voltage reference level. It should be set to a realistic level in static simulations or parameterized with a measured voltage time-series in a time-series simulation. Both can be done within the Adaptricity platform.
    The grid topology can be displayed in a schematic view with freely configurable layout as well as on a map in its real geographical layout. Note that a grid that looks correct in the GIS view can still have missing logical links since, e.g., a line can be correctly drawn between two buses without being topologically connected to these two buses. Consequently, it is usually useful to verify the correctness of a grid import in the schematic view.
    In the schematic view, grid elements are positioned based on x-y coordinates on a canvas. After a GIS-based import, the GIS coordinates provide the basis for initial placement of the elements on the canvas. Consequently, it is not necessary to fill them separately in the GIS export.
    For running a power flow computation, the node-branch model needs to be complete in the sense that all grid elements are properly connected (e.g., every branch has a start and end node and no disconnected parts of the grid exist) and all required electrical parameters are defined.
    For attaching static load and generation objects or time series to grid buses for the purpose of load flows and time-series simulations in the Adaptricity platform, buses need to be referenced, e.g., in the list of final customers present on that grid. For this purpose, the ID, name, description or a special property called customersToBusMatchingID can be used. This mechanism establishes the link between the grid topology and anything that happens on that topology.

    ================== 5. Detail Schemes and Switching States ==================

    The topology of a grid area is comprised of two different aspects:
    a.	The layout of cables and overhead lines in the field
    b.	The inner topology of primary and secondary substations and distribution cabinets
    While a. is usually quite straight-forward to extract from a GIS, b. is usually contained in special schematic diagrams, often referred to as detail schemes. Especially on lower voltage levels, the inner topology usually determines how a grid is operated (radially, in closed rings, weakly meshed, fully meshed) by means of switches that are open or closed.
    In order to obtain a consistent topology for grid simulations, both a. and b. need to be merged to the same node-branch model by traversing the grid and associating the correct switching states to the correct line ends and transformer terminals. This is a requirement for the export mechanism which is run on the source data. In the Adaptricity platform, we do not depict detail schemes separately. Both, the switching state of switches and fuses as well as the activation state of lines can be set in the Adaptricity grid model format.

    ================== 6. Descriptive and Electrical Parameters of Lines and Transformers ==================

    While a GIS often contains descriptive information about the component type used in the field (e.g. cable cross section and material, transformer brand and model), it often does not contain the numerical parameters needed for a load flow computation (e.g., resistance and reactance). To perform a load flow on a GIS-based grid model, these usually must be supplied separately.
    In the Adaptricity platform, a component library for lines and transformers is available which can be matched to the components used in a grid model. The library comes with several pre-configured parameter sets for typical lines and transformers and can be extended by the user.
    The procedure for using the component database to enrich a GIS-based grid model import is as follows:
    •	First, it must be ensured that all the cables and transformers in the grid model coming from the GIS have a unique property, or combination of properties, that allows to identify the component unambiguously. E.g.
    	o	A component name for the transformer or line which is unique (straight-forward matching between component names of grid model and component libraries)
    	o	A transformer type which is clearly identifiable by its power rating (e.g., since the grid operator only uses one transformer type per rating)
    	o	A transformer type which is clearly identifiable by its brand and model name
    	o	A cable type which is clearly identifiable by its material and cross section (e.g., aluminum 150mm², since the grid operator only uses one type of aluminum 150mm² cables)
    •	Then, two alternatives exist:
    	o	Adapting the component library such that for each imported component a suitable match in the library exists
    	o	Adapting the data situation in the GIS such that the imported descriptive parameters match a record in the database
    •	During import of a grid model, the matching is performed automatically, and the model is enriched with the proper electrical parameters. For grid elements that have no unambiguous match in the database, the user is queried for a matching decision.
Properties |
attribute form default | unqualified
element form default | unqualified

[ top ]
Element DefiniteTimeOvercurrentProtection / STAGE

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | Stage*
Children | Stage
Instance |
    <STAGE>
      <Stage CurrentInKiloampere="" SwitchOffTimeInSeconds="">{0,unbounded}</Stage>
    </STAGE>
Source |
    <xs:element name="STAGE" minOccurs="0" maxOccurs="1">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="Stage" minOccurs="0" maxOccurs="unbounded">
            <xs:annotation>
              <xs:documentation>A DTOP - definite time overcurrent protection device (Ger. 'UMZ - Unabhängiger Maximalstromzeitschutz') is a protection device, where the swich-off time depends on the short circuit current. DTOPs are configured, such that high currents are cleared faster than small currents. The reason is that high currents indicate a close proximity to the fault location. This current-time-dependency is expressed as list of time-current pair, wich discribes a step-shaped curve. Example: - 1kA / 3.0s - 2kA / 1.5s - 4kA / 0.5s The above list of current/time pairs represents this behavior: - Fault currents below 1kA are not cleared - Fault currents between 1kA and 2kA are cleared after 3s - Fault currents between 2kA and 4kA are cleared after 1.5s - Fault currents above 4kA are cleared after 0.5s</xs:documentation>
            </xs:annotation>
            <xs:complexType>
              <xs:attribute name="CurrentInKiloampere" type="xs:double">
                <xs:annotation>
                  <xs:documentation>When measuring a current between this current and the next higher CurrentInKiloampere, the devices clears the fault after SwitchOffTimeInSeconds seconds.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="SwitchOffTimeInSeconds" type="xs:double">
                <xs:annotation>
                  <xs:documentation>The time after which the fault is cleared.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
            </xs:complexType>
          </xs:element>
        </xs:sequence>
      </xs:complexType>
    </xs:element>

[ top ]
Element DefiniteTimeOvercurrentProtection / STAGE / Stage

Annotations |
    A DTOP - definite time overcurrent protection device (Ger. 'UMZ - Unabhängiger Maximalstromzeitschutz')
    										is a protection device, where the swich-off time depends on the short circuit current.
    										DTOPs are configured, such that high currents are cleared faster than small currents.
    										The reason is that high currents indicate a close proximity to the fault location.
    										This current-time-dependency is expressed as list of time-current pair, wich discribes a step-shaped curve.
    										Example:
    										- 1kA / 3.0s
    										- 2kA / 1.5s
    										- 4kA / 0.5s

    										The above list of current/time pairs represents this behavior:
    										- Fault currents below 1kA are not cleared
    										- Fault currents between 1kA and 2kA are cleared after 3s
    										- Fault currents between 2kA and 4kA are cleared after 1.5s
    										- Fault currents above 4kA are cleared after 0.5s
Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | unbounded
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
CurrentInKiloampere | xs:double | optional |
    When measuring a current between this current and the next higher CurrentInKiloampere, the devices clears the fault after SwitchOffTimeInSeconds seconds.
SwitchOffTimeInSeconds | xs:double | optional |
    The time after which the fault is cleared.
Source |
    <xs:element name="Stage" minOccurs="0" maxOccurs="unbounded">
      <xs:annotation>
        <xs:documentation>A DTOP - definite time overcurrent protection device (Ger. 'UMZ - Unabhängiger Maximalstromzeitschutz') is a protection device, where the swich-off time depends on the short circuit current. DTOPs are configured, such that high currents are cleared faster than small currents. The reason is that high currents indicate a close proximity to the fault location. This current-time-dependency is expressed as list of time-current pair, wich discribes a step-shaped curve. Example: - 1kA / 3.0s - 2kA / 1.5s - 4kA / 0.5s The above list of current/time pairs represents this behavior: - Fault currents below 1kA are not cleared - Fault currents between 1kA and 2kA are cleared after 3s - Fault currents between 2kA and 4kA are cleared after 1.5s - Fault currents above 4kA are cleared after 0.5s</xs:documentation>
      </xs:annotation>
      <xs:complexType>
        <xs:attribute name="CurrentInKiloampere" type="xs:double">
          <xs:annotation>
            <xs:documentation>When measuring a current between this current and the next higher CurrentInKiloampere, the devices clears the fault after SwitchOffTimeInSeconds seconds.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="SwitchOffTimeInSeconds" type="xs:double">
          <xs:annotation>
            <xs:documentation>The time after which the fault is cleared.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element DistanceProtection / STAGE

Annotations |
    A DP - distance protection device (Ger. 'Distanzschutz') is a protection device, where the swich-off time depends
    on the measured electical distance (in Ohm) to the fault location.
    DPs are configured, such that close faults (measured impedance low) are cleared faster than distant faults (measured impedance high).
    This distance-time-dependency is expressed as list of distance-time pairs, wich discribes a step-shaped curve.
    Stages of DistanceProtection devices work analogously to the stages of DefiniteTimeOvercurrentProtection devices
    with the difference the the distance is measured in Ohm instead of Ampere. For an example how to define stages, please look at the DefiniteTimeOvercurrentProtection device.
Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | Stage*
Children | Stage
Instance |
    <STAGE>
      <Stage ImpedanceInOhm="" SwitchOffTimeInSeconds="">{0,unbounded}</Stage>
    </STAGE>
Source |
    <xs:element name="STAGE" minOccurs="0" maxOccurs="1">
      <xs:annotation>
        <xs:documentation>A DP - distance protection device (Ger. 'Distanzschutz') is a protection device, where the swich-off time depends on the measured electical distance (in Ohm) to the fault location. DPs are configured, such that close faults (measured impedance low) are cleared faster than distant faults (measured impedance high). This distance-time-dependency is expressed as list of distance-time pairs, wich discribes a step-shaped curve. Stages of DistanceProtection devices work analogously to the stages of DefiniteTimeOvercurrentProtection devices with the difference the the distance is measured in Ohm instead of Ampere. For an example how to define stages, please look at the DefiniteTimeOvercurrentProtection device.</xs:documentation>
      </xs:annotation>
      <xs:complexType>
        <xs:sequence>
          <xs:element name="Stage" minOccurs="0" maxOccurs="unbounded">
            <xs:complexType>
              <xs:attribute name="ImpedanceInOhm" type="xs:double"/>
              <xs:attribute name="SwitchOffTimeInSeconds" type="xs:double"/>
            </xs:complexType>
          </xs:element>
        </xs:sequence>
      </xs:complexType>
    </xs:element>

[ top ]
Element DistanceProtection / STAGE / Stage

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | unbounded
Attributes |
QName | Type | Use |
--- | --- | --- | ---
ImpedanceInOhm | xs:double | optional |
SwitchOffTimeInSeconds | xs:double | optional |
Source |
    <xs:element name="Stage" minOccurs="0" maxOccurs="unbounded">
      <xs:complexType>
        <xs:attribute name="ImpedanceInOhm" type="xs:double"/>
        <xs:attribute name="SwitchOffTimeInSeconds" type="xs:double"/>
      </xs:complexType>
    </xs:element>

[ top ]
Element ReactivePowerCharacteristic / COSPHI_U_CHARACTERISTIC_DATA

Diagram |
Properties |
content | complex
minOccurs | 0
Model | CosPhiUCharacteristicData*
Children | CosPhiUCharacteristicData
Instance |
    <COSPHI_U_CHARACTERISTIC_DATA>
      <CosPhiUCharacteristicData CosPhi="" CosPhiType="" VoltageInPerUnit="">{0,unbounded}</CosPhiUCharacteristicData>
    </COSPHI_U_CHARACTERISTIC_DATA>
Source |
    <xs:element name="COSPHI_U_CHARACTERISTIC_DATA" minOccurs="0">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="CosPhiUCharacteristicData" type="CosPhiUCharacteristicDataPoint" minOccurs="0" maxOccurs="unbounded"/>
        </xs:sequence>
      </xs:complexType>
    </xs:element>

[ top ]
Element ReactivePowerCharacteristic / COSPHI_U_CHARACTERISTIC_DATA / CosPhiUCharacteristicData

Diagram |
Type | CosPhiUCharacteristicDataPoint
Properties |
content | complex
minOccurs | 0
maxOccurs | unbounded
Model |
Attributes |
QName | Type | Use |
--- | --- | --- | ---
CosPhi | xs:double | required |
CosPhiType | cosPhiType | optional |
VoltageInPerUnit | xs:double | required |
Source |
    <xs:element name="CosPhiUCharacteristicData" type="CosPhiUCharacteristicDataPoint" minOccurs="0" maxOccurs="unbounded"/>

[ top ]
Element ReactivePowerCharacteristic / Q_U_CHARACTERISTIC_DATA

Diagram |
Properties |
content | complex
minOccurs | 0
Model | QUCharacteristicData*
Children | QUCharacteristicData
Instance |
    <Q_U_CHARACTERISTIC_DATA>
      <QUCharacteristicData RelativeReactivePowerInPerUnit="" VoltageInPerUnit="">{0,unbounded}</QUCharacteristicData>
    </Q_U_CHARACTERISTIC_DATA>
Source |
    <xs:element name="Q_U_CHARACTERISTIC_DATA" minOccurs="0">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="QUCharacteristicData" type="QUCharacteristicDataPoint" minOccurs="0" maxOccurs="unbounded"/>
        </xs:sequence>
      </xs:complexType>
    </xs:element>

[ top ]
Element ReactivePowerCharacteristic / Q_U_CHARACTERISTIC_DATA / QUCharacteristicData

Diagram |
Type | QUCharacteristicDataPoint
Properties |
content | complex
minOccurs | 0
maxOccurs | unbounded
Model |
Attributes |
QName | Type | Use |
--- | --- | --- | ---
RelativeReactivePowerInPerUnit | xs:double | required |
VoltageInPerUnit | xs:double | required |
Source |
    <xs:element name="QUCharacteristicData" type="QUCharacteristicDataPoint" minOccurs="0" maxOccurs="unbounded"/>

[ top ]
Element GISType / Points

Diagram |
Properties |
content | complex
minOccurs | 1
maxOccurs | 1
Model | Point
Children | Point
Instance |
    <Points>
      <Point Lat="" Lon="">{1,1}</Point>
    </Points>
Source |
    <xs:element minOccurs="1" maxOccurs="1" name="Points">
      <xs:complexType>
        <xs:sequence maxOccurs="unbounded">
          <xs:element name="Point">
            <xs:complexType>
              <xs:attribute name="Lat" type="xs:double" use="required">
                <xs:annotation>
                  <xs:documentation>Latitude in WGS-84 projection of the current point</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Lon" type="xs:double" use="required">
                <xs:annotation>
                  <xs:documentation>Longitude in WGS-84 projection of the current point</xs:documentation>
                </xs:annotation>
              </xs:attribute>
            </xs:complexType>
          </xs:element>
        </xs:sequence>
      </xs:complexType>
    </xs:element>

[ top ]
Element GISType / Points / Point

Diagram |
Properties |
content | complex
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
Lat | xs:double | required |
    Latitude in WGS-84 projection of the current point
Lon | xs:double | required |
    Longitude in WGS-84 projection of the current point
Source |
    <xs:element name="Point">
      <xs:complexType>
        <xs:attribute name="Lat" type="xs:double" use="required">
          <xs:annotation>
            <xs:documentation>Latitude in WGS-84 projection of the current point</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Lon" type="xs:double" use="required">
          <xs:annotation>
            <xs:documentation>Longitude in WGS-84 projection of the current point</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID

Diagram |
Properties |
content | complex
Model | ALL(description{0,1} BUSBAR_NODE{0,1} LINE{0,1} CONNECTION{0,1} VOLTAGEREGULATOR{0,1} ASYMMETRIC_LINE{0,1} ASYMMETRIC_TRANSFORMER{0,1} TREE-W-TRANSFORMER{0,1} SHUNT{0,1} LOAD{0,1} GENERATOR{0,1} TRANSFORMER{0,1} FEEDER{0,1} FUSE{0,1} PROTECTIONDEVICE{0,1} SWITCH{0,1} SHAPE{0,1})
Children | ASYMMETRIC_LINE, ASYMMETRIC_TRANSFORMER, BUSBAR_NODE, CONNECTION, FEEDER, FUSE, GENERATOR, LINE, LOAD, PROTECTIONDEVICE, SHAPE, SHUNT, SWITCH, TRANSFORMER, TREE-W-TRANSFORMER, VOLTAGEREGULATOR, description
Instance |
    <GRID DPGXMLVersion="">
      <description>{0,1}</description>
      <BUSBAR_NODE>{0,1}</BUSBAR_NODE>
      <LINE>{0,1}</LINE>
      <CONNECTION>{0,1}</CONNECTION>
      <VOLTAGEREGULATOR>{0,1}</VOLTAGEREGULATOR>
      <ASYMMETRIC_LINE>{0,1}</ASYMMETRIC_LINE>
      <ASYMMETRIC_TRANSFORMER>{0,1}</ASYMMETRIC_TRANSFORMER>
      <TREE-W-TRANSFORMER>{0,1}</TREE-W-TRANSFORMER>
      <SHUNT>{0,1}</SHUNT>
      <LOAD>{0,1}</LOAD>
      <GENERATOR>{0,1}</GENERATOR>
      <TRANSFORMER>{0,1}</TRANSFORMER>
      <FEEDER>{0,1}</FEEDER>
      <FUSE>{0,1}</FUSE>
      <PROTECTIONDEVICE>{0,1}</PROTECTIONDEVICE>
      <SWITCH>{0,1}</SWITCH>
      <SHAPE>{0,1}</SHAPE>
    </GRID>
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
DPGXMLVersion | xs:string | optional |
    Internal file version of the XML file
Source |
    <xs:element name="GRID">
      <xs:complexType>
        <xs:all>
          <xs:element name="description" type="xs:string" minOccurs="0" maxOccurs="1">
            <xs:annotation>
              <xs:documentation>Descriptive field to add comments. Shown in the frontend of the software. Has no impact on any calculations.</xs:documentation>
            </xs:annotation>
          </xs:element>
          <xs:element name="BUSBAR_NODE" minOccurs="0" maxOccurs="1">
            <xs:complexType>
              <xs:sequence>
                <xs:element name="Node" minOccurs="0" maxOccurs="unbounded">
                  <xs:complexType>
                    <xs:all>
                      <xs:element name="GIS" type="GISType" maxOccurs="1" minOccurs="0"/>
                    </xs:all>
                    <xs:attribute name="ID" type="StringID" use="required">
                      <xs:annotation>
                        <xs:documentation>ID (see type StringID). Each Node requires a unique ID among all Nodes.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="CustomersToBusMatchingID" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>Customer-specific ID to match data (e.g., smartmeter data) to the bus.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Name" type="xs:string"/>
                    <xs:attribute name="Description" type="xs:string"/>
                    <xs:attribute name="ConstructionYear" type="xs:integer"/>
                    <xs:attribute name="ExternalURL" type="xs:anyURI"/>
                    <xs:attribute name="IsVertical" type="xs:boolean">
                      <xs:annotation>
                        <xs:documentation>Defines if the bus (if it is drawn as a bus bar) is drawn horizontally or vertically. Buses are drawn horizontally by default, i.e., if this attribute is absent.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Type" type="BusTypeEnum">
                      <xs:annotation>
                        <xs:documentation>Denotes the type of the grid node and shall be either TransformerStation, DistributionCabinet, CableJunction, BusBar, ConnectionPoint, SmallConnectionPoint, or Other</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="BaseVoltageInKilovolt" type="xs:double"/>
                    <xs:attribute name="SelfTimeInSeconds" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>Time required to deenergize underlying transformer station in case of fault. Optionally used in the protection calculation.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="x" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>x-coordinate of the bus to display in the schematic view</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="y" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>y-coordinate of the bus to display in the schematic view</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="LibraryRealibilityName" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                  </xs:complexType>
                </xs:element>
              </xs:sequence>
            </xs:complexType>
          </xs:element>
          <xs:element name="LINE" minOccurs="0" maxOccurs="1">
            <xs:complexType>
              <xs:sequence>
                <xs:choice>
                  <xs:element name="Line" minOccurs="0" maxOccurs="unbounded">
                    <xs:complexType>
                      <xs:sequence>
                        <xs:element name="GIS" type="GISType" minOccurs="0" maxOccurs="1"/>
                      </xs:sequence>
                      <xs:attribute name="ID" type="StringID" use="required">
                        <xs:annotation>
                          <xs:documentation>ID (see type StringID). Each Line requires a unique ID among all branch types (Line, Connection, Transformer).</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Name" type="xs:string"/>
                      <xs:attribute name="Description" type="xs:string"/>
                      <xs:attribute name="ConstructionYear" type="xs:integer"/>
                      <xs:attribute name="ExternalURL" type="xs:anyURI"/>
                      <xs:attribute name="ResistanceInOhmPerKilometer" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if resistance and reactance values are not given in the xml.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ReactanceInOhmPerKilometer" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if resistance and reactance values are not given in the xml.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ZeroSequenceResistanceInOhmPerKilometer" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Optional parameter for short circuit calculations involving ground faults. If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ZeroSequenceReactanceInOhmPerKilometer" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Optional parameter for short circuit calculations involving ground faults. If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="MaximumCurrentInAmpere" type="xs:double"/>
                      <xs:attribute name="ShortCircuitStabilityThreePhaseInKiloampere" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Optional parameter denoting the maximal three phase aperiodic short circuit current the line can withstand.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ShuntCapacitanceInMicrofaradPerKilometer" type="xs:double"/>
                      <xs:attribute name="LengthInKilometer" type="xs:double"/>
                      <xs:attribute name="Manufacturer" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>Manufacturer name (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="LibraryComponentName" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>Name of the component, must be unique in the component library (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="LibraryComponentType" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>Type of the cable (e.g., GKN). It will be removed after grid import, used for component library matching only if the required electrical attributes are missing.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="IsOverhead" type="xs:boolean">
                        <xs:annotation>
                          <xs:documentation>True if overhead line, false if underground cable or other (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Material" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>Material name (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="CrossSection" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>Cross section of the cable (e.g. 95mm^2, 3x95/95, ...), notation needs to match the notation in the component library.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Bus1ID" type="StringID">
                        <xs:annotation>
                          <xs:documentation>ID of bus 1 that it is connected to.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Bus2ID" type="StringID">
                        <xs:annotation>
                          <xs:documentation>ID of bus 2 that it is connected to.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
                        <xs:annotation>
                          <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected). Default value is true.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
                        <xs:annotation>
                          <xs:documentation>True if switch is closed (connected) at bus 2, false if open (not connected). Default value is true.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Owner" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>Each branch (lines, transformer, connection) in the grid model can be assigned an owner. The selectable owners can be configured in the general options in the Adaptricity Admin panel. For each owner, you can specify whether the associated branches are to be ignored when evaluating connection requests. These branches are referred to as "ignored" in the following. Ignored branches are handled differently: 1) In Adaptricity.Connect: a bus is ignored when calculating the hosting capacity if it is connected exclusively to ignored branches. As a result, these buses are not available as possible connection points in Adaptricity.Connect. If the 'Hosting capacity on lines' option has been selected, hosting capacities are also not calculated on ignored lines. 2) In the user-defined connection request: During the automatic selection of potential connection nodes, those nodes that are connected exclusively to ignored branches are ignored.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="LibraryRealibilityName" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                    </xs:complexType>
                  </xs:element>
                </xs:choice>
              </xs:sequence>
            </xs:complexType>
          </xs:element>
          <xs:element name="CONNECTION" minOccurs="0" maxOccurs="1">
            <xs:complexType>
              <xs:sequence>
                <xs:choice>
                  <xs:element name="Connection" minOccurs="0" maxOccurs="unbounded">
                    <xs:complexType>
                      <xs:sequence>
                        <xs:element name="GIS" type="GISType" minOccurs="0" maxOccurs="1"/>
                      </xs:sequence>
                      <xs:attribute name="ID" type="StringID" use="required">
                        <xs:annotation>
                          <xs:documentation>ID (see type StringID). Each Line requires a unique ID among all branch types (Line, Connection, Transformer).</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Name" type="xs:string"/>
                      <xs:attribute name="Description" type="xs:string"/>
                      <xs:attribute name="ConstructionYear" type="xs:integer"/>
                      <xs:attribute name="ExternalURL" type="xs:anyURI"/>
                      <xs:attribute name="ResistanceInMilliOhm" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Resistance in mΩ. Optional parameter. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided, the connection has a minimal resistance of 1mΩ (for numerical reasons).</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ReactanceInMilliOhm" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Reactance in mΩ. Optional parameter. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided, the connection has a minimal resistance of 1mΩ (for numerical reasons).</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Bus1ID" type="StringID">
                        <xs:annotation>
                          <xs:documentation>ID of bus 1 that it is connected to.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Bus2ID" type="StringID">
                        <xs:annotation>
                          <xs:documentation>ID of bus 2 that it is connected to.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
                        <xs:annotation>
                          <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected). Default value is true</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
                        <xs:annotation>
                          <xs:documentation>True if switch is closed (connected) at bus 2, false if open (not connected). Default value is true</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Owner" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>Each branch (lines, transformer, connection) in the grid model can be assigned an owner. The selectable owners can be configured in the general options in the Adaptricity Admin panel. For each owner, you can specify whether the associated branches are to be ignored when evaluating connection requests. These branches are referred to as "ignored" in the following. Ignored branches are handled differently: 1) In Adaptricity.Connect: a bus is ignored when calculating the hosting capacity if it is connected exclusively to ignored branches. As a result, these buses are not available as possible connection points in Adaptricity.Connect. If the 'Hosting capacity on lines' option has been selected, hosting capacities are also not calculated on ignored lines. 2) In the user-defined connection request: During the automatic selection of potential connection nodes, those nodes that are connected exclusively to ignored branches are ignored.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="LibraryRealibilityName" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                    </xs:complexType>
                  </xs:element>
                </xs:choice>
              </xs:sequence>
            </xs:complexType>
          </xs:element>
          <xs:element name="VOLTAGEREGULATOR" minOccurs="0" maxOccurs="1">
            <xs:complexType>
              <xs:sequence>
                <xs:choice>
                  <xs:element name="VoltageRegulator" minOccurs="0" maxOccurs="unbounded">
                    <xs:complexType>
                      <xs:attribute name="ID" type="StringID" use="required">
                        <xs:annotation>
                          <xs:documentation>ID (see type StringID). Each VoltageRegulator requires a unique ID among all VoltageRegulators.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Name" type="xs:string"/>
                      <xs:attribute name="Description" type="xs:string"/>
                      <xs:attribute name="ConstructionYear" type="xs:integer"/>
                      <xs:attribute name="ExternalURL" type="xs:anyURI"/>
                      <xs:attribute name="HostLineID" type="StringID"/>
                      <xs:attribute name="NumTaps" type="xs:integer"/>
                      <xs:attribute name="TapSizeFractionInPercent" type="xs:double"/>
                      <xs:attribute name="DeadBandFractionInPercent" type="xs:double"/>
                      <xs:attribute name="SetpointInPerUnit" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>This defines the desired voltage in per unit at the measured bus.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                    </xs:complexType>
                  </xs:element>
                </xs:choice>
              </xs:sequence>
            </xs:complexType>
          </xs:element>
          <xs:element name="ASYMMETRIC_LINE" minOccurs="0" maxOccurs="1"/>
          <xs:element name="ASYMMETRIC_TRANSFORMER" minOccurs="0" maxOccurs="1"/>
          <xs:element name="TREE-W-TRANSFORMER" minOccurs="0" maxOccurs="1"/>
          <xs:element name="SHUNT" minOccurs="0" maxOccurs="1"/>
          <xs:element name="LOAD" minOccurs="0" maxOccurs="1">
            <xs:complexType>
              <xs:sequence>
                <xs:element name="Load" minOccurs="0" maxOccurs="unbounded">
                  <xs:complexType>
                    <xs:sequence>
                      <xs:element name="ReactiveLoadCharacteristic" type="ReactivePowerCharacteristic" minOccurs="0"/>
                    </xs:sequence>
                    <xs:attribute name="ID" type="StringID" use="required">
                      <xs:annotation>
                        <xs:documentation>ID (see type StringID). Each Load requires a unique ID among all Loads.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Name" type="xs:string"/>
                    <xs:attribute name="Description" type="xs:string"/>
                    <xs:attribute name="ConstructionYear" type="xs:integer"/>
                    <xs:attribute name="ExternalURL" type="xs:anyURI"/>
                    <xs:attribute name="LoadCategory" type="LoadCategoryEnum"/>
                    <xs:attribute name="ActiveLoadInMegawatt" type="xs:double"/>
                    <xs:attribute name="Bus1ID" type="StringID">
                      <xs:annotation>
                        <xs:documentation>ID of bus 1 that it is connected to</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Connected" type="xs:boolean">
                      <xs:annotation>
                        <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected)</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ConnectionRequestID" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>Optional parameter. If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                  </xs:complexType>
                </xs:element>
              </xs:sequence>
            </xs:complexType>
          </xs:element>
          <xs:element name="GENERATOR" minOccurs="0" maxOccurs="1">
            <xs:complexType>
              <xs:sequence>
                <xs:element name="Generator" minOccurs="0" maxOccurs="unbounded">
                  <xs:complexType>
                    <xs:sequence>
                      <xs:element name="ReactiveGenerationCharacteristic" type="ReactivePowerCharacteristic" minOccurs="0"/>
                    </xs:sequence>
                    <xs:attribute name="ID" type="StringID" use="required">
                      <xs:annotation>
                        <xs:documentation>ID (see type StringID). Each Generator requires a unique ID among all Generators.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Name" type="xs:string"/>
                    <xs:attribute name="Description" type="xs:string"/>
                    <xs:attribute name="ConstructionYear" type="xs:integer"/>
                    <xs:attribute name="ExternalURL" type="xs:anyURI"/>
                    <xs:attribute name="GenerationCategory" type="GenerationCategoryEnum"/>
                    <xs:attribute name="ConnectionType" type="GenerationConnectionEnum"/>
                    <xs:attribute name="ActiveGenerationInMegawatt" type="xs:double"/>
                    <xs:attribute name="MinReactiveGenerationInMegavar" type="xs:double"/>
                    <xs:attribute name="MaxReactiveGenerationInMegavar" type="xs:double"/>
                    <xs:attribute name="MinActiveGenerationInMegawatt" type="xs:double"/>
                    <xs:attribute name="MaxActiveGenerationInMegawatt" type="xs:double"/>
                    <xs:attribute name="VoltageSetpointInKilovolt" type="xs:double"/>
                    <xs:attribute name="Bus1ID" type="StringID">
                      <xs:annotation>
                        <xs:documentation>ID of bus 1 that it is connected to</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Connected" type="xs:boolean">
                      <xs:annotation>
                        <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected)</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ConnectionRequestID" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>Optional parameter. If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="LibraryRealibilityName" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                  </xs:complexType>
                </xs:element>
              </xs:sequence>
            </xs:complexType>
          </xs:element>
          <xs:element name="TRANSFORMER" minOccurs="0" maxOccurs="1">
            <xs:complexType>
              <xs:sequence>
                <xs:choice>
                  <xs:element name="Transformer" minOccurs="0" maxOccurs="unbounded">
                    <xs:complexType>
                      <xs:sequence>
                        <xs:element name="GIS" type="GISType" minOccurs="0" maxOccurs="1"/>
                      </xs:sequence>
                      <xs:attribute name="ID" type="StringID" use="required">
                        <xs:annotation>
                          <xs:documentation>ID (see type StringID). Each Transformer requires a unique ID among all branch types (Line, Connection, Transformer).</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="MeasuredVoltageBusID" type="StringID">
                        <xs:annotation>
                          <xs:documentation>The bus ID at which the voltage is measured for the tap-changing controller (see type StringID)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Name" type="xs:string"/>
                      <xs:attribute name="Description" type="xs:string"/>
                      <xs:attribute name="ColorIndex" type="xs:nonNegativeInteger">
                        <xs:annotation>
                          <xs:documentation>Optional color index that, if set, will force the subgrid containing this transformer to the color with the specified index when grid colorization is turned on. The index references the color in the standard color palette used for grid colorization.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ConstructionYear" type="xs:integer"/>
                      <xs:attribute name="ExternalURL" type="xs:anyURI"/>
                      <xs:attribute name="VectorGroup" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>Vector group (Schaltgruppe) of transformer, e.g. Dyn5</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="StarPointGrounding" type="StarPointGrounding">
                        <xs:annotation>
                          <xs:documentation>Defines how the star point is grounded. If vectorGroup doesn't have a star point, leave empty.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="SecondaryGroundingInductanceInHenry" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>In case the star point grounding type 'Resonant grounding' was selected, this number defines the grounding inductance in Henry.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="TransformerRatingInMegavoltampere" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="MaximumApparentPowerInMegavoltampere" type="xs:double"/>
                      <xs:attribute name="ShortCircuitVoltageInPercent" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="CopperLossesInPercent" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="RatedVoltageAtBus1" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Rated transformer voltage on the side of Bus 1 in Kilovolt</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="RatedVoltageAtBus2" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Rated transformer voltage on the side of Bus 2 in Kilovolt.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="IsTapChanging" type="xs:boolean">
                        <xs:annotation>
                          <xs:documentation>True if transformer is a tap-changing transformer.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="NumTaps" type="xs:int">
                        <xs:annotation>
                          <xs:documentation>For tap-changing transformers, it defines the number of taps.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="TapSizeInPercent" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>For tap-changing transformers, it defines the tap size in percent (%)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="DeadBandInPercent" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>For tap-changing transformers, it defines the dead band in percent (%)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="SetpointInPerUnit" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>For tap-changing transformers, it defines the desired voltage in per unit at the measured bus.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Model" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>Text field (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Manufacturer" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>Manufacturer name (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="LibraryComponentName" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>Name of the component, must be unique in the component library (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="LibraryComponentType" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>Type of the transformer as described in the library (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Bus1ID" type="StringID">
                        <xs:annotation>
                          <xs:documentation>ID of bus 1 that it is connected to.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Bus2ID" type="StringID">
                        <xs:annotation>
                          <xs:documentation>ID of bus 2 that it is connected to.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
                        <xs:annotation>
                          <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected). Default value is true.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
                        <xs:annotation>
                          <xs:documentation>True if switch is closed (connected) at bus 2, false if open (not connected). Default value is true.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Owner" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>Each branch (lines, transformer, connection) in the grid model can be assigned an owner. The selectable owners can be configured in the general options in the Adaptricity Admin panel. For each owner, you can specify whether the associated branches are to be ignored when evaluating connection requests. These branches are referred to as "ignored" in the following. Ignored branches are handled differently: 1) In Adaptricity.Connect: a bus is ignored when calculating the hosting capacity if it is connected exclusively to ignored branches. As a result, these buses are not available as possible connection points in Adaptricity.Connect. If the 'Hosting capacity on lines' option has been selected, hosting capacities are also not calculated on ignored lines. 2) In the user-defined connection request: During the automatic selection of potential connection nodes, those nodes that are connected exclusively to ignored branches are ignored.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="LibraryRealibilityName" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                    </xs:complexType>
                  </xs:element>
                </xs:choice>
              </xs:sequence>
            </xs:complexType>
          </xs:element>
          <xs:element name="FEEDER" minOccurs="0" maxOccurs="1">
            <xs:complexType>
              <xs:sequence>
                <xs:element name="Feeder" minOccurs="0" maxOccurs="unbounded">
                  <xs:complexType>
                    <xs:attribute name="ID" type="StringID" use="required">
                      <xs:annotation>
                        <xs:documentation>ID (see type StringID).</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Name" type="xs:string"/>
                    <xs:attribute name="HostBusID" type="StringID"/>
                    <xs:attribute name="Description" type="xs:string"/>
                    <xs:attribute name="ConstructionYear" type="xs:integer"/>
                    <xs:attribute name="ExternalURL" type="xs:anyURI"/>
                    <xs:attribute name="OperationalVoltageInPerUnit" type="xs:double"/>
                    <xs:attribute name="OperationalAngleInRadians" type="xs:double"/>
                    <xs:attribute name="VoltageFactorMax" type="xs:double"/>
                    <xs:attribute name="VoltageFactorMin" type="xs:double"/>
                    <xs:attribute name="MaxSourceShortCircuitPowerInMegavoltampere" type="xs:double"/>
                    <xs:attribute name="MinSourceShortCircuitPowerInMegavoltampere" type="xs:double"/>
                    <xs:attribute name="ReactanceToResistanceRatio" type="xs:double"/>
                    <xs:attribute name="Connected" type="xs:boolean">
                      <xs:annotation>
                        <xs:documentation>True if switch is closed (connected) at the host bus, false if open (not connected)</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                  </xs:complexType>
                </xs:element>
              </xs:sequence>
            </xs:complexType>
          </xs:element>
          <xs:element name="FUSE" minOccurs="0" maxOccurs="1">
            <xs:complexType>
              <xs:sequence>
                <xs:element name="Fuse" minOccurs="0" maxOccurs="unbounded">
                  <xs:complexType>
                    <xs:attribute name="ID" type="StringID" use="required">
                      <xs:annotation>
                        <xs:documentation>ID (see type StringID). Each Fuse requires a unique ID among all Fuses.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Name" type="xs:string"/>
                    <xs:attribute name="Description" type="xs:string"/>
                    <xs:attribute name="ConstructionYear" type="xs:integer"/>
                    <xs:attribute name="ExternalURL" type="xs:anyURI"/>
                    <xs:attribute name="HostBranchID" type="StringID">
                      <xs:annotation>
                        <xs:documentation>ID of the branch that the fuse is connected to (required)</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="BranchEnd" type="BranchEndEnum">
                      <xs:annotation>
                        <xs:documentation>The branch end that the fuse is connected to</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="FuseType" type="FuseTypeEnum"/>
                    <xs:attribute name="LibraryFuseName" type="xs:string"/>
                  </xs:complexType>
                </xs:element>
              </xs:sequence>
            </xs:complexType>
          </xs:element>
          <xs:element name="PROTECTIONDEVICE" minOccurs="0" maxOccurs="1">
            <xs:complexType>
              <xs:sequence>
                <xs:element name="ProtectionDevice" minOccurs="0" maxOccurs="unbounded" type="ProtectionDevice"/>
              </xs:sequence>
            </xs:complexType>
          </xs:element>
          <xs:element name="SWITCH" minOccurs="0" maxOccurs="1">
            <xs:complexType>
              <xs:sequence>
                <xs:element name="Switch" minOccurs="0" maxOccurs="unbounded">
                  <xs:complexType>
                    <xs:attribute name="ID" type="StringID" use="required">
                      <xs:annotation>
                        <xs:documentation>ID (see type StringID). Each Switch requires a unique ID among all Switches.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Name" type="xs:string"/>
                    <xs:attribute name="Description" type="xs:string"/>
                    <xs:attribute name="Type" type="SwitchTypeEnum"/>
                    <xs:attribute name="BranchEnd" type="BranchEndEnum"/>
                    <xs:attribute name="HostBranchID" type="xs:string"/>
                    <xs:attribute name="MaxAperiodicShortCircuitCurrentInKiloampere" type="xs:double"/>
                    <xs:attribute name="ConstructionYear" type="xs:integer"/>
                    <xs:attribute name="ExternalURL" type="xs:anyURI"/>
                    <xs:attribute name="LibraryRealibilityName" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                  </xs:complexType>
                </xs:element>
              </xs:sequence>
            </xs:complexType>
          </xs:element>
          <xs:element name="SHAPE" minOccurs="0" maxOccurs="1">
            <xs:complexType>
              <xs:sequence>
                <xs:element name="Shape" minOccurs="0" maxOccurs="unbounded">
                  <xs:annotation>
                    <xs:documentation>A shape (including text), applicable to both the map and schematic viewers. For compatibility with other (actual) grid elements, if a shape is used in the schematic viewer, the shape's position and size is defined by the (x1, y1) and (x2, y2) coordinates: - A line will go from (x1, y1) to (x2, y2) - A rectangle is defined by the upper left (x1, y1) and lower right coordinates (x2, y2) - An ellipse will be bound by the rectangle spanned by (x1, y1). (x2, y2) - For a polygon, (x1, y1). (x2, y2) define its bounding box. For the actual polygon definition, the GIS element is used. On the map, the GIS element is used all the time. For ellipses, a rectangular polygon is used into which the ellipse is inscribed.</xs:documentation>
                  </xs:annotation>
                  <xs:complexType>
                    <xs:all>
                      <xs:element name="GIS" type="GISType" minOccurs="0" maxOccurs="1"/>
                    </xs:all>
                    <xs:attribute name="ID" type="StringID" use="required"/>
                    <xs:attribute name="DisplayType" type="DisplayTypeEnum" use="required"/>
                    <xs:attribute name="Type" type="FormTypeEnum" use="required"/>
                    <xs:attribute name="x1" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>The x-coordinate of the upper left corner of the shape</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="y1" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>The y-coordinate of the upper left corner of the shape</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="x2" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>The x-coordinate of the lower right corner of the shape</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="y2" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>The y-coordinate of the lower right corner of the shape</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Name" type="xs:string"/>
                    <xs:attribute name="Description" type="xs:string"/>
                    <xs:attribute name="Text" type="xs:string"/>
                    <xs:attribute name="TextStyle" type="xs:integer">
                      <xs:annotation>
                        <xs:documentation>A bit mask of text styles. The following constants are OR-ed bitwise: - 1: italic - 2: bold - 4: underlined - 8: strikethrough</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="TextPosition" type="TextPositionEnumType"/>
                    <xs:attribute name="TextOrientation" type="TextOrientationEnumType"/>
                    <xs:attribute name="FontSize" type="xs:integer"/>
                    <xs:attribute name="TextColor" type="ColorType"/>
                    <xs:attribute name="OutlineColor" type="ColorType"/>
                    <xs:attribute name="BackgroundColor" type="ColorType"/>
                    <xs:attribute name="OutlineWidth" type="xs:integer"/>
                  </xs:complexType>
                </xs:element>
              </xs:sequence>
            </xs:complexType>
          </xs:element>
        </xs:all>
        <xs:attribute name="DPGXMLVersion" type="xs:string">
          <xs:annotation>
            <xs:documentation>Internal file version of the XML file</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / description

Annotations |
    Descriptive field to add comments.
    Shown in the frontend of the software. Has no impact on any calculations.
Diagram |
Type | xs:string
Properties |
content | simple
minOccurs | 0
maxOccurs | 1
Source |
    <xs:element name="description" type="xs:string" minOccurs="0" maxOccurs="1">
      <xs:annotation>
        <xs:documentation>Descriptive field to add comments. Shown in the frontend of the software. Has no impact on any calculations.</xs:documentation>
      </xs:annotation>
    </xs:element>

[ top ]
Element GRID / BUSBAR_NODE

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | Node*
Children | Node
Instance |
    <BUSBAR_NODE>
      <Node BaseVoltageInKilovolt="" ConstructionYear="" CustomersToBusMatchingID="" Description="" ExternalURL="" ID="" IsVertical="" LibraryRealibilityName="" Name="" SelfTimeInSeconds="" Type="" x="" y="">{0,unbounded}</Node>
    </BUSBAR_NODE>
Source |
    <xs:element name="BUSBAR_NODE" minOccurs="0" maxOccurs="1">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="Node" minOccurs="0" maxOccurs="unbounded">
            <xs:complexType>
              <xs:all>
                <xs:element name="GIS" type="GISType" maxOccurs="1" minOccurs="0"/>
              </xs:all>
              <xs:attribute name="ID" type="StringID" use="required">
                <xs:annotation>
                  <xs:documentation>ID (see type StringID). Each Node requires a unique ID among all Nodes.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="CustomersToBusMatchingID" type="xs:string">
                <xs:annotation>
                  <xs:documentation>Customer-specific ID to match data (e.g., smartmeter data) to the bus.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Name" type="xs:string"/>
              <xs:attribute name="Description" type="xs:string"/>
              <xs:attribute name="ConstructionYear" type="xs:integer"/>
              <xs:attribute name="ExternalURL" type="xs:anyURI"/>
              <xs:attribute name="IsVertical" type="xs:boolean">
                <xs:annotation>
                  <xs:documentation>Defines if the bus (if it is drawn as a bus bar) is drawn horizontally or vertically. Buses are drawn horizontally by default, i.e., if this attribute is absent.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Type" type="BusTypeEnum">
                <xs:annotation>
                  <xs:documentation>Denotes the type of the grid node and shall be either TransformerStation, DistributionCabinet, CableJunction, BusBar, ConnectionPoint, SmallConnectionPoint, or Other</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="BaseVoltageInKilovolt" type="xs:double"/>
              <xs:attribute name="SelfTimeInSeconds" type="xs:double">
                <xs:annotation>
                  <xs:documentation>Time required to deenergize underlying transformer station in case of fault. Optionally used in the protection calculation.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="x" type="xs:double">
                <xs:annotation>
                  <xs:documentation>x-coordinate of the bus to display in the schematic view</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="y" type="xs:double">
                <xs:annotation>
                  <xs:documentation>y-coordinate of the bus to display in the schematic view</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="LibraryRealibilityName" type="xs:string">
                <xs:annotation>
                  <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
            </xs:complexType>
          </xs:element>
        </xs:sequence>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / BUSBAR_NODE / Node

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | unbounded
Model | ALL(GIS{0,1})
Children | GIS
Instance |
    <Node BaseVoltageInKilovolt="" ConstructionYear="" CustomersToBusMatchingID="" Description="" ExternalURL="" ID="" IsVertical="" LibraryRealibilityName="" Name="" SelfTimeInSeconds="" Type="" x="" y="">
      <GIS ShapeType="">{0,1}</GIS>
    </Node>
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
BaseVoltageInKilovolt | xs:double | optional |
ConstructionYear | xs:integer | optional |
CustomersToBusMatchingID | xs:string | optional |
    Customer-specific ID to match data (e.g., smartmeter data) to the bus.
Description | xs:string | optional |
ExternalURL | xs:anyURI | optional |
ID | StringID | required |
    ID (see type StringID). Each Node requires a unique ID among all Nodes.
IsVertical | xs:boolean | optional |
    Defines if the bus (if it is drawn as a bus bar) is drawn horizontally or vertically. Buses are drawn horizontally by default, i.e., if this attribute is absent.
LibraryRealibilityName | xs:string | optional |
    Defines the used reliability model of Adaptricity's component library. The reliability model
    defines how long and how frequently the component is expected to fail.
Name | xs:string | optional |
SelfTimeInSeconds | xs:double | optional |
    Time required to deenergize underlying transformer station in case of fault. Optionally used in the protection calculation.
Type | BusTypeEnum | optional |
    Denotes the type of the grid node and shall be either TransformerStation, DistributionCabinet, CableJunction, BusBar, ConnectionPoint, SmallConnectionPoint, or Other
x | xs:double | optional |
    x-coordinate of the bus to display in the schematic view
y | xs:double | optional |
    y-coordinate of the bus to display in the schematic view
Source |
    <xs:element name="Node" minOccurs="0" maxOccurs="unbounded">
      <xs:complexType>
        <xs:all>
          <xs:element name="GIS" type="GISType" maxOccurs="1" minOccurs="0"/>
        </xs:all>
        <xs:attribute name="ID" type="StringID" use="required">
          <xs:annotation>
            <xs:documentation>ID (see type StringID). Each Node requires a unique ID among all Nodes.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="CustomersToBusMatchingID" type="xs:string">
          <xs:annotation>
            <xs:documentation>Customer-specific ID to match data (e.g., smartmeter data) to the bus.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string"/>
        <xs:attribute name="Description" type="xs:string"/>
        <xs:attribute name="ConstructionYear" type="xs:integer"/>
        <xs:attribute name="ExternalURL" type="xs:anyURI"/>
        <xs:attribute name="IsVertical" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>Defines if the bus (if it is drawn as a bus bar) is drawn horizontally or vertically. Buses are drawn horizontally by default, i.e., if this attribute is absent.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Type" type="BusTypeEnum">
          <xs:annotation>
            <xs:documentation>Denotes the type of the grid node and shall be either TransformerStation, DistributionCabinet, CableJunction, BusBar, ConnectionPoint, SmallConnectionPoint, or Other</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="BaseVoltageInKilovolt" type="xs:double"/>
        <xs:attribute name="SelfTimeInSeconds" type="xs:double">
          <xs:annotation>
            <xs:documentation>Time required to deenergize underlying transformer station in case of fault. Optionally used in the protection calculation.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="x" type="xs:double">
          <xs:annotation>
            <xs:documentation>x-coordinate of the bus to display in the schematic view</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="y" type="xs:double">
          <xs:annotation>
            <xs:documentation>y-coordinate of the bus to display in the schematic view</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="LibraryRealibilityName" type="xs:string">
          <xs:annotation>
            <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / BUSBAR_NODE / Node / GIS

Diagram |
Type | GISType
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | Points
Children | Points
Instance |
    <GIS ShapeType="">
      <Points>{1,1}</Points>
    </GIS>
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
ShapeType | ShapeTypeEnum | required |
    Type of shape, either Point, Line, or Polygon
Source |
    <xs:element name="GIS" type="GISType" maxOccurs="1" minOccurs="0"/>

[ top ]
Element GRID / LINE

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | (Line*)
Children | Line
Instance |
    <LINE>
      <Line Bus1ID="" Bus2ID="" ConnectedAtBus1="" ConnectedAtBus2="" ConstructionYear="" CrossSection="" Description="" ExternalURL="" ID="" IsOverhead="" LengthInKilometer="" LibraryComponentName="" LibraryComponentType="" LibraryRealibilityName="" Manufacturer="" Material="" MaximumCurrentInAmpere="" Name="" Owner="" ReactanceInOhmPerKilometer="" ResistanceInOhmPerKilometer="" ShortCircuitStabilityThreePhaseInKiloampere="" ShuntCapacitanceInMicrofaradPerKilometer="" ZeroSequenceReactanceInOhmPerKilometer="" ZeroSequenceResistanceInOhmPerKilometer="">{0,unbounded}</Line>
    </LINE>
Source |
    <xs:element name="LINE" minOccurs="0" maxOccurs="1">
      <xs:complexType>
        <xs:sequence>
          <xs:choice>
            <xs:element name="Line" minOccurs="0" maxOccurs="unbounded">
              <xs:complexType>
                <xs:sequence>
                  <xs:element name="GIS" type="GISType" minOccurs="0" maxOccurs="1"/>
                </xs:sequence>
                <xs:attribute name="ID" type="StringID" use="required">
                  <xs:annotation>
                    <xs:documentation>ID (see type StringID). Each Line requires a unique ID among all branch types (Line, Connection, Transformer).</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Name" type="xs:string"/>
                <xs:attribute name="Description" type="xs:string"/>
                <xs:attribute name="ConstructionYear" type="xs:integer"/>
                <xs:attribute name="ExternalURL" type="xs:anyURI"/>
                <xs:attribute name="ResistanceInOhmPerKilometer" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if resistance and reactance values are not given in the xml.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ReactanceInOhmPerKilometer" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if resistance and reactance values are not given in the xml.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ZeroSequenceResistanceInOhmPerKilometer" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Optional parameter for short circuit calculations involving ground faults. If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ZeroSequenceReactanceInOhmPerKilometer" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Optional parameter for short circuit calculations involving ground faults. If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="MaximumCurrentInAmpere" type="xs:double"/>
                <xs:attribute name="ShortCircuitStabilityThreePhaseInKiloampere" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Optional parameter denoting the maximal three phase aperiodic short circuit current the line can withstand.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ShuntCapacitanceInMicrofaradPerKilometer" type="xs:double"/>
                <xs:attribute name="LengthInKilometer" type="xs:double"/>
                <xs:attribute name="Manufacturer" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>Manufacturer name (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="LibraryComponentName" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>Name of the component, must be unique in the component library (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="LibraryComponentType" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>Type of the cable (e.g., GKN). It will be removed after grid import, used for component library matching only if the required electrical attributes are missing.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="IsOverhead" type="xs:boolean">
                  <xs:annotation>
                    <xs:documentation>True if overhead line, false if underground cable or other (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Material" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>Material name (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="CrossSection" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>Cross section of the cable (e.g. 95mm^2, 3x95/95, ...), notation needs to match the notation in the component library.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Bus1ID" type="StringID">
                  <xs:annotation>
                    <xs:documentation>ID of bus 1 that it is connected to.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Bus2ID" type="StringID">
                  <xs:annotation>
                    <xs:documentation>ID of bus 2 that it is connected to.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
                  <xs:annotation>
                    <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected). Default value is true.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
                  <xs:annotation>
                    <xs:documentation>True if switch is closed (connected) at bus 2, false if open (not connected). Default value is true.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Owner" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>Each branch (lines, transformer, connection) in the grid model can be assigned an owner. The selectable owners can be configured in the general options in the Adaptricity Admin panel. For each owner, you can specify whether the associated branches are to be ignored when evaluating connection requests. These branches are referred to as "ignored" in the following. Ignored branches are handled differently: 1) In Adaptricity.Connect: a bus is ignored when calculating the hosting capacity if it is connected exclusively to ignored branches. As a result, these buses are not available as possible connection points in Adaptricity.Connect. If the 'Hosting capacity on lines' option has been selected, hosting capacities are also not calculated on ignored lines. 2) In the user-defined connection request: During the automatic selection of potential connection nodes, those nodes that are connected exclusively to ignored branches are ignored.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="LibraryRealibilityName" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
              </xs:complexType>
            </xs:element>
          </xs:choice>
        </xs:sequence>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / LINE / Line

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | unbounded
Model | GIS{0,1}
Children | GIS
Instance |
    <Line Bus1ID="" Bus2ID="" ConnectedAtBus1="" ConnectedAtBus2="" ConstructionYear="" CrossSection="" Description="" ExternalURL="" ID="" IsOverhead="" LengthInKilometer="" LibraryComponentName="" LibraryComponentType="" LibraryRealibilityName="" Manufacturer="" Material="" MaximumCurrentInAmpere="" Name="" Owner="" ReactanceInOhmPerKilometer="" ResistanceInOhmPerKilometer="" ShortCircuitStabilityThreePhaseInKiloampere="" ShuntCapacitanceInMicrofaradPerKilometer="" ZeroSequenceReactanceInOhmPerKilometer="" ZeroSequenceResistanceInOhmPerKilometer="">
      <GIS ShapeType="">{0,1}</GIS>
    </Line>
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
Bus1ID | StringID | optional |
    ID of bus 1 that it is connected to.
Bus2ID | StringID | optional |
    ID of bus 2 that it is connected to.
ConnectedAtBus1 | xs:boolean | optional |
    True if switch is closed (connected) at
    bus 1, false if open (not connected).
    Default value is true.
ConnectedAtBus2 | xs:boolean | optional |
    True if switch is closed (connected) at
    bus 2, false if open (not connected).
    Default value is true.
ConstructionYear | xs:integer | optional |
CrossSection | xs:string | optional |
    Cross section of the cable (e.g. 95mm^2, 3x95/95, ...), notation needs to match the notation in the component library.
Description | xs:string | optional |
ExternalURL | xs:anyURI | optional |
ID | StringID | required |
    ID (see type StringID). Each Line requires a unique ID among all branch types (Line, Connection, Transformer).
IsOverhead | xs:boolean | optional |
    True if overhead line, false if underground cable or other (it will be removed after
    grid import, used for component library matching only if the required electrical attributes are missing)
LengthInKilometer | xs:double | optional |
LibraryComponentName | xs:string | optional |
    Name of the component, must be unique in the component library (it will be removed after grid
    import, used for component library matching only if the required electrical attributes are missing)
LibraryComponentType | xs:string | optional |
    Type of the cable (e.g., GKN). It will be removed after grid import, used
    for component library matching only if the required electrical attributes are missing.
LibraryRealibilityName | xs:string | optional |
    Defines the used reliability model of Adaptricity's component library. The reliability model
    defines how long and how frequently the component is expected to fail.
Manufacturer | xs:string | optional |
    Manufacturer name (it will be removed after grid import, used for component
    library matching only if the required electrical attributes are missing)
Material | xs:string | optional |
    Material name (it will be removed after grid import, used for
    component library matching only if the required electrical attributes are missing)
MaximumCurrentInAmpere | xs:double | optional |
Name | xs:string | optional |
Owner | xs:string | optional |
    Each branch (lines, transformer, connection) in the grid model can be assigned an owner. The selectable owners can be configured in the general options
    in the Adaptricity Admin panel. For each owner, you can specify whether the associated branches are to be ignored when evaluating connection requests.
    These branches are referred to as "ignored" in the following. Ignored branches are handled differently:
    1) In Adaptricity.Connect: a bus is ignored when calculating the hosting capacity if it is connected exclusively to ignored branches. As a result,
    these buses are not available as possible connection points in Adaptricity.Connect. If the 'Hosting capacity on lines' option has been selected,
    hosting capacities are also not calculated on ignored lines.
    2) In the user-defined connection request: During the automatic selection of potential connection nodes,
    those nodes that are connected exclusively to ignored branches are ignored.
ReactanceInOhmPerKilometer | xs:double | optional |
    Required for power flow simulations. It can be fetched from the
    Component Library if resistance and reactance values are not given in the xml.
ResistanceInOhmPerKilometer | xs:double | optional |
    Required for power flow simulations. It can be fetched from the
    Component Library if resistance and reactance values are not given in the xml.
ShortCircuitStabilityThreePhaseInKiloampere | xs:double | optional |
    Optional parameter denoting the maximal
    three phase aperiodic short circuit current the line can withstand.
ShuntCapacitanceInMicrofaradPerKilometer | xs:double | optional |
ZeroSequenceReactanceInOhmPerKilometer | xs:double | optional |
    Optional parameter for short circuit calculations involving
    ground faults. If undefined, zero sequence impedance is linked to positive
    sequence impedance using a constant factor.
ZeroSequenceResistanceInOhmPerKilometer | xs:double | optional |
    Optional parameter for short circuit calculations involving
    ground faults. If undefined, zero sequence impedance is linked to positive
    sequence impedance using a constant factor.
Source |
    <xs:element name="Line" minOccurs="0" maxOccurs="unbounded">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="GIS" type="GISType" minOccurs="0" maxOccurs="1"/>
        </xs:sequence>
        <xs:attribute name="ID" type="StringID" use="required">
          <xs:annotation>
            <xs:documentation>ID (see type StringID). Each Line requires a unique ID among all branch types (Line, Connection, Transformer).</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string"/>
        <xs:attribute name="Description" type="xs:string"/>
        <xs:attribute name="ConstructionYear" type="xs:integer"/>
        <xs:attribute name="ExternalURL" type="xs:anyURI"/>
        <xs:attribute name="ResistanceInOhmPerKilometer" type="xs:double">
          <xs:annotation>
            <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if resistance and reactance values are not given in the xml.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ReactanceInOhmPerKilometer" type="xs:double">
          <xs:annotation>
            <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if resistance and reactance values are not given in the xml.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ZeroSequenceResistanceInOhmPerKilometer" type="xs:double">
          <xs:annotation>
            <xs:documentation>Optional parameter for short circuit calculations involving ground faults. If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ZeroSequenceReactanceInOhmPerKilometer" type="xs:double">
          <xs:annotation>
            <xs:documentation>Optional parameter for short circuit calculations involving ground faults. If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="MaximumCurrentInAmpere" type="xs:double"/>
        <xs:attribute name="ShortCircuitStabilityThreePhaseInKiloampere" type="xs:double">
          <xs:annotation>
            <xs:documentation>Optional parameter denoting the maximal three phase aperiodic short circuit current the line can withstand.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ShuntCapacitanceInMicrofaradPerKilometer" type="xs:double"/>
        <xs:attribute name="LengthInKilometer" type="xs:double"/>
        <xs:attribute name="Manufacturer" type="xs:string">
          <xs:annotation>
            <xs:documentation>Manufacturer name (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="LibraryComponentName" type="xs:string">
          <xs:annotation>
            <xs:documentation>Name of the component, must be unique in the component library (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="LibraryComponentType" type="xs:string">
          <xs:annotation>
            <xs:documentation>Type of the cable (e.g., GKN). It will be removed after grid import, used for component library matching only if the required electrical attributes are missing.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="IsOverhead" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>True if overhead line, false if underground cable or other (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Material" type="xs:string">
          <xs:annotation>
            <xs:documentation>Material name (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="CrossSection" type="xs:string">
          <xs:annotation>
            <xs:documentation>Cross section of the cable (e.g. 95mm^2, 3x95/95, ...), notation needs to match the notation in the component library.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Bus1ID" type="StringID">
          <xs:annotation>
            <xs:documentation>ID of bus 1 that it is connected to.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Bus2ID" type="StringID">
          <xs:annotation>
            <xs:documentation>ID of bus 2 that it is connected to.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected). Default value is true.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>True if switch is closed (connected) at bus 2, false if open (not connected). Default value is true.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Owner" type="xs:string">
          <xs:annotation>
            <xs:documentation>Each branch (lines, transformer, connection) in the grid model can be assigned an owner. The selectable owners can be configured in the general options in the Adaptricity Admin panel. For each owner, you can specify whether the associated branches are to be ignored when evaluating connection requests. These branches are referred to as "ignored" in the following. Ignored branches are handled differently: 1) In Adaptricity.Connect: a bus is ignored when calculating the hosting capacity if it is connected exclusively to ignored branches. As a result, these buses are not available as possible connection points in Adaptricity.Connect. If the 'Hosting capacity on lines' option has been selected, hosting capacities are also not calculated on ignored lines. 2) In the user-defined connection request: During the automatic selection of potential connection nodes, those nodes that are connected exclusively to ignored branches are ignored.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="LibraryRealibilityName" type="xs:string">
          <xs:annotation>
            <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / LINE / Line / GIS

Diagram |
Type | GISType
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | Points
Children | Points
Instance |
    <GIS ShapeType="">
      <Points>{1,1}</Points>
    </GIS>
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
ShapeType | ShapeTypeEnum | required |
    Type of shape, either Point, Line, or Polygon
Source |
    <xs:element name="GIS" type="GISType" minOccurs="0" maxOccurs="1"/>

[ top ]
Element GRID / CONNECTION

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | (Connection*)
Children | Connection
Instance |
    <CONNECTION>
      <Connection Bus1ID="" Bus2ID="" ConnectedAtBus1="" ConnectedAtBus2="" ConstructionYear="" Description="" ExternalURL="" ID="" LibraryRealibilityName="" Name="" Owner="" ReactanceInMilliOhm="" ResistanceInMilliOhm="">{0,unbounded}</Connection>
    </CONNECTION>
Source |
    <xs:element name="CONNECTION" minOccurs="0" maxOccurs="1">
      <xs:complexType>
        <xs:sequence>
          <xs:choice>
            <xs:element name="Connection" minOccurs="0" maxOccurs="unbounded">
              <xs:complexType>
                <xs:sequence>
                  <xs:element name="GIS" type="GISType" minOccurs="0" maxOccurs="1"/>
                </xs:sequence>
                <xs:attribute name="ID" type="StringID" use="required">
                  <xs:annotation>
                    <xs:documentation>ID (see type StringID). Each Line requires a unique ID among all branch types (Line, Connection, Transformer).</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Name" type="xs:string"/>
                <xs:attribute name="Description" type="xs:string"/>
                <xs:attribute name="ConstructionYear" type="xs:integer"/>
                <xs:attribute name="ExternalURL" type="xs:anyURI"/>
                <xs:attribute name="ResistanceInMilliOhm" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Resistance in mΩ. Optional parameter. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided, the connection has a minimal resistance of 1mΩ (for numerical reasons).</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ReactanceInMilliOhm" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Reactance in mΩ. Optional parameter. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided, the connection has a minimal resistance of 1mΩ (for numerical reasons).</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Bus1ID" type="StringID">
                  <xs:annotation>
                    <xs:documentation>ID of bus 1 that it is connected to.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Bus2ID" type="StringID">
                  <xs:annotation>
                    <xs:documentation>ID of bus 2 that it is connected to.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
                  <xs:annotation>
                    <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected). Default value is true</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
                  <xs:annotation>
                    <xs:documentation>True if switch is closed (connected) at bus 2, false if open (not connected). Default value is true</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Owner" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>Each branch (lines, transformer, connection) in the grid model can be assigned an owner. The selectable owners can be configured in the general options in the Adaptricity Admin panel. For each owner, you can specify whether the associated branches are to be ignored when evaluating connection requests. These branches are referred to as "ignored" in the following. Ignored branches are handled differently: 1) In Adaptricity.Connect: a bus is ignored when calculating the hosting capacity if it is connected exclusively to ignored branches. As a result, these buses are not available as possible connection points in Adaptricity.Connect. If the 'Hosting capacity on lines' option has been selected, hosting capacities are also not calculated on ignored lines. 2) In the user-defined connection request: During the automatic selection of potential connection nodes, those nodes that are connected exclusively to ignored branches are ignored.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="LibraryRealibilityName" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
              </xs:complexType>
            </xs:element>
          </xs:choice>
        </xs:sequence>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / CONNECTION / Connection

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | unbounded
Model | GIS{0,1}
Children | GIS
Instance |
    <Connection Bus1ID="" Bus2ID="" ConnectedAtBus1="" ConnectedAtBus2="" ConstructionYear="" Description="" ExternalURL="" ID="" LibraryRealibilityName="" Name="" Owner="" ReactanceInMilliOhm="" ResistanceInMilliOhm="">
      <GIS ShapeType="">{0,1}</GIS>
    </Connection>
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
Bus1ID | StringID | optional |
    ID of bus 1 that it is connected to.
Bus2ID | StringID | optional |
    ID of bus 2 that it is connected to.
ConnectedAtBus1 | xs:boolean | optional |
    True if switch is closed (connected) at
    bus 1, false if open (not connected). Default value is true
ConnectedAtBus2 | xs:boolean | optional |
    True if switch is closed (connected) at
    bus 2, false if open (not connected). Default value is true
ConstructionYear | xs:integer | optional |
Description | xs:string | optional |
ExternalURL | xs:anyURI | optional |
ID | StringID | required |
    ID (see type StringID). Each Line requires a unique ID among all branch types (Line, Connection, Transformer).
LibraryRealibilityName | xs:string | optional |
    Defines the used reliability model of Adaptricity's component library. The reliability model
    defines how long and how frequently the component is expected to fail.
Name | xs:string | optional |
Owner | xs:string | optional |
    Each branch (lines, transformer, connection) in the grid model can be assigned an owner. The selectable owners can be configured in the general options
    in the Adaptricity Admin panel. For each owner, you can specify whether the associated branches are to be ignored when evaluating connection requests.
    These branches are referred to as "ignored" in the following. Ignored branches are handled differently:
    1) In Adaptricity.Connect: a bus is ignored when calculating the hosting capacity if it is connected exclusively to ignored branches. As a result,
    these buses are not available as possible connection points in Adaptricity.Connect. If the 'Hosting capacity on lines' option has been selected,
    hosting capacities are also not calculated on ignored lines.
    2) In the user-defined connection request: During the automatic selection of potential connection nodes,
    those nodes that are connected exclusively to ignored branches are ignored.
ReactanceInMilliOhm | xs:double | optional |
    Reactance in mΩ. Optional parameter. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided,
    the connection has a minimal resistance of 1mΩ (for numerical reasons).
ResistanceInMilliOhm | xs:double | optional |
    Resistance in mΩ. Optional parameter. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided,
    the connection has a minimal resistance of 1mΩ (for numerical reasons).
Source |
    <xs:element name="Connection" minOccurs="0" maxOccurs="unbounded">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="GIS" type="GISType" minOccurs="0" maxOccurs="1"/>
        </xs:sequence>
        <xs:attribute name="ID" type="StringID" use="required">
          <xs:annotation>
            <xs:documentation>ID (see type StringID). Each Line requires a unique ID among all branch types (Line, Connection, Transformer).</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string"/>
        <xs:attribute name="Description" type="xs:string"/>
        <xs:attribute name="ConstructionYear" type="xs:integer"/>
        <xs:attribute name="ExternalURL" type="xs:anyURI"/>
        <xs:attribute name="ResistanceInMilliOhm" type="xs:double">
          <xs:annotation>
            <xs:documentation>Resistance in mΩ. Optional parameter. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided, the connection has a minimal resistance of 1mΩ (for numerical reasons).</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ReactanceInMilliOhm" type="xs:double">
          <xs:annotation>
            <xs:documentation>Reactance in mΩ. Optional parameter. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided, the connection has a minimal resistance of 1mΩ (for numerical reasons).</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Bus1ID" type="StringID">
          <xs:annotation>
            <xs:documentation>ID of bus 1 that it is connected to.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Bus2ID" type="StringID">
          <xs:annotation>
            <xs:documentation>ID of bus 2 that it is connected to.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected). Default value is true</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>True if switch is closed (connected) at bus 2, false if open (not connected). Default value is true</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Owner" type="xs:string">
          <xs:annotation>
            <xs:documentation>Each branch (lines, transformer, connection) in the grid model can be assigned an owner. The selectable owners can be configured in the general options in the Adaptricity Admin panel. For each owner, you can specify whether the associated branches are to be ignored when evaluating connection requests. These branches are referred to as "ignored" in the following. Ignored branches are handled differently: 1) In Adaptricity.Connect: a bus is ignored when calculating the hosting capacity if it is connected exclusively to ignored branches. As a result, these buses are not available as possible connection points in Adaptricity.Connect. If the 'Hosting capacity on lines' option has been selected, hosting capacities are also not calculated on ignored lines. 2) In the user-defined connection request: During the automatic selection of potential connection nodes, those nodes that are connected exclusively to ignored branches are ignored.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="LibraryRealibilityName" type="xs:string">
          <xs:annotation>
            <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / CONNECTION / Connection / GIS

Diagram |
Type | GISType
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | Points
Children | Points
Instance |
    <GIS ShapeType="">
      <Points>{1,1}</Points>
    </GIS>
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
ShapeType | ShapeTypeEnum | required |
    Type of shape, either Point, Line, or Polygon
Source |
    <xs:element name="GIS" type="GISType" minOccurs="0" maxOccurs="1"/>

[ top ]
Element GRID / VOLTAGEREGULATOR

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | (VoltageRegulator*)
Children | VoltageRegulator
Instance |
    <VOLTAGEREGULATOR>
      <VoltageRegulator ConstructionYear="" DeadBandFractionInPercent="" Description="" ExternalURL="" HostLineID="" ID="" Name="" NumTaps="" SetpointInPerUnit="" TapSizeFractionInPercent="">{0,unbounded}</VoltageRegulator>
    </VOLTAGEREGULATOR>
Source |
    <xs:element name="VOLTAGEREGULATOR" minOccurs="0" maxOccurs="1">
      <xs:complexType>
        <xs:sequence>
          <xs:choice>
            <xs:element name="VoltageRegulator" minOccurs="0" maxOccurs="unbounded">
              <xs:complexType>
                <xs:attribute name="ID" type="StringID" use="required">
                  <xs:annotation>
                    <xs:documentation>ID (see type StringID). Each VoltageRegulator requires a unique ID among all VoltageRegulators.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Name" type="xs:string"/>
                <xs:attribute name="Description" type="xs:string"/>
                <xs:attribute name="ConstructionYear" type="xs:integer"/>
                <xs:attribute name="ExternalURL" type="xs:anyURI"/>
                <xs:attribute name="HostLineID" type="StringID"/>
                <xs:attribute name="NumTaps" type="xs:integer"/>
                <xs:attribute name="TapSizeFractionInPercent" type="xs:double"/>
                <xs:attribute name="DeadBandFractionInPercent" type="xs:double"/>
                <xs:attribute name="SetpointInPerUnit" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>This defines the desired voltage in per unit at the measured bus.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
              </xs:complexType>
            </xs:element>
          </xs:choice>
        </xs:sequence>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / VOLTAGEREGULATOR / VoltageRegulator

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | unbounded
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
ConstructionYear | xs:integer | optional |
DeadBandFractionInPercent | xs:double | optional |
Description | xs:string | optional |
ExternalURL | xs:anyURI | optional |
HostLineID | StringID | optional |
ID | StringID | required |
    ID (see type StringID). Each VoltageRegulator requires a unique ID among all VoltageRegulators.
Name | xs:string | optional |
NumTaps | xs:integer | optional |
SetpointInPerUnit | xs:double | optional |
    This defines the desired voltage in per unit at the measured bus.
TapSizeFractionInPercent | xs:double | optional |
Source |
    <xs:element name="VoltageRegulator" minOccurs="0" maxOccurs="unbounded">
      <xs:complexType>
        <xs:attribute name="ID" type="StringID" use="required">
          <xs:annotation>
            <xs:documentation>ID (see type StringID). Each VoltageRegulator requires a unique ID among all VoltageRegulators.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string"/>
        <xs:attribute name="Description" type="xs:string"/>
        <xs:attribute name="ConstructionYear" type="xs:integer"/>
        <xs:attribute name="ExternalURL" type="xs:anyURI"/>
        <xs:attribute name="HostLineID" type="StringID"/>
        <xs:attribute name="NumTaps" type="xs:integer"/>
        <xs:attribute name="TapSizeFractionInPercent" type="xs:double"/>
        <xs:attribute name="DeadBandFractionInPercent" type="xs:double"/>
        <xs:attribute name="SetpointInPerUnit" type="xs:double">
          <xs:annotation>
            <xs:documentation>This defines the desired voltage in per unit at the measured bus.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / ASYMMETRIC_LINE

Diagram |
Properties |
minOccurs | 0
maxOccurs | 1
Source |
    <xs:element name="ASYMMETRIC_LINE" minOccurs="0" maxOccurs="1"/>

[ top ]
Element GRID / ASYMMETRIC_TRANSFORMER

Diagram |
Properties |
minOccurs | 0
maxOccurs | 1
Source |
    <xs:element name="ASYMMETRIC_TRANSFORMER" minOccurs="0" maxOccurs="1"/>

[ top ]
Element GRID / TREE-W-TRANSFORMER

Diagram |
Properties |
minOccurs | 0
maxOccurs | 1
Source |
    <xs:element name="TREE-W-TRANSFORMER" minOccurs="0" maxOccurs="1"/>

[ top ]
Element GRID / SHUNT

Diagram |
Properties |
minOccurs | 0
maxOccurs | 1
Source |
    <xs:element name="SHUNT" minOccurs="0" maxOccurs="1"/>

[ top ]
Element GRID / LOAD

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | Load*
Children | Load
Instance |
    <LOAD>
      <Load ActiveLoadInMegawatt="" Bus1ID="" Connected="" ConnectionRequestID="" ConstructionYear="" Description="" ExternalURL="" ID="" LoadCategory="" Name="">{0,unbounded}</Load>
    </LOAD>
Source |
    <xs:element name="LOAD" minOccurs="0" maxOccurs="1">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="Load" minOccurs="0" maxOccurs="unbounded">
            <xs:complexType>
              <xs:sequence>
                <xs:element name="ReactiveLoadCharacteristic" type="ReactivePowerCharacteristic" minOccurs="0"/>
              </xs:sequence>
              <xs:attribute name="ID" type="StringID" use="required">
                <xs:annotation>
                  <xs:documentation>ID (see type StringID). Each Load requires a unique ID among all Loads.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Name" type="xs:string"/>
              <xs:attribute name="Description" type="xs:string"/>
              <xs:attribute name="ConstructionYear" type="xs:integer"/>
              <xs:attribute name="ExternalURL" type="xs:anyURI"/>
              <xs:attribute name="LoadCategory" type="LoadCategoryEnum"/>
              <xs:attribute name="ActiveLoadInMegawatt" type="xs:double"/>
              <xs:attribute name="Bus1ID" type="StringID">
                <xs:annotation>
                  <xs:documentation>ID of bus 1 that it is connected to</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Connected" type="xs:boolean">
                <xs:annotation>
                  <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected)</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ConnectionRequestID" type="xs:string">
                <xs:annotation>
                  <xs:documentation>Optional parameter. If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
            </xs:complexType>
          </xs:element>
        </xs:sequence>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / LOAD / Load

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | unbounded
Model | ReactiveLoadCharacteristic{0,1}
Children | ReactiveLoadCharacteristic
Instance |
    <Load ActiveLoadInMegawatt="" Bus1ID="" Connected="" ConnectionRequestID="" ConstructionYear="" Description="" ExternalURL="" ID="" LoadCategory="" Name="">
      <ReactiveLoadCharacteristic CharacteristicType="" CosPhiCharacteristicMaxCosPhiFormula="" CosPhiType="" FixedCosPhi="" FixedQInKilovar="" QUCosPhi="">{0,1}</ReactiveLoadCharacteristic>
    </Load>
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
ActiveLoadInMegawatt | xs:double | optional |
Bus1ID | StringID | optional |
    ID of bus 1 that it is connected to
Connected | xs:boolean | optional |
    True if switch is closed (connected) at bus
    1, false if open (not connected)
ConnectionRequestID | xs:string | optional |
    Optional parameter. If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration.
ConstructionYear | xs:integer | optional |
Description | xs:string | optional |
ExternalURL | xs:anyURI | optional |
ID | StringID | required |
    ID (see type StringID). Each Load requires a unique ID among all Loads.
LoadCategory | LoadCategoryEnum | optional |
Name | xs:string | optional |
Source |
    <xs:element name="Load" minOccurs="0" maxOccurs="unbounded">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="ReactiveLoadCharacteristic" type="ReactivePowerCharacteristic" minOccurs="0"/>
        </xs:sequence>
        <xs:attribute name="ID" type="StringID" use="required">
          <xs:annotation>
            <xs:documentation>ID (see type StringID). Each Load requires a unique ID among all Loads.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string"/>
        <xs:attribute name="Description" type="xs:string"/>
        <xs:attribute name="ConstructionYear" type="xs:integer"/>
        <xs:attribute name="ExternalURL" type="xs:anyURI"/>
        <xs:attribute name="LoadCategory" type="LoadCategoryEnum"/>
        <xs:attribute name="ActiveLoadInMegawatt" type="xs:double"/>
        <xs:attribute name="Bus1ID" type="StringID">
          <xs:annotation>
            <xs:documentation>ID of bus 1 that it is connected to</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Connected" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConnectionRequestID" type="xs:string">
          <xs:annotation>
            <xs:documentation>Optional parameter. If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / LOAD / Load / ReactiveLoadCharacteristic

Diagram |
Type | ReactivePowerCharacteristic
Properties |
content | complex
minOccurs | 0
Model | COSPHI_U_CHARACTERISTIC_DATA{0,1} , Q_U_CHARACTERISTIC_DATA{0,1}
Children | COSPHI_U_CHARACTERISTIC_DATA, Q_U_CHARACTERISTIC_DATA
Instance |
    <ReactiveLoadCharacteristic CharacteristicType="" CosPhiCharacteristicMaxCosPhiFormula="" CosPhiType="" FixedCosPhi="" FixedQInKilovar="" QUCosPhi="">
      <COSPHI_U_CHARACTERISTIC_DATA>{0,1}</COSPHI_U_CHARACTERISTIC_DATA>
      <Q_U_CHARACTERISTIC_DATA>{0,1}</Q_U_CHARACTERISTIC_DATA>
    </ReactiveLoadCharacteristic>
Attributes |
QName | Type | Use |
--- | --- | --- | ---
CharacteristicType | reactivePowerCharacteristicType | optional |
CosPhiCharacteristicMaxCosPhiFormula | xs:string | optional |
CosPhiType | cosPhiType | optional |
FixedCosPhi | xs:double | optional |
FixedQInKilovar | xs:double | optional |
QUCosPhi | xs:double | optional |
Source |
    <xs:element name="ReactiveLoadCharacteristic" type="ReactivePowerCharacteristic" minOccurs="0"/>

[ top ]
Element GRID / GENERATOR

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | Generator*
Children | Generator
Instance |
    <GENERATOR>
      <Generator ActiveGenerationInMegawatt="" Bus1ID="" Connected="" ConnectionRequestID="" ConnectionType="" ConstructionYear="" Description="" ExternalURL="" GenerationCategory="" ID="" LibraryRealibilityName="" MaxActiveGenerationInMegawatt="" MaxReactiveGenerationInMegavar="" MinActiveGenerationInMegawatt="" MinReactiveGenerationInMegavar="" Name="" VoltageSetpointInKilovolt="">{0,unbounded}</Generator>
    </GENERATOR>
Source |
    <xs:element name="GENERATOR" minOccurs="0" maxOccurs="1">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="Generator" minOccurs="0" maxOccurs="unbounded">
            <xs:complexType>
              <xs:sequence>
                <xs:element name="ReactiveGenerationCharacteristic" type="ReactivePowerCharacteristic" minOccurs="0"/>
              </xs:sequence>
              <xs:attribute name="ID" type="StringID" use="required">
                <xs:annotation>
                  <xs:documentation>ID (see type StringID). Each Generator requires a unique ID among all Generators.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Name" type="xs:string"/>
              <xs:attribute name="Description" type="xs:string"/>
              <xs:attribute name="ConstructionYear" type="xs:integer"/>
              <xs:attribute name="ExternalURL" type="xs:anyURI"/>
              <xs:attribute name="GenerationCategory" type="GenerationCategoryEnum"/>
              <xs:attribute name="ConnectionType" type="GenerationConnectionEnum"/>
              <xs:attribute name="ActiveGenerationInMegawatt" type="xs:double"/>
              <xs:attribute name="MinReactiveGenerationInMegavar" type="xs:double"/>
              <xs:attribute name="MaxReactiveGenerationInMegavar" type="xs:double"/>
              <xs:attribute name="MinActiveGenerationInMegawatt" type="xs:double"/>
              <xs:attribute name="MaxActiveGenerationInMegawatt" type="xs:double"/>
              <xs:attribute name="VoltageSetpointInKilovolt" type="xs:double"/>
              <xs:attribute name="Bus1ID" type="StringID">
                <xs:annotation>
                  <xs:documentation>ID of bus 1 that it is connected to</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Connected" type="xs:boolean">
                <xs:annotation>
                  <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected)</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ConnectionRequestID" type="xs:string">
                <xs:annotation>
                  <xs:documentation>Optional parameter. If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="LibraryRealibilityName" type="xs:string">
                <xs:annotation>
                  <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
            </xs:complexType>
          </xs:element>
        </xs:sequence>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / GENERATOR / Generator

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | unbounded
Model | ReactiveGenerationCharacteristic{0,1}
Children | ReactiveGenerationCharacteristic
Instance |
    <Generator ActiveGenerationInMegawatt="" Bus1ID="" Connected="" ConnectionRequestID="" ConnectionType="" ConstructionYear="" Description="" ExternalURL="" GenerationCategory="" ID="" LibraryRealibilityName="" MaxActiveGenerationInMegawatt="" MaxReactiveGenerationInMegavar="" MinActiveGenerationInMegawatt="" MinReactiveGenerationInMegavar="" Name="" VoltageSetpointInKilovolt="">
      <ReactiveGenerationCharacteristic CharacteristicType="" CosPhiCharacteristicMaxCosPhiFormula="" CosPhiType="" FixedCosPhi="" FixedQInKilovar="" QUCosPhi="">{0,1}</ReactiveGenerationCharacteristic>
    </Generator>
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
ActiveGenerationInMegawatt | xs:double | optional |
Bus1ID | StringID | optional |
    ID of bus 1 that it is connected to
Connected | xs:boolean | optional |
    True if switch is closed (connected) at bus
    1, false if open (not connected)
ConnectionRequestID | xs:string | optional |
    Optional parameter. If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration.
ConnectionType | GenerationConnectionEnum | optional |
ConstructionYear | xs:integer | optional |
Description | xs:string | optional |
ExternalURL | xs:anyURI | optional |
GenerationCategory | GenerationCategoryEnum | optional |
ID | StringID | required |
    ID (see type StringID). Each Generator requires a unique ID among all Generators.
LibraryRealibilityName | xs:string | optional |
    Defines the used reliability model of Adaptricity's component library. The reliability model
    defines how long and how frequently the component is expected to fail.
MaxActiveGenerationInMegawatt | xs:double | optional |
MaxReactiveGenerationInMegavar | xs:double | optional |
MinActiveGenerationInMegawatt | xs:double | optional |
MinReactiveGenerationInMegavar | xs:double | optional |
Name | xs:string | optional |
VoltageSetpointInKilovolt | xs:double | optional |
Source |
    <xs:element name="Generator" minOccurs="0" maxOccurs="unbounded">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="ReactiveGenerationCharacteristic" type="ReactivePowerCharacteristic" minOccurs="0"/>
        </xs:sequence>
        <xs:attribute name="ID" type="StringID" use="required">
          <xs:annotation>
            <xs:documentation>ID (see type StringID). Each Generator requires a unique ID among all Generators.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string"/>
        <xs:attribute name="Description" type="xs:string"/>
        <xs:attribute name="ConstructionYear" type="xs:integer"/>
        <xs:attribute name="ExternalURL" type="xs:anyURI"/>
        <xs:attribute name="GenerationCategory" type="GenerationCategoryEnum"/>
        <xs:attribute name="ConnectionType" type="GenerationConnectionEnum"/>
        <xs:attribute name="ActiveGenerationInMegawatt" type="xs:double"/>
        <xs:attribute name="MinReactiveGenerationInMegavar" type="xs:double"/>
        <xs:attribute name="MaxReactiveGenerationInMegavar" type="xs:double"/>
        <xs:attribute name="MinActiveGenerationInMegawatt" type="xs:double"/>
        <xs:attribute name="MaxActiveGenerationInMegawatt" type="xs:double"/>
        <xs:attribute name="VoltageSetpointInKilovolt" type="xs:double"/>
        <xs:attribute name="Bus1ID" type="StringID">
          <xs:annotation>
            <xs:documentation>ID of bus 1 that it is connected to</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Connected" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConnectionRequestID" type="xs:string">
          <xs:annotation>
            <xs:documentation>Optional parameter. If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="LibraryRealibilityName" type="xs:string">
          <xs:annotation>
            <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / GENERATOR / Generator / ReactiveGenerationCharacteristic

Diagram |
Type | ReactivePowerCharacteristic
Properties |
content | complex
minOccurs | 0
Model | COSPHI_U_CHARACTERISTIC_DATA{0,1} , Q_U_CHARACTERISTIC_DATA{0,1}
Children | COSPHI_U_CHARACTERISTIC_DATA, Q_U_CHARACTERISTIC_DATA
Instance |
    <ReactiveGenerationCharacteristic CharacteristicType="" CosPhiCharacteristicMaxCosPhiFormula="" CosPhiType="" FixedCosPhi="" FixedQInKilovar="" QUCosPhi="">
      <COSPHI_U_CHARACTERISTIC_DATA>{0,1}</COSPHI_U_CHARACTERISTIC_DATA>
      <Q_U_CHARACTERISTIC_DATA>{0,1}</Q_U_CHARACTERISTIC_DATA>
    </ReactiveGenerationCharacteristic>
Attributes |
QName | Type | Use |
--- | --- | --- | ---
CharacteristicType | reactivePowerCharacteristicType | optional |
CosPhiCharacteristicMaxCosPhiFormula | xs:string | optional |
CosPhiType | cosPhiType | optional |
FixedCosPhi | xs:double | optional |
FixedQInKilovar | xs:double | optional |
QUCosPhi | xs:double | optional |
Source |
    <xs:element name="ReactiveGenerationCharacteristic" type="ReactivePowerCharacteristic" minOccurs="0"/>

[ top ]
Element GRID / TRANSFORMER

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | (Transformer*)
Children | Transformer
Instance |
    <TRANSFORMER>
      <Transformer Bus1ID="" Bus2ID="" ColorIndex="" ConnectedAtBus1="" ConnectedAtBus2="" ConstructionYear="" CopperLossesInPercent="" DeadBandInPercent="" Description="" ExternalURL="" ID="" IsTapChanging="" LibraryComponentName="" LibraryComponentType="" LibraryRealibilityName="" Manufacturer="" MaximumApparentPowerInMegavoltampere="" MeasuredVoltageBusID="" Model="" Name="" NumTaps="" Owner="" RatedVoltageAtBus1="" RatedVoltageAtBus2="" SecondaryGroundingInductanceInHenry="" SetpointInPerUnit="" ShortCircuitVoltageInPercent="" StarPointGrounding="" TapSizeInPercent="" TransformerRatingInMegavoltampere="" VectorGroup="">{0,unbounded}</Transformer>
    </TRANSFORMER>
Source |
    <xs:element name="TRANSFORMER" minOccurs="0" maxOccurs="1">
      <xs:complexType>
        <xs:sequence>
          <xs:choice>
            <xs:element name="Transformer" minOccurs="0" maxOccurs="unbounded">
              <xs:complexType>
                <xs:sequence>
                  <xs:element name="GIS" type="GISType" minOccurs="0" maxOccurs="1"/>
                </xs:sequence>
                <xs:attribute name="ID" type="StringID" use="required">
                  <xs:annotation>
                    <xs:documentation>ID (see type StringID). Each Transformer requires a unique ID among all branch types (Line, Connection, Transformer).</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="MeasuredVoltageBusID" type="StringID">
                  <xs:annotation>
                    <xs:documentation>The bus ID at which the voltage is measured for the tap-changing controller (see type StringID)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Name" type="xs:string"/>
                <xs:attribute name="Description" type="xs:string"/>
                <xs:attribute name="ColorIndex" type="xs:nonNegativeInteger">
                  <xs:annotation>
                    <xs:documentation>Optional color index that, if set, will force the subgrid containing this transformer to the color with the specified index when grid colorization is turned on. The index references the color in the standard color palette used for grid colorization.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ConstructionYear" type="xs:integer"/>
                <xs:attribute name="ExternalURL" type="xs:anyURI"/>
                <xs:attribute name="VectorGroup" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>Vector group (Schaltgruppe) of transformer, e.g. Dyn5</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="StarPointGrounding" type="StarPointGrounding">
                  <xs:annotation>
                    <xs:documentation>Defines how the star point is grounded. If vectorGroup doesn't have a star point, leave empty.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="SecondaryGroundingInductanceInHenry" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>In case the star point grounding type 'Resonant grounding' was selected, this number defines the grounding inductance in Henry.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="TransformerRatingInMegavoltampere" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="MaximumApparentPowerInMegavoltampere" type="xs:double"/>
                <xs:attribute name="ShortCircuitVoltageInPercent" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="CopperLossesInPercent" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="RatedVoltageAtBus1" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Rated transformer voltage on the side of Bus 1 in Kilovolt</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="RatedVoltageAtBus2" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Rated transformer voltage on the side of Bus 2 in Kilovolt.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="IsTapChanging" type="xs:boolean">
                  <xs:annotation>
                    <xs:documentation>True if transformer is a tap-changing transformer.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="NumTaps" type="xs:int">
                  <xs:annotation>
                    <xs:documentation>For tap-changing transformers, it defines the number of taps.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="TapSizeInPercent" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>For tap-changing transformers, it defines the tap size in percent (%)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="DeadBandInPercent" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>For tap-changing transformers, it defines the dead band in percent (%)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="SetpointInPerUnit" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>For tap-changing transformers, it defines the desired voltage in per unit at the measured bus.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Model" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>Text field (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Manufacturer" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>Manufacturer name (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="LibraryComponentName" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>Name of the component, must be unique in the component library (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="LibraryComponentType" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>Type of the transformer as described in the library (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Bus1ID" type="StringID">
                  <xs:annotation>
                    <xs:documentation>ID of bus 1 that it is connected to.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Bus2ID" type="StringID">
                  <xs:annotation>
                    <xs:documentation>ID of bus 2 that it is connected to.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
                  <xs:annotation>
                    <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected). Default value is true.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
                  <xs:annotation>
                    <xs:documentation>True if switch is closed (connected) at bus 2, false if open (not connected). Default value is true.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Owner" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>Each branch (lines, transformer, connection) in the grid model can be assigned an owner. The selectable owners can be configured in the general options in the Adaptricity Admin panel. For each owner, you can specify whether the associated branches are to be ignored when evaluating connection requests. These branches are referred to as "ignored" in the following. Ignored branches are handled differently: 1) In Adaptricity.Connect: a bus is ignored when calculating the hosting capacity if it is connected exclusively to ignored branches. As a result, these buses are not available as possible connection points in Adaptricity.Connect. If the 'Hosting capacity on lines' option has been selected, hosting capacities are also not calculated on ignored lines. 2) In the user-defined connection request: During the automatic selection of potential connection nodes, those nodes that are connected exclusively to ignored branches are ignored.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="LibraryRealibilityName" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
              </xs:complexType>
            </xs:element>
          </xs:choice>
        </xs:sequence>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / TRANSFORMER / Transformer

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | unbounded
Model | GIS{0,1}
Children | GIS
Instance |
    <Transformer Bus1ID="" Bus2ID="" ColorIndex="" ConnectedAtBus1="" ConnectedAtBus2="" ConstructionYear="" CopperLossesInPercent="" DeadBandInPercent="" Description="" ExternalURL="" ID="" IsTapChanging="" LibraryComponentName="" LibraryComponentType="" LibraryRealibilityName="" Manufacturer="" MaximumApparentPowerInMegavoltampere="" MeasuredVoltageBusID="" Model="" Name="" NumTaps="" Owner="" RatedVoltageAtBus1="" RatedVoltageAtBus2="" SecondaryGroundingInductanceInHenry="" SetpointInPerUnit="" ShortCircuitVoltageInPercent="" StarPointGrounding="" TapSizeInPercent="" TransformerRatingInMegavoltampere="" VectorGroup="">
      <GIS ShapeType="">{0,1}</GIS>
    </Transformer>
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
Bus1ID | StringID | optional |
    ID of bus 1 that it is connected to.
Bus2ID | StringID | optional |
    ID of bus 2 that it is connected to.
ColorIndex | xs:nonNegativeInteger | optional |
    Optional color index that, if set, will force the subgrid containing this transformer
    to the color with the specified index when grid colorization is turned on.
    The index references the color in the standard color palette used for grid colorization.
ConnectedAtBus1 | xs:boolean | optional |
    True if switch is closed (connected) at
    bus 1, false if open (not connected).
    Default value is true.
ConnectedAtBus2 | xs:boolean | optional |
    True if switch is closed (connected) at
    bus 2, false if open (not connected).
    Default value is true.
ConstructionYear | xs:integer | optional |
CopperLossesInPercent | xs:double | optional |
    Required for power flow simulations. It can be fetched from the Component
    Library if short circuit voltage and copper losses values are not given in the xml.
DeadBandInPercent | xs:double | optional |
    For tap-changing transformers, it defines the dead band in percent (%)
Description | xs:string | optional |
ExternalURL | xs:anyURI | optional |
ID | StringID | required |
    ID (see type StringID). Each Transformer requires a unique ID among all branch types (Line, Connection, Transformer).
IsTapChanging | xs:boolean | optional |
    True if transformer is a tap-changing transformer.
LibraryComponentName | xs:string | optional |
    Name of the component, must be unique in the component library (it will be removed after
    grid import, used for component library matching only if the required electrical attributes are missing)
LibraryComponentType | xs:string | optional |
    Type of the transformer as described in the library (it will be removed after grid
    import, used for component library matching only if the required electrical attributes are missing)
LibraryRealibilityName | xs:string | optional |
    Defines the used reliability model of Adaptricity's component library. The reliability model
    defines how long and how frequently the component is expected to fail.
Manufacturer | xs:string | optional |
    Manufacturer name (it will be removed after grid	import, used for
    component library matching only if the required electrical attributes are missing)
MaximumApparentPowerInMegavoltampere | xs:double | optional |
MeasuredVoltageBusID | StringID | optional |
    The bus ID at which the voltage is measured for the tap-changing controller (see type StringID)
Model | xs:string | optional |
    Text field (it will be removed after grid	import, used for
    component library matching only if the required electrical attributes are missing)
Name | xs:string | optional |
NumTaps | xs:int | optional |
    For tap-changing transformers, it defines the number of taps.
Owner | xs:string | optional |
    Each branch (lines, transformer, connection) in the grid model can be assigned an owner. The selectable owners can be configured in the general options
    in the Adaptricity Admin panel. For each owner, you can specify whether the associated branches are to be ignored when evaluating connection requests.
    These branches are referred to as "ignored" in the following. Ignored branches are handled differently:
    1) In Adaptricity.Connect: a bus is ignored when calculating the hosting capacity if it is connected exclusively to ignored branches. As a result,
    these buses are not available as possible connection points in Adaptricity.Connect. If the 'Hosting capacity on lines' option has been selected,
    hosting capacities are also not calculated on ignored lines.
    2) In the user-defined connection request: During the automatic selection of potential connection nodes,
    those nodes that are connected exclusively to ignored branches are ignored.
RatedVoltageAtBus1 | xs:double | optional |
    Rated transformer voltage on the side of Bus 1 in Kilovolt
RatedVoltageAtBus2 | xs:double | optional |
    Rated transformer voltage on the side of Bus 2 in Kilovolt.
SecondaryGroundingInductanceInHenry | xs:double | optional |
    In case the star point grounding type 'Resonant grounding' was selected, this number defines the grounding inductance in Henry.
SetpointInPerUnit | xs:double | optional |
    For tap-changing transformers, it defines the desired voltage in per unit at the measured bus.
ShortCircuitVoltageInPercent | xs:double | optional |
    Required for power flow simulations. It can be fetched from the Component
    Library if short circuit voltage and copper losses values are not given in the xml.
StarPointGrounding | StarPointGrounding | optional |
    Defines how the star point is grounded. If vectorGroup doesn't have a star point, leave empty.
TapSizeInPercent | xs:double | optional |
    For tap-changing transformers, it defines the tap size in percent (%)
TransformerRatingInMegavoltampere | xs:double | optional |
    Required for power flow simulations. It can be fetched from the Component
    Library if short circuit voltage and copper losses values are not given in the xml.
VectorGroup | xs:string | optional |
    Vector group (Schaltgruppe) of transformer, e.g. Dyn5
Source |
    <xs:element name="Transformer" minOccurs="0" maxOccurs="unbounded">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="GIS" type="GISType" minOccurs="0" maxOccurs="1"/>
        </xs:sequence>
        <xs:attribute name="ID" type="StringID" use="required">
          <xs:annotation>
            <xs:documentation>ID (see type StringID). Each Transformer requires a unique ID among all branch types (Line, Connection, Transformer).</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="MeasuredVoltageBusID" type="StringID">
          <xs:annotation>
            <xs:documentation>The bus ID at which the voltage is measured for the tap-changing controller (see type StringID)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string"/>
        <xs:attribute name="Description" type="xs:string"/>
        <xs:attribute name="ColorIndex" type="xs:nonNegativeInteger">
          <xs:annotation>
            <xs:documentation>Optional color index that, if set, will force the subgrid containing this transformer to the color with the specified index when grid colorization is turned on. The index references the color in the standard color palette used for grid colorization.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConstructionYear" type="xs:integer"/>
        <xs:attribute name="ExternalURL" type="xs:anyURI"/>
        <xs:attribute name="VectorGroup" type="xs:string">
          <xs:annotation>
            <xs:documentation>Vector group (Schaltgruppe) of transformer, e.g. Dyn5</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="StarPointGrounding" type="StarPointGrounding">
          <xs:annotation>
            <xs:documentation>Defines how the star point is grounded. If vectorGroup doesn't have a star point, leave empty.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="SecondaryGroundingInductanceInHenry" type="xs:double">
          <xs:annotation>
            <xs:documentation>In case the star point grounding type 'Resonant grounding' was selected, this number defines the grounding inductance in Henry.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="TransformerRatingInMegavoltampere" type="xs:double">
          <xs:annotation>
            <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="MaximumApparentPowerInMegavoltampere" type="xs:double"/>
        <xs:attribute name="ShortCircuitVoltageInPercent" type="xs:double">
          <xs:annotation>
            <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="CopperLossesInPercent" type="xs:double">
          <xs:annotation>
            <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="RatedVoltageAtBus1" type="xs:double">
          <xs:annotation>
            <xs:documentation>Rated transformer voltage on the side of Bus 1 in Kilovolt</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="RatedVoltageAtBus2" type="xs:double">
          <xs:annotation>
            <xs:documentation>Rated transformer voltage on the side of Bus 2 in Kilovolt.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="IsTapChanging" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>True if transformer is a tap-changing transformer.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="NumTaps" type="xs:int">
          <xs:annotation>
            <xs:documentation>For tap-changing transformers, it defines the number of taps.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="TapSizeInPercent" type="xs:double">
          <xs:annotation>
            <xs:documentation>For tap-changing transformers, it defines the tap size in percent (%)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="DeadBandInPercent" type="xs:double">
          <xs:annotation>
            <xs:documentation>For tap-changing transformers, it defines the dead band in percent (%)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="SetpointInPerUnit" type="xs:double">
          <xs:annotation>
            <xs:documentation>For tap-changing transformers, it defines the desired voltage in per unit at the measured bus.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Model" type="xs:string">
          <xs:annotation>
            <xs:documentation>Text field (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Manufacturer" type="xs:string">
          <xs:annotation>
            <xs:documentation>Manufacturer name (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="LibraryComponentName" type="xs:string">
          <xs:annotation>
            <xs:documentation>Name of the component, must be unique in the component library (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="LibraryComponentType" type="xs:string">
          <xs:annotation>
            <xs:documentation>Type of the transformer as described in the library (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Bus1ID" type="StringID">
          <xs:annotation>
            <xs:documentation>ID of bus 1 that it is connected to.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Bus2ID" type="StringID">
          <xs:annotation>
            <xs:documentation>ID of bus 2 that it is connected to.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected). Default value is true.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>True if switch is closed (connected) at bus 2, false if open (not connected). Default value is true.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Owner" type="xs:string">
          <xs:annotation>
            <xs:documentation>Each branch (lines, transformer, connection) in the grid model can be assigned an owner. The selectable owners can be configured in the general options in the Adaptricity Admin panel. For each owner, you can specify whether the associated branches are to be ignored when evaluating connection requests. These branches are referred to as "ignored" in the following. Ignored branches are handled differently: 1) In Adaptricity.Connect: a bus is ignored when calculating the hosting capacity if it is connected exclusively to ignored branches. As a result, these buses are not available as possible connection points in Adaptricity.Connect. If the 'Hosting capacity on lines' option has been selected, hosting capacities are also not calculated on ignored lines. 2) In the user-defined connection request: During the automatic selection of potential connection nodes, those nodes that are connected exclusively to ignored branches are ignored.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="LibraryRealibilityName" type="xs:string">
          <xs:annotation>
            <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / TRANSFORMER / Transformer / GIS

Diagram |
Type | GISType
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | Points
Children | Points
Instance |
    <GIS ShapeType="">
      <Points>{1,1}</Points>
    </GIS>
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
ShapeType | ShapeTypeEnum | required |
    Type of shape, either Point, Line, or Polygon
Source |
    <xs:element name="GIS" type="GISType" minOccurs="0" maxOccurs="1"/>

[ top ]
Element GRID / FEEDER

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | Feeder*
Children | Feeder
Instance |
    <FEEDER>
      <Feeder Connected="" ConstructionYear="" Description="" ExternalURL="" HostBusID="" ID="" MaxSourceShortCircuitPowerInMegavoltampere="" MinSourceShortCircuitPowerInMegavoltampere="" Name="" OperationalAngleInRadians="" OperationalVoltageInPerUnit="" ReactanceToResistanceRatio="" VoltageFactorMax="" VoltageFactorMin="">{0,unbounded}</Feeder>
    </FEEDER>
Source |
    <xs:element name="FEEDER" minOccurs="0" maxOccurs="1">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="Feeder" minOccurs="0" maxOccurs="unbounded">
            <xs:complexType>
              <xs:attribute name="ID" type="StringID" use="required">
                <xs:annotation>
                  <xs:documentation>ID (see type StringID).</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Name" type="xs:string"/>
              <xs:attribute name="HostBusID" type="StringID"/>
              <xs:attribute name="Description" type="xs:string"/>
              <xs:attribute name="ConstructionYear" type="xs:integer"/>
              <xs:attribute name="ExternalURL" type="xs:anyURI"/>
              <xs:attribute name="OperationalVoltageInPerUnit" type="xs:double"/>
              <xs:attribute name="OperationalAngleInRadians" type="xs:double"/>
              <xs:attribute name="VoltageFactorMax" type="xs:double"/>
              <xs:attribute name="VoltageFactorMin" type="xs:double"/>
              <xs:attribute name="MaxSourceShortCircuitPowerInMegavoltampere" type="xs:double"/>
              <xs:attribute name="MinSourceShortCircuitPowerInMegavoltampere" type="xs:double"/>
              <xs:attribute name="ReactanceToResistanceRatio" type="xs:double"/>
              <xs:attribute name="Connected" type="xs:boolean">
                <xs:annotation>
                  <xs:documentation>True if switch is closed (connected) at the host bus, false if open (not connected)</xs:documentation>
                </xs:annotation>
              </xs:attribute>
            </xs:complexType>
          </xs:element>
        </xs:sequence>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / FEEDER / Feeder

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | unbounded
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
Connected | xs:boolean | optional |
    True if switch is closed (connected) at the
    host bus, false if open (not connected)
ConstructionYear | xs:integer | optional |
Description | xs:string | optional |
ExternalURL | xs:anyURI | optional |
HostBusID | StringID | optional |
ID | StringID | required |
    ID (see type StringID).
MaxSourceShortCircuitPowerInMegavoltampere | xs:double | optional |
MinSourceShortCircuitPowerInMegavoltampere | xs:double | optional |
Name | xs:string | optional |
OperationalAngleInRadians | xs:double | optional |
OperationalVoltageInPerUnit | xs:double | optional |
ReactanceToResistanceRatio | xs:double | optional |
VoltageFactorMax | xs:double | optional |
VoltageFactorMin | xs:double | optional |
Source |
    <xs:element name="Feeder" minOccurs="0" maxOccurs="unbounded">
      <xs:complexType>
        <xs:attribute name="ID" type="StringID" use="required">
          <xs:annotation>
            <xs:documentation>ID (see type StringID).</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string"/>
        <xs:attribute name="HostBusID" type="StringID"/>
        <xs:attribute name="Description" type="xs:string"/>
        <xs:attribute name="ConstructionYear" type="xs:integer"/>
        <xs:attribute name="ExternalURL" type="xs:anyURI"/>
        <xs:attribute name="OperationalVoltageInPerUnit" type="xs:double"/>
        <xs:attribute name="OperationalAngleInRadians" type="xs:double"/>
        <xs:attribute name="VoltageFactorMax" type="xs:double"/>
        <xs:attribute name="VoltageFactorMin" type="xs:double"/>
        <xs:attribute name="MaxSourceShortCircuitPowerInMegavoltampere" type="xs:double"/>
        <xs:attribute name="MinSourceShortCircuitPowerInMegavoltampere" type="xs:double"/>
        <xs:attribute name="ReactanceToResistanceRatio" type="xs:double"/>
        <xs:attribute name="Connected" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>True if switch is closed (connected) at the host bus, false if open (not connected)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / FUSE

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | Fuse*
Children | Fuse
Instance |
    <FUSE>
      <Fuse BranchEnd="" ConstructionYear="" Description="" ExternalURL="" FuseType="" HostBranchID="" ID="" LibraryFuseName="" Name="">{0,unbounded}</Fuse>
    </FUSE>
Source |
    <xs:element name="FUSE" minOccurs="0" maxOccurs="1">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="Fuse" minOccurs="0" maxOccurs="unbounded">
            <xs:complexType>
              <xs:attribute name="ID" type="StringID" use="required">
                <xs:annotation>
                  <xs:documentation>ID (see type StringID). Each Fuse requires a unique ID among all Fuses.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Name" type="xs:string"/>
              <xs:attribute name="Description" type="xs:string"/>
              <xs:attribute name="ConstructionYear" type="xs:integer"/>
              <xs:attribute name="ExternalURL" type="xs:anyURI"/>
              <xs:attribute name="HostBranchID" type="StringID">
                <xs:annotation>
                  <xs:documentation>ID of the branch that the fuse is connected to (required)</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="BranchEnd" type="BranchEndEnum">
                <xs:annotation>
                  <xs:documentation>The branch end that the fuse is connected to</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="FuseType" type="FuseTypeEnum"/>
              <xs:attribute name="LibraryFuseName" type="xs:string"/>
            </xs:complexType>
          </xs:element>
        </xs:sequence>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / FUSE / Fuse

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | unbounded
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
BranchEnd | BranchEndEnum | optional |
    The branch end that the fuse is connected to
ConstructionYear | xs:integer | optional |
Description | xs:string | optional |
ExternalURL | xs:anyURI | optional |
FuseType | FuseTypeEnum | optional |
HostBranchID | StringID | optional |
    ID of the branch that the fuse is connected to (required)
ID | StringID | required |
    ID (see type StringID). Each Fuse requires a unique ID among all Fuses.
LibraryFuseName | xs:string | optional |
Name | xs:string | optional |
Source |
    <xs:element name="Fuse" minOccurs="0" maxOccurs="unbounded">
      <xs:complexType>
        <xs:attribute name="ID" type="StringID" use="required">
          <xs:annotation>
            <xs:documentation>ID (see type StringID). Each Fuse requires a unique ID among all Fuses.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string"/>
        <xs:attribute name="Description" type="xs:string"/>
        <xs:attribute name="ConstructionYear" type="xs:integer"/>
        <xs:attribute name="ExternalURL" type="xs:anyURI"/>
        <xs:attribute name="HostBranchID" type="StringID">
          <xs:annotation>
            <xs:documentation>ID of the branch that the fuse is connected to (required)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="BranchEnd" type="BranchEndEnum">
          <xs:annotation>
            <xs:documentation>The branch end that the fuse is connected to</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="FuseType" type="FuseTypeEnum"/>
        <xs:attribute name="LibraryFuseName" type="xs:string"/>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / PROTECTIONDEVICE

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | ProtectionDevice*
Children | ProtectionDevice
Instance |
    <PROTECTIONDEVICE>
      <ProtectionDevice ConstructionYear="" Description="" Direction="" ExternalURL="" HostSwitchID="" ID="" Name="">{0,unbounded}</ProtectionDevice>
    </PROTECTIONDEVICE>
Source |
    <xs:element name="PROTECTIONDEVICE" minOccurs="0" maxOccurs="1">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="ProtectionDevice" minOccurs="0" maxOccurs="unbounded" type="ProtectionDevice"/>
        </xs:sequence>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / PROTECTIONDEVICE / ProtectionDevice

Diagram |
Type | ProtectionDevice
Properties |
content | complex
minOccurs | 0
maxOccurs | unbounded
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
ConstructionYear | xs:integer | optional |
Description | xs:string | optional |
Direction | ProtectionDeviceDirection | optional |
ExternalURL | xs:anyURI | optional |
HostSwitchID | StringID | optional |
    ID of the switch where the protection device is connected to (required). Previously called 'HostCircuitBreakerID'.
ID | StringID | required |
    ID (see type StringID). Each ProtectionDevice requires a unique ID among all ProtectionDevices.
Name | xs:string | optional |
Source |
    <xs:element name="ProtectionDevice" minOccurs="0" maxOccurs="unbounded" type="ProtectionDevice"/>

[ top ]
Element GRID / SWITCH

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | Switch*
Children | Switch
Instance |
    <SWITCH>
      <Switch BranchEnd="" ConstructionYear="" Description="" ExternalURL="" HostBranchID="" ID="" LibraryRealibilityName="" MaxAperiodicShortCircuitCurrentInKiloampere="" Name="" Type="">{0,unbounded}</Switch>
    </SWITCH>
Source |
    <xs:element name="SWITCH" minOccurs="0" maxOccurs="1">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="Switch" minOccurs="0" maxOccurs="unbounded">
            <xs:complexType>
              <xs:attribute name="ID" type="StringID" use="required">
                <xs:annotation>
                  <xs:documentation>ID (see type StringID). Each Switch requires a unique ID among all Switches.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Name" type="xs:string"/>
              <xs:attribute name="Description" type="xs:string"/>
              <xs:attribute name="Type" type="SwitchTypeEnum"/>
              <xs:attribute name="BranchEnd" type="BranchEndEnum"/>
              <xs:attribute name="HostBranchID" type="xs:string"/>
              <xs:attribute name="MaxAperiodicShortCircuitCurrentInKiloampere" type="xs:double"/>
              <xs:attribute name="ConstructionYear" type="xs:integer"/>
              <xs:attribute name="ExternalURL" type="xs:anyURI"/>
              <xs:attribute name="LibraryRealibilityName" type="xs:string">
                <xs:annotation>
                  <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
            </xs:complexType>
          </xs:element>
        </xs:sequence>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / SWITCH / Switch

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | unbounded
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
BranchEnd | BranchEndEnum | optional |
ConstructionYear | xs:integer | optional |
Description | xs:string | optional |
ExternalURL | xs:anyURI | optional |
HostBranchID | xs:string | optional |
ID | StringID | required |
    ID (see type StringID). Each Switch requires a unique ID among all Switches.
LibraryRealibilityName | xs:string | optional |
    Defines the used reliability model of Adaptricity's component library. The reliability model
    defines how long and how frequently the component is expected to fail.
MaxAperiodicShortCircuitCurrentInKiloampere | xs:double | optional |
Name | xs:string | optional |
Type | SwitchTypeEnum | optional |
Source |
    <xs:element name="Switch" minOccurs="0" maxOccurs="unbounded">
      <xs:complexType>
        <xs:attribute name="ID" type="StringID" use="required">
          <xs:annotation>
            <xs:documentation>ID (see type StringID). Each Switch requires a unique ID among all Switches.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string"/>
        <xs:attribute name="Description" type="xs:string"/>
        <xs:attribute name="Type" type="SwitchTypeEnum"/>
        <xs:attribute name="BranchEnd" type="BranchEndEnum"/>
        <xs:attribute name="HostBranchID" type="xs:string"/>
        <xs:attribute name="MaxAperiodicShortCircuitCurrentInKiloampere" type="xs:double"/>
        <xs:attribute name="ConstructionYear" type="xs:integer"/>
        <xs:attribute name="ExternalURL" type="xs:anyURI"/>
        <xs:attribute name="LibraryRealibilityName" type="xs:string">
          <xs:annotation>
            <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / SHAPE

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | Shape*
Children | Shape
Instance |
    <SHAPE>
      <Shape BackgroundColor="" Description="" DisplayType="" FontSize="" ID="" Name="" OutlineColor="" OutlineWidth="" Text="" TextColor="" TextOrientation="" TextPosition="" TextStyle="" Type="" x1="" x2="" y1="" y2="">{0,unbounded}</Shape>
    </SHAPE>
Source |
    <xs:element name="SHAPE" minOccurs="0" maxOccurs="1">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="Shape" minOccurs="0" maxOccurs="unbounded">
            <xs:annotation>
              <xs:documentation>A shape (including text), applicable to both the map and schematic viewers. For compatibility with other (actual) grid elements, if a shape is used in the schematic viewer, the shape's position and size is defined by the (x1, y1) and (x2, y2) coordinates: - A line will go from (x1, y1) to (x2, y2) - A rectangle is defined by the upper left (x1, y1) and lower right coordinates (x2, y2) - An ellipse will be bound by the rectangle spanned by (x1, y1). (x2, y2) - For a polygon, (x1, y1). (x2, y2) define its bounding box. For the actual polygon definition, the GIS element is used. On the map, the GIS element is used all the time. For ellipses, a rectangular polygon is used into which the ellipse is inscribed.</xs:documentation>
            </xs:annotation>
            <xs:complexType>
              <xs:all>
                <xs:element name="GIS" type="GISType" minOccurs="0" maxOccurs="1"/>
              </xs:all>
              <xs:attribute name="ID" type="StringID" use="required"/>
              <xs:attribute name="DisplayType" type="DisplayTypeEnum" use="required"/>
              <xs:attribute name="Type" type="FormTypeEnum" use="required"/>
              <xs:attribute name="x1" type="xs:double">
                <xs:annotation>
                  <xs:documentation>The x-coordinate of the upper left corner of the shape</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="y1" type="xs:double">
                <xs:annotation>
                  <xs:documentation>The y-coordinate of the upper left corner of the shape</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="x2" type="xs:double">
                <xs:annotation>
                  <xs:documentation>The x-coordinate of the lower right corner of the shape</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="y2" type="xs:double">
                <xs:annotation>
                  <xs:documentation>The y-coordinate of the lower right corner of the shape</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Name" type="xs:string"/>
              <xs:attribute name="Description" type="xs:string"/>
              <xs:attribute name="Text" type="xs:string"/>
              <xs:attribute name="TextStyle" type="xs:integer">
                <xs:annotation>
                  <xs:documentation>A bit mask of text styles. The following constants are OR-ed bitwise: - 1: italic - 2: bold - 4: underlined - 8: strikethrough</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="TextPosition" type="TextPositionEnumType"/>
              <xs:attribute name="TextOrientation" type="TextOrientationEnumType"/>
              <xs:attribute name="FontSize" type="xs:integer"/>
              <xs:attribute name="TextColor" type="ColorType"/>
              <xs:attribute name="OutlineColor" type="ColorType"/>
              <xs:attribute name="BackgroundColor" type="ColorType"/>
              <xs:attribute name="OutlineWidth" type="xs:integer"/>
            </xs:complexType>
          </xs:element>
        </xs:sequence>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / SHAPE / Shape

Annotations |
    A shape (including text), applicable to both the map and schematic viewers.
    For compatibility with other (actual) grid elements, if a shape is used in the
    schematic viewer, the shape's position and size is defined by the
    (x1, y1) and (x2, y2) coordinates:
    - A line will go from (x1, y1) to (x2, y2)
    - A rectangle is defined by the upper left (x1, y1) and lower right coordinates (x2, y2)
    - An ellipse will be bound by the rectangle spanned by (x1, y1). (x2, y2)
    - For a polygon, (x1, y1). (x2, y2) define its bounding box.
      For the actual polygon definition, the GIS element is used.
    On the map, the GIS element is used all the time.
    For ellipses, a rectangular polygon is used into which the ellipse is inscribed.
Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | unbounded
Model | ALL(GIS{0,1})
Children | GIS
Instance |
    <Shape BackgroundColor="" Description="" DisplayType="" FontSize="" ID="" Name="" OutlineColor="" OutlineWidth="" Text="" TextColor="" TextOrientation="" TextPosition="" TextStyle="" Type="" x1="" x2="" y1="" y2="">
      <GIS ShapeType="">{0,1}</GIS>
    </Shape>
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
BackgroundColor | ColorType | optional |
Description | xs:string | optional |
DisplayType | DisplayTypeEnum | required |
FontSize | xs:integer | optional |
ID | StringID | required |
Name | xs:string | optional |
OutlineColor | ColorType | optional |
OutlineWidth | xs:integer | optional |
Text | xs:string | optional |
TextColor | ColorType | optional |
TextOrientation | TextOrientationEnumType | optional |
TextPosition | TextPositionEnumType | optional |
TextStyle | xs:integer | optional |
    A bit mask of text styles.
    The following constants are OR-ed bitwise:
    - 1: italic
    - 2: bold
    - 4: underlined
    - 8: strikethrough
Type | FormTypeEnum | required |
x1 | xs:double | optional |
    The x-coordinate of the upper left corner of the shape
x2 | xs:double | optional |
    The x-coordinate of the lower right corner of the shape
y1 | xs:double | optional |
    The y-coordinate of the upper left corner of the shape
y2 | xs:double | optional |
    The y-coordinate of the lower right corner of the shape
Source |
    <xs:element name="Shape" minOccurs="0" maxOccurs="unbounded">
      <xs:annotation>
        <xs:documentation>A shape (including text), applicable to both the map and schematic viewers. For compatibility with other (actual) grid elements, if a shape is used in the schematic viewer, the shape's position and size is defined by the (x1, y1) and (x2, y2) coordinates: - A line will go from (x1, y1) to (x2, y2) - A rectangle is defined by the upper left (x1, y1) and lower right coordinates (x2, y2) - An ellipse will be bound by the rectangle spanned by (x1, y1). (x2, y2) - For a polygon, (x1, y1). (x2, y2) define its bounding box. For the actual polygon definition, the GIS element is used. On the map, the GIS element is used all the time. For ellipses, a rectangular polygon is used into which the ellipse is inscribed.</xs:documentation>
      </xs:annotation>
      <xs:complexType>
        <xs:all>
          <xs:element name="GIS" type="GISType" minOccurs="0" maxOccurs="1"/>
        </xs:all>
        <xs:attribute name="ID" type="StringID" use="required"/>
        <xs:attribute name="DisplayType" type="DisplayTypeEnum" use="required"/>
        <xs:attribute name="Type" type="FormTypeEnum" use="required"/>
        <xs:attribute name="x1" type="xs:double">
          <xs:annotation>
            <xs:documentation>The x-coordinate of the upper left corner of the shape</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="y1" type="xs:double">
          <xs:annotation>
            <xs:documentation>The y-coordinate of the upper left corner of the shape</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="x2" type="xs:double">
          <xs:annotation>
            <xs:documentation>The x-coordinate of the lower right corner of the shape</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="y2" type="xs:double">
          <xs:annotation>
            <xs:documentation>The y-coordinate of the lower right corner of the shape</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string"/>
        <xs:attribute name="Description" type="xs:string"/>
        <xs:attribute name="Text" type="xs:string"/>
        <xs:attribute name="TextStyle" type="xs:integer">
          <xs:annotation>
            <xs:documentation>A bit mask of text styles. The following constants are OR-ed bitwise: - 1: italic - 2: bold - 4: underlined - 8: strikethrough</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="TextPosition" type="TextPositionEnumType"/>
        <xs:attribute name="TextOrientation" type="TextOrientationEnumType"/>
        <xs:attribute name="FontSize" type="xs:integer"/>
        <xs:attribute name="TextColor" type="ColorType"/>
        <xs:attribute name="OutlineColor" type="ColorType"/>
        <xs:attribute name="BackgroundColor" type="ColorType"/>
        <xs:attribute name="OutlineWidth" type="xs:integer"/>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / SHAPE / Shape / GIS

Diagram |
Type | GISType
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | Points
Children | Points
Instance |
    <GIS ShapeType="">
      <Points>{1,1}</Points>
    </GIS>
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
ShapeType | ShapeTypeEnum | required |
    Type of shape, either Point, Line, or Polygon
Source |
    <xs:element name="GIS" type="GISType" minOccurs="0" maxOccurs="1"/>

[ top ]
Simple Type StarPointGrounding

Annotations |
    This type characterizes how the star point of a transformer is grounded. This is relevant in case of a short circuit.
    Not all transformers have a star point. Only if the vector group contains a 'y' character on the secondary side, e.g. 'Dy', the transformer has a star point.
    In the Adaptricity platform the StarPointGrounding property is interpreted as grounding information for a star point the secondary side of the transformer.
    This property is not mandatory. However, if not provided for transformers that do have a star point on the secondary side, short circuit calculation is not possible.
Diagram |
Type | restriction of xs:string
Facets |
enumeration | Direct grounding |
    The start point is connected to ground by a (low resistance) cable.
enumeration | Resonant grounding |
    The start point is connected to ground by an inductor.
enumeration | Insulated grid |
    The start point is not connected to ground (insulated).
Used by |
Attribute | GRID/TRANSFORMER/Transformer/@StarPointGrounding
Source |
    <xs:simpleType name="StarPointGrounding">
      <xs:annotation>
        <xs:documentation>This type characterizes how the star point of a transformer is grounded. This is relevant in case of a short circuit. Not all transformers have a star point. Only if the vector group contains a 'y' character on the secondary side, e.g. 'Dy', the transformer has a star point. In the Adaptricity platform the StarPointGrounding property is interpreted as grounding information for a star point the secondary side of the transformer. This property is not mandatory. However, if not provided for transformers that do have a star point on the secondary side, short circuit calculation is not possible.</xs:documentation>
      </xs:annotation>
      <xs:restriction base="xs:string">
        <xs:enumeration value="Direct grounding">
          <xs:annotation>
            <xs:documentation>The start point is connected to ground by a (low resistance) cable.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Resonant grounding">
          <xs:annotation>
            <xs:documentation>The start point is connected to ground by an inductor.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Insulated grid">
          <xs:annotation>
            <xs:documentation>The start point is not connected to ground (insulated).</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
      </xs:restriction>
    </xs:simpleType>

[ top ]
Simple Type ShapeTypeEnum

Diagram |
Type | restriction of xs:string
Facets |
enumeration | Point |
    Shape type "Point" needs in its child node element "Points" exactly one "Point" element.
enumeration | Line |
    Shape type "Line" needs in its child node element "Points" two or more "Point" elements.
enumeration | Polygon |
    Shape type "Polygon" needs in its child node element "Points" three or more "Point" elements.
Used by |
Attribute | GISType/@ShapeType
Source |
    <xs:simpleType name="ShapeTypeEnum">
      <xs:restriction base="xs:string">
        <xs:enumeration value="Point">
          <xs:annotation>
            <xs:documentation>Shape type "Point" needs in its child node element "Points" exactly one "Point" element.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Line">
          <xs:annotation>
            <xs:documentation>Shape type "Line" needs in its child node element "Points" two or more "Point" elements.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Polygon">
          <xs:annotation>
            <xs:documentation>Shape type "Polygon" needs in its child node element "Points" three or more "Point" elements.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
      </xs:restriction>
    </xs:simpleType>

[ top ]
Simple Type BusTypeEnum

Annotations |
    Each bus can optionally have a bus Type. Depending on the type the bus is visualized differently
    in the schematic grid viewer.
    Unless indicated, this property doesn't affect calculations.
Diagram |
Type | restriction of xs:string
Facets |
enumeration | TransformerStation |
    Indicates the location of a transformer station.
    Useful in MV grid to see where transformers are connected (in the same grid model, or in a subgrid).
enumeration | DistributionCabinet |
    A distribtion cabinet (Ger. 'Verteilkabine') is used in LV grids to distribute the power
    to different households or streets. They sometimes include metering devices.
enumeration | CableJunction |
    A cable junction (Ger. 'Muffe') is used to connect two different cables.
    Connecting other grid elements is usually not possible.
enumeration | BusBar |
    A bus bar (Ger. 'Sammelschiene') is a metallic bar inside a transformer station used
    for high current power distribution.
enumeration | ConnectionPoint |
    A connection point (Ger. 'Hausanschluss') represents a customer (private or commercial).
enumeration | SmallConnectionPoint |
    A small connection point (Ger. 'Kleinverbraucheranschluss') is a small power consumer,
    typically located in public areas, such as ticket machines or street lighting.
enumeration | Virtual |
    Virtual buses are buses that do not exist in the physical reality but are created
    for the sake of the grid modeling.
enumeration | PreferredNetworkFeederLocation |
    If the grid model does not have a network feeder, this defines the host bus of the network feeder
    that is created by the software. If the grid model has a network feeder it is recommended to use
    this type for the host bus.
enumeration | Other |
    Other buses that don't match any of the above types.
Used by |
Attribute | GRID/BUSBAR_NODE/Node/@Type
Source |
    <xs:simpleType name="BusTypeEnum">
      <xs:annotation>
        <xs:documentation>Each bus can optionally have a bus Type. Depending on the type the bus is visualized differently in the schematic grid viewer. Unless indicated, this property doesn't affect calculations.</xs:documentation>
      </xs:annotation>
      <xs:restriction base="xs:string">
        <xs:enumeration value="TransformerStation">
          <xs:annotation>
            <xs:documentation>Indicates the location of a transformer station. Useful in MV grid to see where transformers are connected (in the same grid model, or in a subgrid).</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="DistributionCabinet">
          <xs:annotation>
            <xs:documentation>A distribtion cabinet (Ger. 'Verteilkabine') is used in LV grids to distribute the power to different households or streets. They sometimes include metering devices.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="CableJunction">
          <xs:annotation>
            <xs:documentation>A cable junction (Ger. 'Muffe') is used to connect two different cables. Connecting other grid elements is usually not possible.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="BusBar">
          <xs:annotation>
            <xs:documentation>A bus bar (Ger. 'Sammelschiene') is a metallic bar inside a transformer station used for high current power distribution.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="ConnectionPoint">
          <xs:annotation>
            <xs:documentation>A connection point (Ger. 'Hausanschluss') represents a customer (private or commercial).</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="SmallConnectionPoint">
          <xs:annotation>
            <xs:documentation>A small connection point (Ger. 'Kleinverbraucheranschluss') is a small power consumer, typically located in public areas, such as ticket machines or street lighting.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Virtual">
          <xs:annotation>
            <xs:documentation>Virtual buses are buses that do not exist in the physical reality but are created for the sake of the grid modeling.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="PreferredNetworkFeederLocation">
          <xs:annotation>
            <xs:documentation>If the grid model does not have a network feeder, this defines the host bus of the network feeder that is created by the software. If the grid model has a network feeder it is recommended to use this type for the host bus.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Other">
          <xs:annotation>
            <xs:documentation>Other buses that don't match any of the above types.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
      </xs:restriction>
    </xs:simpleType>

[ top ]
Simple Type BranchEndEnum

Annotations |
    The BranchEndEnum at which end of a branch (line, transformer, connection) something is measured/installed .
Diagram |
Type | restriction of xs:string
Facets |
enumeration | Bus1 |
    The end of the branch where the bus1 is connected.
enumeration | Bus2 |
    The end of the branch where the bus2 is connected.
Used by |
Attributes | GRID/FUSE/Fuse/@BranchEnd, GRID/SWITCH/Switch/@BranchEnd
Source |
    <xs:simpleType name="BranchEndEnum">
      <xs:annotation>
        <xs:documentation>The BranchEndEnum at which end of a branch (line, transformer, connection) something is measured/installed .</xs:documentation>
      </xs:annotation>
      <xs:restriction base="xs:string">
        <xs:enumeration value="Bus1">
          <xs:annotation>
            <xs:documentation>The end of the branch where the bus1 is connected.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Bus2">
          <xs:annotation>
            <xs:documentation>The end of the branch where the bus2 is connected.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
      </xs:restriction>
    </xs:simpleType>

[ top ]
Simple Type GenerationCategoryEnum

Annotations |
    Generators can have a category. This is used for filtering.
Diagram |
Type | restriction of xs:string
Facets |
enumeration | PV |
    A photovoltaic generator (solar power).
enumeration | Wind |
    A Wind turbine.
enumeration | Biomass |
    In a biomass power plant is some kind of biofuel (e.g. wood) is burned to produce electricity.
enumeration | Hydro |
    A power plant where water is used to power a generator.
    For example with a high pressure from a reservior (pumped hydro) or low pressure (river).
enumeration | Gas turbine |
    A power plant where gas is burned to power a generator.
enumeration | Combined heat and power |
    A power plant where a fuel is burned to provide thermal and electrical energy.
enumeration | Equivalent aggregated generation |
    When a grid is split, in each subgrid, the generation is summed up and placed in the higher voltage grid
    (where the subgrid was extracted from). This generator has the type 'Equivalent aggregated generation'.
enumeration | Other |
    A generator that doesn't match any other category.
Used by |
Attribute | GRID/GENERATOR/Generator/@GenerationCategory
Source |
    <xs:simpleType name="GenerationCategoryEnum">
      <xs:annotation>
        <xs:documentation>Generators can have a category. This is used for filtering.</xs:documentation>
      </xs:annotation>
      <xs:restriction base="xs:string">
        <xs:enumeration value="PV">
          <xs:annotation>
            <xs:documentation>A photovoltaic generator (solar power).</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Wind">
          <xs:annotation>
            <xs:documentation>A Wind turbine.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Biomass">
          <xs:annotation>
            <xs:documentation>In a biomass power plant is some kind of biofuel (e.g. wood) is burned to produce electricity.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Hydro">
          <xs:annotation>
            <xs:documentation>A power plant where water is used to power a generator. For example with a high pressure from a reservior (pumped hydro) or low pressure (river).</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Gas turbine">
          <xs:annotation>
            <xs:documentation>A power plant where gas is burned to power a generator.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Combined heat and power">
          <xs:annotation>
            <xs:documentation>A power plant where a fuel is burned to provide thermal and electrical energy.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Equivalent aggregated generation">
          <xs:annotation>
            <xs:documentation>When a grid is split, in each subgrid, the generation is summed up and placed in the higher voltage grid (where the subgrid was extracted from). This generator has the type 'Equivalent aggregated generation'.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Other">
          <xs:annotation>
            <xs:documentation>A generator that doesn't match any other category.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
      </xs:restriction>
    </xs:simpleType>

[ top ]
Simple Type LoadCategoryEnum

Diagram |
Type | restriction of xs:string
Facets |
enumeration | Residential |
    Load of a private customer
enumeration | Industrial |
    Load of an industrial customer
enumeration | Heat pump |
    A heat pump, e.g. to heat a building.
enumeration | Electric heating |
    Electric resistive heating, e.g. to heat a building.
    As this is very inefficient, this is forbidden in some countries.
enumeration | Electric water heater |
    For example a hot water boiler.
enumeration | EV charger |
    Charger of an electric vehicle
enumeration | Stationary battery |
    A Battery. A batterie defined as static load will always consumer power.
    Batteries with a charge and discharge behavior cannot be modelled in a static grid model.
    They can be applied in the software as part of a 'Scenario'.
enumeration | Equivalent aggregated load |
    When a grid is split, in each subgrid, the load is summed up and placed in the higher voltage grid
    (where the subgrid was extracted from). This load has the type 'Equivalent aggregated load'.
enumeration | Other |
    A load that doesn't match any other category.
Used by |
Attribute | GRID/LOAD/Load/@LoadCategory
Source |
    <xs:simpleType name="LoadCategoryEnum">
      <xs:restriction base="xs:string">
        <xs:enumeration value="Residential">
          <xs:annotation>
            <xs:documentation>Load of a private customer</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Industrial">
          <xs:annotation>
            <xs:documentation>Load of an industrial customer</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Heat pump">
          <xs:annotation>
            <xs:documentation>A heat pump, e.g. to heat a building.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Electric heating">
          <xs:annotation>
            <xs:documentation>Electric resistive heating, e.g. to heat a building. As this is very inefficient, this is forbidden in some countries.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Electric water heater">
          <xs:annotation>
            <xs:documentation>For example a hot water boiler.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="EV charger">
          <xs:annotation>
            <xs:documentation>Charger of an electric vehicle</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Stationary battery">
          <xs:annotation>
            <xs:documentation>A Battery. A batterie defined as static load will always consumer power. Batteries with a charge and discharge behavior cannot be modelled in a static grid model. They can be applied in the software as part of a 'Scenario'.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Equivalent aggregated load">
          <xs:annotation>
            <xs:documentation>When a grid is split, in each subgrid, the load is summed up and placed in the higher voltage grid (where the subgrid was extracted from). This load has the type 'Equivalent aggregated load'.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Other">
          <xs:annotation>
            <xs:documentation>A load that doesn't match any other category.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
      </xs:restriction>
    </xs:simpleType>

[ top ]
Simple Type FuseTypeEnum

Diagram |
Type | restriction of xs:string
Facets |
enumeration | Grid |
    A grid fuse protects a larger (usually public) part of the distribution grid from a short circuit.
    They are typically found in transformer stations and distribution cabinets.
    Grid fuses are dimensioned to withstand a higher current and melt slowler than a connection fuse, allowing connection fuses to melt first.
enumeration | Connection |
    A connection fuse protects an individual customer from a short circuit.
    They are installed where the customer is connected to the grid.
    Connection fuses are dimension to withstand a lower current and melt faster than grid fuses, preventing the grid fuses to disconnect a much larger part of the grid.
Used by |
Attribute | GRID/FUSE/Fuse/@FuseType
Source |
    <xs:simpleType name="FuseTypeEnum">
      <xs:restriction base="xs:string">
        <xs:annotation>
          <xs:documentation>Characterizes the location of a fuse.</xs:documentation>
        </xs:annotation>
        <xs:enumeration value="Grid">
          <xs:annotation>
            <xs:documentation>A grid fuse protects a larger (usually public) part of the distribution grid from a short circuit. They are typically found in transformer stations and distribution cabinets. Grid fuses are dimensioned to withstand a higher current and melt slowler than a connection fuse, allowing connection fuses to melt first.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Connection">
          <xs:annotation>
            <xs:documentation>A connection fuse protects an individual customer from a short circuit. They are installed where the customer is connected to the grid. Connection fuses are dimension to withstand a lower current and melt faster than grid fuses, preventing the grid fuses to disconnect a much larger part of the grid.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
      </xs:restriction>
    </xs:simpleType>

[ top ]
Simple Type GenerationConnectionEnum

Diagram |
Type | restriction of xs:string
Facets |
enumeration | Direct |
    This option is deprecated and should not be used anymore.
enumeration | Inverter |
    An inverter (Ger. 'Wechselrichter') converts DC power to AC power. It is typically used for solar PV.
enumeration | Synchronous Machine |
    Synchronous generators have a efficieny and are typically used in large power plants (such as hydro or nuclear).
enumeration | Asynchronous Machine |
    Asynchronous machines are sometimes used in small generators (Diesel generator, wind power, hydro ).
enumeration | Converter |
    A converter (Ger. 'Frequenzumrichter') converts the frequency and amplitude.
Used by |
Attribute | GRID/GENERATOR/Generator/@ConnectionType
Source |
    <xs:simpleType name="GenerationConnectionEnum">
      <xs:restriction base="xs:string">
        <xs:annotation>
          <xs:documentation>Discribes how a generator is connected to the grid. The connection type describes, to what extent a generator contributes to a short circuit.</xs:documentation>
        </xs:annotation>
        <xs:enumeration value="Direct">
          <xs:annotation>
            <xs:documentation>This option is deprecated and should not be used anymore.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Inverter">
          <xs:annotation>
            <xs:documentation>An inverter (Ger. 'Wechselrichter') converts DC power to AC power. It is typically used for solar PV.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Synchronous Machine">
          <xs:annotation>
            <xs:documentation>Synchronous generators have a efficieny and are typically used in large power plants (such as hydro or nuclear).</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Asynchronous Machine">
          <xs:annotation>
            <xs:documentation>Asynchronous machines are sometimes used in small generators (Diesel generator, wind power, hydro ).</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Converter">
          <xs:annotation>
            <xs:documentation>A converter (Ger. 'Frequenzumrichter') converts the frequency and amplitude.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
      </xs:restriction>
    </xs:simpleType>

[ top ]
Simple Type DisplayTypeEnum

Diagram |
Type | restriction of xs:string
Facets |
enumeration | Schematic |
enumeration | Map |
Used by |
Attribute | GRID/SHAPE/Shape/@DisplayType
Source |
    <xs:simpleType name="DisplayTypeEnum">
      <xs:restriction base="xs:string">
        <xs:enumeration value="Schematic"/>
        <xs:enumeration value="Map"/>
      </xs:restriction>
    </xs:simpleType>

[ top ]
Simple Type FormTypeEnum

Diagram |
Type | restriction of xs:string
Facets |
enumeration | Line |
enumeration | Arrow |
enumeration | Ellipse |
enumeration | Rectangle |
enumeration | Polygon |
Used by |
Attribute | GRID/SHAPE/Shape/@Type
Source |
    <xs:simpleType name="FormTypeEnum">
      <xs:restriction base="xs:string">
        <xs:enumeration value="Line"/>
        <xs:enumeration value="Arrow"/>
        <xs:enumeration value="Ellipse"/>
        <xs:enumeration value="Rectangle"/>
        <xs:enumeration value="Polygon"/>
      </xs:restriction>
    </xs:simpleType>

[ top ]
Simple Type TextPositionEnumType

Diagram |
Type | restriction of xs:string
Facets |
enumeration | TopLeft |
enumeration | TopCenter |
enumeration | TopRight |
enumeration | MiddleLeft |
enumeration | MiddleCenter |
enumeration | MiddleRight |
enumeration | BottomLeft |
enumeration | BottomCenter |
enumeration | BottomRight |
Used by |
Attribute | GRID/SHAPE/Shape/@TextPosition
Source |
    <xs:simpleType name="TextPositionEnumType">
      <xs:restriction base="xs:string">
        <xs:enumeration value="TopLeft"/>
        <xs:enumeration value="TopCenter"/>
        <xs:enumeration value="TopRight"/>
        <xs:enumeration value="MiddleLeft"/>
        <xs:enumeration value="MiddleCenter"/>
        <xs:enumeration value="MiddleRight"/>
        <xs:enumeration value="BottomLeft"/>
        <xs:enumeration value="BottomCenter"/>
        <xs:enumeration value="BottomRight"/>
      </xs:restriction>
    </xs:simpleType>

[ top ]
Simple Type TextOrientationEnumType

Diagram |
Type | restriction of xs:string
Facets |
enumeration | Horizontal |
enumeration | Vertical |
Used by |
Attribute | GRID/SHAPE/Shape/@TextOrientation
Source |
    <xs:simpleType name="TextOrientationEnumType">
      <xs:restriction base="xs:string">
        <xs:enumeration value="Horizontal"/>
        <xs:enumeration value="Vertical"/>
      </xs:restriction>
    </xs:simpleType>

[ top ]
Simple Type StringID

Annotations |
    A valid ID consists of lowercase letters, digits, _, and @. Uppercase letters are accepted for importing the grid but need to be corrected in the Grid Editor in the software before the grid can be used.
    Each element requires a unique ID. Usually IDs must be unique among their own type.
    For branch types (Line, DiscSwitch, LoadSwitch, CircuitBreaker, Transformer) all IDs must be unique among all branch types. E.g. A line must not have the same ID as a DiscSwitch.
Diagram |
Type | restriction of xs:string
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Attributes | GRID/BUSBAR_NODE/Node/@ID, GRID/CONNECTION/Connection/@Bus1ID, GRID/CONNECTION/Connection/@Bus2ID, GRID/CONNECTION/Connection/@ID, GRID/FEEDER/Feeder/@HostBusID, GRID/FEEDER/Feeder/@ID, GRID/FUSE/Fuse/@HostBranchID, GRID/FUSE/Fuse/@ID, GRID/GENERATOR/Generator/@Bus1ID, GRID/GENERATOR/Generator/@ID, GRID/LINE/Line/@Bus1ID, GRID/LINE/Line/@Bus2ID, GRID/LINE/Line/@ID, GRID/LOAD/Load/@Bus1ID, GRID/LOAD/Load/@ID, GRID/SHAPE/Shape/@ID, GRID/SWITCH/Switch/@ID, GRID/TRANSFORMER/Transformer/@Bus1ID, GRID/TRANSFORMER/Transformer/@Bus2ID, GRID/TRANSFORMER/Transformer/@ID, GRID/TRANSFORMER/Transformer/@MeasuredVoltageBusID, GRID/VOLTAGEREGULATOR/VoltageRegulator/@HostLineID, GRID/VOLTAGEREGULATOR/VoltageRegulator/@ID, ProtectionDevice/@HostSwitchID, ProtectionDevice/@ID
Source |
    <xs:simpleType name="StringID">
      <xs:annotation>
        <xs:documentation>A valid ID consists of lowercase letters, digits, _, and @. Uppercase letters are accepted for importing the grid but need to be corrected in the Grid Editor in the software before the grid can be used. Each element requires a unique ID. Usually IDs must be unique among their own type. For branch types (Line, DiscSwitch, LoadSwitch, CircuitBreaker, Transformer) all IDs must be unique among all branch types. E.g. A line must not have the same ID as a DiscSwitch.</xs:documentation>
      </xs:annotation>
      <xs:restriction base="xs:string">
        <xs:pattern value="[a-zA-Z0-9_@]+"/>
      </xs:restriction>
    </xs:simpleType>

[ top ]
Simple Type ProtectionDeviceDirection

Diagram |
Type | restriction of xs:string
Facets |
enumeration | Undirected |
    Faults in both directions are cleared. This option must not be used for Distance Protection Devices as they cannot be undirected.
enumeration | Bus 1 to Bus 2 |
    Only faults visible when 'looking' from bus1 to bus2 are cleared.
enumeration | Bus 2 to Bus 1 |
    Only faults visible when 'looking' from bus2 to bus1 are cleared.
Used by |
Attribute | ProtectionDevice/@Direction
Source |
    <xs:simpleType name="ProtectionDeviceDirection">
      <xs:restriction base="xs:string">
        <xs:annotation>
          <xs:documentation>Protection devices can be directed in the sense that they only clear faults (short circuits) that occur on a specific side of the device.</xs:documentation>
        </xs:annotation>
        <xs:enumeration value="Undirected">
          <xs:annotation>
            <xs:documentation>Faults in both directions are cleared. This option must not be used for Distance Protection Devices as they cannot be undirected.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Bus 1 to Bus 2">
          <xs:annotation>
            <xs:documentation>Only faults visible when 'looking' from bus1 to bus2 are cleared.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Bus 2 to Bus 1">
          <xs:annotation>
            <xs:documentation>Only faults visible when 'looking' from bus2 to bus1 are cleared.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
      </xs:restriction>
    </xs:simpleType>

[ top ]
Simple Type SwitchTypeEnum

Diagram |
Type | restriction of xs:string
Facets |
enumeration | Circuit Breaker |
    A circuit breaker (Ger. 'Leitungsschutzschalter') is an automatically operated electrical
    switch designed to protect an electrical circuit from damage caused by excess current from an overload or short circuit.
    It can switch under load and has a mechanism to suppress electric arcs.
enumeration | Disconnect Switch |
    A disconnect switch (Ger. 'Trennschalter') is used to ensure that an electrical circuit is completely
    de-energized for service or maintenance. It connot switch under load.
enumeration | Load Switch |
    The switch is a load 2 (Ger. 'Lastschalter') is a switch designed to connect and disconnect devices under
    normal operating conditions. It has a mechanism to suppress electric arcs caused by normal operational currents (not fault currents).
Used by |
Attribute | GRID/SWITCH/Switch/@Type
Source |
    <xs:simpleType name="SwitchTypeEnum">
      <xs:restriction base="xs:string">
        <xs:enumeration value="Circuit Breaker">
          <xs:annotation>
            <xs:documentation>A circuit breaker (Ger. 'Leitungsschutzschalter') is an automatically operated electrical switch designed to protect an electrical circuit from damage caused by excess current from an overload or short circuit. It can switch under load and has a mechanism to suppress electric arcs.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Disconnect Switch">
          <xs:annotation>
            <xs:documentation>A disconnect switch (Ger. 'Trennschalter') is used to ensure that an electrical circuit is completely de-energized for service or maintenance. It connot switch under load.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Load Switch">
          <xs:annotation>
            <xs:documentation>The switch is a load 2 (Ger. 'Lastschalter') is a switch designed to connect and disconnect devices under normal operating conditions. It has a mechanism to suppress electric arcs caused by normal operational currents (not fault currents).</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
      </xs:restriction>
    </xs:simpleType>

[ top ]
Complex Type ProtectionDevice

Diagram |
Used by |
Complex Types | DefiniteTimeOvercurrentProtection, DistanceProtection
Element | GRID/PROTECTIONDEVICE/ProtectionDevice
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
ConstructionYear | xs:integer | optional |
Description | xs:string | optional |
Direction | ProtectionDeviceDirection | optional |
ExternalURL | xs:anyURI | optional |
HostSwitchID | StringID | optional |
    ID of the switch where the protection device is connected to (required). Previously called 'HostCircuitBreakerID'.
ID | StringID | required |
    ID (see type StringID). Each ProtectionDevice requires a unique ID among all ProtectionDevices.
Name | xs:string | optional |
Source |
    <xs:complexType name="ProtectionDevice">
      <xs:attribute name="ID" type="StringID" use="required">
        <xs:annotation>
          <xs:documentation>ID (see type StringID). Each ProtectionDevice requires a unique ID among all ProtectionDevices.</xs:documentation>
        </xs:annotation>
      </xs:attribute>
      <xs:attribute name="Name" type="xs:string"/>
      <xs:attribute name="Description" type="xs:string"/>
      <xs:attribute name="ConstructionYear" type="xs:integer"/>
      <xs:attribute name="ExternalURL" type="xs:anyURI"/>
      <xs:attribute name="Direction" type="ProtectionDeviceDirection"/>
      <xs:attribute name="HostSwitchID" type="StringID">
        <xs:annotation>
          <xs:documentation>ID of the switch where the protection device is connected to (required). Previously called 'HostCircuitBreakerID'.</xs:documentation>
        </xs:annotation>
      </xs:attribute>
    </xs:complexType>

[ top ]
Complex Type DefiniteTimeOvercurrentProtection

Diagram |
Type | extension of ProtectionDevice
Type hierarchy | ProtectionDevice DefiniteTimeOvercurrentProtection
Model | STAGE{0,1}
Children | STAGE
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
ConstructionYear | xs:integer | optional |
Description | xs:string | optional |
Direction | ProtectionDeviceDirection | optional |
ExternalURL | xs:anyURI | optional |
HostSwitchID | StringID | optional |
    ID of the switch where the protection device is connected to (required). Previously called 'HostCircuitBreakerID'.
ID | StringID | required |
    ID (see type StringID). Each ProtectionDevice requires a unique ID among all ProtectionDevices.
Name | xs:string | optional |
Source |
    <xs:complexType name="DefiniteTimeOvercurrentProtection">
      <xs:complexContent>
        <xs:extension base="ProtectionDevice">
          <xs:sequence>
            <xs:element name="STAGE" minOccurs="0" maxOccurs="1">
              <xs:complexType>
                <xs:sequence>
                  <xs:element name="Stage" minOccurs="0" maxOccurs="unbounded">
                    <xs:annotation>
                      <xs:documentation>A DTOP - definite time overcurrent protection device (Ger. 'UMZ - Unabhängiger Maximalstromzeitschutz') is a protection device, where the swich-off time depends on the short circuit current. DTOPs are configured, such that high currents are cleared faster than small currents. The reason is that high currents indicate a close proximity to the fault location. This current-time-dependency is expressed as list of time-current pair, wich discribes a step-shaped curve. Example: - 1kA / 3.0s - 2kA / 1.5s - 4kA / 0.5s The above list of current/time pairs represents this behavior: - Fault currents below 1kA are not cleared - Fault currents between 1kA and 2kA are cleared after 3s - Fault currents between 2kA and 4kA are cleared after 1.5s - Fault currents above 4kA are cleared after 0.5s</xs:documentation>
                    </xs:annotation>
                    <xs:complexType>
                      <xs:attribute name="CurrentInKiloampere" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>When measuring a current between this current and the next higher CurrentInKiloampere, the devices clears the fault after SwitchOffTimeInSeconds seconds.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="SwitchOffTimeInSeconds" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>The time after which the fault is cleared.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                    </xs:complexType>
                  </xs:element>
                </xs:sequence>
              </xs:complexType>
            </xs:element>
          </xs:sequence>
        </xs:extension>
      </xs:complexContent>
    </xs:complexType>

[ top ]
Complex Type DistanceProtection

Diagram |
Type | extension of ProtectionDevice
Type hierarchy | ProtectionDevice DistanceProtection
Model | STAGE{0,1}
Children | STAGE
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
ConstructionYear | xs:integer | optional |
Description | xs:string | optional |
Direction | ProtectionDeviceDirection | optional |
DirectionalFinalTimeInSeconds | xs:double | optional |
    When a distance protection device recognizes a fault in it's direction,
    this is the time after which the device sends a second
    	switch-open-signal to the circuit breaker if the first one didn't work for some reason.
ExternalURL | xs:anyURI | optional |
HostSwitchID | StringID | optional |
    ID of the switch where the protection device is connected to (required). Previously called 'HostCircuitBreakerID'.
ID | StringID | required |
    ID (see type StringID). Each ProtectionDevice requires a unique ID among all ProtectionDevices.
MaxStages | xs:integer | optional |
    The maximum number of stages that can be configured in the device
MinimalGridImpedanceInOhm | xs:double | optional |
    The minimum impedance a distance protection device can reliably detect.
    When parameterizing distance protection devices automatically,
    the impedance of the first stage will not fall below this value.
Name | xs:string | optional |
NonDirectionalFinalTimeInSeconds | xs:double | optional |
    The swich-off time when a fault in backwards direction is detected.
OvercurrentThresholdInKiloampere | xs:double | optional |
    Threshold for the device to get active. Measured currents above this threshold are assumed to be faults,
    in this case the device will switch after the delay defined by the stages and the measured impedance.
    whereas currents under this threshold are assumed to be normal operational currents.
Source |
    <xs:complexType name="DistanceProtection">
      <xs:complexContent>
        <xs:extension base="ProtectionDevice">
          <xs:sequence>
            <xs:element name="STAGE" minOccurs="0" maxOccurs="1">
              <xs:annotation>
                <xs:documentation>A DP - distance protection device (Ger. 'Distanzschutz') is a protection device, where the swich-off time depends on the measured electical distance (in Ohm) to the fault location. DPs are configured, such that close faults (measured impedance low) are cleared faster than distant faults (measured impedance high). This distance-time-dependency is expressed as list of distance-time pairs, wich discribes a step-shaped curve. Stages of DistanceProtection devices work analogously to the stages of DefiniteTimeOvercurrentProtection devices with the difference the the distance is measured in Ohm instead of Ampere. For an example how to define stages, please look at the DefiniteTimeOvercurrentProtection device.</xs:documentation>
              </xs:annotation>
              <xs:complexType>
                <xs:sequence>
                  <xs:element name="Stage" minOccurs="0" maxOccurs="unbounded">
                    <xs:complexType>
                      <xs:attribute name="ImpedanceInOhm" type="xs:double"/>
                      <xs:attribute name="SwitchOffTimeInSeconds" type="xs:double"/>
                    </xs:complexType>
                  </xs:element>
                </xs:sequence>
              </xs:complexType>
            </xs:element>
          </xs:sequence>
          <xs:attribute name="DirectionalFinalTimeInSeconds" type="xs:double">
            <xs:annotation>
              <xs:documentation>When a distance protection device recognizes a fault in it's direction, this is the time after which the device sends a second switch-open-signal to the circuit breaker if the first one didn't work for some reason.</xs:documentation>
            </xs:annotation>
          </xs:attribute>
          <xs:attribute name="NonDirectionalFinalTimeInSeconds" type="xs:double">
            <xs:annotation>
              <xs:documentation>The swich-off time when a fault in backwards direction is detected.</xs:documentation>
            </xs:annotation>
          </xs:attribute>
          <xs:attribute name="OvercurrentThresholdInKiloampere" type="xs:double">
            <xs:annotation>
              <xs:documentation>Threshold for the device to get active. Measured currents above this threshold are assumed to be faults, in this case the device will switch after the delay defined by the stages and the measured impedance. whereas currents under this threshold are assumed to be normal operational currents.</xs:documentation>
            </xs:annotation>
          </xs:attribute>
          <xs:attribute name="MinimalGridImpedanceInOhm" type="xs:double">
            <xs:annotation>
              <xs:documentation>The minimum impedance a distance protection device can reliably detect. When parameterizing distance protection devices automatically, the impedance of the first stage will not fall below this value.</xs:documentation>
            </xs:annotation>
          </xs:attribute>
          <xs:attribute name="MaxStages" type="xs:integer">
            <xs:annotation>
              <xs:documentation>The maximum number of stages that can be configured in the device</xs:documentation>
            </xs:annotation>
          </xs:attribute>
        </xs:extension>
      </xs:complexContent>
    </xs:complexType>

[ top ]
Simple Type reactivePowerCharacteristicType

Diagram |
Type | restriction of xs:string
Facets |
enumeration | FIXED_Q |
    Reactive Power is directly entered as a (constant) value in Megawatt. This is the simplest form of defining reactive power.
enumeration | FLUCTUATING_Q |
    Reactive Power is randomly chosen between two user-defined limits (minimal and maximal power in Megawatt).
enumeration | P_Q_CHARACTERISTIC |
    User can define a curve that links active powers to reactive power.
enumeration | FIXED_COS_PHI |
    Reactive power is calculated from a fixed cosPhi and a cosPhiType.
enumeration | FLUCTUATING_COS_PHI |
    Reactive power is calculated from a cosPhi and a cosPhiType. The cosPhi is chosen randomly between two user-defined limits.
enumeration | COS_PHI_CHARACTERISTIC |
    User can define a curve that links active powers to a cosPhi. The active power is calcuated out of the cosPhi.
enumeration | COS_PHI_U |
    User can define a curve that links voltage to a cos(phi). During the powerflow, the voltage is measured and the reactive power is determined from the cos(phi) for that voltage.
enumeration | Q_U |
    User can define a curve that links voltage to reactive power. During the powerflow, the voltage is measured and the reactive power is determined from the curse.
Used by |
Attribute | ReactivePowerCharacteristic/@CharacteristicType
Source |
    <xs:simpleType name="reactivePowerCharacteristicType">
      <xs:restriction base="xs:string">
        <xs:annotation>
          <xs:documentation>Defines how reactive power is calculated out of active power.</xs:documentation>
        </xs:annotation>
        <xs:enumeration value="FIXED_Q">
          <xs:annotation>
            <xs:documentation>Reactive Power is directly entered as a (constant) value in Megawatt. This is the simplest form of defining reactive power.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="FLUCTUATING_Q">
          <xs:annotation>
            <xs:documentation>Reactive Power is randomly chosen between two user-defined limits (minimal and maximal power in Megawatt).</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="P_Q_CHARACTERISTIC">
          <xs:annotation>
            <xs:documentation>User can define a curve that links active powers to reactive power.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="FIXED_COS_PHI">
          <xs:annotation>
            <xs:documentation>Reactive power is calculated from a fixed cosPhi and a cosPhiType.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="FLUCTUATING_COS_PHI">
          <xs:annotation>
            <xs:documentation>Reactive power is calculated from a cosPhi and a cosPhiType. The cosPhi is chosen randomly between two user-defined limits.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="COS_PHI_CHARACTERISTIC">
          <xs:annotation>
            <xs:documentation>User can define a curve that links active powers to a cosPhi. The active power is calcuated out of the cosPhi.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="COS_PHI_U">
          <xs:annotation>
            <xs:documentation>User can define a curve that links voltage to a cos(phi). During the powerflow, the voltage is measured and the reactive power is determined from the cos(phi) for that voltage.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Q_U">
          <xs:annotation>
            <xs:documentation>User can define a curve that links voltage to reactive power. During the powerflow, the voltage is measured and the reactive power is determined from the curse.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
      </xs:restriction>
    </xs:simpleType>

[ top ]
Simple Type cosPhiType

Annotations |
    Defines in which situations reactive power is injected into or consumed from the grid. This depends on the cosPhiType and sometimes on the 'reference frame'.
    Loads are evaluated in the 'cosumer reference frame' and generators in the 'producer reference frame'.
Diagram |
Type | restriction of xs:string
Facets |
enumeration | INDUCTIVE |
    For Loads: Reactive power is injected when active power is injected, reactive power is consumed when active power is consumed.
    For Generators: Reactive power is consumed when active power is injected, reactive power is injected when active power is consumed.
enumeration | CAPACITIVE |
    For Loads: Reactive power is injected when active power is consumed, reactive power is consumed when active power is injected.
    For Generators: Reactive power is consumed when active power is consumed, reactive power is injected when active power is injected.
enumeration | UNDEREXCITED |
    For Loads and Generators: Reactive power is drawn from the grid.
enumeration | OVEREXCITED |
    For Loads and Generators: Reactive power is injected into the grid.
Used by |
Attributes | CosPhiUCharacteristicDataPoint/@CosPhiType, ReactivePowerCharacteristic/@CosPhiType
Source |
    <xs:simpleType name="cosPhiType">
      <xs:annotation>
        <xs:documentation>Defines in which situations reactive power is injected into or consumed from the grid. This depends on the cosPhiType and sometimes on the 'reference frame'. Loads are evaluated in the 'cosumer reference frame' and generators in the 'producer reference frame'.</xs:documentation>
      </xs:annotation>
      <xs:restriction base="xs:string">
        <xs:enumeration value="INDUCTIVE">
          <xs:annotation>
            <xs:documentation>For Loads: Reactive power is injected when active power is injected, reactive power is consumed when active power is consumed. For Generators: Reactive power is consumed when active power is injected, reactive power is injected when active power is consumed.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="CAPACITIVE">
          <xs:annotation>
            <xs:documentation>For Loads: Reactive power is injected when active power is consumed, reactive power is consumed when active power is injected. For Generators: Reactive power is consumed when active power is consumed, reactive power is injected when active power is injected.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="UNDEREXCITED">
          <xs:annotation>
            <xs:documentation>For Loads and Generators: Reactive power is drawn from the grid.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="OVEREXCITED">
          <xs:annotation>
            <xs:documentation>For Loads and Generators: Reactive power is injected into the grid.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
      </xs:restriction>
    </xs:simpleType>

[ top ]
Complex Type ReactivePowerCharacteristic

Diagram |
Used by |
Elements | GRID/GENERATOR/Generator/ReactiveGenerationCharacteristic, GRID/LOAD/Load/ReactiveLoadCharacteristic
Model | COSPHI_U_CHARACTERISTIC_DATA{0,1} , Q_U_CHARACTERISTIC_DATA{0,1}
Children | COSPHI_U_CHARACTERISTIC_DATA, Q_U_CHARACTERISTIC_DATA
Attributes |
QName | Type | Use |
--- | --- | --- | ---
CharacteristicType | reactivePowerCharacteristicType | optional |
CosPhiCharacteristicMaxCosPhiFormula | xs:string | optional |
CosPhiType | cosPhiType | optional |
FixedCosPhi | xs:double | optional |
FixedQInKilovar | xs:double | optional |
QUCosPhi | xs:double | optional |
Source |
    <xs:complexType name="ReactivePowerCharacteristic">
      <xs:sequence>
        <xs:element name="COSPHI_U_CHARACTERISTIC_DATA" minOccurs="0">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="CosPhiUCharacteristicData" type="CosPhiUCharacteristicDataPoint" minOccurs="0" maxOccurs="unbounded"/>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
        <xs:element name="Q_U_CHARACTERISTIC_DATA" minOccurs="0">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="QUCharacteristicData" type="QUCharacteristicDataPoint" minOccurs="0" maxOccurs="unbounded"/>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
      </xs:sequence>
      <xs:attribute name="CharacteristicType" type="reactivePowerCharacteristicType"/>
      <xs:attribute name="FixedCosPhi" type="xs:double"/>
      <xs:attribute name="CosPhiType" type="cosPhiType"/>
      <xs:attribute name="CosPhiCharacteristicMaxCosPhiFormula" type="xs:string"/>
      <xs:attribute name="FixedQInKilovar" type="xs:double"/>
      <xs:attribute name="QUCosPhi" type="xs:double"/>
    </xs:complexType>

[ top ]
Complex Type CosPhiUCharacteristicDataPoint

Diagram |
Used by |
Element | ReactivePowerCharacteristic/COSPHI_U_CHARACTERISTIC_DATA/CosPhiUCharacteristicData
Model |
Attributes |
QName | Type | Use |
--- | --- | --- | ---
CosPhi | xs:double | required |
CosPhiType | cosPhiType | optional |
VoltageInPerUnit | xs:double | required |
Source |
    <xs:complexType name="CosPhiUCharacteristicDataPoint">
      <xs:sequence/>
      <xs:attribute name="VoltageInPerUnit" type="xs:double" use="required"/>
      <xs:attribute name="CosPhi" type="xs:double" use="required"/>
      <xs:attribute name="CosPhiType" type="cosPhiType"/>
    </xs:complexType>

[ top ]
Complex Type QUCharacteristicDataPoint

Diagram |
Used by |
Element | ReactivePowerCharacteristic/Q_U_CHARACTERISTIC_DATA/QUCharacteristicData
Model |
Attributes |
QName | Type | Use |
--- | --- | --- | ---
RelativeReactivePowerInPerUnit | xs:double | required |
VoltageInPerUnit | xs:double | required |
Source |
    <xs:complexType name="QUCharacteristicDataPoint">
      <xs:sequence/>
      <xs:attribute name="VoltageInPerUnit" type="xs:double" use="required"/>
      <xs:attribute name="RelativeReactivePowerInPerUnit" type="xs:double" use="required"/>
    </xs:complexType>

[ top ]
Complex Type GISType

Diagram |
Used by |
Elements | GRID/BUSBAR_NODE/Node/GIS, GRID/CONNECTION/Connection/GIS, GRID/LINE/Line/GIS, GRID/SHAPE/Shape/GIS, GRID/TRANSFORMER/Transformer/GIS
Model | Points
Children | Points
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
ShapeType | ShapeTypeEnum | required |
    Type of shape, either Point, Line, or Polygon
Source |
    <xs:complexType name="GISType">
      <xs:sequence>
        <xs:element minOccurs="1" maxOccurs="1" name="Points">
          <xs:complexType>
            <xs:sequence maxOccurs="unbounded">
              <xs:element name="Point">
                <xs:complexType>
                  <xs:attribute name="Lat" type="xs:double" use="required">
                    <xs:annotation>
                      <xs:documentation>Latitude in WGS-84 projection of the current point</xs:documentation>
                    </xs:annotation>
                  </xs:attribute>
                  <xs:attribute name="Lon" type="xs:double" use="required">
                    <xs:annotation>
                      <xs:documentation>Longitude in WGS-84 projection of the current point</xs:documentation>
                    </xs:annotation>
                  </xs:attribute>
                </xs:complexType>
              </xs:element>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
      </xs:sequence>
      <xs:attribute name="ShapeType" type="ShapeTypeEnum" use="required">
        <xs:annotation>
          <xs:documentation>Type of shape, either Point, Line, or Polygon</xs:documentation>
        </xs:annotation>
      </xs:attribute>
    </xs:complexType>

[ top ]
Simple Type ColorType

Annotations |
    A hex color CSS string in the format #RRGGBBAA
Diagram |
Type | restriction of xs:string
Facets |
pattern | #[0-9a-fA-F]{8} |
Used by |
Attributes | GRID/SHAPE/Shape/@BackgroundColor, GRID/SHAPE/Shape/@OutlineColor, GRID/SHAPE/Shape/@TextColor
Source |
    <xs:simpleType name="ColorType">
      <xs:annotation>
        <xs:documentation>A hex color CSS string in the format #RRGGBBAA</xs:documentation>
      </xs:annotation>
      <xs:restriction base="xs:string">
        <xs:pattern value="#[0-9a-fA-F]{8}"/>
      </xs:restriction>
    </xs:simpleType>

[ top ]
Attribute ProtectionDevice / @ID

Annotations |
    ID (see type StringID). Each ProtectionDevice requires a unique ID among all ProtectionDevices.
Type | StringID
Properties |
use | required
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Complex Type | ProtectionDevice
Source |
    <xs:attribute name="ID" type="StringID" use="required">
      <xs:annotation>
        <xs:documentation>ID (see type StringID). Each ProtectionDevice requires a unique ID among all ProtectionDevices.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute ProtectionDevice / @Name

Type | xs:string
Properties |
content | simple
Used by |
Complex Type | ProtectionDevice
Source |
    <xs:attribute name="Name" type="xs:string"/>

[ top ]
Attribute ProtectionDevice / @Description

Type | xs:string
Properties |
content | simple
Used by |
Complex Type | ProtectionDevice
Source |
    <xs:attribute name="Description" type="xs:string"/>

[ top ]
Attribute ProtectionDevice / @ConstructionYear

Type | xs:integer
Properties |
content | simple
Used by |
Complex Type | ProtectionDevice
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer"/>

[ top ]
Attribute ProtectionDevice / @ExternalURL

Type | xs:anyURI
Properties |
content | simple
Used by |
Complex Type | ProtectionDevice
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI"/>

[ top ]
Attribute ProtectionDevice / @Direction

Type | ProtectionDeviceDirection
Properties |
content | simple
Facets |
enumeration | Undirected |
    Faults in both directions are cleared. This option must not be used for Distance Protection Devices as they cannot be undirected.
enumeration | Bus 1 to Bus 2 |
    Only faults visible when 'looking' from bus1 to bus2 are cleared.
enumeration | Bus 2 to Bus 1 |
    Only faults visible when 'looking' from bus2 to bus1 are cleared.
Used by |
Complex Type | ProtectionDevice
Source |
    <xs:attribute name="Direction" type="ProtectionDeviceDirection"/>

[ top ]
Attribute ProtectionDevice / @HostSwitchID

Annotations |
    ID of the switch where the protection device is connected to (required). Previously called 'HostCircuitBreakerID'.
Type | StringID
Properties |
content | simple
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Complex Type | ProtectionDevice
Source |
    <xs:attribute name="HostSwitchID" type="StringID">
      <xs:annotation>
        <xs:documentation>ID of the switch where the protection device is connected to (required). Previously called 'HostCircuitBreakerID'.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute DefiniteTimeOvercurrentProtection / STAGE / Stage / @CurrentInKiloampere

Annotations |
    When measuring a current between this current and the next higher CurrentInKiloampere, the devices clears the fault after SwitchOffTimeInSeconds seconds.
Type | xs:double
Properties |
content | simple
Used by |
Element | DefiniteTimeOvercurrentProtection/STAGE/Stage
Source |
    <xs:attribute name="CurrentInKiloampere" type="xs:double">
      <xs:annotation>
        <xs:documentation>When measuring a current between this current and the next higher CurrentInKiloampere, the devices clears the fault after SwitchOffTimeInSeconds seconds.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute DefiniteTimeOvercurrentProtection / STAGE / Stage / @SwitchOffTimeInSeconds

Annotations |
    The time after which the fault is cleared.
Type | xs:double
Properties |
content | simple
Used by |
Element | DefiniteTimeOvercurrentProtection/STAGE/Stage
Source |
    <xs:attribute name="SwitchOffTimeInSeconds" type="xs:double">
      <xs:annotation>
        <xs:documentation>The time after which the fault is cleared.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute DistanceProtection / STAGE / Stage / @ImpedanceInOhm

Type | xs:double
Properties |
content | simple
Used by |
Element | DistanceProtection/STAGE/Stage
Source |
    <xs:attribute name="ImpedanceInOhm" type="xs:double"/>

[ top ]
Attribute DistanceProtection / STAGE / Stage / @SwitchOffTimeInSeconds

Type | xs:double
Properties |
content | simple
Used by |
Element | DistanceProtection/STAGE/Stage
Source |
    <xs:attribute name="SwitchOffTimeInSeconds" type="xs:double"/>

[ top ]
Attribute DistanceProtection / @DirectionalFinalTimeInSeconds

Annotations |
    When a distance protection device recognizes a fault in it's direction,
    this is the time after which the device sends a second
    	switch-open-signal to the circuit breaker if the first one didn't work for some reason.
Type | xs:double
Properties |
content | simple
Used by |
Complex Type | DistanceProtection
Source |
    <xs:attribute name="DirectionalFinalTimeInSeconds" type="xs:double">
      <xs:annotation>
        <xs:documentation>When a distance protection device recognizes a fault in it's direction, this is the time after which the device sends a second switch-open-signal to the circuit breaker if the first one didn't work for some reason.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute DistanceProtection / @NonDirectionalFinalTimeInSeconds

Annotations |
    The swich-off time when a fault in backwards direction is detected.
Type | xs:double
Properties |
content | simple
Used by |
Complex Type | DistanceProtection
Source |
    <xs:attribute name="NonDirectionalFinalTimeInSeconds" type="xs:double">
      <xs:annotation>
        <xs:documentation>The swich-off time when a fault in backwards direction is detected.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute DistanceProtection / @OvercurrentThresholdInKiloampere

Annotations |
    Threshold for the device to get active. Measured currents above this threshold are assumed to be faults,
    in this case the device will switch after the delay defined by the stages and the measured impedance.
    whereas currents under this threshold are assumed to be normal operational currents.
Type | xs:double
Properties |
content | simple
Used by |
Complex Type | DistanceProtection
Source |
    <xs:attribute name="OvercurrentThresholdInKiloampere" type="xs:double">
      <xs:annotation>
        <xs:documentation>Threshold for the device to get active. Measured currents above this threshold are assumed to be faults, in this case the device will switch after the delay defined by the stages and the measured impedance. whereas currents under this threshold are assumed to be normal operational currents.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute DistanceProtection / @MinimalGridImpedanceInOhm

Annotations |
    The minimum impedance a distance protection device can reliably detect.
    When parameterizing distance protection devices automatically,
    the impedance of the first stage will not fall below this value.
Type | xs:double
Properties |
content | simple
Used by |
Complex Type | DistanceProtection
Source |
    <xs:attribute name="MinimalGridImpedanceInOhm" type="xs:double">
      <xs:annotation>
        <xs:documentation>The minimum impedance a distance protection device can reliably detect. When parameterizing distance protection devices automatically, the impedance of the first stage will not fall below this value.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute DistanceProtection / @MaxStages

Annotations |
    The maximum number of stages that can be configured in the device
Type | xs:integer
Properties |
content | simple
Used by |
Complex Type | DistanceProtection
Source |
    <xs:attribute name="MaxStages" type="xs:integer">
      <xs:annotation>
        <xs:documentation>The maximum number of stages that can be configured in the device</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute CosPhiUCharacteristicDataPoint / @VoltageInPerUnit

Type | xs:double
Properties |
use | required
Used by |
Complex Type | CosPhiUCharacteristicDataPoint
Source |
    <xs:attribute name="VoltageInPerUnit" type="xs:double" use="required"/>

[ top ]
Attribute CosPhiUCharacteristicDataPoint / @CosPhi

Type | xs:double
Properties |
use | required
Used by |
Complex Type | CosPhiUCharacteristicDataPoint
Source |
    <xs:attribute name="CosPhi" type="xs:double" use="required"/>

[ top ]
Attribute CosPhiUCharacteristicDataPoint / @CosPhiType

Type | cosPhiType
Properties |
content | simple
Facets |
enumeration | INDUCTIVE |
    For Loads: Reactive power is injected when active power is injected, reactive power is consumed when active power is consumed.
    For Generators: Reactive power is consumed when active power is injected, reactive power is injected when active power is consumed.
enumeration | CAPACITIVE |
    For Loads: Reactive power is injected when active power is consumed, reactive power is consumed when active power is injected.
    For Generators: Reactive power is consumed when active power is consumed, reactive power is injected when active power is injected.
enumeration | UNDEREXCITED |
    For Loads and Generators: Reactive power is drawn from the grid.
enumeration | OVEREXCITED |
    For Loads and Generators: Reactive power is injected into the grid.
Used by |
Complex Type | CosPhiUCharacteristicDataPoint
Source |
    <xs:attribute name="CosPhiType" type="cosPhiType"/>

[ top ]
Attribute QUCharacteristicDataPoint / @VoltageInPerUnit

Type | xs:double
Properties |
use | required
Used by |
Complex Type | QUCharacteristicDataPoint
Source |
    <xs:attribute name="VoltageInPerUnit" type="xs:double" use="required"/>

[ top ]
Attribute QUCharacteristicDataPoint / @RelativeReactivePowerInPerUnit

Type | xs:double
Properties |
use | required
Used by |
Complex Type | QUCharacteristicDataPoint
Source |
    <xs:attribute name="RelativeReactivePowerInPerUnit" type="xs:double" use="required"/>

[ top ]
Attribute ReactivePowerCharacteristic / @CharacteristicType

Type | reactivePowerCharacteristicType
Properties |
content | simple
Facets |
enumeration | FIXED_Q |
    Reactive Power is directly entered as a (constant) value in Megawatt. This is the simplest form of defining reactive power.
enumeration | FLUCTUATING_Q |
    Reactive Power is randomly chosen between two user-defined limits (minimal and maximal power in Megawatt).
enumeration | P_Q_CHARACTERISTIC |
    User can define a curve that links active powers to reactive power.
enumeration | FIXED_COS_PHI |
    Reactive power is calculated from a fixed cosPhi and a cosPhiType.
enumeration | FLUCTUATING_COS_PHI |
    Reactive power is calculated from a cosPhi and a cosPhiType. The cosPhi is chosen randomly between two user-defined limits.
enumeration | COS_PHI_CHARACTERISTIC |
    User can define a curve that links active powers to a cosPhi. The active power is calcuated out of the cosPhi.
enumeration | COS_PHI_U |
    User can define a curve that links voltage to a cos(phi). During the powerflow, the voltage is measured and the reactive power is determined from the cos(phi) for that voltage.
enumeration | Q_U |
    User can define a curve that links voltage to reactive power. During the powerflow, the voltage is measured and the reactive power is determined from the curse.
Used by |
Complex Type | ReactivePowerCharacteristic
Source |
    <xs:attribute name="CharacteristicType" type="reactivePowerCharacteristicType"/>

[ top ]
Attribute ReactivePowerCharacteristic / @FixedCosPhi

Type | xs:double
Properties |
content | simple
Used by |
Complex Type | ReactivePowerCharacteristic
Source |
    <xs:attribute name="FixedCosPhi" type="xs:double"/>

[ top ]
Attribute ReactivePowerCharacteristic / @CosPhiType

Type | cosPhiType
Properties |
content | simple
Facets |
enumeration | INDUCTIVE |
    For Loads: Reactive power is injected when active power is injected, reactive power is consumed when active power is consumed.
    For Generators: Reactive power is consumed when active power is injected, reactive power is injected when active power is consumed.
enumeration | CAPACITIVE |
    For Loads: Reactive power is injected when active power is consumed, reactive power is consumed when active power is injected.
    For Generators: Reactive power is consumed when active power is consumed, reactive power is injected when active power is injected.
enumeration | UNDEREXCITED |
    For Loads and Generators: Reactive power is drawn from the grid.
enumeration | OVEREXCITED |
    For Loads and Generators: Reactive power is injected into the grid.
Used by |
Complex Type | ReactivePowerCharacteristic
Source |
    <xs:attribute name="CosPhiType" type="cosPhiType"/>

[ top ]
Attribute ReactivePowerCharacteristic / @CosPhiCharacteristicMaxCosPhiFormula

Type | xs:string
Properties |
content | simple
Used by |
Complex Type | ReactivePowerCharacteristic
Source |
    <xs:attribute name="CosPhiCharacteristicMaxCosPhiFormula" type="xs:string"/>

[ top ]
Attribute ReactivePowerCharacteristic / @FixedQInKilovar

Type | xs:double
Properties |
content | simple
Used by |
Complex Type | ReactivePowerCharacteristic
Source |
    <xs:attribute name="FixedQInKilovar" type="xs:double"/>

[ top ]
Attribute ReactivePowerCharacteristic / @QUCosPhi

Type | xs:double
Properties |
content | simple
Used by |
Complex Type | ReactivePowerCharacteristic
Source |
    <xs:attribute name="QUCosPhi" type="xs:double"/>

[ top ]
Attribute GISType / Points / Point / @Lat

Annotations |
    Latitude in WGS-84 projection of the current point
Type | xs:double
Properties |
use | required
Used by |
Element | GISType/Points/Point
Source |
    <xs:attribute name="Lat" type="xs:double" use="required">
      <xs:annotation>
        <xs:documentation>Latitude in WGS-84 projection of the current point</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GISType / Points / Point / @Lon

Annotations |
    Longitude in WGS-84 projection of the current point
Type | xs:double
Properties |
use | required
Used by |
Element | GISType/Points/Point
Source |
    <xs:attribute name="Lon" type="xs:double" use="required">
      <xs:annotation>
        <xs:documentation>Longitude in WGS-84 projection of the current point</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GISType / @ShapeType

Annotations |
    Type of shape, either Point, Line, or Polygon
Type | ShapeTypeEnum
Properties |
use | required
Facets |
enumeration | Point |
    Shape type "Point" needs in its child node element "Points" exactly one "Point" element.
enumeration | Line |
    Shape type "Line" needs in its child node element "Points" two or more "Point" elements.
enumeration | Polygon |
    Shape type "Polygon" needs in its child node element "Points" three or more "Point" elements.
Used by |
Complex Type | GISType
Source |
    <xs:attribute name="ShapeType" type="ShapeTypeEnum" use="required">
      <xs:annotation>
        <xs:documentation>Type of shape, either Point, Line, or Polygon</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / BUSBAR_NODE / Node / @ID

Annotations |
    ID (see type StringID). Each Node requires a unique ID among all Nodes.
Type | StringID
Properties |
use | required
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="ID" type="StringID" use="required">
      <xs:annotation>
        <xs:documentation>ID (see type StringID). Each Node requires a unique ID among all Nodes.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / BUSBAR_NODE / Node / @CustomersToBusMatchingID

Annotations |
    Customer-specific ID to match data (e.g., smartmeter data) to the bus.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="CustomersToBusMatchingID" type="xs:string">
      <xs:annotation>
        <xs:documentation>Customer-specific ID to match data (e.g., smartmeter data) to the bus.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / BUSBAR_NODE / Node / @Name

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="Name" type="xs:string"/>

[ top ]
Attribute GRID / BUSBAR_NODE / Node / @Description

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="Description" type="xs:string"/>

[ top ]
Attribute GRID / BUSBAR_NODE / Node / @ConstructionYear

Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer"/>

[ top ]
Attribute GRID / BUSBAR_NODE / Node / @ExternalURL

Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI"/>

[ top ]
Attribute GRID / BUSBAR_NODE / Node / @IsVertical

Annotations |
    Defines if the bus (if it is drawn as a bus bar) is drawn horizontally or vertically. Buses are drawn horizontally by default, i.e., if this attribute is absent.
Type | xs:boolean
Properties |
content | simple
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="IsVertical" type="xs:boolean">
      <xs:annotation>
        <xs:documentation>Defines if the bus (if it is drawn as a bus bar) is drawn horizontally or vertically. Buses are drawn horizontally by default, i.e., if this attribute is absent.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / BUSBAR_NODE / Node / @Type

Annotations |
    Denotes the type of the grid node and shall be either TransformerStation, DistributionCabinet, CableJunction, BusBar, ConnectionPoint, SmallConnectionPoint, or Other
Type | BusTypeEnum
Properties |
content | simple
Facets |
enumeration | TransformerStation |
    Indicates the location of a transformer station.
    Useful in MV grid to see where transformers are connected (in the same grid model, or in a subgrid).
enumeration | DistributionCabinet |
    A distribtion cabinet (Ger. 'Verteilkabine') is used in LV grids to distribute the power
    to different households or streets. They sometimes include metering devices.
enumeration | CableJunction |
    A cable junction (Ger. 'Muffe') is used to connect two different cables.
    Connecting other grid elements is usually not possible.
enumeration | BusBar |
    A bus bar (Ger. 'Sammelschiene') is a metallic bar inside a transformer station used
    for high current power distribution.
enumeration | ConnectionPoint |
    A connection point (Ger. 'Hausanschluss') represents a customer (private or commercial).
enumeration | SmallConnectionPoint |
    A small connection point (Ger. 'Kleinverbraucheranschluss') is a small power consumer,
    typically located in public areas, such as ticket machines or street lighting.
enumeration | Virtual |
    Virtual buses are buses that do not exist in the physical reality but are created
    for the sake of the grid modeling.
enumeration | PreferredNetworkFeederLocation |
    If the grid model does not have a network feeder, this defines the host bus of the network feeder
    that is created by the software. If the grid model has a network feeder it is recommended to use
    this type for the host bus.
enumeration | Other |
    Other buses that don't match any of the above types.
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="Type" type="BusTypeEnum">
      <xs:annotation>
        <xs:documentation>Denotes the type of the grid node and shall be either TransformerStation, DistributionCabinet, CableJunction, BusBar, ConnectionPoint, SmallConnectionPoint, or Other</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / BUSBAR_NODE / Node / @BaseVoltageInKilovolt

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="BaseVoltageInKilovolt" type="xs:double"/>

[ top ]
Attribute GRID / BUSBAR_NODE / Node / @SelfTimeInSeconds

Annotations |
    Time required to deenergize underlying transformer station in case of fault. Optionally used in the protection calculation.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="SelfTimeInSeconds" type="xs:double">
      <xs:annotation>
        <xs:documentation>Time required to deenergize underlying transformer station in case of fault. Optionally used in the protection calculation.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / BUSBAR_NODE / Node / @x

Annotations |
    x-coordinate of the bus to display in the schematic view
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="x" type="xs:double">
      <xs:annotation>
        <xs:documentation>x-coordinate of the bus to display in the schematic view</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / BUSBAR_NODE / Node / @y

Annotations |
    y-coordinate of the bus to display in the schematic view
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="y" type="xs:double">
      <xs:annotation>
        <xs:documentation>y-coordinate of the bus to display in the schematic view</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / BUSBAR_NODE / Node / @LibraryRealibilityName

Annotations |
    Defines the used reliability model of Adaptricity's component library. The reliability model
    defines how long and how frequently the component is expected to fail.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="LibraryRealibilityName" type="xs:string">
      <xs:annotation>
        <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LINE / Line / @ID

Annotations |
    ID (see type StringID). Each Line requires a unique ID among all branch types (Line, Connection, Transformer).
Type | StringID
Properties |
use | required
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="ID" type="StringID" use="required">
      <xs:annotation>
        <xs:documentation>ID (see type StringID). Each Line requires a unique ID among all branch types (Line, Connection, Transformer).</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LINE / Line / @Name

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="Name" type="xs:string"/>

[ top ]
Attribute GRID / LINE / Line / @Description

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="Description" type="xs:string"/>

[ top ]
Attribute GRID / LINE / Line / @ConstructionYear

Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer"/>

[ top ]
Attribute GRID / LINE / Line / @ExternalURL

Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI"/>

[ top ]
Attribute GRID / LINE / Line / @ResistanceInOhmPerKilometer

Annotations |
    Required for power flow simulations. It can be fetched from the
    Component Library if resistance and reactance values are not given in the xml.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="ResistanceInOhmPerKilometer" type="xs:double">
      <xs:annotation>
        <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if resistance and reactance values are not given in the xml.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LINE / Line / @ReactanceInOhmPerKilometer

Annotations |
    Required for power flow simulations. It can be fetched from the
    Component Library if resistance and reactance values are not given in the xml.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="ReactanceInOhmPerKilometer" type="xs:double">
      <xs:annotation>
        <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if resistance and reactance values are not given in the xml.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LINE / Line / @ZeroSequenceResistanceInOhmPerKilometer

Annotations |
    Optional parameter for short circuit calculations involving
    ground faults. If undefined, zero sequence impedance is linked to positive
    sequence impedance using a constant factor.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="ZeroSequenceResistanceInOhmPerKilometer" type="xs:double">
      <xs:annotation>
        <xs:documentation>Optional parameter for short circuit calculations involving ground faults. If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LINE / Line / @ZeroSequenceReactanceInOhmPerKilometer

Annotations |
    Optional parameter for short circuit calculations involving
    ground faults. If undefined, zero sequence impedance is linked to positive
    sequence impedance using a constant factor.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="ZeroSequenceReactanceInOhmPerKilometer" type="xs:double">
      <xs:annotation>
        <xs:documentation>Optional parameter for short circuit calculations involving ground faults. If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LINE / Line / @MaximumCurrentInAmpere

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="MaximumCurrentInAmpere" type="xs:double"/>

[ top ]
Attribute GRID / LINE / Line / @ShortCircuitStabilityThreePhaseInKiloampere

Annotations |
    Optional parameter denoting the maximal
    three phase aperiodic short circuit current the line can withstand.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="ShortCircuitStabilityThreePhaseInKiloampere" type="xs:double">
      <xs:annotation>
        <xs:documentation>Optional parameter denoting the maximal three phase aperiodic short circuit current the line can withstand.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LINE / Line / @ShuntCapacitanceInMicrofaradPerKilometer

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="ShuntCapacitanceInMicrofaradPerKilometer" type="xs:double"/>

[ top ]
Attribute GRID / LINE / Line / @LengthInKilometer

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="LengthInKilometer" type="xs:double"/>

[ top ]
Attribute GRID / LINE / Line / @Manufacturer

Annotations |
    Manufacturer name (it will be removed after grid import, used for component
    library matching only if the required electrical attributes are missing)
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="Manufacturer" type="xs:string">
      <xs:annotation>
        <xs:documentation>Manufacturer name (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LINE / Line / @LibraryComponentName

Annotations |
    Name of the component, must be unique in the component library (it will be removed after grid
    import, used for component library matching only if the required electrical attributes are missing)
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="LibraryComponentName" type="xs:string">
      <xs:annotation>
        <xs:documentation>Name of the component, must be unique in the component library (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LINE / Line / @LibraryComponentType

Annotations |
    Type of the cable (e.g., GKN). It will be removed after grid import, used
    for component library matching only if the required electrical attributes are missing.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="LibraryComponentType" type="xs:string">
      <xs:annotation>
        <xs:documentation>Type of the cable (e.g., GKN). It will be removed after grid import, used for component library matching only if the required electrical attributes are missing.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LINE / Line / @IsOverhead

Annotations |
    True if overhead line, false if underground cable or other (it will be removed after
    grid import, used for component library matching only if the required electrical attributes are missing)
Type | xs:boolean
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="IsOverhead" type="xs:boolean">
      <xs:annotation>
        <xs:documentation>True if overhead line, false if underground cable or other (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LINE / Line / @Material

Annotations |
    Material name (it will be removed after grid import, used for
    component library matching only if the required electrical attributes are missing)
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="Material" type="xs:string">
      <xs:annotation>
        <xs:documentation>Material name (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LINE / Line / @CrossSection

Annotations |
    Cross section of the cable (e.g. 95mm^2, 3x95/95, ...), notation needs to match the notation in the component library.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="CrossSection" type="xs:string">
      <xs:annotation>
        <xs:documentation>Cross section of the cable (e.g. 95mm^2, 3x95/95, ...), notation needs to match the notation in the component library.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LINE / Line / @Bus1ID

Annotations |
    ID of bus 1 that it is connected to.
Type | StringID
Properties |
content | simple
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="Bus1ID" type="StringID">
      <xs:annotation>
        <xs:documentation>ID of bus 1 that it is connected to.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LINE / Line / @Bus2ID

Annotations |
    ID of bus 2 that it is connected to.
Type | StringID
Properties |
content | simple
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="Bus2ID" type="StringID">
      <xs:annotation>
        <xs:documentation>ID of bus 2 that it is connected to.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LINE / Line / @ConnectedAtBus1

Annotations |
    True if switch is closed (connected) at
    bus 1, false if open (not connected).
    Default value is true.
Type | xs:boolean
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
      <xs:annotation>
        <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected). Default value is true.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LINE / Line / @ConnectedAtBus2

Annotations |
    True if switch is closed (connected) at
    bus 2, false if open (not connected).
    Default value is true.
Type | xs:boolean
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
      <xs:annotation>
        <xs:documentation>True if switch is closed (connected) at bus 2, false if open (not connected). Default value is true.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LINE / Line / @Owner

Annotations |
    Each branch (lines, transformer, connection) in the grid model can be assigned an owner. The selectable owners can be configured in the general options
    in the Adaptricity Admin panel. For each owner, you can specify whether the associated branches are to be ignored when evaluating connection requests.
    These branches are referred to as "ignored" in the following. Ignored branches are handled differently:
    1) In Adaptricity.Connect: a bus is ignored when calculating the hosting capacity if it is connected exclusively to ignored branches. As a result,
    these buses are not available as possible connection points in Adaptricity.Connect. If the 'Hosting capacity on lines' option has been selected,
    hosting capacities are also not calculated on ignored lines.
    2) In the user-defined connection request: During the automatic selection of potential connection nodes,
    those nodes that are connected exclusively to ignored branches are ignored.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="Owner" type="xs:string">
      <xs:annotation>
        <xs:documentation>Each branch (lines, transformer, connection) in the grid model can be assigned an owner. The selectable owners can be configured in the general options in the Adaptricity Admin panel. For each owner, you can specify whether the associated branches are to be ignored when evaluating connection requests. These branches are referred to as "ignored" in the following. Ignored branches are handled differently: 1) In Adaptricity.Connect: a bus is ignored when calculating the hosting capacity if it is connected exclusively to ignored branches. As a result, these buses are not available as possible connection points in Adaptricity.Connect. If the 'Hosting capacity on lines' option has been selected, hosting capacities are also not calculated on ignored lines. 2) In the user-defined connection request: During the automatic selection of potential connection nodes, those nodes that are connected exclusively to ignored branches are ignored.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LINE / Line / @LibraryRealibilityName

Annotations |
    Defines the used reliability model of Adaptricity's component library. The reliability model
    defines how long and how frequently the component is expected to fail.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="LibraryRealibilityName" type="xs:string">
      <xs:annotation>
        <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / CONNECTION / Connection / @ID

Annotations |
    ID (see type StringID). Each Line requires a unique ID among all branch types (Line, Connection, Transformer).
Type | StringID
Properties |
use | required
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/CONNECTION/Connection
Source |
    <xs:attribute name="ID" type="StringID" use="required">
      <xs:annotation>
        <xs:documentation>ID (see type StringID). Each Line requires a unique ID among all branch types (Line, Connection, Transformer).</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / CONNECTION / Connection / @Name

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/CONNECTION/Connection
Source |
    <xs:attribute name="Name" type="xs:string"/>

[ top ]
Attribute GRID / CONNECTION / Connection / @Description

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/CONNECTION/Connection
Source |
    <xs:attribute name="Description" type="xs:string"/>

[ top ]
Attribute GRID / CONNECTION / Connection / @ConstructionYear

Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/CONNECTION/Connection
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer"/>

[ top ]
Attribute GRID / CONNECTION / Connection / @ExternalURL

Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/CONNECTION/Connection
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI"/>

[ top ]
Attribute GRID / CONNECTION / Connection / @ResistanceInMilliOhm

Annotations |
    Resistance in mΩ. Optional parameter. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided,
    the connection has a minimal resistance of 1mΩ (for numerical reasons).
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/CONNECTION/Connection
Source |
    <xs:attribute name="ResistanceInMilliOhm" type="xs:double">
      <xs:annotation>
        <xs:documentation>Resistance in mΩ. Optional parameter. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided, the connection has a minimal resistance of 1mΩ (for numerical reasons).</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / CONNECTION / Connection / @ReactanceInMilliOhm

Annotations |
    Reactance in mΩ. Optional parameter. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided,
    the connection has a minimal resistance of 1mΩ (for numerical reasons).
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/CONNECTION/Connection
Source |
    <xs:attribute name="ReactanceInMilliOhm" type="xs:double">
      <xs:annotation>
        <xs:documentation>Reactance in mΩ. Optional parameter. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided, the connection has a minimal resistance of 1mΩ (for numerical reasons).</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / CONNECTION / Connection / @Bus1ID

Annotations |
    ID of bus 1 that it is connected to.
Type | StringID
Properties |
content | simple
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/CONNECTION/Connection
Source |
    <xs:attribute name="Bus1ID" type="StringID">
      <xs:annotation>
        <xs:documentation>ID of bus 1 that it is connected to.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / CONNECTION / Connection / @Bus2ID

Annotations |
    ID of bus 2 that it is connected to.
Type | StringID
Properties |
content | simple
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/CONNECTION/Connection
Source |
    <xs:attribute name="Bus2ID" type="StringID">
      <xs:annotation>
        <xs:documentation>ID of bus 2 that it is connected to.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / CONNECTION / Connection / @ConnectedAtBus1

Annotations |
    True if switch is closed (connected) at
    bus 1, false if open (not connected). Default value is true
Type | xs:boolean
Properties |
content | simple
Used by |
Element | GRID/CONNECTION/Connection
Source |
    <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
      <xs:annotation>
        <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected). Default value is true</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / CONNECTION / Connection / @ConnectedAtBus2

Annotations |
    True if switch is closed (connected) at
    bus 2, false if open (not connected). Default value is true
Type | xs:boolean
Properties |
content | simple
Used by |
Element | GRID/CONNECTION/Connection
Source |
    <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
      <xs:annotation>
        <xs:documentation>True if switch is closed (connected) at bus 2, false if open (not connected). Default value is true</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / CONNECTION / Connection / @Owner

Annotations |
    Each branch (lines, transformer, connection) in the grid model can be assigned an owner. The selectable owners can be configured in the general options
    in the Adaptricity Admin panel. For each owner, you can specify whether the associated branches are to be ignored when evaluating connection requests.
    These branches are referred to as "ignored" in the following. Ignored branches are handled differently:
    1) In Adaptricity.Connect: a bus is ignored when calculating the hosting capacity if it is connected exclusively to ignored branches. As a result,
    these buses are not available as possible connection points in Adaptricity.Connect. If the 'Hosting capacity on lines' option has been selected,
    hosting capacities are also not calculated on ignored lines.
    2) In the user-defined connection request: During the automatic selection of potential connection nodes,
    those nodes that are connected exclusively to ignored branches are ignored.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/CONNECTION/Connection
Source |
    <xs:attribute name="Owner" type="xs:string">
      <xs:annotation>
        <xs:documentation>Each branch (lines, transformer, connection) in the grid model can be assigned an owner. The selectable owners can be configured in the general options in the Adaptricity Admin panel. For each owner, you can specify whether the associated branches are to be ignored when evaluating connection requests. These branches are referred to as "ignored" in the following. Ignored branches are handled differently: 1) In Adaptricity.Connect: a bus is ignored when calculating the hosting capacity if it is connected exclusively to ignored branches. As a result, these buses are not available as possible connection points in Adaptricity.Connect. If the 'Hosting capacity on lines' option has been selected, hosting capacities are also not calculated on ignored lines. 2) In the user-defined connection request: During the automatic selection of potential connection nodes, those nodes that are connected exclusively to ignored branches are ignored.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / CONNECTION / Connection / @LibraryRealibilityName

Annotations |
    Defines the used reliability model of Adaptricity's component library. The reliability model
    defines how long and how frequently the component is expected to fail.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/CONNECTION/Connection
Source |
    <xs:attribute name="LibraryRealibilityName" type="xs:string">
      <xs:annotation>
        <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / VOLTAGEREGULATOR / VoltageRegulator / @ID

Annotations |
    ID (see type StringID). Each VoltageRegulator requires a unique ID among all VoltageRegulators.
Type | StringID
Properties |
use | required
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/VOLTAGEREGULATOR/VoltageRegulator
Source |
    <xs:attribute name="ID" type="StringID" use="required">
      <xs:annotation>
        <xs:documentation>ID (see type StringID). Each VoltageRegulator requires a unique ID among all VoltageRegulators.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / VOLTAGEREGULATOR / VoltageRegulator / @Name

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/VOLTAGEREGULATOR/VoltageRegulator
Source |
    <xs:attribute name="Name" type="xs:string"/>

[ top ]
Attribute GRID / VOLTAGEREGULATOR / VoltageRegulator / @Description

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/VOLTAGEREGULATOR/VoltageRegulator
Source |
    <xs:attribute name="Description" type="xs:string"/>

[ top ]
Attribute GRID / VOLTAGEREGULATOR / VoltageRegulator / @ConstructionYear

Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/VOLTAGEREGULATOR/VoltageRegulator
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer"/>

[ top ]
Attribute GRID / VOLTAGEREGULATOR / VoltageRegulator / @ExternalURL

Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/VOLTAGEREGULATOR/VoltageRegulator
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI"/>

[ top ]
Attribute GRID / VOLTAGEREGULATOR / VoltageRegulator / @HostLineID

Type | StringID
Properties |
content | simple
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/VOLTAGEREGULATOR/VoltageRegulator
Source |
    <xs:attribute name="HostLineID" type="StringID"/>

[ top ]
Attribute GRID / VOLTAGEREGULATOR / VoltageRegulator / @NumTaps

Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/VOLTAGEREGULATOR/VoltageRegulator
Source |
    <xs:attribute name="NumTaps" type="xs:integer"/>

[ top ]
Attribute GRID / VOLTAGEREGULATOR / VoltageRegulator / @TapSizeFractionInPercent

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/VOLTAGEREGULATOR/VoltageRegulator
Source |
    <xs:attribute name="TapSizeFractionInPercent" type="xs:double"/>

[ top ]
Attribute GRID / VOLTAGEREGULATOR / VoltageRegulator / @DeadBandFractionInPercent

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/VOLTAGEREGULATOR/VoltageRegulator
Source |
    <xs:attribute name="DeadBandFractionInPercent" type="xs:double"/>

[ top ]
Attribute GRID / VOLTAGEREGULATOR / VoltageRegulator / @SetpointInPerUnit

Annotations |
    This defines the desired voltage in per unit at the measured bus.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/VOLTAGEREGULATOR/VoltageRegulator
Source |
    <xs:attribute name="SetpointInPerUnit" type="xs:double">
      <xs:annotation>
        <xs:documentation>This defines the desired voltage in per unit at the measured bus.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LOAD / Load / @ID

Annotations |
    ID (see type StringID). Each Load requires a unique ID among all Loads.
Type | StringID
Properties |
use | required
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/LOAD/Load
Source |
    <xs:attribute name="ID" type="StringID" use="required">
      <xs:annotation>
        <xs:documentation>ID (see type StringID). Each Load requires a unique ID among all Loads.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LOAD / Load / @Name

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/LOAD/Load
Source |
    <xs:attribute name="Name" type="xs:string"/>

[ top ]
Attribute GRID / LOAD / Load / @Description

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/LOAD/Load
Source |
    <xs:attribute name="Description" type="xs:string"/>

[ top ]
Attribute GRID / LOAD / Load / @ConstructionYear

Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/LOAD/Load
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer"/>

[ top ]
Attribute GRID / LOAD / Load / @ExternalURL

Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/LOAD/Load
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI"/>

[ top ]
Attribute GRID / LOAD / Load / @LoadCategory

Type | LoadCategoryEnum
Properties |
content | simple
Facets |
enumeration | Residential |
    Load of a private customer
enumeration | Industrial |
    Load of an industrial customer
enumeration | Heat pump |
    A heat pump, e.g. to heat a building.
enumeration | Electric heating |
    Electric resistive heating, e.g. to heat a building.
    As this is very inefficient, this is forbidden in some countries.
enumeration | Electric water heater |
    For example a hot water boiler.
enumeration | EV charger |
    Charger of an electric vehicle
enumeration | Stationary battery |
    A Battery. A batterie defined as static load will always consumer power.
    Batteries with a charge and discharge behavior cannot be modelled in a static grid model.
    They can be applied in the software as part of a 'Scenario'.
enumeration | Equivalent aggregated load |
    When a grid is split, in each subgrid, the load is summed up and placed in the higher voltage grid
    (where the subgrid was extracted from). This load has the type 'Equivalent aggregated load'.
enumeration | Other |
    A load that doesn't match any other category.
Used by |
Element | GRID/LOAD/Load
Source |
    <xs:attribute name="LoadCategory" type="LoadCategoryEnum"/>

[ top ]
Attribute GRID / LOAD / Load / @ActiveLoadInMegawatt

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/LOAD/Load
Source |
    <xs:attribute name="ActiveLoadInMegawatt" type="xs:double"/>

[ top ]
Attribute GRID / LOAD / Load / @Bus1ID

Annotations |
    ID of bus 1 that it is connected to
Type | StringID
Properties |
content | simple
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/LOAD/Load
Source |
    <xs:attribute name="Bus1ID" type="StringID">
      <xs:annotation>
        <xs:documentation>ID of bus 1 that it is connected to</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LOAD / Load / @Connected

Annotations |
    True if switch is closed (connected) at bus
    1, false if open (not connected)
Type | xs:boolean
Properties |
content | simple
Used by |
Element | GRID/LOAD/Load
Source |
    <xs:attribute name="Connected" type="xs:boolean">
      <xs:annotation>
        <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / LOAD / Load / @ConnectionRequestID

Annotations |
    Optional parameter. If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/LOAD/Load
Source |
    <xs:attribute name="ConnectionRequestID" type="xs:string">
      <xs:annotation>
        <xs:documentation>Optional parameter. If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / GENERATOR / Generator / @ID

Annotations |
    ID (see type StringID). Each Generator requires a unique ID among all Generators.
Type | StringID
Properties |
use | required
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="ID" type="StringID" use="required">
      <xs:annotation>
        <xs:documentation>ID (see type StringID). Each Generator requires a unique ID among all Generators.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / GENERATOR / Generator / @Name

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="Name" type="xs:string"/>

[ top ]
Attribute GRID / GENERATOR / Generator / @Description

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="Description" type="xs:string"/>

[ top ]
Attribute GRID / GENERATOR / Generator / @ConstructionYear

Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer"/>

[ top ]
Attribute GRID / GENERATOR / Generator / @ExternalURL

Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI"/>

[ top ]
Attribute GRID / GENERATOR / Generator / @GenerationCategory

Type | GenerationCategoryEnum
Properties |
content | simple
Facets |
enumeration | PV |
    A photovoltaic generator (solar power).
enumeration | Wind |
    A Wind turbine.
enumeration | Biomass |
    In a biomass power plant is some kind of biofuel (e.g. wood) is burned to produce electricity.
enumeration | Hydro |
    A power plant where water is used to power a generator.
    For example with a high pressure from a reservior (pumped hydro) or low pressure (river).
enumeration | Gas turbine |
    A power plant where gas is burned to power a generator.
enumeration | Combined heat and power |
    A power plant where a fuel is burned to provide thermal and electrical energy.
enumeration | Equivalent aggregated generation |
    When a grid is split, in each subgrid, the generation is summed up and placed in the higher voltage grid
    (where the subgrid was extracted from). This generator has the type 'Equivalent aggregated generation'.
enumeration | Other |
    A generator that doesn't match any other category.
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="GenerationCategory" type="GenerationCategoryEnum"/>

[ top ]
Attribute GRID / GENERATOR / Generator / @ConnectionType

Type | GenerationConnectionEnum
Properties |
content | simple
Facets |
enumeration | Direct |
    This option is deprecated and should not be used anymore.
enumeration | Inverter |
    An inverter (Ger. 'Wechselrichter') converts DC power to AC power. It is typically used for solar PV.
enumeration | Synchronous Machine |
    Synchronous generators have a efficieny and are typically used in large power plants (such as hydro or nuclear).
enumeration | Asynchronous Machine |
    Asynchronous machines are sometimes used in small generators (Diesel generator, wind power, hydro ).
enumeration | Converter |
    A converter (Ger. 'Frequenzumrichter') converts the frequency and amplitude.
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="ConnectionType" type="GenerationConnectionEnum"/>

[ top ]
Attribute GRID / GENERATOR / Generator / @ActiveGenerationInMegawatt

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="ActiveGenerationInMegawatt" type="xs:double"/>

[ top ]
Attribute GRID / GENERATOR / Generator / @MinReactiveGenerationInMegavar

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="MinReactiveGenerationInMegavar" type="xs:double"/>

[ top ]
Attribute GRID / GENERATOR / Generator / @MaxReactiveGenerationInMegavar

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="MaxReactiveGenerationInMegavar" type="xs:double"/>

[ top ]
Attribute GRID / GENERATOR / Generator / @MinActiveGenerationInMegawatt

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="MinActiveGenerationInMegawatt" type="xs:double"/>

[ top ]
Attribute GRID / GENERATOR / Generator / @MaxActiveGenerationInMegawatt

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="MaxActiveGenerationInMegawatt" type="xs:double"/>

[ top ]
Attribute GRID / GENERATOR / Generator / @VoltageSetpointInKilovolt

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="VoltageSetpointInKilovolt" type="xs:double"/>

[ top ]
Attribute GRID / GENERATOR / Generator / @Bus1ID

Annotations |
    ID of bus 1 that it is connected to
Type | StringID
Properties |
content | simple
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="Bus1ID" type="StringID">
      <xs:annotation>
        <xs:documentation>ID of bus 1 that it is connected to</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / GENERATOR / Generator / @Connected

Annotations |
    True if switch is closed (connected) at bus
    1, false if open (not connected)
Type | xs:boolean
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="Connected" type="xs:boolean">
      <xs:annotation>
        <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / GENERATOR / Generator / @ConnectionRequestID

Annotations |
    Optional parameter. If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="ConnectionRequestID" type="xs:string">
      <xs:annotation>
        <xs:documentation>Optional parameter. If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / GENERATOR / Generator / @LibraryRealibilityName

Annotations |
    Defines the used reliability model of Adaptricity's component library. The reliability model
    defines how long and how frequently the component is expected to fail.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="LibraryRealibilityName" type="xs:string">
      <xs:annotation>
        <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @ID

Annotations |
    ID (see type StringID). Each Transformer requires a unique ID among all branch types (Line, Connection, Transformer).
Type | StringID
Properties |
use | required
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="ID" type="StringID" use="required">
      <xs:annotation>
        <xs:documentation>ID (see type StringID). Each Transformer requires a unique ID among all branch types (Line, Connection, Transformer).</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @MeasuredVoltageBusID

Annotations |
    The bus ID at which the voltage is measured for the tap-changing controller (see type StringID)
Type | StringID
Properties |
content | simple
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="MeasuredVoltageBusID" type="StringID">
      <xs:annotation>
        <xs:documentation>The bus ID at which the voltage is measured for the tap-changing controller (see type StringID)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @Name

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="Name" type="xs:string"/>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @Description

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="Description" type="xs:string"/>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @ColorIndex

Annotations |
    Optional color index that, if set, will force the subgrid containing this transformer
    to the color with the specified index when grid colorization is turned on.
    The index references the color in the standard color palette used for grid colorization.
Type | xs:nonNegativeInteger
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="ColorIndex" type="xs:nonNegativeInteger">
      <xs:annotation>
        <xs:documentation>Optional color index that, if set, will force the subgrid containing this transformer to the color with the specified index when grid colorization is turned on. The index references the color in the standard color palette used for grid colorization.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @ConstructionYear

Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer"/>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @ExternalURL

Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI"/>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @VectorGroup

Annotations |
    Vector group (Schaltgruppe) of transformer, e.g. Dyn5
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="VectorGroup" type="xs:string">
      <xs:annotation>
        <xs:documentation>Vector group (Schaltgruppe) of transformer, e.g. Dyn5</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @StarPointGrounding

Annotations |
    Defines how the star point is grounded. If vectorGroup doesn't have a star point, leave empty.
Type | StarPointGrounding
Properties |
content | simple
Facets |
enumeration | Direct grounding |
    The start point is connected to ground by a (low resistance) cable.
enumeration | Resonant grounding |
    The start point is connected to ground by an inductor.
enumeration | Insulated grid |
    The start point is not connected to ground (insulated).
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="StarPointGrounding" type="StarPointGrounding">
      <xs:annotation>
        <xs:documentation>Defines how the star point is grounded. If vectorGroup doesn't have a star point, leave empty.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @SecondaryGroundingInductanceInHenry

Annotations |
    In case the star point grounding type 'Resonant grounding' was selected, this number defines the grounding inductance in Henry.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="SecondaryGroundingInductanceInHenry" type="xs:double">
      <xs:annotation>
        <xs:documentation>In case the star point grounding type 'Resonant grounding' was selected, this number defines the grounding inductance in Henry.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @TransformerRatingInMegavoltampere

Annotations |
    Required for power flow simulations. It can be fetched from the Component
    Library if short circuit voltage and copper losses values are not given in the xml.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="TransformerRatingInMegavoltampere" type="xs:double">
      <xs:annotation>
        <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @MaximumApparentPowerInMegavoltampere

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="MaximumApparentPowerInMegavoltampere" type="xs:double"/>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @ShortCircuitVoltageInPercent

Annotations |
    Required for power flow simulations. It can be fetched from the Component
    Library if short circuit voltage and copper losses values are not given in the xml.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="ShortCircuitVoltageInPercent" type="xs:double">
      <xs:annotation>
        <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @CopperLossesInPercent

Annotations |
    Required for power flow simulations. It can be fetched from the Component
    Library if short circuit voltage and copper losses values are not given in the xml.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="CopperLossesInPercent" type="xs:double">
      <xs:annotation>
        <xs:documentation>Required for power flow simulations. It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @RatedVoltageAtBus1

Annotations |
    Rated transformer voltage on the side of Bus 1 in Kilovolt
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="RatedVoltageAtBus1" type="xs:double">
      <xs:annotation>
        <xs:documentation>Rated transformer voltage on the side of Bus 1 in Kilovolt</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @RatedVoltageAtBus2

Annotations |
    Rated transformer voltage on the side of Bus 2 in Kilovolt.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="RatedVoltageAtBus2" type="xs:double">
      <xs:annotation>
        <xs:documentation>Rated transformer voltage on the side of Bus 2 in Kilovolt.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @IsTapChanging

Annotations |
    True if transformer is a tap-changing transformer.
Type | xs:boolean
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="IsTapChanging" type="xs:boolean">
      <xs:annotation>
        <xs:documentation>True if transformer is a tap-changing transformer.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @NumTaps

Annotations |
    For tap-changing transformers, it defines the number of taps.
Type | xs:int
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="NumTaps" type="xs:int">
      <xs:annotation>
        <xs:documentation>For tap-changing transformers, it defines the number of taps.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @TapSizeInPercent

Annotations |
    For tap-changing transformers, it defines the tap size in percent (%)
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="TapSizeInPercent" type="xs:double">
      <xs:annotation>
        <xs:documentation>For tap-changing transformers, it defines the tap size in percent (%)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @DeadBandInPercent

Annotations |
    For tap-changing transformers, it defines the dead band in percent (%)
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="DeadBandInPercent" type="xs:double">
      <xs:annotation>
        <xs:documentation>For tap-changing transformers, it defines the dead band in percent (%)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @SetpointInPerUnit

Annotations |
    For tap-changing transformers, it defines the desired voltage in per unit at the measured bus.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="SetpointInPerUnit" type="xs:double">
      <xs:annotation>
        <xs:documentation>For tap-changing transformers, it defines the desired voltage in per unit at the measured bus.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @Model

Annotations |
    Text field (it will be removed after grid	import, used for
    component library matching only if the required electrical attributes are missing)
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="Model" type="xs:string">
      <xs:annotation>
        <xs:documentation>Text field (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @Manufacturer

Annotations |
    Manufacturer name (it will be removed after grid	import, used for
    component library matching only if the required electrical attributes are missing)
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="Manufacturer" type="xs:string">
      <xs:annotation>
        <xs:documentation>Manufacturer name (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @LibraryComponentName

Annotations |
    Name of the component, must be unique in the component library (it will be removed after
    grid import, used for component library matching only if the required electrical attributes are missing)
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="LibraryComponentName" type="xs:string">
      <xs:annotation>
        <xs:documentation>Name of the component, must be unique in the component library (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @LibraryComponentType

Annotations |
    Type of the transformer as described in the library (it will be removed after grid
    import, used for component library matching only if the required electrical attributes are missing)
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="LibraryComponentType" type="xs:string">
      <xs:annotation>
        <xs:documentation>Type of the transformer as described in the library (it will be removed after grid import, used for component library matching only if the required electrical attributes are missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @Bus1ID

Annotations |
    ID of bus 1 that it is connected to.
Type | StringID
Properties |
content | simple
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="Bus1ID" type="StringID">
      <xs:annotation>
        <xs:documentation>ID of bus 1 that it is connected to.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @Bus2ID

Annotations |
    ID of bus 2 that it is connected to.
Type | StringID
Properties |
content | simple
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="Bus2ID" type="StringID">
      <xs:annotation>
        <xs:documentation>ID of bus 2 that it is connected to.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @ConnectedAtBus1

Annotations |
    True if switch is closed (connected) at
    bus 1, false if open (not connected).
    Default value is true.
Type | xs:boolean
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
      <xs:annotation>
        <xs:documentation>True if switch is closed (connected) at bus 1, false if open (not connected). Default value is true.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @ConnectedAtBus2

Annotations |
    True if switch is closed (connected) at
    bus 2, false if open (not connected).
    Default value is true.
Type | xs:boolean
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
      <xs:annotation>
        <xs:documentation>True if switch is closed (connected) at bus 2, false if open (not connected). Default value is true.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @Owner

Annotations |
    Each branch (lines, transformer, connection) in the grid model can be assigned an owner. The selectable owners can be configured in the general options
    in the Adaptricity Admin panel. For each owner, you can specify whether the associated branches are to be ignored when evaluating connection requests.
    These branches are referred to as "ignored" in the following. Ignored branches are handled differently:
    1) In Adaptricity.Connect: a bus is ignored when calculating the hosting capacity if it is connected exclusively to ignored branches. As a result,
    these buses are not available as possible connection points in Adaptricity.Connect. If the 'Hosting capacity on lines' option has been selected,
    hosting capacities are also not calculated on ignored lines.
    2) In the user-defined connection request: During the automatic selection of potential connection nodes,
    those nodes that are connected exclusively to ignored branches are ignored.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="Owner" type="xs:string">
      <xs:annotation>
        <xs:documentation>Each branch (lines, transformer, connection) in the grid model can be assigned an owner. The selectable owners can be configured in the general options in the Adaptricity Admin panel. For each owner, you can specify whether the associated branches are to be ignored when evaluating connection requests. These branches are referred to as "ignored" in the following. Ignored branches are handled differently: 1) In Adaptricity.Connect: a bus is ignored when calculating the hosting capacity if it is connected exclusively to ignored branches. As a result, these buses are not available as possible connection points in Adaptricity.Connect. If the 'Hosting capacity on lines' option has been selected, hosting capacities are also not calculated on ignored lines. 2) In the user-defined connection request: During the automatic selection of potential connection nodes, those nodes that are connected exclusively to ignored branches are ignored.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / TRANSFORMER / Transformer / @LibraryRealibilityName

Annotations |
    Defines the used reliability model of Adaptricity's component library. The reliability model
    defines how long and how frequently the component is expected to fail.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="LibraryRealibilityName" type="xs:string">
      <xs:annotation>
        <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / FEEDER / Feeder / @ID

Annotations |
    ID (see type StringID).
Type | StringID
Properties |
use | required
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="ID" type="StringID" use="required">
      <xs:annotation>
        <xs:documentation>ID (see type StringID).</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / FEEDER / Feeder / @Name

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="Name" type="xs:string"/>

[ top ]
Attribute GRID / FEEDER / Feeder / @HostBusID

Type | StringID
Properties |
content | simple
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="HostBusID" type="StringID"/>

[ top ]
Attribute GRID / FEEDER / Feeder / @Description

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="Description" type="xs:string"/>

[ top ]
Attribute GRID / FEEDER / Feeder / @ConstructionYear

Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer"/>

[ top ]
Attribute GRID / FEEDER / Feeder / @ExternalURL

Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI"/>

[ top ]
Attribute GRID / FEEDER / Feeder / @OperationalVoltageInPerUnit

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="OperationalVoltageInPerUnit" type="xs:double"/>

[ top ]
Attribute GRID / FEEDER / Feeder / @OperationalAngleInRadians

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="OperationalAngleInRadians" type="xs:double"/>

[ top ]
Attribute GRID / FEEDER / Feeder / @VoltageFactorMax

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="VoltageFactorMax" type="xs:double"/>

[ top ]
Attribute GRID / FEEDER / Feeder / @VoltageFactorMin

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="VoltageFactorMin" type="xs:double"/>

[ top ]
Attribute GRID / FEEDER / Feeder / @MaxSourceShortCircuitPowerInMegavoltampere

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="MaxSourceShortCircuitPowerInMegavoltampere" type="xs:double"/>

[ top ]
Attribute GRID / FEEDER / Feeder / @MinSourceShortCircuitPowerInMegavoltampere

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="MinSourceShortCircuitPowerInMegavoltampere" type="xs:double"/>

[ top ]
Attribute GRID / FEEDER / Feeder / @ReactanceToResistanceRatio

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="ReactanceToResistanceRatio" type="xs:double"/>

[ top ]
Attribute GRID / FEEDER / Feeder / @Connected

Annotations |
    True if switch is closed (connected) at the
    host bus, false if open (not connected)
Type | xs:boolean
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="Connected" type="xs:boolean">
      <xs:annotation>
        <xs:documentation>True if switch is closed (connected) at the host bus, false if open (not connected)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / FUSE / Fuse / @ID

Annotations |
    ID (see type StringID). Each Fuse requires a unique ID among all Fuses.
Type | StringID
Properties |
use | required
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/FUSE/Fuse
Source |
    <xs:attribute name="ID" type="StringID" use="required">
      <xs:annotation>
        <xs:documentation>ID (see type StringID). Each Fuse requires a unique ID among all Fuses.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / FUSE / Fuse / @Name

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/FUSE/Fuse
Source |
    <xs:attribute name="Name" type="xs:string"/>

[ top ]
Attribute GRID / FUSE / Fuse / @Description

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/FUSE/Fuse
Source |
    <xs:attribute name="Description" type="xs:string"/>

[ top ]
Attribute GRID / FUSE / Fuse / @ConstructionYear

Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/FUSE/Fuse
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer"/>

[ top ]
Attribute GRID / FUSE / Fuse / @ExternalURL

Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/FUSE/Fuse
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI"/>

[ top ]
Attribute GRID / FUSE / Fuse / @HostBranchID

Annotations |
    ID of the branch that the fuse is connected to (required)
Type | StringID
Properties |
content | simple
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/FUSE/Fuse
Source |
    <xs:attribute name="HostBranchID" type="StringID">
      <xs:annotation>
        <xs:documentation>ID of the branch that the fuse is connected to (required)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / FUSE / Fuse / @BranchEnd

Annotations |
    The branch end that the fuse is connected to
Type | BranchEndEnum
Properties |
content | simple
Facets |
enumeration | Bus1 |
    The end of the branch where the bus1 is connected.
enumeration | Bus2 |
    The end of the branch where the bus2 is connected.
Used by |
Element | GRID/FUSE/Fuse
Source |
    <xs:attribute name="BranchEnd" type="BranchEndEnum">
      <xs:annotation>
        <xs:documentation>The branch end that the fuse is connected to</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / FUSE / Fuse / @FuseType

Type | FuseTypeEnum
Properties |
content | simple
Facets |
enumeration | Grid |
    A grid fuse protects a larger (usually public) part of the distribution grid from a short circuit.
    They are typically found in transformer stations and distribution cabinets.
    Grid fuses are dimensioned to withstand a higher current and melt slowler than a connection fuse, allowing connection fuses to melt first.
enumeration | Connection |
    A connection fuse protects an individual customer from a short circuit.
    They are installed where the customer is connected to the grid.
    Connection fuses are dimension to withstand a lower current and melt faster than grid fuses, preventing the grid fuses to disconnect a much larger part of the grid.
Used by |
Element | GRID/FUSE/Fuse
Source |
    <xs:attribute name="FuseType" type="FuseTypeEnum"/>

[ top ]
Attribute GRID / FUSE / Fuse / @LibraryFuseName

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/FUSE/Fuse
Source |
    <xs:attribute name="LibraryFuseName" type="xs:string"/>

[ top ]
Attribute GRID / SWITCH / Switch / @ID

Annotations |
    ID (see type StringID). Each Switch requires a unique ID among all Switches.
Type | StringID
Properties |
use | required
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/SWITCH/Switch
Source |
    <xs:attribute name="ID" type="StringID" use="required">
      <xs:annotation>
        <xs:documentation>ID (see type StringID). Each Switch requires a unique ID among all Switches.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / SWITCH / Switch / @Name

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/SWITCH/Switch
Source |
    <xs:attribute name="Name" type="xs:string"/>

[ top ]
Attribute GRID / SWITCH / Switch / @Description

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/SWITCH/Switch
Source |
    <xs:attribute name="Description" type="xs:string"/>

[ top ]
Attribute GRID / SWITCH / Switch / @Type

Type | SwitchTypeEnum
Properties |
content | simple
Facets |
enumeration | Circuit Breaker |
    A circuit breaker (Ger. 'Leitungsschutzschalter') is an automatically operated electrical
    switch designed to protect an electrical circuit from damage caused by excess current from an overload or short circuit.
    It can switch under load and has a mechanism to suppress electric arcs.
enumeration | Disconnect Switch |
    A disconnect switch (Ger. 'Trennschalter') is used to ensure that an electrical circuit is completely
    de-energized for service or maintenance. It connot switch under load.
enumeration | Load Switch |
    The switch is a load 2 (Ger. 'Lastschalter') is a switch designed to connect and disconnect devices under
    normal operating conditions. It has a mechanism to suppress electric arcs caused by normal operational currents (not fault currents).
Used by |
Element | GRID/SWITCH/Switch
Source |
    <xs:attribute name="Type" type="SwitchTypeEnum"/>

[ top ]
Attribute GRID / SWITCH / Switch / @BranchEnd

Type | BranchEndEnum
Properties |
content | simple
Facets |
enumeration | Bus1 |
    The end of the branch where the bus1 is connected.
enumeration | Bus2 |
    The end of the branch where the bus2 is connected.
Used by |
Element | GRID/SWITCH/Switch
Source |
    <xs:attribute name="BranchEnd" type="BranchEndEnum"/>

[ top ]
Attribute GRID / SWITCH / Switch / @HostBranchID

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/SWITCH/Switch
Source |
    <xs:attribute name="HostBranchID" type="xs:string"/>

[ top ]
Attribute GRID / SWITCH / Switch / @MaxAperiodicShortCircuitCurrentInKiloampere

Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/SWITCH/Switch
Source |
    <xs:attribute name="MaxAperiodicShortCircuitCurrentInKiloampere" type="xs:double"/>

[ top ]
Attribute GRID / SWITCH / Switch / @ConstructionYear

Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/SWITCH/Switch
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer"/>

[ top ]
Attribute GRID / SWITCH / Switch / @ExternalURL

Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/SWITCH/Switch
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI"/>

[ top ]
Attribute GRID / SWITCH / Switch / @LibraryRealibilityName

Annotations |
    Defines the used reliability model of Adaptricity's component library. The reliability model
    defines how long and how frequently the component is expected to fail.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/SWITCH/Switch
Source |
    <xs:attribute name="LibraryRealibilityName" type="xs:string">
      <xs:annotation>
        <xs:documentation>Defines the used reliability model of Adaptricity's component library. The reliability model defines how long and how frequently the component is expected to fail.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / SHAPE / Shape / @ID

Type | StringID
Properties |
use | required
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="ID" type="StringID" use="required"/>

[ top ]
Attribute GRID / SHAPE / Shape / @DisplayType

Type | DisplayTypeEnum
Properties |
use | required
Facets |
enumeration | Schematic |
enumeration | Map |
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="DisplayType" type="DisplayTypeEnum" use="required"/>

[ top ]
Attribute GRID / SHAPE / Shape / @Type

Type | FormTypeEnum
Properties |
use | required
Facets |
enumeration | Line |
enumeration | Arrow |
enumeration | Ellipse |
enumeration | Rectangle |
enumeration | Polygon |
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="Type" type="FormTypeEnum" use="required"/>

[ top ]
Attribute GRID / SHAPE / Shape / @x1

Annotations |
    The x-coordinate of the upper left corner of the shape
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="x1" type="xs:double">
      <xs:annotation>
        <xs:documentation>The x-coordinate of the upper left corner of the shape</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / SHAPE / Shape / @y1

Annotations |
    The y-coordinate of the upper left corner of the shape
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="y1" type="xs:double">
      <xs:annotation>
        <xs:documentation>The y-coordinate of the upper left corner of the shape</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / SHAPE / Shape / @x2

Annotations |
    The x-coordinate of the lower right corner of the shape
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="x2" type="xs:double">
      <xs:annotation>
        <xs:documentation>The x-coordinate of the lower right corner of the shape</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / SHAPE / Shape / @y2

Annotations |
    The y-coordinate of the lower right corner of the shape
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="y2" type="xs:double">
      <xs:annotation>
        <xs:documentation>The y-coordinate of the lower right corner of the shape</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / SHAPE / Shape / @Name

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="Name" type="xs:string"/>

[ top ]
Attribute GRID / SHAPE / Shape / @Description

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="Description" type="xs:string"/>

[ top ]
Attribute GRID / SHAPE / Shape / @Text

Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="Text" type="xs:string"/>

[ top ]
Attribute GRID / SHAPE / Shape / @TextStyle

Annotations |
    A bit mask of text styles.
    The following constants are OR-ed bitwise:
    - 1: italic
    - 2: bold
    - 4: underlined
    - 8: strikethrough
Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="TextStyle" type="xs:integer">
      <xs:annotation>
        <xs:documentation>A bit mask of text styles. The following constants are OR-ed bitwise: - 1: italic - 2: bold - 4: underlined - 8: strikethrough</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / SHAPE / Shape / @TextPosition

Type | TextPositionEnumType
Properties |
content | simple
Facets |
enumeration | TopLeft |
enumeration | TopCenter |
enumeration | TopRight |
enumeration | MiddleLeft |
enumeration | MiddleCenter |
enumeration | MiddleRight |
enumeration | BottomLeft |
enumeration | BottomCenter |
enumeration | BottomRight |
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="TextPosition" type="TextPositionEnumType"/>

[ top ]
Attribute GRID / SHAPE / Shape / @TextOrientation

Type | TextOrientationEnumType
Properties |
content | simple
Facets |
enumeration | Horizontal |
enumeration | Vertical |
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="TextOrientation" type="TextOrientationEnumType"/>

[ top ]
Attribute GRID / SHAPE / Shape / @FontSize

Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="FontSize" type="xs:integer"/>

[ top ]
Attribute GRID / SHAPE / Shape / @TextColor

Type | ColorType
Properties |
content | simple
Facets |
pattern | #[0-9a-fA-F]{8} |
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="TextColor" type="ColorType"/>

[ top ]
Attribute GRID / SHAPE / Shape / @OutlineColor

Type | ColorType
Properties |
content | simple
Facets |
pattern | #[0-9a-fA-F]{8} |
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="OutlineColor" type="ColorType"/>

[ top ]
Attribute GRID / SHAPE / Shape / @BackgroundColor

Type | ColorType
Properties |
content | simple
Facets |
pattern | #[0-9a-fA-F]{8} |
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="BackgroundColor" type="ColorType"/>

[ top ]
Attribute GRID / SHAPE / Shape / @OutlineWidth

Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="OutlineWidth" type="xs:integer"/>

[ top ]
Attribute GRID / @DPGXMLVersion

Annotations |
    Internal file version of the XML file
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID
Source |
    <xs:attribute name="DPGXMLVersion" type="xs:string">
      <xs:annotation>
        <xs:documentation>Internal file version of the XML file</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]