Lambda — Fórmulas auditáveis

Repositório público das fórmulas matemáticas usadas pelo Lambda, calculadora de mistura de combustível para preparadores automotivos brasileiros.

O que tem aqui

• src/formulas.ts — Pearson/Turner 2015 (AFR mass-weighted), Anderson 2011 (octanagem molar), balanço estequiométrico, 4 modos de mistura (volume → AFR, AFR alvo → composição, calibração de injetor)
• src/formulas.test.ts — 61 testes unitários (invariantes matemáticas + valores de referência da literatura ICE)
• src/fuels.ts — Biblioteca de 9 combustíveis brasileiros e racing: 3 gasolinas BR (Comum E30, Premium, Podium), 2 etanóis (Hidratado, Anidro), 3 racing fuels (VP C16, VP MS109, Sunoco Standard) + metanol
• src/types.ts — TypeScript types (Fuel, Recipe, MixtureResult, CorrectionResult)

O que NÃO tem

• Código da aplicação (UI, auth, billing, persistência) — fica fechado em repo privado
• Integrações com Stripe/Cognito/MailerLite
• Combustíveis customizados de cliente — biblioteca pública é a "stock" só

Por que separar?

A aplicação é proprietária mas a matemática é auditável. Se algum preparador quiser conferir como calculamos AFR de E30 ou de mistura E70, está aqui. Pull requests com correções de fórmula ou referências adicionais são bem-vindos.

Instalação

npm install lambda-formulas
# ou
pnpm add lambda-formulas

Uso rápido

import { calculateModeA, DEFAULT_FUELS_BY_ID } from "lambda-formulas";

const result = calculateModeA({
  components: [
    { fuelId: "gasoline-c-e30", volumeFraction: 0.7 },
    { fuelId: "ethanol-hydrous", volumeFraction: 0.3 },
  ],
  fuelsById: DEFAULT_FUELS_BY_ID,
});

console.log(result.afrStoich); // 11.83
console.log(result.density);   // 0.758 kg/L
console.log(result.ron);       // 100.4

Rodar testes

pnpm install
pnpm test

61 testes cobrindo invariantes matemáticas + valores de referência da literatura (Heywood, Pulkrabek, Pearson, Anderson, Anderson Jr.).

Licença

MIT — use, modifique, fork. Atribuição apreciada.

Referências canônicas

Normas técnicas brasileiras

• ANP Resolução 988/2025 — gasolina BR E30 (30% etanol anidro em volume)
• ANP Resolução 907/2022 — etanol combustível (EAC e EHC)
• ASTM D86 — densidade
• ASTM D2699 / D2700 — octanagem RON / MON

Literatura ICE

• Heywood, J.B. (2018) Internal Combustion Engine Fundamentals 2nd ed. — capítulo 3 (combustão estequiométrica)
• Pulkrabek, W.W. (2003) Engineering Fundamentals of the Internal Combustion Engine
• Pearson, R.J., Turner, J.W.G. et al. (2015) "Iso-stoichiometric fuel blends: Characterization of physicochemical properties for mixtures of gasoline, ethanol, methanol and water" — Proceedings of the Institution of Mechanical Engineers, Part D
• Anderson, J.E. et al. (2010) "Octane Numbers of Ethanol−Gasoline Blends: Measurements and Predictions" — Energy & Fuels
• Anderson, J.E. et al. (2011) "Octane Numbers of Ethanol- and Methanol-Gasoline Blends Estimated from Molar Concentrations" — Energy & Fuels

Bug?

Achou um bug ou divergência com literatura? Abra issue ou manda PR. Email: roberto@microforge.app.

App fechada

A aplicação Lambda em lambda.microforge.app usa estas fórmulas + UI/persistência/PDF/cloud sync. Trial 14 dias grátis, Pro anual a partir de R$ 99.