About LoadLens
LoadLens is a small, free cooling load calculator for buildings. You give it a floor plan PDF or a room schedule; it gives you the room-wise cooling load in TR, supply air in L/s and the watts behind every room.
It exists because the first pass of an HVAC load estimate is usually the slowest part of the job. The rooms are already named and dimensioned in the drawing — retyping them into a spreadsheet is pure copying. LoadLens reads that text layer directly and starts you from the real room list, which you then check and correct.
It is a study and checking tool, not a certified design package. The method is handbook-level and simplified; see Method and assumptions for the exact numbers and Help for what kinds of PDFs work. There is also a case study of what the tool does on a real sheet, including the parts it deliberately refuses to guess.
Who made it
LoadLens is built and maintained by Ratul S, an MEP / HVAC drafter and modeller working with Kerala and Gulf projects. It started as a personal script to stop retyping room schedules, and is published as open source so other students, modellers and consultancies can use it and improve it.
The code is public: https://github.com/ratul-sraj/hvac. Issues, corrections to the assumptions and pull requests are welcome there.
The stack
Deliberately boring: no framework, no build step, no CDN.
| Part | What is used |
|---|---|
| Pages and styling | Plain HTML, one CSS file per area, system fonts only. Two separate CSS files: one for the calculator, one for these public pages. |
| Application logic | Plain ES modules (js/*.js) loaded directly by the browser. No bundler, no transpiler, no minification. |
| PDF text extraction | pdf.js 4.10.38, vendored locally in vendor/ so the page works offline. |
| Optional server | Node 22 + Express, with multer for uploads. It serves the same UI and can read the PDF on the server instead of in the browser. |
| Hosting | GitHub Pages for the free static version; the same folder runs on Docker, Render, Railway or Fly if you want the server. |
| Storage | Your browser's local storage, plus plain .json project files you save and open yourself. No database, no accounts. |
| Python | None. The project is Python-free — Node and the browser only, so there is nothing extra to install. |
| Tests | Plain Node scripts (no test framework) for the engine, the parser and the API, plus a puppeteer-core check that drives the real Edge browser. |
How to run it yourself
1. Free version — do nothing
The static version is served straight from GitHub Pages. Open the calculator and it works: the PDF is read in your browser. There is no server and nothing to install.
Best for a quick estimate on any computer, including a college lab.
2. Local version — the Node server
Faster on big drawings, and the PDF is read on your own machine.
- Install Node 22 if you do not have it.
- Get the code:
git clone https://github.com/ratul-sraj/hvac cd hvacnpm installnpm start- Open http://localhost:3000
The page detects the server on its own and switches to server-side reading.
Change the port with PORT=8080 npm start.
Sample drawing credit
The drawings behind Try sample drawing and Try a house plan
are not ours.
Try sample drawing loads LEVEL 11 FLOOR PLAN (a Level 11
office floor plan, printed at SCALE 1:100), uploaded to Wikimedia Commons by
the user Vivianwwj, used under the
Creative Commons
Attribution-ShareAlike 4.0 licence (CC BY-SA 4.0).
Try a house plan loads BALLARAT Waller Estate Floor plan,
uploaded to Wikimedia Commons by the user MichaelScott99, used under the
Creative Commons
Attribution-ShareAlike 3.0 licence (CC BY-SA 3.0). Both licences require us to name the
author and the licence — which is what this page is for.
Office sheet — LEVEL 11 FLOOR PLAN
- File: LEVEL 11 FLOOR PLAN.pdf, Wikimedia Commons.
- Author / uploader: Vivianwwj (own work, uploaded 2015).
- Licence: CC BY-SA 4.0 — the licence text.
- Source page: the Commons file page.
House sheet — BALLARAT Waller Estate
- File: BALLARAT Waller Estate Floor plan.pdf, Wikimedia Commons.
- Author / uploader: MichaelScott99 (own work, uploaded 2014-05-09).
- Licence: CC BY-SA 3.0 — the licence text.
- Source page: the Commons file page.
Each drawing stays under its own licence (share-alike applies to the file: CC BY-SA 4.0 for
the office sheet, CC BY-SA 3.0 for the house sheet). LoadLens' own code is unaffected. We did
not draw them and do not claim them: they are real plans a real engineer would recognise,
which is exactly why they are a better first thing to see than a cartoon. The office sheet
prints room names but no room areas, so its rooms arrive with their areas
unknown and out of the load; the house sheet is a smaller, more enclosed plan. You give each
room an area before it counts — by typing it, or with Fill areas from the drawing.
The full credit also lives in the project's docs/SAMPLE-CREDITS.md.
Where your files go
Your file is never sent to a third party. In the static version the PDF is read by pdf.js inside
your own browser tab and never leaves the computer. In the local server version it is posted to
http://localhost:3000 — your own machine — parsed there, and not stored.
On this site (loadlens.net) the PDF is posted to this site's own server so it can
be read faster; it is parsed in memory and is not stored, and nothing from it is
logged. There is no third-party analytics, no tracking cookies and no account. The only measurement
is an anonymous count of which buttons are used, of coarse reader/source properties and of coarse outcome categories (a failure reason, an error area, or how far a visit got), and — when you upload a drawing — which size band the file fell in and which bands its page and room counts fell in (for example "1-5 MB", "3-5 pages", "25-75 rooms"): bands only, so that a large drawing can be told apart from a small one without the file, its name or its exact size ever being sent. That measurement is joined by the
four utm_ campaign tags from the page URL if present — no cookie, no id, no IP
address, no file name, no room name, and never your drawing or its contents. This is a recent change: the site's own web server keeps ordinary access logs — the IP address that asked for which page, and the browser type it gave — so that unique visitors can be counted; those logs stay in the owner's own AWS account and are never shared, and no drawing or file content is ever in them.
Contributing
The method numbers live in one readable file and the assumptions are all named. If you find a value that does not match your local code (NBC India, ECBC, ASHRAE), open an issue at github.com/ratul-sraj/hvac with the city and the reference. Corrections are welcome.