# Application Input Format

_Source: `application/PhasorDynamics/README.md`_

## Input file for GridKit phasor dynamics application

### Root elements

   Name               | Value
 ---------------------|-------------------------------------------------------
  `system_model_file` | Path to the system model file[^1]
  `dt`                | A floating point value for time step size
  `tmax`              | A floating point value for max time
  `events`            | An array of event groups (see [Events](#events) below)
  `output_file`       | Path to output (CSV) file
  `reference_file`    | A string containing the name of the case
  `error_tolerance`   | A string containing the name of the case

[^1]: See system model [case format](../models/generated/phasor-dynamics/input-format.md)

### Events

Each event group describes a system event that occurs at a given time point

   Name              | Value
 --------------------|-------------------------------------------------------
  `time`             | A floating point value for time event occurs
  `type`             | Event type (one of { "fault_on", "fault_off" })
  `element_id`       | An integer value referencing the element associated with the event (e.g., bus fault id)