{
    "$schema": "http://json-schema.org/schema#",
    "$schemaVersion": "0.0.1",
    "$id": "https://smart-data-models.github.io/dataModels.CIMEnergyClasses/TapChanger/schema.json",
    "title": " Smart Data Models - TapChanger",
    "description": "Adapted from CIM data models. Mechanism for changing transformer winding tap positions.",
    "type": "object",
    "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",
                    "enum": [
                        "TapChanger"
                    ],
                    "description": "Property. NGSI type. It has to be TapChanger"
                },
                "SvTapStep": {
                    "description": "Property. Model:'https://schema.org/Number'. The tap step state associated with the tap changer. Default: None",
                    "type": "number"
                },
                "TapChangerControl": {
                    "description": "Property. Model:'https://schema.org/Number'. The tap changers that participates in this regulating tap control scheme. Default: None",
                    "type": "number"
                },
                "TapSchedules": {
                    "description": "Property. Model:'https://schema.org/Number'. A TapSchedule is associated with a TapChanger. Default: 'list'",
                    "type": "number"
                },
                "controlEnabled": {
                    "description": "Property. Model:'https://schema.org/Number'. Specifies the regulation status of the equipment.  True is regulating, false is not regulating. Default: False",
                    "type": "number"
                },
                "highStep": {
                    "description": "Property. Model:'https://schema.org/Number'. Highest possible tap step position, advance from neutral. The attribute shall be greater than lowStep. Default: 0",
                    "type": "number"
                },
                "lowStep": {
                    "description": "Property. Model:'https://schema.org/Number'. Lowest possible tap step position, retard from neutral Default: 0",
                    "type": "number"
                },
                "ltcFlag": {
                    "description": "Property. Model:'https://schema.org/Number'. Specifies whether or not a TapChanger has load tap changing capabilities. Default: False",
                    "type": "number"
                },
                "neutralStep": {
                    "description": "Property. Model:'https://schema.org/Number'. The neutral tap step position for this winding. The attribute shall be equal or greater than lowStep and equal or less than highStep. Default: 0",
                    "type": "number"
                },
                "neutralU": {
                    "description": "Property. Model:'https://schema.org/Number'. Voltage at which the winding operates at the neutral tap setting. Default: 0.0",
                    "type": "number"
                },
                "normalStep": {
                    "description": "Property. Model:'https://schema.org/Number'. The tap step position used in `normal` network operation for this winding. For a `Fixed` tap changer indicates the current physical tap setting. The attribute shall be equal or greater than lowStep and equal or less than highStep. Default: 0",
                    "type": "number"
                },
                "step": {
                    "description": "Property. Model:'https://schema.org/Number'. Tap changer position. Starting step for a steady state solution. Non integer values are allowed to support continuous tap variables. The reasons for continuous value are to support study cases where no discrete tap changers has yet been designed, a solutions where a narrow voltage band force the tap step to oscillate or accommodate for a continuous solution as input. The attribute shall be equal or greater than lowStep and equal or less than highStep. Default: 0.0",
                    "type": "number"
                }
            }
        }
    ]
}