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

## Table of Contents

Main schema dpgsimgridschema_2.44.xsd

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

    ================== 1. Purpose of this XML Schema ==================

    This XML Schema Definition (XSD) specifies the node-branch data model that is required for electricity grid simulations within the Adaptricity platform. It serves as a basis for mapping the available data points at a grid operator to the attributes required by Adaptricity such that a data converter can be constructed. Besides that, a grid XML file can be validated against this XSD.

    ================== 2. 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), and connections. At a node (generally referred to as "bus" in the Adaptricity platform), further elements can be connected: Network feeder, load, or generator. Switches, line voltage regulators, and fuses are attached to a defined end of an existing branch element.

    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.

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

    A real grid area of a grid operator (e.g., the perimeter of a primary substation including low-voltage connections, or even a larger region) can be contained in one comprehensive grid model. Alternatively, it can be split into different grid models in order to speed up certain computation tasks (e.g., connection requests). The splitting can either be conducted automatically on a cyclic import via the Grid Data Integration (GDI) interface, or manually on any given grid model in the grid editor.

    ================== 4. 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. 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.

    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.

    ================== 5. 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 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} THREE-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} STATION{0,1} SHAPE{0,1})
Children | ASYMMETRIC_LINE, ASYMMETRIC_TRANSFORMER, BUSBAR_NODE, CONNECTION, FEEDER, FUSE, GENERATOR, LINE, LOAD, PROTECTIONDEVICE, SHAPE, SHUNT, STATION, SWITCH, THREE-W-TRANSFORMER, 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>
      <THREE-W-TRANSFORMER>{0,1}</THREE-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>
      <STATION>{0,1}</STATION>
      <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:annotation>
                          <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display in general - Adaptricity.Connect</xs:documentation>
                        </xs:annotation>
                      </xs:element>
                    </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. Hard requirement.</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. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Name" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Description" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ConstructionYear" type="xs:integer">
                      <xs:annotation>
                        <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ExternalURL" type="xs:anyURI">
                      <xs:annotation>
                        <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <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. No requirement.</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. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="BaseVoltageInKilovolt" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>The nominal voltage of the grid node (as defined by the voltage level). Required for: - All calculations</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="SelfTimeInSeconds" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>Time required to deenergize underlying transformer station in case of fault. Required for: - Protection calculation (only for certain setups; not necessarily required)</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="StationID" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>The ID of the station, if this bus belongs to a station. No requirement.</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. Required for: - Display in schematic view (ony for customer specific schematic visualization; default schematic coordinates are calculated from geo-coordinates)</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. Required for: - Display in schematic view (ony for customer specific schematic visualization; default schematic coordinates are calculated from geo-coordinates)</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</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:annotation>
                            <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display in general - Adaptricity.Connect</xs:documentation>
                          </xs:annotation>
                        </xs:element>
                      </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). Hard requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Name" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Description" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ConstructionYear" type="xs:integer">
                        <xs:annotation>
                          <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ExternalURL" type="xs:anyURI">
                        <xs:annotation>
                          <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ResistanceInOhmPerKilometer" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Can be fetched from the Component Library if resistance and reactance values are not given in the xml. Required for: - All calculations</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ReactanceInOhmPerKilometer" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Can be fetched from the Component Library if resistance and reactance values are not given in the xml. Required for: - All calculations</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ZeroSequenceResistanceInOhmPerKilometer" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor. Required for: - Short circuit calculations involving ground faults (but it will be derived from positive sequence impedance if missing)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ZeroSequenceReactanceInOhmPerKilometer" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor. Required for: - Short circuit calculations involving ground faults (but it will be derived from positive sequence impedance if missing)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="MaximumCurrentInAmpere" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Maximum rated current of the line in Ampere, used to calculate the loading. Can be fetched from the Component Library if the value is not given in the xml. Required for: - All calculations (calculations can be carried out without it but the line loading cannot be determined)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ShortCircuitStabilityThreePhaseInKiloampere" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Parameter denoting the maximal three phase aperiodic short circuit current the line can withstand. Required for: - Short circuit calculations of maximal three phase aperiodic short circuits (but it will be derived from other parameters if missing)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ShuntCapacitanceInMicrofaradPerKilometer" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Shunt capacitance of the line in Microfarad per kilometer, used for calculating the shunt admittances. Can be fetched from the Component Library if the value is not given in the xml. Required for: - Power flow based functionalities (makes it more accurate but is not strictly necessary)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="LengthInKilometer" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Length of the line in kilometers, used for computing the absolute line parameters. Required for: - All calculations</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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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. Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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. Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Bus1ID" type="StringID">
                        <xs:annotation>
                          <xs:documentation>ID of bus 1 that the line is connected to. Required for: - All calculations</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Bus2ID" type="StringID">
                        <xs:annotation>
                          <xs:documentation>ID of bus 2 that the line is connected to. Required for: - All calculations</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
                        <xs:annotation>
                          <xs:documentation>Denotes whether the line is electrically connected at Bus 1. true if the switch is closed (connected) at bus 1, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
                        <xs:annotation>
                          <xs:documentation>Denotes whether the line is electrically connected at Bus 2. true if the switch is closed (connected) at bus 2, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</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. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</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:annotation>
                            <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display in general - Adaptricity.Connect</xs:documentation>
                          </xs:annotation>
                        </xs:element>
                      </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). Hard requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Name" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Description" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ConstructionYear" type="xs:integer">
                        <xs:annotation>
                          <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ExternalURL" type="xs:anyURI">
                        <xs:annotation>
                          <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ResistanceInMilliOhm" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Resistance in mΩ. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided, the connection has a minimal resistance of 0.01 mΩ (for numerical reasons). Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ReactanceInMilliOhm" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Reactance in mΩ. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided, the connection has a minimal resistance of 0.01 mΩ (for numerical reasons). Required for: - All calculations ((calculations are run with the default value if missing)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Bus1ID" type="StringID">
                        <xs:annotation>
                          <xs:documentation>ID of bus 1 that the connection element it is connected to. Required for: - All calculations</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Bus2ID" type="StringID">
                        <xs:annotation>
                          <xs:documentation>ID of bus 2 that the connection element it is connected to. Required for: - All calculations</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
                        <xs:annotation>
                          <xs:documentation>true if the switch is closed (connected) at bus 1, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
                        <xs:annotation>
                          <xs:documentation>true if the switch is closed (connected) at bus 2, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</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. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</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:annotation>
              <xs:documentation>Voltage regulators can be created and attached to lines in radial parts of the grid. During a simulation they behave similarly to tap changing transformers and will have an effect on the power flow both in static and time-series based simulations.</xs:documentation>
            </xs:annotation>
            <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. Hard requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Name" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Description" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ConstructionYear" type="xs:integer">
                        <xs:annotation>
                          <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ExternalURL" type="xs:anyURI">
                        <xs:annotation>
                          <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="HostLineID" type="StringID">
                        <xs:annotation>
                          <xs:documentation>ID of the line that the voltage regulator is installed at. Required for: - All calculations</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="NumTaps" type="xs:integer">
                        <xs:annotation>
                          <xs:documentation>Number of taps of the transformer (both upward and downward). Required for: - All calculations</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="TapSizeFractionInPercent" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Size of each tap in terms of voltage change. Required for: - All calculations</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="DeadBandFractionInPercent" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Dead-band of the hysteresis controller that switches the taps. Required for: - All calculations</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="SetpointInPerUnit" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>This defines the desired voltage in per unit at the measured bus. Required for: - All calculations</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:annotation>
              <xs:documentation>Not supported yet.</xs:documentation>
            </xs:annotation>
          </xs:element>
          <xs:element name="ASYMMETRIC_TRANSFORMER" minOccurs="0" maxOccurs="1">
            <xs:annotation>
              <xs:documentation>Not supported yet.</xs:documentation>
            </xs:annotation>
          </xs:element>
          <xs:element name="THREE-W-TRANSFORMER" minOccurs="0" maxOccurs="1">
            <xs:annotation>
              <xs:documentation>Not supported yet.</xs:documentation>
            </xs:annotation>
          </xs:element>
          <xs:element name="SHUNT" minOccurs="0" maxOccurs="1">
            <xs:annotation>
              <xs:documentation>Not supported yet.</xs:documentation>
            </xs:annotation>
          </xs:element>
          <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:annotation>
                          <xs:documentation>Defines the characteristics of the reactive power of the load. Required for: - Static power flow based functionalities if the load features a special reactive power characteristic</xs:documentation>
                        </xs:annotation>
                      </xs:element>
                    </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. Hard requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Name" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Description" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>A human-readable description No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ConstructionYear" type="xs:integer">
                      <xs:annotation>
                        <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ExternalURL" type="xs:anyURI">
                      <xs:annotation>
                        <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="LoadCategory" type="LoadCategoryEnum">
                      <xs:annotation>
                        <xs:documentation>Denotes the allowed load categories. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ActiveLoadInMegawatt" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>Active power in MW that the load consumes from the grid (should normally be positive). Required for: - All calculations</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Bus1ID" type="StringID">
                      <xs:annotation>
                        <xs:documentation>ID of the Bus that the load is connected to. Required for: - All calculations</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Connected" type="xs:boolean">
                      <xs:annotation>
                        <xs:documentation>Denotes whether the load is electrically connected. true if the switch is closed (connected), false if the switch is open (not connected). Defaults to true. Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ConnectionRequestID" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration. No requirement.</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:annotation>
                          <xs:documentation>Defines the characteristics of the reactive power generation of the generator. Required for: - Static power flow based functionalities (if the generator features a special reactive power characteristic)</xs:documentation>
                        </xs:annotation>
                      </xs:element>
                    </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. Hard requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Name" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Description" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ConstructionYear" type="xs:integer">
                      <xs:annotation>
                        <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ExternalURL" type="xs:anyURI">
                      <xs:annotation>
                        <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="GenerationCategory" type="GenerationCategoryEnum">
                      <xs:annotation>
                        <xs:documentation>Denotes the allowed categories of generation devices. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ConnectionType" type="GenerationConnectionEnum">
                      <xs:annotation>
                        <xs:documentation>Denotes the type of the connection to the grid. Required for: - Short circuit calculations (makes them more accurate)</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ActiveGenerationInMegawatt" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>Active power in MW that the generator injects into the grid (should normally be positive). Required for: - All calculations</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="MinReactiveGenerationInMegavar" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>Currently not supported. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="MaxReactiveGenerationInMegavar" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>Currently not supported. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="MinActiveGenerationInMegawatt" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>Currently not supported. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="MaxActiveGenerationInMegawatt" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>Currently not supported. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="VoltageSetpointInKilovolt" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>Currently not supported. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Bus1ID" type="StringID">
                      <xs:annotation>
                        <xs:documentation>ID of Bus that the generator is connected to. Required for: - All calculations</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Connected" type="xs:boolean">
                      <xs:annotation>
                        <xs:documentation>Denotes whether the generator is electrically connected. true if the switch is closed (connected), false if the switch is open (not connected). Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ConnectionRequestID" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</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:annotation>
                            <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display</xs:documentation>
                          </xs:annotation>
                        </xs:element>
                      </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). Hard requirement.</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). Required for: - All calculations if the transformer is tap-changing</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Name" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Description" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <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. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ConstructionYear" type="xs:integer">
                        <xs:annotation>
                          <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ExternalURL" type="xs:anyURI">
                        <xs:annotation>
                          <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="VectorGroup" type="xs:string">
                        <xs:annotation>
                          <xs:documentation>Vector group (Schaltgruppe) of transformer, e.g. Dyn5. Required for: - Short circuit calculations</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. Required for: - Short circuit calculations in case transformer vector group has a star point</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. Required for: - Short circuit calculations if transformer grounding type is 'Resonant grounding'</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="TransformerRatingInMegavoltampere" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml. Required for: - All calculations</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="MaximumApparentPowerInMegavoltampere" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Maximum allowed apparent power. Usually the same as the transformer rating. Can be fetched from the Component Library. Required for: - All calculations</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ShortCircuitVoltageInPercent" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml. Required for: - All calculations</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="CopperLossesInPercent" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml. Required for: - All calculations</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. Used for calculation of the turns ratio. Required for: - All calculations (defaults to the value of the bus voltage if missing)</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. Used for calculation of the turns ratio. Required for: - All calculations (defaults to the value of the bus voltage if missing)</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. Required for: - All calculations if transformer is tap changing</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. Required for: - All calculations if transformer is tap changing</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 (%). Required for: - All calculations if transformer is tap changing</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 of the hysteresis controller in percent (%). Required for: - All calculations if transformer is tap changing</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. Required for: - All calculations if transformer is tap changing</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) Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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) Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Bus1ID" type="StringID">
                        <xs:annotation>
                          <xs:documentation>ID of bus 1 that the transformer is connected to. Required for: - All calculations</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="Bus2ID" type="StringID">
                        <xs:annotation>
                          <xs:documentation>ID of bus 2 that the transformer is connected to. Required for: - All calculations</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
                        <xs:annotation>
                          <xs:documentation>Denotes whether the transformer is electrically connected. true if the switch is closed (connected) at bus 1, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
                        <xs:annotation>
                          <xs:documentation>Denotes whether the transformer is electrically connected. true if the switch is closed (connected) at bus 2, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</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. No requirement.</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</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:annotation>
              <xs:documentation>Network feeder. Currently only one network feeder per grid is supported (single slack bus).</xs:documentation>
            </xs:annotation>
            <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). Hard requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Name" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="HostBusID" type="StringID">
                      <xs:annotation>
                        <xs:documentation>Bus ID of the bus that the network feeder is attached to. Becomes the slack bus of the power flow model. Required for: - All calculations</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Description" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>A human-readable documentation No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ConstructionYear" type="xs:integer">
                      <xs:annotation>
                        <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ExternalURL" type="xs:anyURI">
                      <xs:annotation>
                        <xs:documentation>URL that is displayed in our system. Can be used for switching to another system. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="OperationalVoltageInPerUnit" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>Sets the voltage of the slack bus and consequently influences the power flow behavior of the entire grid. Required for: - All calculations</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="OperationalAngleInRadians" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>Can be set to arbitrary value (e.g. zero) since only the angle differences within the grid matter for the power flow. Required for: - All calculations</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="VoltageFactorMax" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>Denotes the voltage multiplier for computation of maximum short-circuit currents according to IEC 60909. Not supported yet (currently, a default value of 1 is used). No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="VoltageFactorMin" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>Denotes the voltage multiplier for computation of minimum short-circuit currents according to IEC 60909. Not supported yet (currently, a default value of 1 is used). No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="MaxSourceShortCircuitPowerInMegavoltampere" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>Denotes the maximum short-circuit power of the overlying grid according to IEC 60909. Required for: - Short circuit calculations</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="MinSourceShortCircuitPowerInMegavoltampere" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>Denotes the minimum short-circuit power of the overlying grid according to IEC 60909. Required for: - Short circuit calculations</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ReactanceToResistanceRatio" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>Denotes the X/R ratio of the overlying grid. Required for: - Short circuit calculations</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Connected" type="xs:boolean">
                      <xs:annotation>
                        <xs:documentation>Denotes whether the network feeder is electrically connected. true if the switch is closed (connected) at the host bus, false if the switch is open (not connected). Required for: - All calculations (calculations are run with the default value of 'true' if missing)</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. Hard requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Name" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Description" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ConstructionYear" type="xs:integer">
                      <xs:annotation>
                        <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ExternalURL" type="xs:anyURI">
                      <xs:annotation>
                        <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="HostBranchID" type="StringID">
                      <xs:annotation>
                        <xs:documentation>ID of the branch that the fuse is connected to (required). Required for: - All calculations</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 (Bus1 or Bus2). Default value is 'Bus1'. Required for: - All calculations</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="FuseType" type="FuseTypeEnum">
                      <xs:annotation>
                        <xs:documentation>Denoting the type of fuse. Possible entries: Grid (installed in the distribution grid), Connection (installed at a connection point, e.g. house) Required for: - Protection calculations</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="LibraryFuseName" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>Unique name that identifies the fuse in the component library. Required for: - Component library matching</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                  </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. Hard requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Name" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Description" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Type" type="SwitchTypeEnum">
                      <xs:annotation>
                        <xs:documentation>Type of the switch. Required for: - All calculations</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="BranchEnd" type="BranchEndEnum">
                      <xs:annotation>
                        <xs:documentation>Specificaties if the switch is placed at bus1 or bus2 of its host edge: “Bus1”, “Bus2”. Required for: - All calculations</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="HostBranchID" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>ID of the branch, which the switch is allocated to. Required for: - All calculations</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="MaxAperiodicShortCircuitCurrentInKiloampere" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>No requirement. Optional for: - Protection calculation</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ConstructionYear" type="xs:integer">
                      <xs:annotation>
                        <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ExternalURL" type="xs:anyURI">
                      <xs:annotation>
                        <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                  </xs:complexType>
                </xs:element>
              </xs:sequence>
            </xs:complexType>
          </xs:element>
          <xs:element name="STATION" minOccurs="0" maxOccurs="1">
            <xs:complexType>
              <xs:sequence>
                <xs:element name="Station" minOccurs="0" maxOccurs="unbounded">
                  <xs:complexType>
                    <xs:all>
                      <xs:element name="GIS" type="GISType" maxOccurs="1" minOccurs="0">
                        <xs:annotation>
                          <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display</xs:documentation>
                        </xs:annotation>
                      </xs:element>
                    </xs:all>
                    <xs:attribute name="ID" type="StringID" use="required">
                      <xs:annotation>
                        <xs:documentation>ID (see type StringID). Each station requires a unique ID among all stations. Hard requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Name" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Description" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ConstructionYear" type="xs:integer">
                      <xs:annotation>
                        <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="ExternalURL" type="xs:anyURI">
                      <xs:annotation>
                        <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Type" type="StationTypeEnum">
                      <xs:annotation>
                        <xs:documentation>Denotes the type of station and shall be either TransformerStation, DistributionCabinet, Substation, or Other. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="x" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>x-coordinate of the station to display in the schematic view. Required for: - Display in schematic view</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="y" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>y-coordinate of the station to display in the schematic view. Required for: - Display in schematic view</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:annotation>
                          <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display</xs:documentation>
                        </xs:annotation>
                      </xs:element>
                    </xs:all>
                    <xs:attribute name="ID" type="StringID" use="required">
                      <xs:annotation>
                        <xs:documentation>A string ID, unique within the grid model. Hard requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="DisplayType" type="DisplayTypeEnum" use="required">
                      <xs:annotation>
                        <xs:documentation>Definition whether the shape is dispayed on the schematic or on the map view: “Schematic”, “Map”. Hard requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Type" type="FormTypeEnum" use="required">
                      <xs:annotation>
                        <xs:documentation>Type of the geometry. Possible types are: “Line”, “Arrow”, “Ellipse”, “Rectangle”, “Polygon” Hard requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="x1" type="xs:double">
                      <xs:annotation>
                        <xs:documentation>The x-coordinate of the upper left corner of the shape. Required for: - Schematic display</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. Required for: - Schematic display</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. Required for: - Schematic display</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. Required for: - Schematic display</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Name" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Description" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="Text" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>Text to be shown within the shape. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <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 No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="TextPosition" type="TextPositionEnumType">
                      <xs:annotation>
                        <xs:documentation>Position, where text is displayed within the shape. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="TextOrientation" type="TextOrientationEnumType">
                      <xs:annotation>
                        <xs:documentation>Orientation of the text. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="FontSize" type="xs:integer">
                      <xs:annotation>
                        <xs:documentation>Font size of the text. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="TextColor" type="ColorType">
                      <xs:annotation>
                        <xs:documentation>Color of the text. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="OutlineColor" type="ColorType">
                      <xs:annotation>
                        <xs:documentation>Color of the shape outline. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="BackgroundColor" type="ColorType">
                      <xs:annotation>
                        <xs:documentation>Background color of the shape. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="OutlineWidth" type="xs:integer">
                      <xs:annotation>
                        <xs:documentation>Width of the shape outline. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                    <xs:attribute name="StationID" type="xs:string">
                      <xs:annotation>
                        <xs:documentation>The ID of the station, if this shape belongs to a station. No requirement.</xs:documentation>
                      </xs:annotation>
                    </xs:attribute>
                  </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="" LibraryReliabilityName="" Name="" SelfTimeInSeconds="" StationID="" 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:annotation>
                    <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display in general - Adaptricity.Connect</xs:documentation>
                  </xs:annotation>
                </xs:element>
              </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. Hard requirement.</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. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Name" type="xs:string">
                <xs:annotation>
                  <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Description" type="xs:string">
                <xs:annotation>
                  <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ConstructionYear" type="xs:integer">
                <xs:annotation>
                  <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ExternalURL" type="xs:anyURI">
                <xs:annotation>
                  <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <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. No requirement.</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. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="BaseVoltageInKilovolt" type="xs:double">
                <xs:annotation>
                  <xs:documentation>The nominal voltage of the grid node (as defined by the voltage level). Required for: - All calculations</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="SelfTimeInSeconds" type="xs:double">
                <xs:annotation>
                  <xs:documentation>Time required to deenergize underlying transformer station in case of fault. Required for: - Protection calculation (only for certain setups; not necessarily required)</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="StationID" type="xs:string">
                <xs:annotation>
                  <xs:documentation>The ID of the station, if this bus belongs to a station. No requirement.</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. Required for: - Display in schematic view (ony for customer specific schematic visualization; default schematic coordinates are calculated from geo-coordinates)</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. Required for: - Display in schematic view (ony for customer specific schematic visualization; default schematic coordinates are calculated from geo-coordinates)</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</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="" LibraryReliabilityName="" Name="" SelfTimeInSeconds="" StationID="" Type="" x="" y="">
      <GIS ShapeType="">{0,1}</GIS>
    </Node>
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
BaseVoltageInKilovolt | xs:double | optional |
    The nominal voltage of the grid node (as defined by the voltage level).

    Required for:
    	- All calculations
