{
  "$schema": "http://json-schema.org/schema#",
  "$schemaVersion": "0.0.4",
  "modelTags": "",
  "$id": "https://smart-data-models.github.io/dataModel.Energy/ThreePhaseAcMeasurement/schema.json",
  "title": "Smart Data Models - Energy / Three Phase AC Measurement",
  "description": "An electrical  measurement from a system that uses three phase alternating current.",
  "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": [
            "ThreePhaseAcMeasurement"
          ],
          "description": "Property. It must be equal to `ThreePhaseAcMeasurement`"
        },
        "refDevice": {
          "type": "array",
          "description": "Relationship. Device(s) used to obtain the measurement",
          "items": {
            "$ref": "https://smart-data-models.github.io/data-models/common-schema.json#/definitions/EntityIdentifierType"
          },
          "minItems": 1,
          "uniqueItems": true
        },
        "refTargetDevice": {
          "type": "array",
          "description": "Relationship. Device(s) for which the measurement was taken",
          "items": {
            "$ref": "https://smart-data-models.github.io/data-models/common-schema.json#/definitions/EntityIdentifierType"
          },
          "minItems": 1,
          "uniqueItems": true
        },
        "dateEnergyMeteringStarted": {
          "type": "string",
          "format": "date-time",
          "description": "Property. Model:'http://schema.org/DateTime'. The starting date for metering energy"
        },
        "totalActiveEnergyImport": {
          "type": "number",
          "minimum": 0,
          "description": "Property. Model:'https://schema.org/Number'. Units:'kilowatt hour (kWh)'. Total energy imported i.e. consumed since metering started (since `dateEnergyMeteringStarted`)"
        },
        "totalReactiveEnergyImport": {
          "type": "number",
          "minimum": 0,
          "description": "Property. Model:'https://schema.org/Number'. Units:'kilovolt-ampere-reactive-hour (kVArh)'. Total energy imported i.e. consumed (with regards to fundamental frequency reactive power) since the metering start date (`dateEnergyMeteringStarted`)"
        },
        "totalApparentEnergyImport": {
          "type": "number",
          "minimum": 0,
          "description": "Property. Model:'https://schema.org/Number'. Units:'kilovolt-ampere-hour (kVAh)'. Total energy imported i.e. consumed (with regards to apparent power) since the metering start date (`dateEnergyMeteringStarted`)"
        },
        "totalActiveEnergyExport": {
          "type": "number",
          "minimum": 0,
          "description": "Property. Model:'https://schema.org/Number'. Units:'kilowatt hour (kWh)'. Total energy exported since metering started (since `dateEnergyMeteringStarted`)"
        },
        "totalReactiveEnergyExport": {
          "type": "number",
          "minimum": 0,
          "description": "Property. Model:'https://schema.org/Number'. Units:'kilovolt-ampere-reactive-hour (kVArh)'. Total fundamental frequency reactive energy exported since metering started (since `dateEnergyMeteringStarted`)"
        },
        "totalApparentEnergyExport": {
          "type": "number",
          "minimum": 0,
          "description": "Property. Model:'https://schema.org/Number'. Units:'kilovolt-ampere-reactive-hour (kVArh)'. Total energy exported (with regards to apparent power) since the metering start date (`dateEnergyMeteringStarted`)"
        },
        "frequency": {
          "type": "number",
          "minimum": 0,
          "description": "Property. Model:'http://schema.org/Number'. Units:'Hertz (Hz)'. The frequency of the circuit"
        },
        "totalActivePower": {
          "type": "number",
          "description": "Property. Model:'http://schema.org/Number'. Units:'watt (W)'. Active power consumed (counting all phases)"
        },
        "totalReactivePower": {
          "type": "number",
          "description": "Property. Model:'http://schema.org/Number'. Units:'volt-ampere-reactive (VAr)'. Reactive power consumed (counting all phases)"
        },
        "totalApparentPower": {
          "type": "number",
          "minimum": 0,
          "description": "Property. Model:'http://schema.org/Number'. Units:'volt-ampere (VA)'. Apparent power consumed (counting all phases)"
        },
        "activeEnergyImport": {
          "type": "object",
          "description": "Property. Model:'http://schema.org/StructuredValue'. Units:'kilowatt hour (kWh)'. Active energy imported i.e. consumed per Line since the metering start date. The actual values will be conveyed by subproperties which names will be equal to the name of each of the alternating current phases: L1, L2, L3",
          "properties": {
            "L1": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 1 of the active energy import"
            },
            "L2": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 2 of the active energy import"
            },
            "L3": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 3 of the active energy import"
            }
          }
        },
        "reactiveEnergyImport": {
          "type": "object",
          "description": "Property. Model:'http://schema.org/StructuredValue'. Units:'kilovolt-ampere-reactive-hour (kVArh)'. Fundamental frequency reactive energy imported i.e. consumed per phase since the metering start date. The actual values will be conveyed by subproperties which names will be equal to the name of each of the alternating current phases: L1, L2, L3",
          "properties": {
            "L1": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 1 of the reactive energy import"
            },
            "L2": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 2 of the reactive energy import"
            },
            "L3": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 3 of the reactive energy import"
            }
          }
        },
        "apparentEnergyImport": {
          "type": "object",
          "description": "Property. Model:'http://schema.org/StructuredValue'. Units:'kilovolt-ampere-hour (kVAh)'. Apparent energy imported i.e. consumed per phase since the metering start date. The actual values will be conveyed by subproperties which names will be equal to the name of each of the alternating current phases: L1, L2, L3",
          "properties": {
            "L1": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 1 of the apparent energy import"
            },
            "L2": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 2 of the apparent energy import"
            },
            "L3": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 3 of the apparent energy import"
            }
          }
        },
        "activeEnergyExport": {
          "type": "object",
          "description": "Property. Model:'http://schema.org/StructuredValue'. Units:'kilowatt hour (kWh)'. Active energy exported per phase since the metering start date. The actual values will be conveyed by subproperties which names will be equal to the name of each of the alternating current phases: L1, L2, L3",
          "properties": {
            "L1": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 1 of the active energy export"
            },
            "L2": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 2 of the active energy export"
            },
            "L3": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 3 of the active energy export"
            }
          }
        },
        "reactiveEnergyExport": {
          "type": "object",
          "description": "Property. Model:'http://schema.org/StructuredValue'. Units:'kilovolt-ampere-reactive-hour (kVArh)'. Fundamental frequency reactive energy exported per phase since the metering start date. The actual values will be conveyed by subproperties which names will be equal to the name of each of the alternating current phases: L1, L2, L3",
          "properties": {
            "L1": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 1 of the reactive energy export"
            },
            "L2": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 2 of the reactive energy export"
            },
            "L3": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 3 of the reactive energy export"
            }
          }
        },
        "apparentEnergyExport": {
          "type": "object",
          "description": "Property. Model:'http://schema.org/StructuredValue'. Units:'kilovolt-ampere-hour (kVAh)'. Apparent energy exported per phase since the metering start date. The actual values will be conveyed by subproperties which names will be equal to the name of each of the alternating current phases: L1, L2, L3",
          "properties": {
            "L1": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 1 of the apparent energy export"
            },
            "L2": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 2 of the apparent energy export"
            },
            "L3": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 3 of the apparent energy export"
            }
          }
        },
        "activePower": {
          "type": "object",
          "description": "Property. Model:'http://schema.org/StructuredValue'. Units:'watt (W)'.Active power consumed per phase. The actual values will beconveyed by subproperties which names will be equal to the name of each of the alternating current phases: L1, L2, L3. ",
          "properties": {
            "L1": {
              "type": "number",
              "description": "Property. Line 1 of the active power"
            },
            "L2": {
              "type": "number",
              "description": "Property. Line 2 of the active power"
            },
            "L3": {
              "type": "number",
              "description": "Property. Line 3 of the active power"
            }
          }
        },
        "reactivePower": {
          "type": "object",
          "description": "Property. Model:'http://schema.org/StructuredValue'. Units:'volts-ampere-reactive (VAr)'. Fundamental frequency reactive power. The actual values will be conveyed by subproperties whose names will be equal to the name of each of the alternating current phases: L1, L2, L3",
          "properties": {
            "L1": {
              "type": "number",
              "description": "Property. Line 1 of the reactive power"
            },
            "L2": {
              "type": "number",
              "description": "Property. Line 2 of the reactive power"
            },
            "L3": {
              "type": "number",
              "description": "Property. Line 3 of the reactive power"
            }
          }
        },
        "apparentPower": {
          "type": "object",
          "description": "Property. Model:'http://schema.org/StructuredValue'. Units:'volt-ampere (VA)'. Apparent power consumed per phase. The actual values will be conveyed by subproperties which names will be equal to the name of each of the alternating current phases: L1, L2, L3",
          "properties": {
            "L1": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 1 of the apparent power"
            },
            "L2": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 2 of the apparent power"
            },
            "L3": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 3 of the apparent power"
            }
          }
        },
        "totalPowerFactor": {
          "type": "number",
          "description": "Property. Model:'http://schema.org/Number'. Units:'-1 to +1'. Power factor including all phases",
          "minimum": -1,
          "maximum": 1
        },
        "powerFactor": {
          "type": "object",
          "description": "Property. Model:'http://schema.org/StructuredValue'. Units:'-1 to +1'. Power factor for each phase. The actual values will be conveyed by one subproperty per alternating current phase: L1, L2 and L3",
          "properties": {
            "L1": {
              "type": "number",
              "minimum": -1,
              "maximum": 1,
              "description": "Property. Line 1 of the power factor"
            },
            "L2": {
              "type": "number",
              "minimum": -1,
              "maximum": 1,
              "description": "Property. Line 2 of the power factor"
            },
            "L3": {
              "type": "number",
              "minimum": -1,
              "maximum": 1,
              "description": "Property. Line 3 of the power factor"
            }
          }
        },
        "totalDisplacementPowerFactor": {
          "type": "number",
          "description": "Property. Model:'http://schema.org/Number'. Units:'-1 to +1'. Displacement power factor including all phases. The quantity is based on the fundamental frequency of the system",
          "minimum": -1,
          "maximum": 1
        },
        "displacementPowerFactor": {
          "type": "object",
          "description": "Property. Model:'http://schema.org/StructuredValue'. Units:'-1 to +1'. Displacement power factor for each phase. The quantity is based on the fundamental frequency of the system. The actual values will be conveyed by one subproperty per alternating current phase: L1, L2 and L3",
          "properties": {
            "L1": {
              "type": "number",
              "minimum": -1,
              "maximum": 1,
              "description": "Property. Line 1 of the displacement power factor"
            },
            "L2": {
              "type": "number",
              "minimum": -1,
              "maximum": 1,
              "description": "Property. Line 2 of the displacement power factor"
            },
            "L3": {
              "type": "number",
              "minimum": -1,
              "maximum": 1,
              "description": "Property. Line 3 of the displacement power factor"
            }
          }
        },
        "current": {
          "type": "object",
          "description": "Property. Model:'http://schema.org/StructuredValue'. Units:'Ampers (A)'. Electrical current. The actual values will be conveyed by one subproperty per alternating current phase and the neutral wire: L1, L2, L3 and N",
          "properties": {
            "L1": {
              "type": "number",
              "description": "Property. Line 1 of the current"
            },
            "L2": {
              "type": "number",
              "description": "Property. Line 2 of the current"
            },
            "L3": {
              "type": "number",
              "description": "Property. Line 3 of the current"
            },
            "N": {
              "type": "number",
              "description": "Property. Neutral of the current"
            }
          }
        },
        "phaseVoltage": {
          "type": "object",
          "description": "Property. Model:'http://schema.org/StructuredValue'. Units:'Volts (V)'. The voltage between each phase and neutral conductor. The actual values will be conveyed by one subproperty per alternating current phase: L1, L2 and L3",
          "properties": {
            "L1": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 1 of the phase voltage"
            },
            "L2": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 2 of the phase voltage"
            },
            "L3": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Line 3 of the phase voltage"
            }
          }
        },
        "phaseToPhaseVoltage": {
          "type": "object",
          "description": "Property. Model:'http://schema.org/StructuredValue'. Units:'Volts (V)'. Voltage between phases. A value for each phase pair: phases 1 and 2 (L12), phases 2 and 3 (L32), phases 3 and 1 (L31)",
          "properties": {
            "L12": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Phase between line 1 and 2 of the phase voltage"
            },
            "L23": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Phase between line 2 and 3 of the phase voltage"
            },
            "L31": {
              "type": "number",
              "minimum": 0,
              "description": "Property. Phase between line 3 and 1 of the phase voltage"
            }
          }
        },
        "thdVoltage": {
          "type": "object",
          "description": "Property. Model:'http://schema.org/StructuredValue'. Units:'0 to 1'. Total harmonic distortion of voltage for each phase. The actual values will be conveyed by one subproperty per alternating current phase: L1, L2 and L3",
          "properties": {
            "L1": {
              "type": "number",
              "minimum": 0,
              "maximum": 1,
              "description": "Property. Line 1 of the total harmonic distortion voltage"
            },
            "L2": {
              "type": "number",
              "minimum": 0,
              "maximum": 1,
              "description": "Property. Line 2 of the total harmonic distortion voltage"
            },
            "L3": {
              "type": "number",
              "minimum": 0,
              "maximum": 1,
              "description": "Property. Line 3 of the total harmonic distortion voltage"
            }
          }
        },
        "thdCurrent": {
          "type": "object",
          "description": "Property. Model:'http://schema.org/StructuredValue'. Units:'0 to 1'. Total harmonic distortion of electrical current. The actual values will be conveyed by one subproperty per alternating current phase: L1, L2 and L3",
          "properties": {
            "L1": {
              "type": "number",
              "minimum": 0,
              "maximum": 1,
              "description": "Property. Line 1 of the total harmonic distortion current"
            },
            "L2": {
              "type": "number",
              "minimum": 0,
              "maximum": 1,
              "description": "Property. Line 2 of the total harmonic distortion current"
            },
            "L3": {
              "type": "number",
              "minimum": 0,
              "maximum": 1,
              "description": "Property. Line 3 of the total harmonic distortion current"
            }
          }
        }
      }
    }
  ],
  "required": [
    "id",
    "type"
  ]
}