Home /Modules/impl/kinematics-subject.sst

kinematics-subject.sst

impl/nordshrift/examples/kinematics-subject.sst · 90 line(s) · sleela

#nordshrift 1.0
#sleela     1.0

/// A Nordshrift 2.0 semantic sheet.
///
/// Declares an explicit physics subject using the shared semantic layer:
/// Subject -> Quantity -> Unit -> Assumption -> Relation -> Formula ->
/// Transformation -> Result -> ComparativeNorm -> Evidence -> Explanation ->
/// Validation. The subject records what is modeled, its assumptions, and how a
/// result was derived, so a computed value is not silently promoted to an
/// observation.
sheet kinematics-subject:
  version      1.0.0
  author       "Sleela Design Council"
  description  "Explicit projectile-range subject with provenance and a work plan."

source:
  root  "src"
  glob  "**/*.sleela"

subject ProjectileRange:
  domain: physics
  depends: [ math ]

  quantity range:
    value:     "v0^2 * sin(2*theta) / g"
    unit:      meter
    dimension: length
    domain:    "0 <= theta <= pi/2"
    status:    modeled

  quantity g:
    value:  "9.80665"
    unit:   "meter/second^2"
    status: specified

  assumption noDrag:
    statement: "air resistance is neglected"
    scope:     "low-speed, short-range trajectories"
    source:    "modeling choice"
    status:    assumed

  relation rangeFormula:
    formula: "R = v0^2 * sin(2*theta) / g"
    inputs:  [ v0, theta, g ]
    outputs: [ range ]

  transformation deriveRange:
    source:      rangeFormula
    operation:   "evaluate at theta = 45deg"
    parameters:  "theta=pi/4"
    destination: range
    approximate: false

  comparison:
    prior:     ProjectileRangeVacuumBaseline
    current:   ProjectileRange
    reference: ProjectileRangeVacuumBaseline
    norm:      "ratio of modeled range to ideal vacuum range"

  evidence:
    status: modeled
    source: "closed-form kinematics under the noDrag assumption"
    note:   "result is a model output, not a measurement"

  explanation:
    subject: ProjectileRange
    steps: [ "identify subject and domain",
             "state quantities and units",
             "declare the noDrag assumption",
             "apply the range relation",
             "evaluate the transformation",
             "record evidence status as modeled" ]

  todo validateAgainstMeasurement:
    priority:    1
    depends:     [ ProjectileRange ]
    preconditions: "a measured trajectory data set is available"
    action:      "compare modeled range to observed range"
    expected:    "relative error within stated tolerance"
    validation:  "residual analysis over the data set"
    status:      planned

target:
  root            "out"
  layout          mirror-source
  java-version    21
  package-root    "com.example.kinematics"
  target-language sleela