ConstructionYear | xs:integer | optional |
    The year that the component was built in the field. Only used for information purposes.

    No requirement.
CustomersToBusMatchingID | xs:string | optional |
    Customer-specific ID to match data (e.g., smartmeter data) to the bus.

    No requirement.
Description | xs:string | optional |
    A human-readable description.

    No requirement.
ExternalURL | xs:anyURI | optional |
    URL that is displayed in our system. Can be used for switching to an external system.

    No requirement.
ID | StringID | required |
    ID (see type StringID). Each Node requires a unique ID among all Nodes.

    Hard requirement.
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.

    No requirement.
LibraryReliabilityName | 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.

    Required for:
    	- Reliability calculations
Name | xs:string | optional |
    A human-readable name.

    No requirement.
SelfTimeInSeconds | xs:double | optional |
    Time required to deenergize underlying transformer station in case of fault.

    Required for:
    	- Protection calculation (only for certain setups; not necessarily required)
StationID | xs:string | optional |
    The ID of the station, if this bus belongs to a station.

    No requirement.
Type | BusTypeEnum | optional |
    Denotes the type of the grid node and shall be either TransformerStation, DistributionCabinet, CableJunction, BusBar, ConnectionPoint, SmallConnectionPoint, or Other.

    No requirement.
x | xs:double | optional |
    x-coordinate of the bus to display in the schematic view.

    Required for:
    	- Display in schematic view (ony for customer specific schematic visualization; default schematic coordinates are calculated from geo-coordinates)
y | xs:double | optional |
    y-coordinate of the bus to display in the schematic view.

    Required for:
    	- Display in schematic view (ony for customer specific schematic visualization; default schematic coordinates are calculated from geo-coordinates)
Source |
    <xs:element name="Node" minOccurs="0" maxOccurs="unbounded">
      <xs:complexType>
        <xs:all>
          <xs:element name="GIS" type="GISType" maxOccurs="1" minOccurs="0">
            <xs:annotation>
              <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display in general - Adaptricity.Connect</xs:documentation>
            </xs:annotation>
          </xs:element>
        </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. Hard requirement.</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. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable name. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Description" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable description. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConstructionYear" type="xs:integer">
          <xs:annotation>
            <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ExternalURL" type="xs:anyURI">
          <xs:annotation>
            <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <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. No requirement.</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. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="BaseVoltageInKilovolt" type="xs:double">
          <xs:annotation>
            <xs:documentation>The nominal voltage of the grid node (as defined by the voltage level). Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="SelfTimeInSeconds" type="xs:double">
          <xs:annotation>
            <xs:documentation>Time required to deenergize underlying transformer station in case of fault. Required for: - Protection calculation (only for certain setups; not necessarily required)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="StationID" type="xs:string">
          <xs:annotation>
            <xs:documentation>The ID of the station, if this bus belongs to a station. No requirement.</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. Required for: - Display in schematic view (ony for customer specific schematic visualization; default schematic coordinates are calculated from geo-coordinates)</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. Required for: - Display in schematic view (ony for customer specific schematic visualization; default schematic coordinates are calculated from geo-coordinates)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / BUSBAR_NODE / Node / GIS

Annotations |
    Defines the GIS information (geometry and coordinates).

    Required for:
    	- Geographical display in general
    	- Adaptricity.Connect
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">
      <xs:annotation>
        <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display in general - Adaptricity.Connect</xs:documentation>
      </xs:annotation>
    </xs:element>

[ 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 / 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="" LibraryReliabilityName="" 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:annotation>
                      <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display in general - Adaptricity.Connect</xs:documentation>
                    </xs:annotation>
                  </xs:element>
                </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). Hard requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Name" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Description" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ConstructionYear" type="xs:integer">
                  <xs:annotation>
                    <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ExternalURL" type="xs:anyURI">
                  <xs:annotation>
                    <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ResistanceInOhmPerKilometer" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Can be fetched from the Component Library if resistance and reactance values are not given in the xml. Required for: - All calculations</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ReactanceInOhmPerKilometer" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Can be fetched from the Component Library if resistance and reactance values are not given in the xml. Required for: - All calculations</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ZeroSequenceResistanceInOhmPerKilometer" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor. Required for: - Short circuit calculations involving ground faults (but it will be derived from positive sequence impedance if missing)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ZeroSequenceReactanceInOhmPerKilometer" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor. Required for: - Short circuit calculations involving ground faults (but it will be derived from positive sequence impedance if missing)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="MaximumCurrentInAmpere" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Maximum rated current of the line in Ampere, used to calculate the loading. Can be fetched from the Component Library if the value is not given in the xml. Required for: - All calculations (calculations can be carried out without it but the line loading cannot be determined)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ShortCircuitStabilityThreePhaseInKiloampere" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Parameter denoting the maximal three phase aperiodic short circuit current the line can withstand. Required for: - Short circuit calculations of maximal three phase aperiodic short circuits (but it will be derived from other parameters if missing)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ShuntCapacitanceInMicrofaradPerKilometer" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Shunt capacitance of the line in Microfarad per kilometer, used for calculating the shunt admittances. Can be fetched from the Component Library if the value is not given in the xml. Required for: - Power flow based functionalities (makes it more accurate but is not strictly necessary)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="LengthInKilometer" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Length of the line in kilometers, used for computing the absolute line parameters. Required for: - All calculations</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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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. Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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. Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Bus1ID" type="StringID">
                  <xs:annotation>
                    <xs:documentation>ID of bus 1 that the line is connected to. Required for: - All calculations</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Bus2ID" type="StringID">
                  <xs:annotation>
                    <xs:documentation>ID of bus 2 that the line is connected to. Required for: - All calculations</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
                  <xs:annotation>
                    <xs:documentation>Denotes whether the line is electrically connected at Bus 1. true if the switch is closed (connected) at bus 1, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
                  <xs:annotation>
                    <xs:documentation>Denotes whether the line is electrically connected at Bus 2. true if the switch is closed (connected) at bus 2, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</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. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</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="" LibraryReliabilityName="" 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 the line is connected to.

    Required for:
    	- All calculations
Bus2ID | StringID | optional |
    ID of bus 2 that the line is connected to.

    Required for:
    	- All calculations
ConnectedAtBus1 | xs:boolean | optional |
    Denotes whether the line is electrically connected at Bus 1.
    true if the switch is closed (connected) at
    bus 1, false if the switch is open (not connected).
    Default value is true.

    Required for:
    	- All calculations (calculations are run with the default value if missing)
ConnectedAtBus2 | xs:boolean | optional |
    Denotes whether the line is electrically connected at Bus 2.
    true if the switch is closed (connected) at
    bus 2, false if the switch is open (not connected).
    Default value is true.

    Required for:
    	- All calculations (calculations are run with the default value if missing)
ConstructionYear | xs:integer | optional |
    The year that the component was built in the field. Only used for information purposes.

    No requirement.
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.

    Required for:
    	- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
Description | xs:string | optional |
    A human-readable description.

    No requirement.
ExternalURL | xs:anyURI | optional |
    URL that is displayed in our system. Can be used for switching to an external system.

    No requirement.
ID | StringID | required |
    ID (see type StringID). Each Line requires a unique ID among all branch types (Line, Connection, Transformer).

    Hard requirement.
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).

    Required for:
    	- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
LengthInKilometer | xs:double | optional |
    Length of the line in kilometers, used for computing the absolute line parameters.

    Required for:
    	- All calculations
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).

    													Required for:
    														- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
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.

    Required for:
    	- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
LibraryReliabilityName | 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.

    Required for:
    	- Reliability calculations
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).

    Required for:
    	- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
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).

    Required for:
    	- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
MaximumCurrentInAmpere | xs:double | optional |
    Maximum rated current of the line in Ampere, used to calculate the loading.
    Can be fetched from the Component Library if the value is not given in the xml.

    Required for:
    	- All calculations (calculations can be carried out without it but the line loading cannot be determined)
Name | xs:string | optional |
    A human-readable name.

    No requirement.
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.

    No requirement.
ReactanceInOhmPerKilometer | xs:double | optional |
    Can be fetched from the Component Library if resistance and reactance values are not given in the xml.

    Required for:
    	- All calculations
ResistanceInOhmPerKilometer | xs:double | optional |
    Can be fetched from the Component Library if resistance and reactance values are not given in the xml.

    Required for:
    	- All calculations
ShortCircuitStabilityThreePhaseInKiloampere | xs:double | optional |
    Parameter denoting the maximal three phase aperiodic short circuit current the line can withstand.

    Required for:
    	- Short circuit calculations of maximal three phase aperiodic short circuits (but it will be derived from other parameters if missing)
ShuntCapacitanceInMicrofaradPerKilometer | xs:double | optional |
    Shunt capacitance of the line in Microfarad per kilometer, used for calculating the shunt admittances.
    Can be fetched from the Component Library if the value is not given in the xml.

    Required for:
    	- Power flow based functionalities (makes it more accurate but is not strictly necessary)
ZeroSequenceReactanceInOhmPerKilometer | xs:double | optional |
    If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor.

    Required for:
    	- Short circuit calculations involving ground faults (but it will be derived from positive sequence impedance if missing)
ZeroSequenceResistanceInOhmPerKilometer | xs:double | optional |
    If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor.

    Required for:
    	- Short circuit calculations involving ground faults (but it will be derived from positive sequence impedance if missing)
Source |
    <xs:element name="Line" minOccurs="0" maxOccurs="unbounded">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="GIS" type="GISType" minOccurs="0" maxOccurs="1">
            <xs:annotation>
              <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display in general - Adaptricity.Connect</xs:documentation>
            </xs:annotation>
          </xs:element>
        </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). Hard requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable name. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Description" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable description. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConstructionYear" type="xs:integer">
          <xs:annotation>
            <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ExternalURL" type="xs:anyURI">
          <xs:annotation>
            <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ResistanceInOhmPerKilometer" type="xs:double">
          <xs:annotation>
            <xs:documentation>Can be fetched from the Component Library if resistance and reactance values are not given in the xml. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ReactanceInOhmPerKilometer" type="xs:double">
          <xs:annotation>
            <xs:documentation>Can be fetched from the Component Library if resistance and reactance values are not given in the xml. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ZeroSequenceResistanceInOhmPerKilometer" type="xs:double">
          <xs:annotation>
            <xs:documentation>If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor. Required for: - Short circuit calculations involving ground faults (but it will be derived from positive sequence impedance if missing)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ZeroSequenceReactanceInOhmPerKilometer" type="xs:double">
          <xs:annotation>
            <xs:documentation>If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor. Required for: - Short circuit calculations involving ground faults (but it will be derived from positive sequence impedance if missing)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="MaximumCurrentInAmpere" type="xs:double">
          <xs:annotation>
            <xs:documentation>Maximum rated current of the line in Ampere, used to calculate the loading. Can be fetched from the Component Library if the value is not given in the xml. Required for: - All calculations (calculations can be carried out without it but the line loading cannot be determined)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ShortCircuitStabilityThreePhaseInKiloampere" type="xs:double">
          <xs:annotation>
            <xs:documentation>Parameter denoting the maximal three phase aperiodic short circuit current the line can withstand. Required for: - Short circuit calculations of maximal three phase aperiodic short circuits (but it will be derived from other parameters if missing)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ShuntCapacitanceInMicrofaradPerKilometer" type="xs:double">
          <xs:annotation>
            <xs:documentation>Shunt capacitance of the line in Microfarad per kilometer, used for calculating the shunt admittances. Can be fetched from the Component Library if the value is not given in the xml. Required for: - Power flow based functionalities (makes it more accurate but is not strictly necessary)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="LengthInKilometer" type="xs:double">
          <xs:annotation>
            <xs:documentation>Length of the line in kilometers, used for computing the absolute line parameters. Required for: - All calculations</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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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. Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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. Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Bus1ID" type="StringID">
          <xs:annotation>
            <xs:documentation>ID of bus 1 that the line is connected to. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Bus2ID" type="StringID">
          <xs:annotation>
            <xs:documentation>ID of bus 2 that the line is connected to. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>Denotes whether the line is electrically connected at Bus 1. true if the switch is closed (connected) at bus 1, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>Denotes whether the line is electrically connected at Bus 2. true if the switch is closed (connected) at bus 2, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</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. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / LINE / Line / GIS

Annotations |
    Defines the GIS information (geometry and coordinates).

    Required for:
    	- Geographical display in general
    	- Adaptricity.Connect
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">
      <xs:annotation>
        <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display in general - Adaptricity.Connect</xs:documentation>
      </xs:annotation>
    </xs:element>

