{
    "$schema": "http://json-schema.org/schema#",
    "$schemaVersion": "0.0.1",
    "modelTags": "SAREF Transformer",
    "$id": "https://smart-data-models.github.com/dataModel.SAREF4BLDG/Transformer/schema.json",
    "derivedFrom": "https://saref.etsi.org/saref4bldg/v1.1.2/#s4bldg:Transformer",
    "title": "Smart data models - Transformer schema",
    "type": "object",
    "license": "https://opensource.org/licenses/BSD-3-Clause",
    "description": "A transformer is an inductive stationary device that transfers electrical energy from one circuit to another.  Transformer is used to transform electric power; conversion of electric signals for other purposes is handled at other entities: Controller converts arbitrary signals, AudioVisualAppliance converts signals for audio or video streams, and CommunicationsAppliance converts signals for data or other communications usage.",
    "allOf": [
        {
            "$ref": "https://smart-data-models.github.io/data-models/common-schema.json#/definitions/GSMA-Commons"
        },
        {
            "$ref": "https://smart-data-models.github.io/data-models/common-schema.json#/definitions/Location-Commons"
        },
        {
            "properties": {
                "type": {
                    "type": "string",
                    "description": "Property. It must be equal to `Transformer`",
                    "enum": [
                        "Transformer"
                    ]
                },
                "apparentPowerMax": {
                    "$ref": "https://raw.githubusercontent.com/smart-data-models/dataModel.S4BLDG/master/S4BLDG-schema.json#/definitions/Measurement",
                    "description": "Property. Maximum apparent power/capacity in VA (volt ampere). Usually measured in Watts (W, J/s)"
                },
                "imaginaryImpedanceRatio": {
                    "$ref": "https://raw.githubusercontent.com/smart-data-models/dataModel.S4BLDG/master/S4BLDG-schema.json#/definitions/Measurement",
                    "description": "Property. The ratio between the imaginary part of the zero sequence impedance and the imaginary part of the positive impedance (i.e. imaginary part of the short-circuit voltage) of the transformer. Used for three-phase transformer which includes a N-conductor"
                },
                "isNeutralPrimaryTerminalAvailable": {
                    "type": "boolean",
                    "description": "Property. An indication of whether the neutral point of the primary winding is available as a terminal (=TRUE) or not (= FALSE)"
                },
                "isNeutralSecondaryTerminalAvailable": {
                    "type": "boolean",
                    "description": "Property. An indication of whether the neutral point of the secondary winding is available as a terminal (=TRUE) or not (= FALSE)"
                },
                "primaryApparentPower": {
                    "$ref": "https://raw.githubusercontent.com/smart-data-models/dataModel.S4BLDG/master/S4BLDG-schema.json#/definitions/Measurement",
                    "description": "Property. The power in VA (volt ampere) that has been transformed and that runs into the transformer on the primary side. Usually measured in Watts (W, J/s)"
                },
                "primaryCurrent": {
                    "$ref": "https://raw.githubusercontent.com/smart-data-models/dataModel.S4BLDG/master/S4BLDG-schema.json#/definitions/Measurement",
                    "description": "Property. The current that is going to be transformed and that runs into the transformer on the primary side. Usually measured in Ampere (A)"
                },
                "primaryFrequency": {
                    "$ref": "https://raw.githubusercontent.com/smart-data-models/dataModel.S4BLDG/master/S4BLDG-schema.json#/definitions/Measurement",
                    "description": "Property. The frequency that is going to be transformed and that runs into the transformer on the primary side. Usually measured in cycles/s or Hertz (Hz)"
                },
                "primaryVoltage": {
                    "$ref": "https://raw.githubusercontent.com/smart-data-models/dataModel.S4BLDG/master/S4BLDG-schema.json#/definitions/Measurement",
                    "description": "Property. The voltage that is going to be transformed and that runs into the transformer on the primary side. Usually measured in Volts (V, W/A)"
                },
                "realImpedanceRatio": {
                    "$ref": "https://raw.githubusercontent.com/smart-data-models/dataModel.S4BLDG/master/S4BLDG-schema.json#/definitions/Measurement",
                    "description": "Property. The ratio between the real part of the zero sequence impedance and the real part of the positive impedance (i.e. real part of the short-circuit voltage) of the transformer. Used for three-phase transformer which includes a N-conductor"
                },
                "secondaryApparentPower": {
                    "$ref": "https://raw.githubusercontent.com/smart-data-models/dataModel.S4BLDG/master/S4BLDG-schema.json#/definitions/Measurement",
                    "description": "Property. The power in VA (volt ampere) that has been transformed and is running out of the transformer on the secondary side. Usually measured in Watts (W, J/s)"
                },
                "secondaryCurrent": {
                    "$ref": "https://raw.githubusercontent.com/smart-data-models/dataModel.S4BLDG/master/S4BLDG-schema.json#/definitions/Measurement",
                    "description": "Property. The current that has been transformed and is running out of the transformer on the secondary side. Usually measured in Ampere (A)"
                },
                "secondaryCurrentType": {
                    "type": "string",
                    "description": "Property. A list of the secondary current types that can result from transformer output"
                },
                "secondaryFrequency": {
                    "$ref": "https://raw.githubusercontent.com/smart-data-models/dataModel.S4BLDG/master/S4BLDG-schema.json#/definitions/Measurement",
                    "description": "Property. The frequency that has been transformed and is running out of the transformer on the secondary side. Usually measured in cycles/s or Hertz (Hz)"
                },
                "secondaryVoltage": {
                    "$ref": "https://raw.githubusercontent.com/smart-data-models/dataModel.S4BLDG/master/S4BLDG-schema.json#/definitions/Measurement",
                    "description": "Property. The voltage that has been transformed and is running out of the transformer on the secondary side. Usually measured in Volts (V, W/A)"
                },
                "transformerVectorGroup": {
                    "type": "string",
                    "description": "Property. List of the possible vector groups for the transformer from which that required may be set. Values in the enumeration list follow a standard international code where the first letter describes how the primary windings are connected, the second letter describes how the secondary windings are connected, and the numbers describe the rotation of voltages and currents from the primary to the secondary side in multiples of 30 degrees. D: means that the windings are delta-connected. Y: means that the windings are star-connected. Z: means that the windings are zig-zag connected (a special start-connected providing low reactance of the transformer). The connectivity is only relevant for three-phase transformers"
                },
                "isContainedInBuildingSpace": {
                    "$ref": "https://smart-data-models.github.io/data-models/common-schema.json#/definitions/EntityIdentifierType",
                    "description": "Relationship. An entity used to define the physical spaces of the building. A building space contains devices or building objects. (BuildingSpace)"
                },
                "isContainedInPhysicalObject": {
                    "$ref": "https://smart-data-models.github.io/data-models/common-schema.json#/definitions/EntityIdentifierType",
                    "description": "Relationship. Any Object that has a proper space region.  (Definition extracted from DUL ontology) (PhysicalObject)"
                },
                "isSubSystemOf": {
                    "type": "array",
                    "description": "Relationship. A reference to a system(s) that this Physical Object is part of",
                    "items": {
                        "$ref": "https://smart-data-models.github.io/data-models/common-schema.json#/definitions/EntityIdentifierType",
                        "description": "Relationship. The class of systems, i.e., systems virtually isolated from the environment, whose behaviour and interactions with the environment are modeled. Systems can be connected to other systems. Connected systems interact in some ways. Systems can also have subsystems. Properties of subsystems somehow contribute to the properties of the supersystem. (System)"
                    }
                },
                "hasManufacturer": {
                    "type": "string",
                    "description": "Property. A relationship identifying the manufacturer of an entity (e.g., device). The value is expected to be a string or a string with language tag"
                },
                "hasModel": {
                    "type": "string",
                    "description": "Property. A relationship identifying the model of an entity (e.g., device). The value is expected to be a string or a string with language tag"
                }
            }
        }
    ],
    "required": [
        "id",
        "type"
    ]
}