Documentation Index
Fetch the complete documentation index at: https://mintlify.com/ency07/B2B/llms.txt
Use this file to discover all available pages before exploring further.
The engineering engine (src/utils/engineering.ts) is a pure-function module with no side effects. It implements ASHRAE-based calculations for industrial ventilation pre-engineering: volume, CFM, air density, static pressure, equipment sizing, noise estimation, and investment range.
All functions are framework-agnostic TypeScript — they can be used in Next.js Server Actions, Node.js scripts, or tests without any runtime dependencies.
ACH by Environment
Air Changes per Hour (ACH) values are defined in the ACH_BY_ENVIRONMENT constant and follow ASHRAE standards for industrial environments.
| Environment Key | ACH (Air Changes/Hour) | Use Case |
|---|
heavy_plant | 45 | Heavy manufacturing / foundry |
fundicion | 45 | Casting/smelting (alias) |
mecanico | 20 | Machine shop |
alimentos | 15 | Food processing |
data_center | 30 | Data center |
datacenter | 30 | Data center (alias) |
warehouse | 8 | Warehouse / storage |
almacen | 8 | Warehouse / storage (alias) |
default | 10 | General industrial |
Criticality by Environment
Each environment is assigned a criticality rating defined in CRITICALITY_BY_ENVIRONMENT, based on thermal and hygrometric load:
| Environment Key | Criticality |
|---|
heavy_plant | "ALTA" |
fundicion | "ALTA" |
mecanico | "MEDIA" |
alimentos | "BAJA" |
data_center | "ALTA" |
datacenter | "ALTA" |
warehouse | "BAJA" |
almacen | "BAJA" |
default | "BAJA" |
Exported Functions
calculateRequiredCfm(dimensions, environment)
calculateRequiredCfm(
dimensions: AreaDimensions,
environment: string
): { cubicMeters: number; cubicFeet: number; ach: number; cfm: number }
generateEngineeringReport directly.
generateEngineeringReport(dimensions, environment, altitudeMsnm, tempCelsius, hasDucts)
generateEngineeringReport(
dimensions: AreaDimensions,
environment: string,
altitudeMsnm: number,
tempCelsius: number,
hasDucts: boolean
): DetailedEngineeringReport
AreaDimensions interface:
interface AreaDimensions {
length: number; // in metres
width: number; // in metres
height: number; // in metres
}
DetailedEngineeringReport interface:
interface DetailedEngineeringReport {
cubicMeters: number;
cubicFeet: number;
ach: number;
cfm: number;
airDensity: number; // kg/m³, corrected for altitude and temperature
staticPressure: number; // inWG: 0.5 (no ducts) or 1.5 (with ducts)
powerHp: number; // HP = (CFM × SP) / 6356
powerKw: number; // kW = HP × 0.746 / 0.94 (IE4 efficiency)
noiseDba: number; // base 68 dBA + 10×log10(eqCount)
eqCount: number; // ceil(CFM / 7500)
distribution: string; // e.g. "2 Inyectores + 2 Extractores tipo Hongo"
investmentRangeMinCop: number;
investmentRangeMaxCop: number;
investmentRangeMinUsd: number;
investmentRangeMaxUsd: number;
airVelocityFpm: number; // CFM / outlet area (sq ft)
criticality: "ALTA" | "MEDIA" | "BAJA";
}
calculateAirDensity(altitudeMsnm, tempCelsius)
calculateAirDensity(altitudeMsnm: number, tempCelsius: number): number
- Temperature correction:
293.15 / (tempCelsius + 273.15)
- Altitude correction:
(1 − 2.2557×10⁻⁵ × altitudeMsnm)^5.25588
getAchForEnvironment(environment)
getAchForEnvironment(environment: string): number
ACH_BY_ENVIRONMENT. Defaults to 10 for unknown or unrecognised environment strings.
Constants
| Constant | Value | Description |
|---|
METERS_TO_FEET_FACTOR | 35.3147 | Cubic metres to cubic feet conversion factor (1 m³ = 35.3147 ft³) |
length and width are clamped to a maximum of 500 m.height is clamped to a maximum of 50 m.- Negative or zero values are replaced with a 0.1 m minimum.
- If the resulting
cubicFeet is zero, cfm is returned as 0 to avoid division by zero downstream.
Usage Example
import { generateEngineeringReport } from "@/utils/engineering";
const report = generateEngineeringReport(
{ length: 50, width: 30, height: 8 },
"heavy_plant",
1600, // Bogotá altitude (masl)
18, // temperature °C
true // has ducts
);
console.log(`Required CFM: ${report.cfm}`);
console.log(`Equipment count: ${report.eqCount} units`);
console.log(`Motor power: ${report.powerKw} kW`);
console.log(`Estimated investment: ${report.investmentRangeMinCop.toLocaleString()} COP`);