[ 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="" LibraryReliabilityName="" 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:annotation>
                      <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display in general - Adaptricity.Connect</xs:documentation>
                    </xs:annotation>
                  </xs:element>
                </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). Hard requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Name" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Description" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ConstructionYear" type="xs:integer">
                  <xs:annotation>
                    <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ExternalURL" type="xs:anyURI">
                  <xs:annotation>
                    <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ResistanceInMilliOhm" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Resistance in mΩ. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided, the connection has a minimal resistance of 0.01 mΩ (for numerical reasons). Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ReactanceInMilliOhm" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Reactance in mΩ. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided, the connection has a minimal resistance of 0.01 mΩ (for numerical reasons). Required for: - All calculations ((calculations are run with the default value if missing)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Bus1ID" type="StringID">
                  <xs:annotation>
                    <xs:documentation>ID of bus 1 that the connection element it is connected to. Required for: - All calculations</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Bus2ID" type="StringID">
                  <xs:annotation>
                    <xs:documentation>ID of bus 2 that the connection element it is connected to. Required for: - All calculations</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
                  <xs:annotation>
                    <xs:documentation>true if the switch is closed (connected) at bus 1, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
                  <xs:annotation>
                    <xs:documentation>true if the switch is closed (connected) at bus 2, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</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. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</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="" LibraryReliabilityName="" Name="" Owner="" ReactanceInMilliOhm="" ResistanceInMilliOhm="">
      <GIS ShapeType="">{0,1}</GIS>
    </Connection>
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
Bus1ID | StringID | optional |
    ID of bus 1 that the connection element it is connected to.

    Required for:
    		- All calculations
Bus2ID | StringID | optional |
    ID of bus 2 that the connection element it is connected to.

    Required for:
    		- All calculations
ConnectedAtBus1 | xs:boolean | optional |
    true if the switch is closed (connected) at
    bus 1, false if the switch is open (not connected). Default value is true.

    Required for:
    	- All calculations (calculations are run with the default value if missing)
ConnectedAtBus2 | xs:boolean | optional |
    true if the switch is closed (connected) at
    bus 2, false if the switch is open (not connected). Default value is true.

    Required for:
    	- All calculations (calculations are run with the default value if missing)
ConstructionYear | xs:integer | optional |
    The year that the component was built in the field.
    Only used for information purposes.

    No requirement.
Description | xs:string | optional |
    A human-readable description.

    No requirement.
ExternalURL | xs:anyURI | optional |
    URL that is displayed in our system.
    Can be used for switching to an external system.

    No requirement.
ID | StringID | required |
    ID (see type StringID). Each Line requires a unique ID among all branch types (Line, Connection, Transformer).

    Hard requirement.
LibraryReliabilityName | 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.

    Required for:
    	- Reliability calculations
Name | xs:string | optional |
    A human-readable name.

    No requirement.
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.

    No requirement.
ReactanceInMilliOhm | xs:double | optional |
    Reactance in mΩ. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided,
    	the connection has a minimal resistance of 0.01 mΩ (for numerical reasons).

    Required for:
    		- All calculations ((calculations are run with the default value if missing)
ResistanceInMilliOhm | xs:double | optional |
    Resistance in mΩ. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided,
    the connection has a minimal resistance of 0.01 mΩ (for numerical reasons).

    Required for:
    	- All calculations (calculations are run with the default value if missing)
Source |
    <xs:element name="Connection" minOccurs="0" maxOccurs="unbounded">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="GIS" type="GISType" minOccurs="0" maxOccurs="1">
            <xs:annotation>
              <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display in general - Adaptricity.Connect</xs:documentation>
            </xs:annotation>
          </xs:element>
        </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). Hard requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable name. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Description" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable description. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConstructionYear" type="xs:integer">
          <xs:annotation>
            <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ExternalURL" type="xs:anyURI">
          <xs:annotation>
            <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ResistanceInMilliOhm" type="xs:double">
          <xs:annotation>
            <xs:documentation>Resistance in mΩ. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided, the connection has a minimal resistance of 0.01 mΩ (for numerical reasons). Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ReactanceInMilliOhm" type="xs:double">
          <xs:annotation>
            <xs:documentation>Reactance in mΩ. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided, the connection has a minimal resistance of 0.01 mΩ (for numerical reasons). Required for: - All calculations ((calculations are run with the default value if missing)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Bus1ID" type="StringID">
          <xs:annotation>
            <xs:documentation>ID of bus 1 that the connection element it is connected to. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Bus2ID" type="StringID">
          <xs:annotation>
            <xs:documentation>ID of bus 2 that the connection element it is connected to. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>true if the switch is closed (connected) at bus 1, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>true if the switch is closed (connected) at bus 2, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</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. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / CONNECTION / Connection / GIS

Annotations |
    Defines the GIS information (geometry and coordinates).

    Required for:
    	- Geographical display in general
    	- Adaptricity.Connect
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">
      <xs:annotation>
        <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display in general - Adaptricity.Connect</xs:documentation>
      </xs:annotation>
    </xs:element>

[ top ]
Element GRID / VOLTAGEREGULATOR

Annotations |
    Voltage regulators can be created and attached to lines in radial parts of the grid.
    During a simulation they behave similarly to tap changing transformers and will have
    an effect on the power flow both in static and time-series based simulations.
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:annotation>
        <xs:documentation>Voltage regulators can be created and attached to lines in radial parts of the grid. During a simulation they behave similarly to tap changing transformers and will have an effect on the power flow both in static and time-series based simulations.</xs:documentation>
      </xs:annotation>
      <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. Hard requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Name" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Description" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ConstructionYear" type="xs:integer">
                  <xs:annotation>
                    <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ExternalURL" type="xs:anyURI">
                  <xs:annotation>
                    <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="HostLineID" type="StringID">
                  <xs:annotation>
                    <xs:documentation>ID of the line that the voltage regulator is installed at. Required for: - All calculations</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="NumTaps" type="xs:integer">
                  <xs:annotation>
                    <xs:documentation>Number of taps of the transformer (both upward and downward). Required for: - All calculations</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="TapSizeFractionInPercent" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Size of each tap in terms of voltage change. Required for: - All calculations</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="DeadBandFractionInPercent" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Dead-band of the hysteresis controller that switches the taps. Required for: - All calculations</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="SetpointInPerUnit" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>This defines the desired voltage in per unit at the measured bus. Required for: - All calculations</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 |
    The year that the component was built in the field.
    Only used for information purposes.

    No requirement.
DeadBandFractionInPercent | xs:double | optional |
    Dead-band of the hysteresis controller that switches the taps.

    Required for:
    	- All calculations
Description | xs:string | optional |
    A human-readable description.

    No requirement.
ExternalURL | xs:anyURI | optional |
    URL that is displayed in our system.
    Can be used for switching to an external system.

    No requirement.
HostLineID | StringID | optional |
    ID of the line that the voltage regulator is installed at.

    Required for:
    	- All calculations
ID | StringID | required |
    ID (see type StringID). Each VoltageRegulator requires a unique ID among all VoltageRegulators.

    Hard requirement.
Name | xs:string | optional |
    A human-readable name.

    No requirement.
NumTaps | xs:integer | optional |
    Number of taps of the transformer (both upward and downward).

    Required for:
    	- All calculations
SetpointInPerUnit | xs:double | optional |
    This defines the desired voltage in per unit at the measured bus.

    Required for:
    	- All calculations
TapSizeFractionInPercent | xs:double | optional |
    Size of each tap in terms of voltage change.

    Required for:
    	- All calculations
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. Hard requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable name. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Description" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable description. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConstructionYear" type="xs:integer">
          <xs:annotation>
            <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ExternalURL" type="xs:anyURI">
          <xs:annotation>
            <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="HostLineID" type="StringID">
          <xs:annotation>
            <xs:documentation>ID of the line that the voltage regulator is installed at. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="NumTaps" type="xs:integer">
          <xs:annotation>
            <xs:documentation>Number of taps of the transformer (both upward and downward). Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="TapSizeFractionInPercent" type="xs:double">
          <xs:annotation>
            <xs:documentation>Size of each tap in terms of voltage change. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="DeadBandFractionInPercent" type="xs:double">
          <xs:annotation>
            <xs:documentation>Dead-band of the hysteresis controller that switches the taps. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="SetpointInPerUnit" type="xs:double">
          <xs:annotation>
            <xs:documentation>This defines the desired voltage in per unit at the measured bus. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / ASYMMETRIC_LINE

Annotations |
    Not supported yet.
Diagram |
Properties |
minOccurs | 0
maxOccurs | 1
Source |
    <xs:element name="ASYMMETRIC_LINE" minOccurs="0" maxOccurs="1">
      <xs:annotation>
        <xs:documentation>Not supported yet.</xs:documentation>
      </xs:annotation>
    </xs:element>

[ top ]
Element GRID / ASYMMETRIC_TRANSFORMER

Annotations |
    Not supported yet.
Diagram |
Properties |
minOccurs | 0
maxOccurs | 1
Source |
    <xs:element name="ASYMMETRIC_TRANSFORMER" minOccurs="0" maxOccurs="1">
      <xs:annotation>
        <xs:documentation>Not supported yet.</xs:documentation>
      </xs:annotation>
    </xs:element>

[ top ]
Element GRID / THREE-W-TRANSFORMER

Annotations |
    Not supported yet.
Diagram |
Properties |
minOccurs | 0
maxOccurs | 1
Source |
    <xs:element name="THREE-W-TRANSFORMER" minOccurs="0" maxOccurs="1">
      <xs:annotation>
        <xs:documentation>Not supported yet.</xs:documentation>
      </xs:annotation>
    </xs:element>

[ top ]
Element GRID / SHUNT

Annotations |
    Not supported yet.
Diagram |
Properties |
minOccurs | 0
maxOccurs | 1
Source |
    <xs:element name="SHUNT" minOccurs="0" maxOccurs="1">
      <xs:annotation>
        <xs:documentation>Not supported yet.</xs:documentation>
      </xs:annotation>
    </xs:element>

[ 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:annotation>
                    <xs:documentation>Defines the characteristics of the reactive power of the load. Required for: - Static power flow based functionalities if the load features a special reactive power characteristic</xs:documentation>
                  </xs:annotation>
                </xs:element>
              </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. Hard requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Name" type="xs:string">
                <xs:annotation>
                  <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Description" type="xs:string">
                <xs:annotation>
                  <xs:documentation>A human-readable description No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ConstructionYear" type="xs:integer">
                <xs:annotation>
                  <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ExternalURL" type="xs:anyURI">
                <xs:annotation>
                  <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="LoadCategory" type="LoadCategoryEnum">
                <xs:annotation>
                  <xs:documentation>Denotes the allowed load categories. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ActiveLoadInMegawatt" type="xs:double">
                <xs:annotation>
                  <xs:documentation>Active power in MW that the load consumes from the grid (should normally be positive). Required for: - All calculations</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Bus1ID" type="StringID">
                <xs:annotation>
                  <xs:documentation>ID of the Bus that the load is connected to. Required for: - All calculations</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Connected" type="xs:boolean">
                <xs:annotation>
                  <xs:documentation>Denotes whether the load is electrically connected. true if the switch is closed (connected), false if the switch is open (not connected). Defaults to true. Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ConnectionRequestID" type="xs:string">
                <xs:annotation>
                  <xs:documentation>If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration. No requirement.</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 |
    Active power in MW that the load consumes from the grid (should normally be positive).

    Required for:
    	- All calculations
Bus1ID | StringID | optional |
    ID of the Bus that the load is connected to.

    Required for:
    	- All calculations
Connected | xs:boolean | optional |
    Denotes whether the load is electrically connected.
    true if the switch is closed (connected), false if the switch is open (not connected). Defaults to true.

    Required for:
    	- All calculations (calculations are run with the default value if missing)
ConnectionRequestID | xs:string | optional |
    If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration.

    No requirement.
ConstructionYear | xs:integer | optional |
    The year that the component was built in the field.
    Only used for information purposes.

    No requirement.
Description | xs:string | optional |
    A human-readable description

    												No requirement.
ExternalURL | xs:anyURI | optional |
    URL that is displayed in our system.
    Can be used for switching to an external system.

    No requirement.
ID | StringID | required |
    ID (see type StringID). Each Load requires a unique ID among all Loads.

    Hard requirement.
LoadCategory | LoadCategoryEnum | optional |
    Denotes the allowed load categories.

    No requirement.
Name | xs:string | optional |
    A human-readable name.

    No requirement.
Source |
    <xs:element name="Load" minOccurs="0" maxOccurs="unbounded">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="ReactiveLoadCharacteristic" type="ReactivePowerCharacteristic" minOccurs="0">
            <xs:annotation>
              <xs:documentation>Defines the characteristics of the reactive power of the load. Required for: - Static power flow based functionalities if the load features a special reactive power characteristic</xs:documentation>
            </xs:annotation>
          </xs:element>
        </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. Hard requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable name. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Description" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable description No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConstructionYear" type="xs:integer">
          <xs:annotation>
            <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ExternalURL" type="xs:anyURI">
          <xs:annotation>
            <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="LoadCategory" type="LoadCategoryEnum">
          <xs:annotation>
            <xs:documentation>Denotes the allowed load categories. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ActiveLoadInMegawatt" type="xs:double">
          <xs:annotation>
            <xs:documentation>Active power in MW that the load consumes from the grid (should normally be positive). Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Bus1ID" type="StringID">
          <xs:annotation>
            <xs:documentation>ID of the Bus that the load is connected to. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Connected" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>Denotes whether the load is electrically connected. true if the switch is closed (connected), false if the switch is open (not connected). Defaults to true. Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConnectionRequestID" type="xs:string">
          <xs:annotation>
            <xs:documentation>If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / LOAD / Load / ReactiveLoadCharacteristic

Annotations |
    Defines the characteristics of the reactive power of the load.

    Required for:
    	- Static power flow based functionalities if the load features a special reactive power characteristic
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">
      <xs:annotation>
        <xs:documentation>Defines the characteristics of the reactive power of the load. Required for: - Static power flow based functionalities if the load features a special reactive power characteristic</xs:documentation>
      </xs:annotation>
    </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 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="" LibraryReliabilityName="" 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:annotation>
                    <xs:documentation>Defines the characteristics of the reactive power generation of the generator. Required for: - Static power flow based functionalities (if the generator features a special reactive power characteristic)</xs:documentation>
                  </xs:annotation>
                </xs:element>
              </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. Hard requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Name" type="xs:string">
                <xs:annotation>
                  <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Description" type="xs:string">
                <xs:annotation>
                  <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ConstructionYear" type="xs:integer">
                <xs:annotation>
                  <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ExternalURL" type="xs:anyURI">
                <xs:annotation>
                  <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="GenerationCategory" type="GenerationCategoryEnum">
                <xs:annotation>
                  <xs:documentation>Denotes the allowed categories of generation devices. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ConnectionType" type="GenerationConnectionEnum">
                <xs:annotation>
                  <xs:documentation>Denotes the type of the connection to the grid. Required for: - Short circuit calculations (makes them more accurate)</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ActiveGenerationInMegawatt" type="xs:double">
                <xs:annotation>
                  <xs:documentation>Active power in MW that the generator injects into the grid (should normally be positive). Required for: - All calculations</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="MinReactiveGenerationInMegavar" type="xs:double">
                <xs:annotation>
                  <xs:documentation>Currently not supported. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="MaxReactiveGenerationInMegavar" type="xs:double">
                <xs:annotation>
                  <xs:documentation>Currently not supported. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="MinActiveGenerationInMegawatt" type="xs:double">
                <xs:annotation>
                  <xs:documentation>Currently not supported. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="MaxActiveGenerationInMegawatt" type="xs:double">
                <xs:annotation>
                  <xs:documentation>Currently not supported. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="VoltageSetpointInKilovolt" type="xs:double">
                <xs:annotation>
                  <xs:documentation>Currently not supported. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Bus1ID" type="StringID">
                <xs:annotation>
                  <xs:documentation>ID of Bus that the generator is connected to. Required for: - All calculations</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Connected" type="xs:boolean">
                <xs:annotation>
                  <xs:documentation>Denotes whether the generator is electrically connected. true if the switch is closed (connected), false if the switch is open (not connected). Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ConnectionRequestID" type="xs:string">
                <xs:annotation>
                  <xs:documentation>If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</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="" LibraryReliabilityName="" 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 |
    Active power in MW that the generator injects into the grid (should normally be positive).

    Required for:
    	- All calculations
Bus1ID | StringID | optional |
    ID of Bus that the generator is connected to.

    Required for:
    	- All calculations
Connected | xs:boolean | optional |
    Denotes whether the generator is electrically connected.
    true if the switch is closed (connected), false if the switch is open (not connected).

    Required for:
    	- All calculations (calculations are run with the default value if missing)
ConnectionRequestID | xs:string | optional |
    If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration.

    No requirement.
ConnectionType | GenerationConnectionEnum | optional |
    Denotes the type of the connection to the grid.

    Required for:
    	- Short circuit calculations (makes them more accurate)
ConstructionYear | xs:integer | optional |
    The year that the component was built in the field.
    Only used for information purposes.

    No requirement.
Description | xs:string | optional |
    A human-readable description.

    No requirement.
ExternalURL | xs:anyURI | optional |
    URL that is displayed in our system.
    Can be used for switching to an external system.

    No requirement.
GenerationCategory | GenerationCategoryEnum | optional |
    Denotes the allowed categories of generation devices.

    No requirement.
ID | StringID | required |
    ID (see type StringID). Each Generator requires a unique ID among all Generators.

    Hard requirement.
LibraryReliabilityName | 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.

    Required for:
    	- Reliability calculations
MaxActiveGenerationInMegawatt | xs:double | optional |
    Currently not supported.

    No requirement.
MaxReactiveGenerationInMegavar | xs:double | optional |
    Currently not supported.

    No requirement.
MinActiveGenerationInMegawatt | xs:double | optional |
    Currently not supported.

    No requirement.
MinReactiveGenerationInMegavar | xs:double | optional |
    Currently not supported.

    No requirement.
Name | xs:string | optional |
    A human-readable name.

    No requirement.
VoltageSetpointInKilovolt | xs:double | optional |
    Currently not supported.

    No requirement.
Source |
    <xs:element name="Generator" minOccurs="0" maxOccurs="unbounded">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="ReactiveGenerationCharacteristic" type="ReactivePowerCharacteristic" minOccurs="0">
            <xs:annotation>
              <xs:documentation>Defines the characteristics of the reactive power generation of the generator. Required for: - Static power flow based functionalities (if the generator features a special reactive power characteristic)</xs:documentation>
            </xs:annotation>
          </xs:element>
        </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. Hard requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable name. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Description" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable description. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConstructionYear" type="xs:integer">
          <xs:annotation>
            <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ExternalURL" type="xs:anyURI">
          <xs:annotation>
            <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="GenerationCategory" type="GenerationCategoryEnum">
          <xs:annotation>
            <xs:documentation>Denotes the allowed categories of generation devices. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConnectionType" type="GenerationConnectionEnum">
          <xs:annotation>
            <xs:documentation>Denotes the type of the connection to the grid. Required for: - Short circuit calculations (makes them more accurate)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ActiveGenerationInMegawatt" type="xs:double">
          <xs:annotation>
            <xs:documentation>Active power in MW that the generator injects into the grid (should normally be positive). Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="MinReactiveGenerationInMegavar" type="xs:double">
          <xs:annotation>
            <xs:documentation>Currently not supported. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="MaxReactiveGenerationInMegavar" type="xs:double">
          <xs:annotation>
            <xs:documentation>Currently not supported. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="MinActiveGenerationInMegawatt" type="xs:double">
          <xs:annotation>
            <xs:documentation>Currently not supported. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="MaxActiveGenerationInMegawatt" type="xs:double">
          <xs:annotation>
            <xs:documentation>Currently not supported. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="VoltageSetpointInKilovolt" type="xs:double">
          <xs:annotation>
            <xs:documentation>Currently not supported. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Bus1ID" type="StringID">
          <xs:annotation>
            <xs:documentation>ID of Bus that the generator is connected to. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Connected" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>Denotes whether the generator is electrically connected. true if the switch is closed (connected), false if the switch is open (not connected). Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConnectionRequestID" type="xs:string">
          <xs:annotation>
            <xs:documentation>If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / GENERATOR / Generator / ReactiveGenerationCharacteristic

Annotations |
    Defines the characteristics of the reactive power generation of the generator.

    Required for:
    	- Static power flow based functionalities (if the generator features a special reactive power characteristic)
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">
      <xs:annotation>
        <xs:documentation>Defines the characteristics of the reactive power generation of the generator. Required for: - Static power flow based functionalities (if the generator features a special reactive power characteristic)</xs:documentation>
      </xs:annotation>
    </xs:element>

[ 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="" LibraryReliabilityName="" 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:annotation>
                      <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display</xs:documentation>
                    </xs:annotation>
                  </xs:element>
                </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). Hard requirement.</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). Required for: - All calculations if the transformer is tap-changing</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Name" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Description" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <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. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ConstructionYear" type="xs:integer">
                  <xs:annotation>
                    <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ExternalURL" type="xs:anyURI">
                  <xs:annotation>
                    <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="VectorGroup" type="xs:string">
                  <xs:annotation>
                    <xs:documentation>Vector group (Schaltgruppe) of transformer, e.g. Dyn5. Required for: - Short circuit calculations</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. Required for: - Short circuit calculations in case transformer vector group has a star point</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. Required for: - Short circuit calculations if transformer grounding type is 'Resonant grounding'</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="TransformerRatingInMegavoltampere" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml. Required for: - All calculations</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="MaximumApparentPowerInMegavoltampere" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>Maximum allowed apparent power. Usually the same as the transformer rating. Can be fetched from the Component Library. Required for: - All calculations</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ShortCircuitVoltageInPercent" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml. Required for: - All calculations</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="CopperLossesInPercent" type="xs:double">
                  <xs:annotation>
                    <xs:documentation>It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml. Required for: - All calculations</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. Used for calculation of the turns ratio. Required for: - All calculations (defaults to the value of the bus voltage if missing)</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. Used for calculation of the turns ratio. Required for: - All calculations (defaults to the value of the bus voltage if missing)</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. Required for: - All calculations if transformer is tap changing</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. Required for: - All calculations if transformer is tap changing</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 (%). Required for: - All calculations if transformer is tap changing</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 of the hysteresis controller in percent (%). Required for: - All calculations if transformer is tap changing</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. Required for: - All calculations if transformer is tap changing</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) Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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) Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Bus1ID" type="StringID">
                  <xs:annotation>
                    <xs:documentation>ID of bus 1 that the transformer is connected to. Required for: - All calculations</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="Bus2ID" type="StringID">
                  <xs:annotation>
                    <xs:documentation>ID of bus 2 that the transformer is connected to. Required for: - All calculations</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
                  <xs:annotation>
                    <xs:documentation>Denotes whether the transformer is electrically connected. true if the switch is closed (connected) at bus 1, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
                  <xs:annotation>
                    <xs:documentation>Denotes whether the transformer is electrically connected. true if the switch is closed (connected) at bus 2, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</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. No requirement.</xs:documentation>
                  </xs:annotation>
                </xs:attribute>
                <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</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="" LibraryReliabilityName="" 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 the transformer is connected to.

    Required for:
    	- All calculations
