{
  "spec": "fio",
  "spec_version": "0.3.0",
  "capabilities": {
    "profile": "full-v0"
  },
  "manifest": {
    "id": "mit-buildvac-ventilation-v1-0",
    "name": "MIT BuildVac Ventilation Requirements",
    "description": "MIT BuildVac Ventilation Requirements with version-pinned publisher workbook calculations, scenario inputs and formula-level audit traces.",
    "workbook": {
      "uri": "mit-buildvac-ventilation.xlsx",
      "locale": "en-US",
      "date_system": 1900
    }
  },
  "ports": [
    {
      "id": "program_area_m2",
      "dir": "in",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C5"
      },
      "schema": {
        "type": "number"
      },
      "description": "Nonnegative floor program area. Units: m². Omitted input retains publisher's source default 5000.",
      "default": 5000,
      "constraints": {
        "min": 0
      }
    },
    {
      "id": "program",
      "dir": "in",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C6"
      },
      "schema": {
        "type": "string"
      },
      "description": "Exact source program label; preserve source spelling Buliding and double spaces. Three lookups use documented exact-match preparation for these labels. Units: source enum. Omitted input retains publisher's source default \"Commercial - Office Buliding - Office Space\".",
      "default": "Commercial - Office Buliding - Office Space",
      "constraints": {
        "enum": [
          "Commercial - Office Buliding - Lobbies and Corridors",
          "Commercial - Office Buliding - Office Space",
          "Education  - Assembly",
          "Education - Classrooms (5-8)",
          "Education - Classrooms (9+)",
          "Education - Lecture Classroom",
          "Education - Lecture Hall",
          "Education - Libraries",
          "Education - University Laboratory",
          "Public Assembly - Auditorium Seating",
          "Public Assembly - Libraries",
          "Public Assembly - Museums",
          "Retail - General",
          "Retail - Mall Common Areas",
          "Retail - Supermarket",
          "Residential - Common Corridors",
          "Residential - Living Area"
        ]
      }
    },
    {
      "id": "occupant_density_method",
      "dir": "in",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C7"
      },
      "schema": {
        "type": "string"
      },
      "description": "Select standard density or activate custom_occupant_density. Units: source enum. Omitted input retains publisher's source default \"ASHRAE 62.1-2022 Occupant Density\".",
      "default": "ASHRAE 62.1-2022 Occupant Density",
      "constraints": {
        "enum": [
          "ASHRAE 62.1-2022 Occupant Density",
          "User-Defined Occupant Density"
        ]
      }
    },
    {
      "id": "custom_occupant_density",
      "dir": "in",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!D8"
      },
      "schema": {
        "type": "number"
      },
      "description": "Active only in User-Defined Occupant Density mode; must supply nonnegative numeric value when activating. Omitted baseline is formula placeholder \"-\" and is not a numeric assumption. Units: persons/m². Omitted input retains publisher's source default \"-\".",
      "constraints": {
        "min": 0
      }
    },
    {
      "id": "flow_rate_method",
      "dir": "in",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C12"
      },
      "schema": {
        "type": "string"
      },
      "description": "Select standard rates or activate both custom flow-rate ports. Units: source enum. Omitted input retains publisher's source default \"ASHRAE 62.1-2022 Flow Rates\".",
      "default": "ASHRAE 62.1-2022 Flow Rates",
      "constraints": {
        "enum": [
          "ASHRAE 62.1-2022 Flow Rates",
          "User-Defined Flow Rates"
        ]
      }
    },
    {
      "id": "custom_flow_per_area",
      "dir": "in",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!D13"
      },
      "schema": {
        "type": "number"
      },
      "description": "Active only in User-Defined Flow Rates mode; supply alongside custom_flow_per_person. Omitted baseline is formula placeholder \"-\". Units: L/s/m². Omitted input retains publisher's source default \"-\".",
      "constraints": {
        "min": 0
      }
    },
    {
      "id": "custom_flow_per_person",
      "dir": "in",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!D14"
      },
      "schema": {
        "type": "number"
      },
      "description": "Active only in User-Defined Flow Rates mode; supply alongside custom_flow_per_area. Omitted baseline is formula placeholder \"-\". Units: L/s/person. Omitted input retains publisher's source default \"-\".",
      "constraints": {
        "min": 0
      }
    },
    {
      "id": "doas_velocity_m_per_s",
      "dir": "in",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C19"
      },
      "schema": {
        "type": "number"
      },
      "description": "Dedicated outdoor air shaft velocity Units: m/s. Omitted input retains publisher's source default 8.",
      "default": 8,
      "constraints": {
        "min": 0.01
      }
    },
    {
      "id": "doas_safety_fraction",
      "dir": "in",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C20"
      },
      "schema": {
        "type": "number"
      },
      "description": "DOAS shaft oversizing margin (0.15 means 15%) Units: decimal fraction. Omitted input retains publisher's source default 0.15.",
      "default": 0.15,
      "constraints": {
        "min": 0
      }
    },
    {
      "id": "peak_heating_kw",
      "dir": "in",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C29"
      },
      "schema": {
        "type": "number"
      },
      "description": "Peak sensible heating load Units: kW. Omitted input retains publisher's source default 170.",
      "default": 170,
      "constraints": {
        "min": 0
      }
    },
    {
      "id": "peak_cooling_kw",
      "dir": "in",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C30"
      },
      "schema": {
        "type": "number"
      },
      "description": "Peak sensible cooling load Units: kW. Omitted input retains publisher's source default 240.",
      "default": 240,
      "constraints": {
        "min": 0
      }
    },
    {
      "id": "cooling_setpoint_c",
      "dir": "in",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C31"
      },
      "schema": {
        "type": "number"
      },
      "description": "Cooling setpoint must exceed supply_air_temperature_c Units: °C. Omitted input retains publisher's source default 24.",
      "default": 24
    },
    {
      "id": "heating_setpoint_c",
      "dir": "in",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C32"
      },
      "schema": {
        "type": "number"
      },
      "description": "Heating setpoint must exceed supply_air_temperature_c for the source calculation Units: °C. Omitted input retains publisher's source default 18.",
      "default": 18
    },
    {
      "id": "supply_air_temperature_c",
      "dir": "in",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C34"
      },
      "schema": {
        "type": "number"
      },
      "description": "Common source supply temperature for heating and cooling; must be below both setpoints Units: °C. Omitted input retains publisher's source default 12.8.",
      "default": 12.8
    },
    {
      "id": "air_specific_heat",
      "dir": "in",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C35"
      },
      "schema": {
        "type": "number"
      },
      "description": "Air specific heat capacity Units: kJ/(kg·°C). Omitted input retains publisher's source default 1.006.",
      "default": 1.006,
      "constraints": {
        "min": 0.001
      }
    },
    {
      "id": "air_density",
      "dir": "in",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C36"
      },
      "schema": {
        "type": "number"
      },
      "description": "Air density Units: kg/m³. Omitted input retains publisher's source default 1.202.",
      "default": 1.202,
      "constraints": {
        "min": 0.001
      }
    },
    {
      "id": "all_air_velocity_m_per_s",
      "dir": "in",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C40"
      },
      "schema": {
        "type": "number"
      },
      "description": "All-air supply shaft velocity Units: m/s. Omitted input retains publisher's source default 8.",
      "default": 8,
      "constraints": {
        "min": 0.01
      }
    },
    {
      "id": "all_air_safety_fraction",
      "dir": "in",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C41"
      },
      "schema": {
        "type": "number"
      },
      "description": "All-air shaft oversizing margin (0.15 means 15%) Units: decimal fraction. Omitted input retains publisher's source default 0.15.",
      "default": 0.15,
      "constraints": {
        "min": 0
      }
    },
    {
      "id": "people_count",
      "dir": "out",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C9"
      },
      "schema": {
        "type": "number"
      },
      "description": "Occupant count Units: persons. Positive unless stated otherwise."
    },
    {
      "id": "outdoor_flow_l_per_s",
      "dir": "out",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C16"
      },
      "schema": {
        "type": "number"
      },
      "description": "Total ventilation outdoor airflow Units: L/s. Positive unless stated otherwise."
    },
    {
      "id": "outdoor_flow_m3_per_s",
      "dir": "out",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C17"
      },
      "schema": {
        "type": "number"
      },
      "description": "Total ventilation outdoor airflow Units: m³/s. Positive unless stated otherwise."
    },
    {
      "id": "doas_supply_shaft_m2",
      "dir": "out",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C21"
      },
      "schema": {
        "type": "number"
      },
      "description": "DOAS supply shaft area Units: m². Positive unless stated otherwise."
    },
    {
      "id": "doas_exhaust_shaft_m2",
      "dir": "out",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C22"
      },
      "schema": {
        "type": "number"
      },
      "description": "DOAS exhaust shaft area, equal to supply Units: m². Positive unless stated otherwise."
    },
    {
      "id": "doas_total_shaft_m2",
      "dir": "out",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C23"
      },
      "schema": {
        "type": "number"
      },
      "description": "Combined DOAS supply and exhaust shaft area Units: m². Positive unless stated otherwise."
    },
    {
      "id": "heating_flow_m3_per_s",
      "dir": "out",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C37"
      },
      "schema": {
        "type": "number"
      },
      "description": "All-air heating flow Units: m³/s. Positive unless stated otherwise."
    },
    {
      "id": "cooling_flow_m3_per_s",
      "dir": "out",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C38"
      },
      "schema": {
        "type": "number"
      },
      "description": "All-air cooling flow Units: m³/s. Positive unless stated otherwise."
    },
    {
      "id": "all_air_supply_shaft_m2",
      "dir": "out",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C42"
      },
      "schema": {
        "type": "number"
      },
      "description": "All-air supply shaft area from maximum heating/cooling flow Units: m². Positive unless stated otherwise."
    },
    {
      "id": "all_air_return_shaft_m2",
      "dir": "out",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C43"
      },
      "schema": {
        "type": "number"
      },
      "description": "All-air return shaft area at fixed 80% of supply Units: m². Positive unless stated otherwise."
    },
    {
      "id": "all_air_total_shaft_m2",
      "dir": "out",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!C44"
      },
      "schema": {
        "type": "number"
      },
      "description": "Combined all-air supply and return shaft area Units: m². Positive unless stated otherwise."
    },
    {
      "id": "shaft_comparison",
      "dir": "out",
      "shape": "scalar",
      "location": {
        "a1": "'CALCULATION'!Q3"
      },
      "schema": {
        "type": "string"
      },
      "description": "Source textual comparison of DOAS and all-air shafts Units: text. Positive unless stated otherwise."
    }
  ]
}
