{"openapi":"3.1.0","info":{"title":"MIT BuildVac Ventilation Requirements (v1.0)","version":"1.0.0","description":"MIT BuildVac Ventilation Requirements with version-pinned publisher workbook calculations, scenario inputs and formula-level audit traces. selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic.","x-formualizer-Provenance":{"publisher":"MIT Sustainable Design Lab","publisherPageUrl":"https://netzerobuildings.mit.edu/ventilation-requirements","sourceUrl":"https://raw.githubusercontent.com/MITSustainableDesignLab/buildvac/main/spreadsheet/Ventilation%20Requirements%20Spreadsheet.xlsx","workbookFilename":"mit-buildvac-ventilation.xlsx","workbookSha256":"be1459148cc1f737846112302d26f6a36ff7e254111b08c94175d7ff72dee1c9","workbookBytes":35646,"format":"xlsx","licenseClass":"open-academic"},"x-formualizer-VerificationLevel":"scenario-independent-arithmetic","x-formualizer-WorkbookDownload":{"mode":"catalog-bytes","sourceUrl":"https://raw.githubusercontent.com/MITSustainableDesignLab/buildvac/main/spreadsheet/Ventilation%20Requirements%20Spreadsheet.xlsx","sha256":"be1459148cc1f737846112302d26f6a36ff7e254111b08c94175d7ff72dee1c9","bytes":35646},"x-formualizer-Flows":[{"id":"quick_ventilation_shafts","title":"Quick ventilation and shaft comparison","kind":"single","inputPorts":["program_area_m2","program","occupant_density_method","custom_occupant_density","flow_rate_method","custom_flow_per_area","custom_flow_per_person","doas_velocity_m_per_s","doas_safety_fraction","peak_heating_kw","peak_cooling_kw","cooling_setpoint_c","heating_setpoint_c","all_air_velocity_m_per_s","all_air_safety_fraction"],"outputPorts":["people_count","outdoor_flow_l_per_s","doas_total_shaft_m2","all_air_total_shaft_m2","shaft_comparison"]},{"id":"full_ventilation_assessment","title":"Full ventilation and all-air assessment","kind":"single","inputPorts":["program_area_m2","program","occupant_density_method","custom_occupant_density","flow_rate_method","custom_flow_per_area","custom_flow_per_person","doas_velocity_m_per_s","doas_safety_fraction","peak_heating_kw","peak_cooling_kw","cooling_setpoint_c","heating_setpoint_c","supply_air_temperature_c","air_specific_heat","air_density","all_air_velocity_m_per_s","all_air_safety_fraction"],"outputPorts":["people_count","outdoor_flow_l_per_s","outdoor_flow_m3_per_s","doas_supply_shaft_m2","doas_exhaust_shaft_m2","doas_total_shaft_m2","heating_flow_m3_per_s","cooling_flow_m3_per_s","all_air_supply_shaft_m2","all_air_return_shaft_m2","all_air_total_shaft_m2","shaft_comparison"]}]},"paths":{"/evaluate":{"post":{"operationId":"evaluateWorkbook","parameters":[{"name":"tablePort","in":"query","description":"Table input port receiving NDJSON rows or Arrow IPC; omit for scenario envelopes","schema":{"type":"string","enum":[]}},{"name":"flow","in":"query","description":"Named input/output flow (default: quick_ventilation_shafts)","schema":{"type":"string","enum":["quick_ventilation_shafts","full_ventilation_assessment"],"default":"quick_ventilation_shafts"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"inputs":{"$ref":"#/components/schemas/Inputs"}},"required":["inputs"]}},"application/x-ndjson":{"schema":{"type":"string","description":"Table rows with tablePort, otherwise scenario envelopes"}},"application/vnd.apache.arrow.stream":{"schema":{"type":"string","format":"binary"}},"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"responses":{"200":{"description":"Workbook outputs","content":{"application/json":{"schema":{"type":"object","properties":{"outputs":{"$ref":"#/components/schemas/Outputs"}}}},"application/x-ndjson":{"schema":{"type":"string","description":"Scenario results, one JSON envelope per line"}}}}}}},"/evaluate-batch":{"post":{"operationId":"evaluateWorkbookBatch","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scenarios":{"type":"array","items":{"type":"object","properties":{"id":{},"inputs":{"$ref":"#/components/schemas/Inputs"}},"required":["inputs"]}}},"required":["scenarios"]}},"application/x-ndjson":{"schema":{"type":"string","description":"Scenario envelopes, one per line"}}}},"responses":{"200":{"description":"Scenario results (including per-scenario errors)","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{},"outputs":{"$ref":"#/components/schemas/Outputs"},"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}},"application/x-ndjson":{"schema":{"type":"string"}}}}}}},"/ports":{"get":{"operationId":"describePorts","responses":{"200":{"description":"Workbook manifest and ports","content":{"application/json":{"schema":{"type":"object","properties":{"manifest":{"type":"object"},"ports":{"type":"array","items":{"type":"object"}}}}}}}}}},"/types.d.ts":{"get":{"operationId":"typeDeclarations","responses":{"200":{"description":"TypeScript Inputs, Outputs and Client declarations","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/v1/models/{slug}/{edition}/workbook.xlsx":{"get":{"summary":"Download catalog workbook or follow publisher redirect","description":"Download mode: catalog-bytes. Reference-only workbooks redirect to the publisher. The sha256 and bytes metadata pin the catalog file, which may be a sanitized derivative. When present, upstreamArtifact separately pins the publisher file. fio.yaml remains downloadable.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","enum":["mit-buildvac-ventilation"]}},{"name":"edition","in":"path","required":true,"schema":{"type":"string","enum":["v1.0"]}}],"responses":{"200":{"description":"Catalog workbook bytes; upstreamArtifact separately identifies publisher bytes when sanitized","headers":{"x-workbook-sha256":{"schema":{"type":"string"},"description":"be1459148cc1f737846112302d26f6a36ff7e254111b08c94175d7ff72dee1c9"},"x-workbook-bytes":{"schema":{"type":"integer"},"description":"35646"}}}}}}},"components":{"schemas":{"Inputs":{"type":"object","properties":{"program_area_m2":{"type":"number","minimum":0,"description":"Nonnegative floor program area. Units: m². Omitted input retains publisher's source default 5000.","default":5000},"program":{"type":"string","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"],"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"},"occupant_density_method":{"type":"string","enum":["ASHRAE 62.1-2022 Occupant Density","User-Defined Occupant Density"],"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"},"custom_occupant_density":{"type":"number","minimum":0,"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 \"-\"."},"flow_rate_method":{"type":"string","enum":["ASHRAE 62.1-2022 Flow Rates","User-Defined Flow Rates"],"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"},"custom_flow_per_area":{"type":"number","minimum":0,"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 \"-\"."},"custom_flow_per_person":{"type":"number","minimum":0,"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 \"-\"."},"doas_velocity_m_per_s":{"type":"number","minimum":0.01,"description":"Dedicated outdoor air shaft velocity Units: m/s. Omitted input retains publisher's source default 8.","default":8},"doas_safety_fraction":{"type":"number","minimum":0,"description":"DOAS shaft oversizing margin (0.15 means 15%) Units: decimal fraction. Omitted input retains publisher's source default 0.15.","default":0.15},"peak_heating_kw":{"type":"number","minimum":0,"description":"Peak sensible heating load Units: kW. Omitted input retains publisher's source default 170.","default":170},"peak_cooling_kw":{"type":"number","minimum":0,"description":"Peak sensible cooling load Units: kW. Omitted input retains publisher's source default 240.","default":240},"cooling_setpoint_c":{"type":"number","description":"Cooling setpoint must exceed supply_air_temperature_c Units: °C. Omitted input retains publisher's source default 24.","default":24},"heating_setpoint_c":{"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},"supply_air_temperature_c":{"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},"air_specific_heat":{"type":"number","minimum":0.001,"description":"Air specific heat capacity Units: kJ/(kg·°C). Omitted input retains publisher's source default 1.006.","default":1.006},"air_density":{"type":"number","minimum":0.001,"description":"Air density Units: kg/m³. Omitted input retains publisher's source default 1.202.","default":1.202},"all_air_velocity_m_per_s":{"type":"number","minimum":0.01,"description":"All-air supply shaft velocity Units: m/s. Omitted input retains publisher's source default 8.","default":8},"all_air_safety_fraction":{"type":"number","minimum":0,"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}},"required":[],"additionalProperties":false},"Outputs":{"type":"object","properties":{"people_count":{"type":"number","description":"Occupant count Units: persons. Positive unless stated otherwise."},"outdoor_flow_l_per_s":{"type":"number","description":"Total ventilation outdoor airflow Units: L/s. Positive unless stated otherwise."},"outdoor_flow_m3_per_s":{"type":"number","description":"Total ventilation outdoor airflow Units: m³/s. Positive unless stated otherwise."},"doas_supply_shaft_m2":{"type":"number","description":"DOAS supply shaft area Units: m². Positive unless stated otherwise."},"doas_exhaust_shaft_m2":{"type":"number","description":"DOAS exhaust shaft area, equal to supply Units: m². Positive unless stated otherwise."},"doas_total_shaft_m2":{"type":"number","description":"Combined DOAS supply and exhaust shaft area Units: m². Positive unless stated otherwise."},"heating_flow_m3_per_s":{"type":"number","description":"All-air heating flow Units: m³/s. Positive unless stated otherwise."},"cooling_flow_m3_per_s":{"type":"number","description":"All-air cooling flow Units: m³/s. Positive unless stated otherwise."},"all_air_supply_shaft_m2":{"type":"number","description":"All-air supply shaft area from maximum heating/cooling flow Units: m². Positive unless stated otherwise."},"all_air_return_shaft_m2":{"type":"number","description":"All-air return shaft area at fixed 80% of supply Units: m². Positive unless stated otherwise."},"all_air_total_shaft_m2":{"type":"number","description":"Combined all-air supply and return shaft area Units: m². Positive unless stated otherwise."},"shaft_comparison":{"type":"string","description":"Source textual comparison of DOAS and all-air shafts Units: text. Positive unless stated otherwise."}},"required":["people_count","outdoor_flow_l_per_s","outdoor_flow_m3_per_s","doas_supply_shaft_m2","doas_exhaust_shaft_m2","doas_total_shaft_m2","heating_flow_m3_per_s","cooling_flow_m3_per_s","all_air_supply_shaft_m2","all_air_return_shaft_m2","all_air_total_shaft_m2","shaft_comparison"],"additionalProperties":false}}}}