Bus2ID | StringID | optional |
    ID of bus 2 that the transformer is connected to.

    Required for:
    	- All calculations
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.

    No requirement.
ConnectedAtBus1 | xs:boolean | optional |
    Denotes whether the transformer is electrically connected.
    true if the switch is closed (connected) at
    bus 1, false if the switch is open (not connected).
    Default value is true.

    Required for:
    	- All calculations (calculations are run with the default value if missing)
ConnectedAtBus2 | xs:boolean | optional |
    Denotes whether the transformer is electrically connected.
    true if the switch is closed (connected) at
    bus 2, false if the switch is open (not connected).
    Default value is true.

    Required for:
    	- All calculations (calculations are run with the default value if missing)
ConstructionYear | xs:integer | optional |
    The year that the component was built in the field.
    Only used for information purposes.

    No requirement.
CopperLossesInPercent | xs:double | optional |
    It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml.

    Required for:
    	- All calculations
DeadBandInPercent | xs:double | optional |
    For tap-changing transformers, it defines the dead band of the hysteresis controller in percent (%).

    Required for:
    	- All calculations if transformer is tap changing
Description | xs:string | optional |
    A human-readable description.

    No requirement.
ExternalURL | xs:anyURI | optional |
    URL that is displayed in our system.
    Can be used for switching to an external system.

    No requirement.
ID | StringID | required |
    ID (see type StringID). Each Transformer requires a unique ID among all branch types (Line, Connection, Transformer).

    Hard requirement.
IsTapChanging | xs:boolean | optional |
    True, if transformer is a tap-changing transformer.

    Required for:
    	- All calculations if transformer is tap changing
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).

    Required for:
    	- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
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).

    Required for:
    	- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
LibraryReliabilityName | 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.

    Required for:
    	- Reliability calculations
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)

    Required for:
    	- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
MaximumApparentPowerInMegavoltampere | xs:double | optional |
    Maximum allowed apparent power. Usually the same as the transformer rating.
    Can be fetched from the Component Library.

    Required for:
    	- All calculations
MeasuredVoltageBusID | StringID | optional |
    The bus ID at which the voltage is measured for the tap-changing controller (see type StringID).

    Required for:
    	- All calculations if the transformer is tap-changing
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)

    Required for:
    	- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
Name | xs:string | optional |
    A human-readable name.

    No requirement.
NumTaps | xs:int | optional |
    For tap-changing transformers, it defines the number of taps.

    Required for:
    	- All calculations if transformer is tap changing
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.

    No requirement.
RatedVoltageAtBus1 | xs:double | optional |
    Rated transformer voltage on the side of Bus 1 in Kilovolt.
    Used for calculation of the turns ratio.

    Required for:
    	- All calculations (defaults to the value of the bus voltage if missing)
RatedVoltageAtBus2 | xs:double | optional |
    Rated transformer voltage on the side of Bus 2 in Kilovolt.
    Used for calculation of the turns ratio.

    Required for:
    	- All calculations (defaults to the value of the bus voltage if missing)
SecondaryGroundingInductanceInHenry | xs:double | optional |
    In case the star point grounding type 'Resonant grounding' was selected, this number defines the grounding inductance in Henry.

    Required for:
    	- Short circuit calculations if transformer grounding type is 'Resonant grounding'
SetpointInPerUnit | xs:double | optional |
    For tap-changing transformers, it defines the desired voltage in per unit at the measured bus.

    Required for:
    	- All calculations if transformer is tap changing
ShortCircuitVoltageInPercent | xs:double | optional |
    It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml.

    Required for:
    	- All calculations
StarPointGrounding | StarPointGrounding | optional |
    Defines how the star point is grounded.
    If vectorGroup doesn't have a star point, leave empty.

    Required for:
    	- Short circuit calculations in case transformer vector group has a star point
TapSizeInPercent | xs:double | optional |
    For tap-changing transformers, it defines the tap size in percent (%).

    Required for:
    	- All calculations if transformer is tap changing
TransformerRatingInMegavoltampere | xs:double | optional |
    It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml.

    Required for:
    	- All calculations
VectorGroup | xs:string | optional |
    Vector group (Schaltgruppe) of transformer, e.g. Dyn5.

    Required for:
    	- Short circuit calculations
Source |
    <xs:element name="Transformer" minOccurs="0" maxOccurs="unbounded">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="GIS" type="GISType" minOccurs="0" maxOccurs="1">
            <xs:annotation>
              <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display</xs:documentation>
            </xs:annotation>
          </xs:element>
        </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). Hard requirement.</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). Required for: - All calculations if the transformer is tap-changing</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable name. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Description" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable description. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <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. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConstructionYear" type="xs:integer">
          <xs:annotation>
            <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ExternalURL" type="xs:anyURI">
          <xs:annotation>
            <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="VectorGroup" type="xs:string">
          <xs:annotation>
            <xs:documentation>Vector group (Schaltgruppe) of transformer, e.g. Dyn5. Required for: - Short circuit calculations</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. Required for: - Short circuit calculations in case transformer vector group has a star point</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. Required for: - Short circuit calculations if transformer grounding type is 'Resonant grounding'</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="TransformerRatingInMegavoltampere" type="xs:double">
          <xs:annotation>
            <xs:documentation>It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="MaximumApparentPowerInMegavoltampere" type="xs:double">
          <xs:annotation>
            <xs:documentation>Maximum allowed apparent power. Usually the same as the transformer rating. Can be fetched from the Component Library. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ShortCircuitVoltageInPercent" type="xs:double">
          <xs:annotation>
            <xs:documentation>It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="CopperLossesInPercent" type="xs:double">
          <xs:annotation>
            <xs:documentation>It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml. Required for: - All calculations</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. Used for calculation of the turns ratio. Required for: - All calculations (defaults to the value of the bus voltage if missing)</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. Used for calculation of the turns ratio. Required for: - All calculations (defaults to the value of the bus voltage if missing)</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. Required for: - All calculations if transformer is tap changing</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. Required for: - All calculations if transformer is tap changing</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 (%). Required for: - All calculations if transformer is tap changing</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 of the hysteresis controller in percent (%). Required for: - All calculations if transformer is tap changing</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. Required for: - All calculations if transformer is tap changing</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) Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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) Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Bus1ID" type="StringID">
          <xs:annotation>
            <xs:documentation>ID of bus 1 that the transformer is connected to. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Bus2ID" type="StringID">
          <xs:annotation>
            <xs:documentation>ID of bus 2 that the transformer is connected to. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>Denotes whether the transformer is electrically connected. true if the switch is closed (connected) at bus 1, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>Denotes whether the transformer is electrically connected. true if the switch is closed (connected) at bus 2, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</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. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / TRANSFORMER / Transformer / GIS

Annotations |
    Defines the GIS information (geometry and coordinates).

    Required for:
    	- Geographical display
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">
      <xs:annotation>
        <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display</xs:documentation>
      </xs:annotation>
    </xs:element>

[ top ]
Element GRID / FEEDER

Annotations |
    Network feeder. Currently only one network feeder per grid is supported (single slack bus).
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:annotation>
        <xs:documentation>Network feeder. Currently only one network feeder per grid is supported (single slack bus).</xs:documentation>
      </xs:annotation>
      <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). Hard requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Name" type="xs:string">
                <xs:annotation>
                  <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="HostBusID" type="StringID">
                <xs:annotation>
                  <xs:documentation>Bus ID of the bus that the network feeder is attached to. Becomes the slack bus of the power flow model. Required for: - All calculations</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Description" type="xs:string">
                <xs:annotation>
                  <xs:documentation>A human-readable documentation No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ConstructionYear" type="xs:integer">
                <xs:annotation>
                  <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ExternalURL" type="xs:anyURI">
                <xs:annotation>
                  <xs:documentation>URL that is displayed in our system. Can be used for switching to another system. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="OperationalVoltageInPerUnit" type="xs:double">
                <xs:annotation>
                  <xs:documentation>Sets the voltage of the slack bus and consequently influences the power flow behavior of the entire grid. Required for: - All calculations</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="OperationalAngleInRadians" type="xs:double">
                <xs:annotation>
                  <xs:documentation>Can be set to arbitrary value (e.g. zero) since only the angle differences within the grid matter for the power flow. Required for: - All calculations</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="VoltageFactorMax" type="xs:double">
                <xs:annotation>
                  <xs:documentation>Denotes the voltage multiplier for computation of maximum short-circuit currents according to IEC 60909. Not supported yet (currently, a default value of 1 is used). No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="VoltageFactorMin" type="xs:double">
                <xs:annotation>
                  <xs:documentation>Denotes the voltage multiplier for computation of minimum short-circuit currents according to IEC 60909. Not supported yet (currently, a default value of 1 is used). No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="MaxSourceShortCircuitPowerInMegavoltampere" type="xs:double">
                <xs:annotation>
                  <xs:documentation>Denotes the maximum short-circuit power of the overlying grid according to IEC 60909. Required for: - Short circuit calculations</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="MinSourceShortCircuitPowerInMegavoltampere" type="xs:double">
                <xs:annotation>
                  <xs:documentation>Denotes the minimum short-circuit power of the overlying grid according to IEC 60909. Required for: - Short circuit calculations</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ReactanceToResistanceRatio" type="xs:double">
                <xs:annotation>
                  <xs:documentation>Denotes the X/R ratio of the overlying grid. Required for: - Short circuit calculations</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Connected" type="xs:boolean">
                <xs:annotation>
                  <xs:documentation>Denotes whether the network feeder is electrically connected. true if the switch is closed (connected) at the host bus, false if the switch is open (not connected). Required for: - All calculations (calculations are run with the default value of 'true' if missing)</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 |
    Denotes whether the network feeder is electrically connected.
    true if the switch is closed (connected) at the
    host bus, false if the switch is open (not connected).

    Required for:
    	- All calculations (calculations are run with the default value of 'true' if missing)
ConstructionYear | xs:integer | optional |
    The year that the component was built in the field.
    Only used for information purposes.

    No requirement.
Description | xs:string | optional |
    A human-readable documentation

    No requirement.
ExternalURL | xs:anyURI | optional |
    URL that is displayed in our system.
    Can be used for switching to another system.

    No requirement.
HostBusID | StringID | optional |
    Bus ID of the bus that the network feeder is attached to.
    Becomes the slack bus of the power flow model.

    Required for:
    	- All calculations
ID | StringID | required |
    ID (see type StringID).

    Hard requirement.
MaxSourceShortCircuitPowerInMegavoltampere | xs:double | optional |
    Denotes the maximum short-circuit power of the overlying grid according to IEC 60909.

    Required for:
    	- Short circuit calculations
MinSourceShortCircuitPowerInMegavoltampere | xs:double | optional |
    Denotes the minimum short-circuit power of the overlying grid according to IEC 60909.

    Required for:
    	- Short circuit calculations
Name | xs:string | optional |
    A human-readable name.

    No requirement.
OperationalAngleInRadians | xs:double | optional |
    Can be set to arbitrary value (e.g. zero) since only the angle differences within the grid matter for the power flow.

    Required for:
    	- All calculations
OperationalVoltageInPerUnit | xs:double | optional |
    Sets the voltage of the slack bus and consequently influences the power flow behavior of the entire grid.

    Required for:
    	- All calculations
ReactanceToResistanceRatio | xs:double | optional |
    Denotes the X/R ratio of the overlying grid.

    Required for:
    	- Short circuit calculations
VoltageFactorMax | xs:double | optional |
    Denotes the voltage multiplier for computation of maximum short-circuit currents according to IEC 60909.
    Not supported yet (currently, a default value of 1 is used).

    No requirement.
