{
  "package": "hyper-ontology/1",
  "designed_with": "Praxis",
  "implemented_with": "Hyper Ontology",
  "paper": {
    "title": "Feeder Firewatch: Live Ignition and Outage Risk for Every Distribution Feeder",
    "url": "https://muhammadumar89.github.io/codeninja-research/wildfire-risk-distribution-us/",
    "doi": "10.5281/zenodo.23119325"
  },
  "sector": "energy-and-utilities",
  "country": "United States",
  "scenario": "illustrative: the operator is a composite written for this design, not a CodeNinja customer",
  "source": "chapter 5 of the paper (5.1 objects and anchors, 5.2 human loop) and Figure 4 (typed links); properties and status vocabularies from the plan the paper was drawn from, which match Figure 4 and the recorded object in 5.3",
  "write_paths": [
    "adapter tier, read only",
    "PSPS decision records, written in this design under a named operator's approval",
    "work orders into the work management system as pending approval; only an approved order reaches a crew"
  ],
  "human_loop": "every de-energisation and fast-trip change is a PSPS decision record approved or declined by a named operator; the design never opens or closes a recloser",
  "objects": [
    {
      "id": "substation",
      "label": "Substation",
      "kind": "site",
      "anchored_in": "SCADA",
      "properties": [
        "Substation ID",
        "Feeder count",
        "PTZ camera",
        "Cellular coverage state"
      ],
      "status_vocabulary": [],
      "links": [
        {
          "to": "feeder",
          "label": "supplies"
        }
      ]
    },
    {
      "id": "feeder",
      "label": "Feeder",
      "kind": "asset",
      "anchored_in": "GIS",
      "properties": [
        "Feeder ID",
        "Substation",
        "Length",
        "Wind exposure"
      ],
      "status_vocabulary": [],
      "links": [
        {
          "to": "feeder_segment",
          "label": "divides into"
        }
      ]
    },
    {
      "id": "feeder_segment",
      "label": "Feeder segment",
      "kind": "asset",
      "anchored_in": "GIS",
      "properties": [
        "Segment ID",
        "Feeder ID",
        "Conductor span",
        "Last inspection date"
      ],
      "status_vocabulary": [],
      "links": [
        {
          "to": "pole",
          "label": "carries"
        }
      ]
    },
    {
      "id": "pole",
      "label": "Pole",
      "kind": "asset",
      "anchored_in": "GIS",
      "properties": [
        "Pole number",
        "Pole class",
        "Installation year",
        "Crossarm condition",
        "Inspection photo link"
      ],
      "status_vocabulary": [
        "Inspected",
        "Pending inspection",
        "Defect found",
        "Replacement scheduled"
      ],
      "links": [
        {
          "to": "pole_inspection_record",
          "label": "documented by"
        }
      ]
    },
    {
      "id": "recloser",
      "label": "Recloser",
      "kind": "asset",
      "anchored_in": "SCADA",
      "properties": [
        "Recloser ID",
        "Feeder segment",
        "Fast trip profile state",
        "Fault counter"
      ],
      "status_vocabulary": [
        "Closed",
        "Open",
        "Locked out",
        "Fast trip enabled",
        "Fast trip disabled"
      ],
      "links": [
        {
          "to": "feeder_segment",
          "label": "protects"
        }
      ]
    },
    {
      "id": "meter",
      "label": "Meter",
      "kind": "asset",
      "anchored_in": "AMI head end",
      "properties": [
        "Meter number",
        "Feeder segment",
        "Last 15-minute read",
        "Last gasp timestamp"
      ],
      "status_vocabulary": [
        "Reporting",
        "Last gasp",
        "Dead",
        "Restored"
      ],
      "links": [
        {
          "to": "feeder_segment",
          "label": "monitors"
        }
      ]
    },
    {
      "id": "pole_inspection_record",
      "label": "Pole inspection record",
      "kind": "record",
      "anchored_in": "pole inspection spreadsheet",
      "properties": [
        "Pole number",
        "Inspection date",
        "Inspector",
        "Defects found",
        "Photo reference"
      ],
      "status_vocabulary": [],
      "links": []
    },
    {
      "id": "outage_event",
      "label": "Outage event",
      "kind": "event",
      "anchored_in": "outage management system",
      "properties": [
        "Event ID",
        "Affected meters",
        "Start time",
        "Cause code",
        "Restoration time"
      ],
      "status_vocabulary": [
        "Reported",
        "Confirmed",
        "Crew assigned",
        "Restored"
      ],
      "links": [
        {
          "to": "meter",
          "label": "",
          "note": "drawn in Figure 4 with its label hidden under the Pole inspection record card; the outage event carries the property Affected meters"
        }
      ]
    },
    {
      "id": "feeder_segment_ignition_risk_score",
      "label": "Feeder segment ignition risk score",
      "kind": "measure",
      "anchored_in": "risk model store",
      "properties": [
        "Segment ID",
        "Score",
        "Forecast horizon",
        "Contributing signals",
        "Model version"
      ],
      "status_vocabulary": [],
      "links": [
        {
          "to": "feeder_segment",
          "label": "scores"
        }
      ]
    },
    {
      "id": "red_flag_warning",
      "label": "Red flag warning",
      "kind": "event",
      "anchored_in": "weather and mesonet subscription",
      "properties": [
        "Warning ID",
        "Counties",
        "Wind gust",
        "Relative humidity",
        "Issue time"
      ],
      "status_vocabulary": [
        "Issued",
        "Expired"
      ],
      "links": [
        {
          "to": "feeder_segment_ignition_risk_score",
          "label": "drives"
        }
      ]
    },
    {
      "id": "wildfire_camera_station",
      "label": "Wildfire camera station",
      "kind": "asset",
      "anchored_in": "wildfire camera vendor portal",
      "properties": [
        "Station ID",
        "Structure",
        "Bearing coverage",
        "Detection events"
      ],
      "status_vocabulary": [
        "Online",
        "Offline",
        "Buffering"
      ],
      "links": [
        {
          "to": "substation",
          "label": "watches"
        }
      ]
    },
    {
      "id": "field_crew",
      "label": "Field crew",
      "kind": "actor",
      "anchored_in": "work management system",
      "properties": [
        "Crew ID",
        "District",
        "AVL position",
        "Assigned work orders"
      ],
      "status_vocabulary": [
        "Available",
        "Dispatched",
        "On site",
        "Cleared"
      ],
      "links": [
        {
          "to": "work_order",
          "label": "works"
        }
      ]
    },
    {
      "id": "work_order",
      "label": "Work order",
      "kind": "record",
      "anchored_in": "work management system",
      "properties": [
        "Order number",
        "Asset",
        "Priority",
        "Crew",
        "Approval trail"
      ],
      "status_vocabulary": [
        "Draft",
        "Pending approval",
        "Approved",
        "Assigned",
        "Work done",
        "Closed"
      ],
      "links": []
    },
    {
      "id": "psps_decision_record",
      "label": "PSPS decision record",
      "kind": "record",
      "anchored_in": "originates in this design (no upstream system)",
      "properties": [
        "Feeder segments",
        "Recommendation",
        "Approving operator",
        "Rationale",
        "PUCT notification reference"
      ],
      "status_vocabulary": [
        "Recommended",
        "Approved",
        "Declined",
        "De-energised",
        "Re-energised"
      ],
      "links": [
        {
          "to": "feeder_segment",
          "label": "de-energises"
        }
      ]
    }
  ]
}