Schema documentation for dpgsimgridschema

Showing:

Annotations

Attributes

Diagrams

Facets

Instances

Model

Properties

Source

Used by

No namespace

	Main Schema
	dpgsimgridschema_2.44.xsd

	Elements
	GRID

	Complex Types
	CosPhiUCharacteristicDataPoint DefiniteTimeOvercurrentProtection DistanceProtection GISType ProtectionDevice QUCharacteristicDataPoint ReactivePowerCharacteristic

Simple Types

BranchEndEnum

BusTypeEnum

ColorType

DisplayTypeEnum

FormTypeEnum

FuseTypeEnum

GenerationCategoryEnum

GenerationConnectionEnum

LoadCategoryEnum

ProtectionDeviceDirection

ShapeTypeEnum

StarPointGrounding

StationTypeEnum

StringID

SwitchTypeEnum

TextOrientationEnumType

TextPositionEnumType

cosPhiType

reactivePowerCharacteristicType

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.

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.

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)

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.

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.

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

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.

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.

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.

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

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

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

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.

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

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.

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.

xs:double

optional

x-coordinate of the station to display in the schematic view.
												
Required for:
	- Display in schematic view

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.

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.

xs:double

optional

The x-coordinate of the upper left corner of the shape.
												
Required for:
	- Schematic display

xs:double

optional

The x-coordinate of the lower right corner of the shape.
												
Required for:
	- Schematic display

xs:double

optional

The y-coordinate of the upper left corner of the shape.
												
Required for:
	- Schematic display

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

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.

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.

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.

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

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 ]

Showing:

Table of Contents