VoltageFactorMin | xs:double | optional |
    Denotes the voltage multiplier for computation of minimum short-circuit currents according to IEC 60909.
    Not supported yet (currently, a default value of 1 is used).

    No requirement.
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). Hard requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable name. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="HostBusID" type="StringID">
          <xs:annotation>
            <xs:documentation>Bus ID of the bus that the network feeder is attached to. Becomes the slack bus of the power flow model. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Description" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable documentation No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConstructionYear" type="xs:integer">
          <xs:annotation>
            <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ExternalURL" type="xs:anyURI">
          <xs:annotation>
            <xs:documentation>URL that is displayed in our system. Can be used for switching to another system. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="OperationalVoltageInPerUnit" type="xs:double">
          <xs:annotation>
            <xs:documentation>Sets the voltage of the slack bus and consequently influences the power flow behavior of the entire grid. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="OperationalAngleInRadians" type="xs:double">
          <xs:annotation>
            <xs:documentation>Can be set to arbitrary value (e.g. zero) since only the angle differences within the grid matter for the power flow. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="VoltageFactorMax" type="xs:double">
          <xs:annotation>
            <xs:documentation>Denotes the voltage multiplier for computation of maximum short-circuit currents according to IEC 60909. Not supported yet (currently, a default value of 1 is used). No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="VoltageFactorMin" type="xs:double">
          <xs:annotation>
            <xs:documentation>Denotes the voltage multiplier for computation of minimum short-circuit currents according to IEC 60909. Not supported yet (currently, a default value of 1 is used). No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="MaxSourceShortCircuitPowerInMegavoltampere" type="xs:double">
          <xs:annotation>
            <xs:documentation>Denotes the maximum short-circuit power of the overlying grid according to IEC 60909. Required for: - Short circuit calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="MinSourceShortCircuitPowerInMegavoltampere" type="xs:double">
          <xs:annotation>
            <xs:documentation>Denotes the minimum short-circuit power of the overlying grid according to IEC 60909. Required for: - Short circuit calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ReactanceToResistanceRatio" type="xs:double">
          <xs:annotation>
            <xs:documentation>Denotes the X/R ratio of the overlying grid. Required for: - Short circuit calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Connected" type="xs:boolean">
          <xs:annotation>
            <xs:documentation>Denotes whether the network feeder is electrically connected. true if the switch is closed (connected) at the host bus, false if the switch is open (not connected). Required for: - All calculations (calculations are run with the default value of 'true' if missing)</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. Hard requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Name" type="xs:string">
                <xs:annotation>
                  <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Description" type="xs:string">
                <xs:annotation>
                  <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ConstructionYear" type="xs:integer">
                <xs:annotation>
                  <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ExternalURL" type="xs:anyURI">
                <xs:annotation>
                  <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="HostBranchID" type="StringID">
                <xs:annotation>
                  <xs:documentation>ID of the branch that the fuse is connected to (required). Required for: - All calculations</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 (Bus1 or Bus2). Default value is 'Bus1'. Required for: - All calculations</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="FuseType" type="FuseTypeEnum">
                <xs:annotation>
                  <xs:documentation>Denoting the type of fuse. Possible entries: Grid (installed in the distribution grid), Connection (installed at a connection point, e.g. house) Required for: - Protection calculations</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="LibraryFuseName" type="xs:string">
                <xs:annotation>
                  <xs:documentation>Unique name that identifies the fuse in the component library. Required for: - Component library matching</xs:documentation>
                </xs:annotation>
              </xs:attribute>
            </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 (Bus1 or Bus2).
    Default value is 'Bus1'.

    Required for:
    	- All calculations
ConstructionYear | xs:integer | optional |
    The year that the component was built in the field.
    Only used for information purposes.

    No requirement.
Description | xs:string | optional |
    A human-readable description.

    No requirement.
ExternalURL | xs:anyURI | optional |
    URL that is displayed in our system.
    Can be used for switching to an external system.

    No requirement.
FuseType | FuseTypeEnum | optional |
    Denoting the type of fuse.
    Possible entries: Grid (installed in the distribution grid),
    Connection (installed at a connection point, e.g. house)

    Required for:
    	- Protection calculations
HostBranchID | StringID | optional |
    ID of the branch that the fuse is connected to (required).

    Required for:
    	- All calculations
ID | StringID | required |
    ID (see type StringID). Each Fuse requires a unique ID among all Fuses.

    Hard requirement.
LibraryFuseName | xs:string | optional |
    Unique name that identifies the fuse in the component library.

    Required for:
    	- Component library matching
Name | xs:string | optional |
    A human-readable name.

    No requirement.
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. Hard requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable name. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Description" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable description. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConstructionYear" type="xs:integer">
          <xs:annotation>
            <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ExternalURL" type="xs:anyURI">
          <xs:annotation>
            <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="HostBranchID" type="StringID">
          <xs:annotation>
            <xs:documentation>ID of the branch that the fuse is connected to (required). Required for: - All calculations</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 (Bus1 or Bus2). Default value is 'Bus1'. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="FuseType" type="FuseTypeEnum">
          <xs:annotation>
            <xs:documentation>Denoting the type of fuse. Possible entries: Grid (installed in the distribution grid), Connection (installed at a connection point, e.g. house) Required for: - Protection calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="LibraryFuseName" type="xs:string">
          <xs:annotation>
            <xs:documentation>Unique name that identifies the fuse in the component library. Required for: - Component library matching</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </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 |
    The year that the component was built in the field. Only used for information purposes.

    No requirement.
Description | xs:string | optional |
    A human-readable description.

    No requirement.
Direction | ProtectionDeviceDirection | optional |
    The direction of the current for which the protection device should trip in the case of a short-circuit.
    Defaults to 'Undirected'.

    No requirement.
ExternalURL | xs:anyURI | optional |
    URL that is displayed in our system. Can be used for switching to an external system.

    No requirement.
HostSwitchID | StringID | optional |
    ID of the switch where the protection device is connected to. Previously called 'HostCircuitBreakerID'.

    Required.
ID | StringID | required |
    ID (see type StringID). Each ProtectionDevice requires a unique ID among all ProtectionDevices.

    Hard requirement.
Name | xs:string | optional |
    A human-readable name.

    No requirement.
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="" LibraryReliabilityName="" 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. Hard requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Name" type="xs:string">
                <xs:annotation>
                  <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Description" type="xs:string">
                <xs:annotation>
                  <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Type" type="SwitchTypeEnum">
                <xs:annotation>
                  <xs:documentation>Type of the switch. Required for: - All calculations</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="BranchEnd" type="BranchEndEnum">
                <xs:annotation>
                  <xs:documentation>Specificaties if the switch is placed at bus1 or bus2 of its host edge: “Bus1”, “Bus2”. Required for: - All calculations</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="HostBranchID" type="xs:string">
                <xs:annotation>
                  <xs:documentation>ID of the branch, which the switch is allocated to. Required for: - All calculations</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="MaxAperiodicShortCircuitCurrentInKiloampere" type="xs:double">
                <xs:annotation>
                  <xs:documentation>No requirement. Optional for: - Protection calculation</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ConstructionYear" type="xs:integer">
                <xs:annotation>
                  <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ExternalURL" type="xs:anyURI">
                <xs:annotation>
                  <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</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 |
    Specificaties if the switch is placed at bus1 or bus2 of its host edge:
    “Bus1”, “Bus2”.

    Required for:
    	- All calculations
ConstructionYear | xs:integer | optional |
    The year that the component was built in the field. Only used for information purposes.

    No requirement.
Description | xs:string | optional |
    A human-readable description.

    No requirement.
ExternalURL | xs:anyURI | optional |
    URL that is displayed in our system.
    Can be used for switching to an external system.

    No requirement.
HostBranchID | xs:string | optional |
    ID of the branch, which the switch is allocated to.

    Required for:
    	- All calculations
ID | StringID | required |
    ID (see type StringID). Each Switch requires a unique ID among all Switches.

    Hard requirement.
LibraryReliabilityName | 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.

    Required for:
    	- Reliability calculations
MaxAperiodicShortCircuitCurrentInKiloampere | xs:double | optional |
    No requirement.
    Optional for:
    	- Protection calculation
Name | xs:string | optional |
    A human-readable name.

    No requirement.
Type | SwitchTypeEnum | optional |
    Type of the switch.

    Required for:
    	- All calculations
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. Hard requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable name. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Description" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable description. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Type" type="SwitchTypeEnum">
          <xs:annotation>
            <xs:documentation>Type of the switch. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="BranchEnd" type="BranchEndEnum">
          <xs:annotation>
            <xs:documentation>Specificaties if the switch is placed at bus1 or bus2 of its host edge: “Bus1”, “Bus2”. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="HostBranchID" type="xs:string">
          <xs:annotation>
            <xs:documentation>ID of the branch, which the switch is allocated to. Required for: - All calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="MaxAperiodicShortCircuitCurrentInKiloampere" type="xs:double">
          <xs:annotation>
            <xs:documentation>No requirement. Optional for: - Protection calculation</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConstructionYear" type="xs:integer">
          <xs:annotation>
            <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ExternalURL" type="xs:anyURI">
          <xs:annotation>
            <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / STATION

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | 1
Model | Station*
Children | Station
Instance |
    <STATION>
      <Station ConstructionYear="" Description="" ExternalURL="" ID="" Name="" Type="" x="" y="">{0,unbounded}</Station>
    </STATION>
Source |
    <xs:element name="STATION" minOccurs="0" maxOccurs="1">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="Station" minOccurs="0" maxOccurs="unbounded">
            <xs:complexType>
              <xs:all>
                <xs:element name="GIS" type="GISType" maxOccurs="1" minOccurs="0">
                  <xs:annotation>
                    <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display</xs:documentation>
                  </xs:annotation>
                </xs:element>
              </xs:all>
              <xs:attribute name="ID" type="StringID" use="required">
                <xs:annotation>
                  <xs:documentation>ID (see type StringID). Each station requires a unique ID among all stations. Hard requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Name" type="xs:string">
                <xs:annotation>
                  <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Description" type="xs:string">
                <xs:annotation>
                  <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ConstructionYear" type="xs:integer">
                <xs:annotation>
                  <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="ExternalURL" type="xs:anyURI">
                <xs:annotation>
                  <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Type" type="StationTypeEnum">
                <xs:annotation>
                  <xs:documentation>Denotes the type of station and shall be either TransformerStation, DistributionCabinet, Substation, or Other. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="x" type="xs:double">
                <xs:annotation>
                  <xs:documentation>x-coordinate of the station to display in the schematic view. Required for: - Display in schematic view</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="y" type="xs:double">
                <xs:annotation>
                  <xs:documentation>y-coordinate of the station to display in the schematic view. Required for: - Display in schematic view</xs:documentation>
                </xs:annotation>
              </xs:attribute>
            </xs:complexType>
          </xs:element>
        </xs:sequence>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / STATION / Station

Diagram |
Properties |
content | complex
minOccurs | 0
maxOccurs | unbounded
Model | ALL(GIS{0,1})
Children | GIS
Instance |
    <Station ConstructionYear="" Description="" ExternalURL="" ID="" Name="" Type="" x="" y="">
      <GIS ShapeType="">{0,1}</GIS>
    </Station>
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
ConstructionYear | xs:integer | optional |
    The year that the component was built in the field. Only used for information purposes.

    No requirement.
Description | xs:string | optional |
    A human-readable description.

    No requirement.
ExternalURL | xs:anyURI | optional |
    URL that is displayed in our system.
    Can be used for switching to an external system.

    No requirement.
ID | StringID | required |
    ID (see type StringID). Each station requires a unique ID among all stations.

    Hard requirement.
Name | xs:string | optional |
    A human-readable name.

    No requirement.
Type | StationTypeEnum | optional |
    Denotes the type of station and shall be either TransformerStation, DistributionCabinet, Substation, or Other.

    No requirement.
x | xs:double | optional |
    x-coordinate of the station to display in the schematic view.

    Required for:
    	- Display in schematic view
y | xs:double | optional |
    y-coordinate of the station to display in the schematic view.

    Required for:
    	- Display in schematic view
Source |
    <xs:element name="Station" minOccurs="0" maxOccurs="unbounded">
      <xs:complexType>
        <xs:all>
          <xs:element name="GIS" type="GISType" maxOccurs="1" minOccurs="0">
            <xs:annotation>
              <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display</xs:documentation>
            </xs:annotation>
          </xs:element>
        </xs:all>
        <xs:attribute name="ID" type="StringID" use="required">
          <xs:annotation>
            <xs:documentation>ID (see type StringID). Each station requires a unique ID among all stations. Hard requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable name. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Description" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable description. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ConstructionYear" type="xs:integer">
          <xs:annotation>
            <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="ExternalURL" type="xs:anyURI">
          <xs:annotation>
            <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Type" type="StationTypeEnum">
          <xs:annotation>
            <xs:documentation>Denotes the type of station and shall be either TransformerStation, DistributionCabinet, Substation, or Other. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="x" type="xs:double">
          <xs:annotation>
            <xs:documentation>x-coordinate of the station to display in the schematic view. Required for: - Display in schematic view</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="y" type="xs:double">
          <xs:annotation>
            <xs:documentation>y-coordinate of the station to display in the schematic view. Required for: - Display in schematic view</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / STATION / Station / GIS

Annotations |
    Defines the GIS information (geometry and coordinates).

    Required for:
    	- Geographical display
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">
      <xs:annotation>
        <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display</xs:documentation>
      </xs:annotation>
    </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="" StationID="" 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:annotation>
                    <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display</xs:documentation>
                  </xs:annotation>
                </xs:element>
              </xs:all>
              <xs:attribute name="ID" type="StringID" use="required">
                <xs:annotation>
                  <xs:documentation>A string ID, unique within the grid model. Hard requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="DisplayType" type="DisplayTypeEnum" use="required">
                <xs:annotation>
                  <xs:documentation>Definition whether the shape is dispayed on the schematic or on the map view: “Schematic”, “Map”. Hard requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Type" type="FormTypeEnum" use="required">
                <xs:annotation>
                  <xs:documentation>Type of the geometry. Possible types are: “Line”, “Arrow”, “Ellipse”, “Rectangle”, “Polygon” Hard requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="x1" type="xs:double">
                <xs:annotation>
                  <xs:documentation>The x-coordinate of the upper left corner of the shape. Required for: - Schematic display</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. Required for: - Schematic display</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. Required for: - Schematic display</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. Required for: - Schematic display</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Name" type="xs:string">
                <xs:annotation>
                  <xs:documentation>A human-readable name. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Description" type="xs:string">
                <xs:annotation>
                  <xs:documentation>A human-readable description. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="Text" type="xs:string">
                <xs:annotation>
                  <xs:documentation>Text to be shown within the shape. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <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 No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="TextPosition" type="TextPositionEnumType">
                <xs:annotation>
                  <xs:documentation>Position, where text is displayed within the shape. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="TextOrientation" type="TextOrientationEnumType">
                <xs:annotation>
                  <xs:documentation>Orientation of the text. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="FontSize" type="xs:integer">
                <xs:annotation>
                  <xs:documentation>Font size of the text. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="TextColor" type="ColorType">
                <xs:annotation>
                  <xs:documentation>Color of the text. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="OutlineColor" type="ColorType">
                <xs:annotation>
                  <xs:documentation>Color of the shape outline. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="BackgroundColor" type="ColorType">
                <xs:annotation>
                  <xs:documentation>Background color of the shape. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="OutlineWidth" type="xs:integer">
                <xs:annotation>
                  <xs:documentation>Width of the shape outline. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="StationID" type="xs:string">
                <xs:annotation>
                  <xs:documentation>The ID of the station, if this shape belongs to a station. No requirement.</xs:documentation>
                </xs:annotation>
              </xs:attribute>
            </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="" StationID="" Text="" TextColor="" TextOrientation="" TextPosition="" TextStyle="" Type="" x1="" x2="" y1="" y2="">
      <GIS ShapeType="">{0,1}</GIS>
    </Shape>
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
BackgroundColor | ColorType | optional |
    Background color of the shape.

    No requirement.
Description | xs:string | optional |
    A human-readable description.

    No requirement.
DisplayType | DisplayTypeEnum | required |
    Definition whether the shape is dispayed on the schematic or on the map view:
    “Schematic”, “Map”.

    Hard requirement.
FontSize | xs:integer | optional |
    Font size of the text.

    No requirement.
ID | StringID | required |
    A string ID, unique within the grid model.

    Hard requirement.
Name | xs:string | optional |
    A human-readable name.

    No requirement.
OutlineColor | ColorType | optional |
    Color of the shape outline.

    No requirement.
OutlineWidth | xs:integer | optional |
    Width of the shape outline.

    No requirement.
StationID | xs:string | optional |
    The ID of the station, if this shape belongs to a station.

    No requirement.
Text | xs:string | optional |
    Text to be shown within the shape.

    No requirement.
TextColor | ColorType | optional |
    Color of the text.

    No requirement.
TextOrientation | TextOrientationEnumType | optional |
    Orientation of the text.

    No requirement.
TextPosition | TextPositionEnumType | optional |
    Position, where text is displayed within the shape.

    No requirement.
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

    No requirement.
Type | FormTypeEnum | required |
    Type of the geometry.
    Possible types are:
    “Line”, “Arrow”, “Ellipse”, “Rectangle”, “Polygon”

    Hard requirement.
x1 | xs:double | optional |
    The x-coordinate of the upper left corner of the shape.

    Required for:
    	- Schematic display
x2 | xs:double | optional |
    The x-coordinate of the lower right corner of the shape.

    Required for:
    	- Schematic display
y1 | xs:double | optional |
    The y-coordinate of the upper left corner of the shape.

    Required for:
    	- Schematic display
y2 | xs:double | optional |
    The y-coordinate of the lower right corner of the shape.

    Required for:
    	- Schematic display
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:annotation>
              <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display</xs:documentation>
            </xs:annotation>
          </xs:element>
        </xs:all>
        <xs:attribute name="ID" type="StringID" use="required">
          <xs:annotation>
            <xs:documentation>A string ID, unique within the grid model. Hard requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="DisplayType" type="DisplayTypeEnum" use="required">
          <xs:annotation>
            <xs:documentation>Definition whether the shape is dispayed on the schematic or on the map view: “Schematic”, “Map”. Hard requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Type" type="FormTypeEnum" use="required">
          <xs:annotation>
            <xs:documentation>Type of the geometry. Possible types are: “Line”, “Arrow”, “Ellipse”, “Rectangle”, “Polygon” Hard requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="x1" type="xs:double">
          <xs:annotation>
            <xs:documentation>The x-coordinate of the upper left corner of the shape. Required for: - Schematic display</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. Required for: - Schematic display</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. Required for: - Schematic display</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. Required for: - Schematic display</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Name" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable name. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Description" type="xs:string">
          <xs:annotation>
            <xs:documentation>A human-readable description. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Text" type="xs:string">
          <xs:annotation>
            <xs:documentation>Text to be shown within the shape. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <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 No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="TextPosition" type="TextPositionEnumType">
          <xs:annotation>
            <xs:documentation>Position, where text is displayed within the shape. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="TextOrientation" type="TextOrientationEnumType">
          <xs:annotation>
            <xs:documentation>Orientation of the text. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="FontSize" type="xs:integer">
          <xs:annotation>
            <xs:documentation>Font size of the text. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="TextColor" type="ColorType">
          <xs:annotation>
            <xs:documentation>Color of the text. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="OutlineColor" type="ColorType">
          <xs:annotation>
            <xs:documentation>Color of the shape outline. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="BackgroundColor" type="ColorType">
          <xs:annotation>
            <xs:documentation>Background color of the shape. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="OutlineWidth" type="xs:integer">
          <xs:annotation>
            <xs:documentation>Width of the shape outline. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="StationID" type="xs:string">
          <xs:annotation>
            <xs:documentation>The ID of the station, if this shape belongs to a station. No requirement.</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ top ]
Element GRID / SHAPE / Shape / GIS

Annotations |
    Defines the GIS information (geometry and coordinates).

    Required for:
    	- Geographical display
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">
      <xs:annotation>
        <xs:documentation>Defines the GIS information (geometry and coordinates). Required for: - Geographical display</xs:documentation>
      </xs:annotation>
    </xs:element>

[ 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 pairs, which 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. Required for: - Protection calculation</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. Required for: - Protection calculation</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 pairs, which 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.

    Required for:
    	- Protection calculation
SwitchOffTimeInSeconds | xs:double | optional |
    The time after which the fault is cleared.

    Required for:
    	- Protection calculation
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 pairs, which 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. Required for: - Protection calculation</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. Required for: - Protection calculation</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, for which 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 is low) are cleared faster than distant faults (measured impedance is high).
    This distance-time dependency is expressed as list of distance-time pairs, which discribes a step-shaped curve.
    Stages of DistanceProtection devices work analogously to the stages of DefiniteTimeOvercurrentProtection devices
    with the difference that 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, for which 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 is low) are cleared faster than distant faults (measured impedance is high). This distance-time dependency is expressed as list of distance-time pairs, which discribes a step-shaped curve. Stages of DistanceProtection devices work analogously to the stages of DefiniteTimeOvercurrentProtection devices with the difference that 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:annotation>
                  <xs:documentation>Denotes the impedances which together with SwitchOffTimeInSeconds define the settings of the protection device. Multiple entries possible. Required for: - Protection calculation</xs:documentation>
                </xs:annotation>
              </xs:attribute>
              <xs:attribute name="SwitchOffTimeInSeconds" type="xs:double">
                <xs:annotation>
                  <xs:documentation>Denotes the time which together with ImpedanceInOhm define the settings of the protection device. Multiple entries possible. Required for: - Protection calculation</xs:documentation>
                </xs:annotation>
              </xs:attribute>
            </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 | Annotation
--- | --- | --- | ---
ImpedanceInOhm | xs:double | optional |
    Denotes the impedances which together with SwitchOffTimeInSeconds define the settings of the protection device. Multiple entries possible.

    Required for:
    	- Protection calculation
SwitchOffTimeInSeconds | xs:double | optional |
    Denotes the time which together with ImpedanceInOhm define the settings of the protection device. Multiple entries possible.

    Required for:
    	- Protection calculation
Source |
    <xs:element name="Stage" minOccurs="0" maxOccurs="unbounded">
      <xs:complexType>
        <xs:attribute name="ImpedanceInOhm" type="xs:double">
          <xs:annotation>
            <xs:documentation>Denotes the impedances which together with SwitchOffTimeInSeconds define the settings of the protection device. Multiple entries possible. Required for: - Protection calculation</xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="SwitchOffTimeInSeconds" type="xs:double">
          <xs:annotation>
            <xs:documentation>Denotes the time which together with ImpedanceInOhm define the settings of the protection device. Multiple entries possible. Required for: - Protection calculation</xs:documentation>
          </xs:annotation>
        </xs:attribute>
      </xs:complexType>
    </xs:element>

[ 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/STATION/Station/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 ShapeTypeEnum

Diagram |
Type | restriction of xs:string
Facets |
enumeration | Point |
    Shape type "Point" needs exactly one "Point" element in its child node "Points".
enumeration | Line |
    Shape type "Line" needs two or more "Point" elements in its child node "Points".
enumeration | Polygon |
    Shape type "Polygon" three or more "Point" elements needs in its child node "Points".
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 exactly one "Point" element in its child node "Points".</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Line">
          <xs:annotation>
            <xs:documentation>Shape type "Line" needs two or more "Point" elements in its child node "Points".</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Polygon">
          <xs:annotation>
            <xs:documentation>Shape type "Polygon" three or more "Point" elements needs in its child node "Points".</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
      </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, Connection, Transformer) all IDs must be unique among all branch types. E.g., a line must not have the same ID as a transformer.
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/STATION/Station/@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, Connection, Transformer) all IDs must be unique among all branch types. E.g., a line must not have the same ID as a transformer.</xs:documentation>
      </xs:annotation>
      <xs:restriction base="xs:string">
        <xs:pattern value="[a-zA-Z0-9_@]+"/>
      </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 otherwise 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 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 types of 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 otherwise 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 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 types of buses that don't match any of the above types.</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 ]
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 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 ]
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 (minimum and maximum power in Megawatt).
enumeration | P_Q_CHARACTERISTIC |
    The user can define a curve that links active power 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 power to a cosPhi. The active power is calcuated from 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 curve.
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 from 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 (minimum and maximum power in Megawatt).</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="P_Q_CHARACTERISTIC">
          <xs:annotation>
            <xs:documentation>The user can define a curve that links active power 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 power to a cosPhi. The active power is calcuated from 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 curve.</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 electric heating is very inefficient, it 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 battery 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 electric heating is very inefficient, it 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 battery 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 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, 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 reservoir (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, 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 reservoir (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 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 photovoltaics.
enumeration | Synchronous Machine |
    Synchronous generators have an efficiency and are typically used in large power plants (such as hydro or nuclear power plants).
enumeration | Asynchronous Machine |
    Asynchronous machines are sometimes used in small generators (Diesel generators, 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>Describes 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 photovoltaics.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Synchronous Machine">
          <xs:annotation>
            <xs:documentation>Synchronous generators have an efficiency and are typically used in large power plants (such as hydro or nuclear power plants).</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Asynchronous Machine">
          <xs:annotation>
            <xs:documentation>Asynchronous machines are sometimes used in small generators (Diesel generators, 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 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 star point is connected to ground by a (low resistance) cable.
enumeration | Resonant grounding |
    The star point is connected to ground by an inductor.
enumeration | Insulated grid |
    The star 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 star 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 star point is connected to ground by an inductor.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Insulated grid">
          <xs:annotation>
            <xs:documentation>The star point is not connected to ground (insulated).</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 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 more slowly than connection fuses, 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 dimensioned 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 more slowly than connection fuses, 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 dimensioned 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 ]
Complex Type ProtectionDevice

Diagram |
Used by |
Element | GRID/PROTECTIONDEVICE/ProtectionDevice
Complex Types | DefiniteTimeOvercurrentProtection, DistanceProtection
Attributes |
QName | Type | Use | Annotation
--- | --- | --- | ---
ConstructionYear | xs:integer | optional |
    The year that the component was built in the field. Only used for information purposes.

    No requirement.
Description | xs:string | optional |
    A human-readable description.

    No requirement.
Direction | ProtectionDeviceDirection | optional |
    The direction of the current for which the protection device should trip in the case of a short-circuit.
    Defaults to 'Undirected'.

    No requirement.
ExternalURL | xs:anyURI | optional |
    URL that is displayed in our system. Can be used for switching to an external system.

    No requirement.
HostSwitchID | StringID | optional |
    ID of the switch where the protection device is connected to. Previously called 'HostCircuitBreakerID'.

    Required.
ID | StringID | required |
    ID (see type StringID). Each ProtectionDevice requires a unique ID among all ProtectionDevices.

    Hard requirement.
Name | xs:string | optional |
    A human-readable name.

    No requirement.
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. Hard requirement.</xs:documentation>
        </xs:annotation>
      </xs:attribute>
      <xs:attribute name="Name" type="xs:string">
        <xs:annotation>
          <xs:documentation>A human-readable name. No requirement.</xs:documentation>
        </xs:annotation>
      </xs:attribute>
      <xs:attribute name="Description" type="xs:string">
        <xs:annotation>
          <xs:documentation>A human-readable description. No requirement.</xs:documentation>
        </xs:annotation>
      </xs:attribute>
      <xs:attribute name="ConstructionYear" type="xs:integer">
        <xs:annotation>
          <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
        </xs:annotation>
      </xs:attribute>
      <xs:attribute name="ExternalURL" type="xs:anyURI">
        <xs:annotation>
          <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
        </xs:annotation>
      </xs:attribute>
      <xs:attribute name="Direction" type="ProtectionDeviceDirection">
        <xs:annotation>
          <xs:documentation>The direction of the current for which the protection device should trip in the case of a short-circuit. Defaults to 'Undirected'. No requirement.</xs:documentation>
        </xs:annotation>
      </xs:attribute>
      <xs:attribute name="HostSwitchID" type="StringID">
        <xs:annotation>
          <xs:documentation>ID of the switch where the protection device is connected to. Previously called 'HostCircuitBreakerID'. Required.</xs:documentation>
        </xs:annotation>
      </xs:attribute>
    </xs:complexType>

[ 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 ]
Simple Type StationTypeEnum

Annotations |
    The type of the station.
    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 | Substation |
    A substation is a high-voltage electric system facility.
    It is used to switch generators, equipment, and circuits or lines in and out of a system.
    It also is used to change AC voltages from one level to another, and/or change alternating
    current to direct current or direct current to alternating current.
enumeration | Other |
    Other type of station that don't match any of the above types.
Used by |
Attribute | GRID/STATION/Station/@Type
Source |
    <xs:simpleType name="StationTypeEnum">
      <xs:annotation>
        <xs:documentation>The type of the station. 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="Substation">
          <xs:annotation>
            <xs:documentation>A substation is a high-voltage electric system facility. It is used to switch generators, equipment, and circuits or lines in and out of a system. It also is used to change AC voltages from one level to another, and/or change alternating current to direct current or direct current to alternating current.</xs:documentation>
          </xs:annotation>
        </xs:enumeration>
        <xs:enumeration value="Other">
          <xs:annotation>
            <xs:documentation>Other type of station that don't match any of the above types.</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 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 ]
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 |
    The year that the component was built in the field. Only used for information purposes.

    No requirement.
Description | xs:string | optional |
    A human-readable description.

    No requirement.
Direction | ProtectionDeviceDirection | optional |
    The direction of the current for which the protection device should trip in the case of a short-circuit.
    Defaults to 'Undirected'.

    No requirement.
ExternalURL | xs:anyURI | optional |
    URL that is displayed in our system. Can be used for switching to an external system.

    No requirement.
HostSwitchID | StringID | optional |
    ID of the switch where the protection device is connected to. Previously called 'HostCircuitBreakerID'.

    Required.
ID | StringID | required |
    ID (see type StringID). Each ProtectionDevice requires a unique ID among all ProtectionDevices.

    Hard requirement.
Name | xs:string | optional |
    A human-readable name.

    No requirement.
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 pairs, which 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. Required for: - Protection calculation</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. Required for: - Protection calculation</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 |
    The year that the component was built in the field. Only used for information purposes.

    No requirement.
Description | xs:string | optional |
    A human-readable description.

    No requirement.
Direction | ProtectionDeviceDirection | optional |
    The direction of the current for which the protection device should trip in the case of a short-circuit.
    Defaults to 'Undirected'.

    No requirement.
DirectionalFinalTimeInSeconds | xs:double | optional |
    When a distance protection device recognizes a fault in its direction,
    this is the time after which the device sends a second switch-open signal to the circuit breaker if the first one did not work for some reason.

    Required for:
    	- Protection calculation
ExternalURL | xs:anyURI | optional |
    URL that is displayed in our system. Can be used for switching to an external system.

    No requirement.
HostSwitchID | StringID | optional |
    ID of the switch where the protection device is connected to. Previously called 'HostCircuitBreakerID'.

    Required.
ID | StringID | required |
    ID (see type StringID). Each ProtectionDevice requires a unique ID among all ProtectionDevices.

    Hard requirement.
MaxStages | xs:integer | optional |
    The maximum number of stages that can be configured in the device.

    Required for:
    	- Protection calculation
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.

    Required for:
    	- Protection calculation
Name | xs:string | optional |
    A human-readable name.

    No requirement.
NonDirectionalFinalTimeInSeconds | xs:double | optional |
    The swich-off time when a fault in backwards direction is detected.

    Required for:
    	- Protection calculation
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.

    Required for:
    	- Protection calculation
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, for which 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 is low) are cleared faster than distant faults (measured impedance is high). This distance-time dependency is expressed as list of distance-time pairs, which discribes a step-shaped curve. Stages of DistanceProtection devices work analogously to the stages of DefiniteTimeOvercurrentProtection devices with the difference that 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:annotation>
                          <xs:documentation>Denotes the impedances which together with SwitchOffTimeInSeconds define the settings of the protection device. Multiple entries possible. Required for: - Protection calculation</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                      <xs:attribute name="SwitchOffTimeInSeconds" type="xs:double">
                        <xs:annotation>
                          <xs:documentation>Denotes the time which together with ImpedanceInOhm define the settings of the protection device. Multiple entries possible. Required for: - Protection calculation</xs:documentation>
                        </xs:annotation>
                      </xs:attribute>
                    </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 its direction, this is the time after which the device sends a second switch-open signal to the circuit breaker if the first one did not work for some reason. Required for: - Protection calculation</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. Required for: - Protection calculation</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. Required for: - Protection calculation</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. Required for: - Protection calculation</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. Required for: - Protection calculation</xs:documentation>
            </xs:annotation>
          </xs:attribute>
        </xs:extension>
      </xs:complexContent>
    </xs:complexType>

[ 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 exactly one "Point" element in its child node "Points".
enumeration | Line |
    Shape type "Line" needs two or more "Point" elements in its child node "Points".
enumeration | Polygon |
    Shape type "Polygon" three or more "Point" elements needs in its child node "Points".
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.

    Hard requirement.
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. Hard requirement.</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.

    No requirement.
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. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable name.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="Name" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable description.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="Description" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable description. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    The year that the component was built in the field. Only used for information purposes.

    No requirement.
Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer">
      <xs:annotation>
        <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    URL that is displayed in our system. Can be used for switching to an external system.

    No requirement.
Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI">
      <xs:annotation>
        <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ 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.

    No requirement.
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. No requirement.</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.

    No requirement.
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 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 types of 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. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    The nominal voltage of the grid node (as defined by the voltage level).

    Required for:
    	- All calculations
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="BaseVoltageInKilovolt" type="xs:double">
      <xs:annotation>
        <xs:documentation>The nominal voltage of the grid node (as defined by the voltage level). Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Time required to deenergize underlying transformer station in case of fault.

    Required for:
    	- Protection calculation (only for certain setups; not necessarily required)
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. Required for: - Protection calculation (only for certain setups; not necessarily required)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    The ID of the station, if this bus belongs to a station.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="StationID" type="xs:string">
      <xs:annotation>
        <xs:documentation>The ID of the station, if this bus belongs to a station. No requirement.</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.

    Required for:
    	- Display in schematic view (ony for customer specific schematic visualization; default schematic coordinates are calculated from geo-coordinates)
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. Required for: - Display in schematic view (ony for customer specific schematic visualization; default schematic coordinates are calculated from geo-coordinates)</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.

    Required for:
    	- Display in schematic view (ony for customer specific schematic visualization; default schematic coordinates are calculated from geo-coordinates)
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. Required for: - Display in schematic view (ony for customer specific schematic visualization; default schematic coordinates are calculated from geo-coordinates)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

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.

    Required for:
    	- Reliability calculations
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/BUSBAR_NODE/Node
Source |
    <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</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).

    Hard requirement.
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). Hard requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable name.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="Name" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable description.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="Description" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable description. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    The year that the component was built in the field. Only used for information purposes.

    No requirement.
Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer">
      <xs:annotation>
        <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    URL that is displayed in our system. Can be used for switching to an external system.

    No requirement.
Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI">
      <xs:annotation>
        <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Can be fetched from the Component Library if resistance and reactance values are not given in the xml.

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

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

Annotations |
    Can be fetched from the Component Library if resistance and reactance values are not given in the xml.

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

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

Annotations |
    If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor.

    Required for:
    	- Short circuit calculations involving ground faults (but it will be derived from positive sequence impedance if missing)
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="ZeroSequenceResistanceInOhmPerKilometer" type="xs:double">
      <xs:annotation>
        <xs:documentation>If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor. Required for: - Short circuit calculations involving ground faults (but it will be derived from positive sequence impedance if missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor.

    Required for:
    	- Short circuit calculations involving ground faults (but it will be derived from positive sequence impedance if missing)
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="ZeroSequenceReactanceInOhmPerKilometer" type="xs:double">
      <xs:annotation>
        <xs:documentation>If undefined, zero sequence impedance is linked to positive sequence impedance using a constant factor. Required for: - Short circuit calculations involving ground faults (but it will be derived from positive sequence impedance if missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Maximum rated current of the line in Ampere, used to calculate the loading.
    Can be fetched from the Component Library if the value is not given in the xml.

    Required for:
    	- All calculations (calculations can be carried out without it but the line loading cannot be determined)
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="MaximumCurrentInAmpere" type="xs:double">
      <xs:annotation>
        <xs:documentation>Maximum rated current of the line in Ampere, used to calculate the loading. Can be fetched from the Component Library if the value is not given in the xml. Required for: - All calculations (calculations can be carried out without it but the line loading cannot be determined)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Parameter denoting the maximal three phase aperiodic short circuit current the line can withstand.

    Required for:
    	- Short circuit calculations of maximal three phase aperiodic short circuits (but it will be derived from other parameters if missing)
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="ShortCircuitStabilityThreePhaseInKiloampere" type="xs:double">
      <xs:annotation>
        <xs:documentation>Parameter denoting the maximal three phase aperiodic short circuit current the line can withstand. Required for: - Short circuit calculations of maximal three phase aperiodic short circuits (but it will be derived from other parameters if missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Shunt capacitance of the line in Microfarad per kilometer, used for calculating the shunt admittances.
    Can be fetched from the Component Library if the value is not given in the xml.

    Required for:
    	- Power flow based functionalities (makes it more accurate but is not strictly necessary)
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="ShuntCapacitanceInMicrofaradPerKilometer" type="xs:double">
      <xs:annotation>
        <xs:documentation>Shunt capacitance of the line in Microfarad per kilometer, used for calculating the shunt admittances. Can be fetched from the Component Library if the value is not given in the xml. Required for: - Power flow based functionalities (makes it more accurate but is not strictly necessary)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Length of the line in kilometers, used for computing the absolute line parameters.

    Required for:
    	- All calculations
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="LengthInKilometer" type="xs:double">
      <xs:annotation>
        <xs:documentation>Length of the line in kilometers, used for computing the absolute line parameters. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ 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).

    Required for:
    	- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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).

    													Required for:
    														- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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.

    Required for:
    	- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
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. Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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).

    Required for:
    	- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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).

    Required for:
    	- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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.

    Required for:
    	- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
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. Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    ID of bus 1 that the line is connected to.

    Required for:
    	- All calculations
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 the line is connected to. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    ID of bus 2 that the line is connected to.

    Required for:
    	- All calculations
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 the line is connected to. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Denotes whether the line is electrically connected at Bus 1.
    true if the switch is closed (connected) at
    bus 1, false if the switch is open (not connected).
    Default value is true.

    Required for:
    	- All calculations (calculations are run with the default value if missing)
Type | xs:boolean
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
      <xs:annotation>
        <xs:documentation>Denotes whether the line is electrically connected at Bus 1. true if the switch is closed (connected) at bus 1, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Denotes whether the line is electrically connected at Bus 2.
    true if the switch is closed (connected) at
    bus 2, false if the switch is open (not connected).
    Default value is true.

    Required for:
    	- All calculations (calculations are run with the default value if missing)
Type | xs:boolean
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
      <xs:annotation>
        <xs:documentation>Denotes whether the line is electrically connected at Bus 2. true if the switch is closed (connected) at bus 2, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</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.

    No requirement.
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. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

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.

    Required for:
    	- Reliability calculations
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/LINE/Line
Source |
    <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</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).

    Hard requirement.
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). Hard requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable name.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/CONNECTION/Connection
Source |
    <xs:attribute name="Name" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable description.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/CONNECTION/Connection
Source |
    <xs:attribute name="Description" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable description. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    The year that the component was built in the field.
    Only used for information purposes.

    No requirement.
Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/CONNECTION/Connection
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer">
      <xs:annotation>
        <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    URL that is displayed in our system.
    Can be used for switching to an external system.

    No requirement.
Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/CONNECTION/Connection
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI">
      <xs:annotation>
        <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Resistance in mΩ. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided,
    the connection has a minimal resistance of 0.01 mΩ (for numerical reasons).

    Required for:
    	- All calculations (calculations are run with the default value if missing)
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Ω. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided, the connection has a minimal resistance of 0.01 mΩ (for numerical reasons). Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Reactance in mΩ. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided,
    	the connection has a minimal resistance of 0.01 mΩ (for numerical reasons).

    Required for:
    		- All calculations ((calculations are run with the default value if missing)
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Ω. If neither ResistanceInMilliOhm nor ReactanceInMilliOhm are provided, the connection has a minimal resistance of 0.01 mΩ (for numerical reasons). Required for: - All calculations ((calculations are run with the default value if missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    ID of bus 1 that the connection element it is connected to.

    Required for:
    		- All calculations
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 the connection element it is connected to. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    ID of bus 2 that the connection element it is connected to.

    Required for:
    		- All calculations
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 the connection element it is connected to. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    true if the switch is closed (connected) at
    bus 1, false if the switch is open (not connected). Default value is true.

    Required for:
    	- All calculations (calculations are run with the default value if missing)
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 the switch is closed (connected) at bus 1, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    true if the switch is closed (connected) at
    bus 2, false if the switch is open (not connected). Default value is true.

    Required for:
    	- All calculations (calculations are run with the default value if missing)
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 the switch is closed (connected) at bus 2, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</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.

    No requirement.
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. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

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.

    Required for:
    	- Reliability calculations
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/CONNECTION/Connection
Source |
    <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</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.

    Hard requirement.
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. Hard requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable name.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/VOLTAGEREGULATOR/VoltageRegulator
Source |
    <xs:attribute name="Name" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable description.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/VOLTAGEREGULATOR/VoltageRegulator
Source |
    <xs:attribute name="Description" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable description. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    The year that the component was built in the field.
    Only used for information purposes.

    No requirement.
Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/VOLTAGEREGULATOR/VoltageRegulator
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer">
      <xs:annotation>
        <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    URL that is displayed in our system.
    Can be used for switching to an external system.

    No requirement.
Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/VOLTAGEREGULATOR/VoltageRegulator
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI">
      <xs:annotation>
        <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    ID of the line that the voltage regulator is installed at.

    Required for:
    	- All calculations
Type | StringID
Properties |
content | simple
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/VOLTAGEREGULATOR/VoltageRegulator
Source |
    <xs:attribute name="HostLineID" type="StringID">
      <xs:annotation>
        <xs:documentation>ID of the line that the voltage regulator is installed at. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Number of taps of the transformer (both upward and downward).

    Required for:
    	- All calculations
Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/VOLTAGEREGULATOR/VoltageRegulator
Source |
    <xs:attribute name="NumTaps" type="xs:integer">
      <xs:annotation>
        <xs:documentation>Number of taps of the transformer (both upward and downward). Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Size of each tap in terms of voltage change.

    Required for:
    	- All calculations
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/VOLTAGEREGULATOR/VoltageRegulator
Source |
    <xs:attribute name="TapSizeFractionInPercent" type="xs:double">
      <xs:annotation>
        <xs:documentation>Size of each tap in terms of voltage change. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Dead-band of the hysteresis controller that switches the taps.

    Required for:
    	- All calculations
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/VOLTAGEREGULATOR/VoltageRegulator
Source |
    <xs:attribute name="DeadBandFractionInPercent" type="xs:double">
      <xs:annotation>
        <xs:documentation>Dead-band of the hysteresis controller that switches the taps. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    This defines the desired voltage in per unit at the measured bus.

    Required for:
    	- All calculations
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. Required for: - All calculations</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 (minimum and maximum power in Megawatt).
enumeration | P_Q_CHARACTERISTIC |
    The user can define a curve that links active power 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 power to a cosPhi. The active power is calcuated from 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 curve.
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 GRID / LOAD / Load / @ID

Annotations |
    ID (see type StringID). Each Load requires a unique ID among all Loads.

    Hard requirement.
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. Hard requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable name.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/LOAD/Load
Source |
    <xs:attribute name="Name" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable description

    												No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/LOAD/Load
Source |
    <xs:attribute name="Description" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable description No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    The year that the component was built in the field.
    Only used for information purposes.

    No requirement.
Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/LOAD/Load
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer">
      <xs:annotation>
        <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    URL that is displayed in our system.
    Can be used for switching to an external system.

    No requirement.
Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/LOAD/Load
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI">
      <xs:annotation>
        <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Denotes the allowed load categories.

    No requirement.
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 electric heating is very inefficient, it 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 battery 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">
      <xs:annotation>
        <xs:documentation>Denotes the allowed load categories. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Active power in MW that the load consumes from the grid (should normally be positive).

    Required for:
    	- All calculations
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/LOAD/Load
Source |
    <xs:attribute name="ActiveLoadInMegawatt" type="xs:double">
      <xs:annotation>
        <xs:documentation>Active power in MW that the load consumes from the grid (should normally be positive). Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    ID of the Bus that the load is connected to.

    Required for:
    	- All calculations
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 the Bus that the load is connected to. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Denotes whether the load is electrically connected.
    true if the switch is closed (connected), false if the switch is open (not connected). Defaults to true.

    Required for:
    	- All calculations (calculations are run with the default value if missing)
Type | xs:boolean
Properties |
content | simple
Used by |
Element | GRID/LOAD/Load
Source |
    <xs:attribute name="Connected" type="xs:boolean">
      <xs:annotation>
        <xs:documentation>Denotes whether the load is electrically connected. true if the switch is closed (connected), false if the switch is open (not connected). Defaults to true. Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration.

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

    Hard requirement.
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. Hard requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable name.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="Name" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable description.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="Description" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable description. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    The year that the component was built in the field.
    Only used for information purposes.

    No requirement.
Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer">
      <xs:annotation>
        <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    URL that is displayed in our system.
    Can be used for switching to an external system.

    No requirement.
Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI">
      <xs:annotation>
        <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Denotes the allowed categories of generation devices.

    No requirement.
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, 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 reservoir (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">
      <xs:annotation>
        <xs:documentation>Denotes the allowed categories of generation devices. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Denotes the type of the connection to the grid.

    Required for:
    	- Short circuit calculations (makes them more accurate)
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 photovoltaics.
enumeration | Synchronous Machine |
    Synchronous generators have an efficiency and are typically used in large power plants (such as hydro or nuclear power plants).
enumeration | Asynchronous Machine |
    Asynchronous machines are sometimes used in small generators (Diesel generators, 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">
      <xs:annotation>
        <xs:documentation>Denotes the type of the connection to the grid. Required for: - Short circuit calculations (makes them more accurate)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Active power in MW that the generator injects into the grid (should normally be positive).

    Required for:
    	- All calculations
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="ActiveGenerationInMegawatt" type="xs:double">
      <xs:annotation>
        <xs:documentation>Active power in MW that the generator injects into the grid (should normally be positive). Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Currently not supported.

    No requirement.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="MinReactiveGenerationInMegavar" type="xs:double">
      <xs:annotation>
        <xs:documentation>Currently not supported. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Currently not supported.

    No requirement.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="MaxReactiveGenerationInMegavar" type="xs:double">
      <xs:annotation>
        <xs:documentation>Currently not supported. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Currently not supported.

    No requirement.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="MinActiveGenerationInMegawatt" type="xs:double">
      <xs:annotation>
        <xs:documentation>Currently not supported. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Currently not supported.

    No requirement.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="MaxActiveGenerationInMegawatt" type="xs:double">
      <xs:annotation>
        <xs:documentation>Currently not supported. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Currently not supported.

    No requirement.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="VoltageSetpointInKilovolt" type="xs:double">
      <xs:annotation>
        <xs:documentation>Currently not supported. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    ID of Bus that the generator is connected to.

    Required for:
    	- All calculations
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 that the generator is connected to. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Denotes whether the generator is electrically connected.
    true if the switch is closed (connected), false if the switch is open (not connected).

    Required for:
    	- All calculations (calculations are run with the default value if missing)
Type | xs:boolean
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="Connected" type="xs:boolean">
      <xs:annotation>
        <xs:documentation>Denotes whether the generator is electrically connected. true if the switch is closed (connected), false if the switch is open (not connected). Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    If set to the ID of a connection request, the corresponding request is automatically closed when the grid is imported via grid data integration.

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

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

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.

    Required for:
    	- Reliability calculations
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/GENERATOR/Generator
Source |
    <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</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).

    Hard requirement.
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). Hard requirement.</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).

    Required for:
    	- All calculations if the transformer is tap-changing
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). Required for: - All calculations if the transformer is tap-changing</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable name.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="Name" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable description.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="Description" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable description. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ 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.

    No requirement.
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. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    The year that the component was built in the field.
    Only used for information purposes.

    No requirement.
Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer">
      <xs:annotation>
        <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    URL that is displayed in our system.
    Can be used for switching to an external system.

    No requirement.
Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI">
      <xs:annotation>
        <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Vector group (Schaltgruppe) of transformer, e.g. Dyn5.

    Required for:
    	- Short circuit calculations
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. Required for: - Short circuit calculations</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.

    Required for:
    	- Short circuit calculations in case transformer vector group has a star point
Type | StarPointGrounding
Properties |
content | simple
Facets |
enumeration | Direct grounding |
    The star point is connected to ground by a (low resistance) cable.
enumeration | Resonant grounding |
    The star point is connected to ground by an inductor.
enumeration | Insulated grid |
    The star 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. Required for: - Short circuit calculations in case transformer vector group has a star point</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.

    Required for:
    	- Short circuit calculations if transformer grounding type is 'Resonant grounding'
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. Required for: - Short circuit calculations if transformer grounding type is 'Resonant grounding'</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml.

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

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

Annotations |
    Maximum allowed apparent power. Usually the same as the transformer rating.
    Can be fetched from the Component Library.

    Required for:
    	- All calculations
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="MaximumApparentPowerInMegavoltampere" type="xs:double">
      <xs:annotation>
        <xs:documentation>Maximum allowed apparent power. Usually the same as the transformer rating. Can be fetched from the Component Library. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml.

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

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

Annotations |
    It can be fetched from the Component Library if short circuit voltage and copper losses values are not given in the xml.

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

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

Annotations |
    Rated transformer voltage on the side of Bus 1 in Kilovolt.
    Used for calculation of the turns ratio.

    Required for:
    	- All calculations (defaults to the value of the bus voltage if missing)
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. Used for calculation of the turns ratio. Required for: - All calculations (defaults to the value of the bus voltage if missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Rated transformer voltage on the side of Bus 2 in Kilovolt.
    Used for calculation of the turns ratio.

    Required for:
    	- All calculations (defaults to the value of the bus voltage if missing)
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. Used for calculation of the turns ratio. Required for: - All calculations (defaults to the value of the bus voltage if missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    True, if transformer is a tap-changing transformer.

    Required for:
    	- All calculations if transformer is tap changing
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. Required for: - All calculations if transformer is tap changing</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    For tap-changing transformers, it defines the number of taps.

    Required for:
    	- All calculations if transformer is tap changing
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. Required for: - All calculations if transformer is tap changing</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    For tap-changing transformers, it defines the tap size in percent (%).

    Required for:
    	- All calculations if transformer is tap changing
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 (%). Required for: - All calculations if transformer is tap changing</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    For tap-changing transformers, it defines the dead band of the hysteresis controller in percent (%).

    Required for:
    	- All calculations if transformer is tap changing
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 of the hysteresis controller in percent (%). Required for: - All calculations if transformer is tap changing</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.

    Required for:
    	- All calculations if transformer is tap changing
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. Required for: - All calculations if transformer is tap changing</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)

    Required for:
    	- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
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) Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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)

    Required for:
    	- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
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) Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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).

    Required for:
    	- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</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).

    Required for:
    	- Component library matching (not all parameters for component library matching are necessary to be present simultaneously)
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). Required for: - Component library matching (not all parameters for component library matching are necessary to be present simultaneously)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    ID of bus 1 that the transformer is connected to.

    Required for:
    	- All calculations
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 the transformer is connected to. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    ID of bus 2 that the transformer is connected to.

    Required for:
    	- All calculations
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 the transformer is connected to. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Denotes whether the transformer is electrically connected.
    true if the switch is closed (connected) at
    bus 1, false if the switch is open (not connected).
    Default value is true.

    Required for:
    	- All calculations (calculations are run with the default value if missing)
Type | xs:boolean
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="ConnectedAtBus1" type="xs:boolean">
      <xs:annotation>
        <xs:documentation>Denotes whether the transformer is electrically connected. true if the switch is closed (connected) at bus 1, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Denotes whether the transformer is electrically connected.
    true if the switch is closed (connected) at
    bus 2, false if the switch is open (not connected).
    Default value is true.

    Required for:
    	- All calculations (calculations are run with the default value if missing)
Type | xs:boolean
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="ConnectedAtBus2" type="xs:boolean">
      <xs:annotation>
        <xs:documentation>Denotes whether the transformer is electrically connected. true if the switch is closed (connected) at bus 2, false if the switch is open (not connected). Default value is true. Required for: - All calculations (calculations are run with the default value if missing)</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.

    No requirement.
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. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

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.

    Required for:
    	- Reliability calculations
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/TRANSFORMER/Transformer
Source |
    <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    ID (see type StringID).

    Hard requirement.
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). Hard requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable name.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="Name" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Bus ID of the bus that the network feeder is attached to.
    Becomes the slack bus of the power flow model.

    Required for:
    	- All calculations
Type | StringID
Properties |
content | simple
Facets |
pattern | [a-zA-Z0-9_@]+ |
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="HostBusID" type="StringID">
      <xs:annotation>
        <xs:documentation>Bus ID of the bus that the network feeder is attached to. Becomes the slack bus of the power flow model. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable documentation

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="Description" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable documentation No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    The year that the component was built in the field.
    Only used for information purposes.

    No requirement.
Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer">
      <xs:annotation>
        <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    URL that is displayed in our system.
    Can be used for switching to another system.

    No requirement.
Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI">
      <xs:annotation>
        <xs:documentation>URL that is displayed in our system. Can be used for switching to another system. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Sets the voltage of the slack bus and consequently influences the power flow behavior of the entire grid.

    Required for:
    	- All calculations
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="OperationalVoltageInPerUnit" type="xs:double">
      <xs:annotation>
        <xs:documentation>Sets the voltage of the slack bus and consequently influences the power flow behavior of the entire grid. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Can be set to arbitrary value (e.g. zero) since only the angle differences within the grid matter for the power flow.

    Required for:
    	- All calculations
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="OperationalAngleInRadians" type="xs:double">
      <xs:annotation>
        <xs:documentation>Can be set to arbitrary value (e.g. zero) since only the angle differences within the grid matter for the power flow. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Denotes the voltage multiplier for computation of maximum short-circuit currents according to IEC 60909.
    Not supported yet (currently, a default value of 1 is used).

    No requirement.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="VoltageFactorMax" type="xs:double">
      <xs:annotation>
        <xs:documentation>Denotes the voltage multiplier for computation of maximum short-circuit currents according to IEC 60909. Not supported yet (currently, a default value of 1 is used). No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Denotes the voltage multiplier for computation of minimum short-circuit currents according to IEC 60909.
    Not supported yet (currently, a default value of 1 is used).

    No requirement.
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="VoltageFactorMin" type="xs:double">
      <xs:annotation>
        <xs:documentation>Denotes the voltage multiplier for computation of minimum short-circuit currents according to IEC 60909. Not supported yet (currently, a default value of 1 is used). No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Denotes the maximum short-circuit power of the overlying grid according to IEC 60909.

    Required for:
    	- Short circuit calculations
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="MaxSourceShortCircuitPowerInMegavoltampere" type="xs:double">
      <xs:annotation>
        <xs:documentation>Denotes the maximum short-circuit power of the overlying grid according to IEC 60909. Required for: - Short circuit calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Denotes the minimum short-circuit power of the overlying grid according to IEC 60909.

    Required for:
    	- Short circuit calculations
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="MinSourceShortCircuitPowerInMegavoltampere" type="xs:double">
      <xs:annotation>
        <xs:documentation>Denotes the minimum short-circuit power of the overlying grid according to IEC 60909. Required for: - Short circuit calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Denotes the X/R ratio of the overlying grid.

    Required for:
    	- Short circuit calculations
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="ReactanceToResistanceRatio" type="xs:double">
      <xs:annotation>
        <xs:documentation>Denotes the X/R ratio of the overlying grid. Required for: - Short circuit calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Denotes whether the network feeder is electrically connected.
    true if the switch is closed (connected) at the
    host bus, false if the switch is open (not connected).

    Required for:
    	- All calculations (calculations are run with the default value of 'true' if missing)
Type | xs:boolean
Properties |
content | simple
Used by |
Element | GRID/FEEDER/Feeder
Source |
    <xs:attribute name="Connected" type="xs:boolean">
      <xs:annotation>
        <xs:documentation>Denotes whether the network feeder is electrically connected. true if the switch is closed (connected) at the host bus, false if the switch is open (not connected). Required for: - All calculations (calculations are run with the default value of 'true' if missing)</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.

    Hard requirement.
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. Hard requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable name.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/FUSE/Fuse
Source |
    <xs:attribute name="Name" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable description.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/FUSE/Fuse
Source |
    <xs:attribute name="Description" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable description. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    The year that the component was built in the field.
    Only used for information purposes.

    No requirement.
Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/FUSE/Fuse
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer">
      <xs:annotation>
        <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    URL that is displayed in our system.
    Can be used for switching to an external system.

    No requirement.
Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/FUSE/Fuse
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI">
      <xs:annotation>
        <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    ID of the branch that the fuse is connected to (required).

    Required for:
    	- All calculations
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). Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    The branch end that the fuse is connected to (Bus1 or Bus2).
    Default value is 'Bus1'.

    Required for:
    	- All calculations
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 (Bus1 or Bus2). Default value is 'Bus1'. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Denoting the type of fuse.
    Possible entries: Grid (installed in the distribution grid),
    Connection (installed at a connection point, e.g. house)

    Required for:
    	- Protection calculations
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 more slowly than connection fuses, 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 dimensioned 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">
      <xs:annotation>
        <xs:documentation>Denoting the type of fuse. Possible entries: Grid (installed in the distribution grid), Connection (installed at a connection point, e.g. house) Required for: - Protection calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Unique name that identifies the fuse in the component library.

    Required for:
    	- Component library matching
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/FUSE/Fuse
Source |
    <xs:attribute name="LibraryFuseName" type="xs:string">
      <xs:annotation>
        <xs:documentation>Unique name that identifies the fuse in the component library. Required for: - Component library matching</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute ProtectionDevice / @ID

Annotations |
    ID (see type StringID). Each ProtectionDevice requires a unique ID among all ProtectionDevices.

    Hard requirement.
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. Hard requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute ProtectionDevice / @Name

Annotations |
    A human-readable name.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Complex Type | ProtectionDevice
Source |
    <xs:attribute name="Name" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute ProtectionDevice / @Description

Annotations |
    A human-readable description.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Complex Type | ProtectionDevice
Source |
    <xs:attribute name="Description" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable description. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute ProtectionDevice / @ConstructionYear

Annotations |
    The year that the component was built in the field. Only used for information purposes.

    No requirement.
Type | xs:integer
Properties |
content | simple
Used by |
Complex Type | ProtectionDevice
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer">
      <xs:annotation>
        <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute ProtectionDevice / @ExternalURL

Annotations |
    URL that is displayed in our system. Can be used for switching to an external system.

    No requirement.
Type | xs:anyURI
Properties |
content | simple
Used by |
Complex Type | ProtectionDevice
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI">
      <xs:annotation>
        <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute ProtectionDevice / @Direction

Annotations |
    The direction of the current for which the protection device should trip in the case of a short-circuit.
    Defaults to 'Undirected'.

    No requirement.
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">
      <xs:annotation>
        <xs:documentation>The direction of the current for which the protection device should trip in the case of a short-circuit. Defaults to 'Undirected'. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute ProtectionDevice / @HostSwitchID

Annotations |
    ID of the switch where the protection device is connected to. Previously called 'HostCircuitBreakerID'.

    Required.
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. Previously called 'HostCircuitBreakerID'. Required.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    ID (see type StringID). Each Switch requires a unique ID among all Switches.

    Hard requirement.
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. Hard requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable name.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/SWITCH/Switch
Source |
    <xs:attribute name="Name" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable description.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/SWITCH/Switch
Source |
    <xs:attribute name="Description" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable description. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Type of the switch.

    Required for:
    	- All calculations
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">
      <xs:annotation>
        <xs:documentation>Type of the switch. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Specificaties if the switch is placed at bus1 or bus2 of its host edge:
    “Bus1”, “Bus2”.

    Required for:
    	- All calculations
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">
      <xs:annotation>
        <xs:documentation>Specificaties if the switch is placed at bus1 or bus2 of its host edge: “Bus1”, “Bus2”. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    ID of the branch, which the switch is allocated to.

    Required for:
    	- All calculations
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/SWITCH/Switch
Source |
    <xs:attribute name="HostBranchID" type="xs:string">
      <xs:annotation>
        <xs:documentation>ID of the branch, which the switch is allocated to. Required for: - All calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    No requirement.
    Optional for:
    	- Protection calculation
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/SWITCH/Switch
Source |
    <xs:attribute name="MaxAperiodicShortCircuitCurrentInKiloampere" type="xs:double">
      <xs:annotation>
        <xs:documentation>No requirement. Optional for: - Protection calculation</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    The year that the component was built in the field. Only used for information purposes.

    No requirement.
Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/SWITCH/Switch
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer">
      <xs:annotation>
        <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    URL that is displayed in our system.
    Can be used for switching to an external system.

    No requirement.
Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/SWITCH/Switch
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI">
      <xs:annotation>
        <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

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.

    Required for:
    	- Reliability calculations
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/SWITCH/Switch
Source |
    <xs:attribute name="LibraryReliabilityName" 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. Required for: - Reliability calculations</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / STATION / Station / @ID

Annotations |
    ID (see type StringID). Each station requires a unique ID among all stations.

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

[ top ]
Attribute GRID / STATION / Station / @Name

Annotations |
    A human-readable name.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/STATION/Station
Source |
    <xs:attribute name="Name" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / STATION / Station / @Description

Annotations |
    A human-readable description.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/STATION/Station
Source |
    <xs:attribute name="Description" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable description. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / STATION / Station / @ConstructionYear

Annotations |
    The year that the component was built in the field. Only used for information purposes.

    No requirement.
Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/STATION/Station
Source |
    <xs:attribute name="ConstructionYear" type="xs:integer">
      <xs:annotation>
        <xs:documentation>The year that the component was built in the field. Only used for information purposes. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / STATION / Station / @ExternalURL

Annotations |
    URL that is displayed in our system.
    Can be used for switching to an external system.

    No requirement.
Type | xs:anyURI
Properties |
content | simple
Used by |
Element | GRID/STATION/Station
Source |
    <xs:attribute name="ExternalURL" type="xs:anyURI">
      <xs:annotation>
        <xs:documentation>URL that is displayed in our system. Can be used for switching to an external system. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / STATION / Station / @Type

Annotations |
    Denotes the type of station and shall be either TransformerStation, DistributionCabinet, Substation, or Other.

    No requirement.
Type | StationTypeEnum
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 | Substation |
    A substation is a high-voltage electric system facility.
    It is used to switch generators, equipment, and circuits or lines in and out of a system.
    It also is used to change AC voltages from one level to another, and/or change alternating
    current to direct current or direct current to alternating current.
enumeration | Other |
    Other type of station that don't match any of the above types.
Used by |
Element | GRID/STATION/Station
Source |
    <xs:attribute name="Type" type="StationTypeEnum">
      <xs:annotation>
        <xs:documentation>Denotes the type of station and shall be either TransformerStation, DistributionCabinet, Substation, or Other. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / STATION / Station / @x

Annotations |
    x-coordinate of the station to display in the schematic view.

    Required for:
    	- Display in schematic view
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/STATION/Station
Source |
    <xs:attribute name="x" type="xs:double">
      <xs:annotation>
        <xs:documentation>x-coordinate of the station to display in the schematic view. Required for: - Display in schematic view</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute GRID / STATION / Station / @y

Annotations |
    y-coordinate of the station to display in the schematic view.

    Required for:
    	- Display in schematic view
Type | xs:double
Properties |
content | simple
Used by |
Element | GRID/STATION/Station
Source |
    <xs:attribute name="y" type="xs:double">
      <xs:annotation>
        <xs:documentation>y-coordinate of the station to display in the schematic view. Required for: - Display in schematic view</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A string ID, unique within the grid model.

    Hard requirement.
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">
      <xs:annotation>
        <xs:documentation>A string ID, unique within the grid model. Hard requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Definition whether the shape is dispayed on the schematic or on the map view:
    “Schematic”, “Map”.

    Hard requirement.
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">
      <xs:annotation>
        <xs:documentation>Definition whether the shape is dispayed on the schematic or on the map view: “Schematic”, “Map”. Hard requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Type of the geometry.
    Possible types are:
    “Line”, “Arrow”, “Ellipse”, “Rectangle”, “Polygon”

    Hard requirement.
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">
      <xs:annotation>
        <xs:documentation>Type of the geometry. Possible types are: “Line”, “Arrow”, “Ellipse”, “Rectangle”, “Polygon” Hard requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    The x-coordinate of the upper left corner of the shape.

    Required for:
    	- Schematic display
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. Required for: - Schematic display</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    The y-coordinate of the upper left corner of the shape.

    Required for:
    	- Schematic display
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. Required for: - Schematic display</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    The x-coordinate of the lower right corner of the shape.

    Required for:
    	- Schematic display
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. Required for: - Schematic display</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    The y-coordinate of the lower right corner of the shape.

    Required for:
    	- Schematic display
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. Required for: - Schematic display</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable name.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="Name" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable name. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    A human-readable description.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="Description" type="xs:string">
      <xs:annotation>
        <xs:documentation>A human-readable description. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Text to be shown within the shape.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="Text" type="xs:string">
      <xs:annotation>
        <xs:documentation>Text to be shown within the shape. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ 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

    No requirement.
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 No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Position, where text is displayed within the shape.

    No requirement.
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">
      <xs:annotation>
        <xs:documentation>Position, where text is displayed within the shape. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Orientation of the text.

    No requirement.
Type | TextOrientationEnumType
Properties |
content | simple
Facets |
enumeration | Horizontal |
enumeration | Vertical |
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="TextOrientation" type="TextOrientationEnumType">
      <xs:annotation>
        <xs:documentation>Orientation of the text. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Font size of the text.

    No requirement.
Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="FontSize" type="xs:integer">
      <xs:annotation>
        <xs:documentation>Font size of the text. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Color of the text.

    No requirement.
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">
      <xs:annotation>
        <xs:documentation>Color of the text. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Color of the shape outline.

    No requirement.
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">
      <xs:annotation>
        <xs:documentation>Color of the shape outline. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Background color of the shape.

    No requirement.
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">
      <xs:annotation>
        <xs:documentation>Background color of the shape. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Width of the shape outline.

    No requirement.
Type | xs:integer
Properties |
content | simple
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="OutlineWidth" type="xs:integer">
      <xs:annotation>
        <xs:documentation>Width of the shape outline. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    The ID of the station, if this shape belongs to a station.

    No requirement.
Type | xs:string
Properties |
content | simple
Used by |
Element | GRID/SHAPE/Shape
Source |
    <xs:attribute name="StationID" type="xs:string">
      <xs:annotation>
        <xs:documentation>The ID of the station, if this shape belongs to a station. No requirement.</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ 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 ]
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.

    Required for:
    	- Protection calculation
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. Required for: - Protection calculation</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    The time after which the fault is cleared.

    Required for:
    	- Protection calculation
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. Required for: - Protection calculation</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Denotes the impedances which together with SwitchOffTimeInSeconds define the settings of the protection device. Multiple entries possible.

    Required for:
    	- Protection calculation
Type | xs:double
Properties |
content | simple
Used by |
Element | DistanceProtection/STAGE/Stage
Source |
    <xs:attribute name="ImpedanceInOhm" type="xs:double">
      <xs:annotation>
        <xs:documentation>Denotes the impedances which together with SwitchOffTimeInSeconds define the settings of the protection device. Multiple entries possible. Required for: - Protection calculation</xs:documentation>
      </xs:annotation>
    </xs:attribute>

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

Annotations |
    Denotes the time which together with ImpedanceInOhm define the settings of the protection device. Multiple entries possible.

    Required for:
    	- Protection calculation
Type | xs:double
Properties |
content | simple
Used by |
Element | DistanceProtection/STAGE/Stage
Source |
    <xs:attribute name="SwitchOffTimeInSeconds" type="xs:double">
      <xs:annotation>
        <xs:documentation>Denotes the time which together with ImpedanceInOhm define the settings of the protection device. Multiple entries possible. Required for: - Protection calculation</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute DistanceProtection / @DirectionalFinalTimeInSeconds

Annotations |
    When a distance protection device recognizes a fault in its direction,
    this is the time after which the device sends a second switch-open signal to the circuit breaker if the first one did not work for some reason.

    Required for:
    	- Protection calculation
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 its direction, this is the time after which the device sends a second switch-open signal to the circuit breaker if the first one did not work for some reason. Required for: - Protection calculation</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute DistanceProtection / @NonDirectionalFinalTimeInSeconds

Annotations |
    The swich-off time when a fault in backwards direction is detected.

    Required for:
    	- Protection calculation
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. Required for: - Protection calculation</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.

    Required for:
    	- Protection calculation
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. Required for: - Protection calculation</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.

    Required for:
    	- Protection calculation
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. Required for: - Protection calculation</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]
Attribute DistanceProtection / @MaxStages

Annotations |
    The maximum number of stages that can be configured in the device.

    Required for:
    	- Protection calculation
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. Required for: - Protection calculation</xs:documentation>
      </xs:annotation>
    </xs:attribute>

[ top ]