CivilKit Calcs

An Excel alternative for engineering calculations

Spreadsheets are the default tool for a quick engineering calculation, and for good reason: they are everywhere and everyone can open one. They are also a poor place to show workings. The formula sits behind a cell, the units are in a header, and a reviewer has to click through references to see what was done.

CivilKit Calcs keeps the calculation as a readable document instead. This page compares the two honestly, including where a spreadsheet is still the better tool.

Open Calcs Read the guide

The same calculation, written out

In a spreadsheet, a bending stress is a number in a cell whose formula reads something like =B4/B5, with the unit conversion done by hand. In a sheet it is:

# Bending stress

M: 54 kN*m | design moment
Z: 691.76 cm^3 | section modulus
sigma: M / Z -> MPa | bending stress

The report shows the formula, the numbers substituted and the result: 78.06 MPa. The engine converted kN·m divided by cm³ into MPa because you asked for MPa. A reviewer reads the page top to bottom and does not need to open anything.

Video: Export a report to Word, Excel and PDF (about 85 seconds). Read the chapter Exporting.

Where a calculation sheet is stronger

Where a spreadsheet is still better

Use a spreadsheet for tables of many similar rows, quick what-if columns, data you will sort or filter, pivot tables, and anything shared with people who only have Excel. A calculation sheet is for a calculation with a story: inputs, steps and checks that you want to read and file. Many engineers use both.

Getting the results into Excel

Export gives you a workbook with the report in document order. Each equation is a row with its description, name, expression, the expression with numbers put in, value and unit. There are separate sheets for variables, for each vector or matrix, for the inputs and for plot data, and plots become native Excel charts that you can edit.

Be clear about what you get: the cells hold calculated values with the expressions as text. They are not live Excel formulas, so changing a cell in the workbook does not recalculate the rest. The workbook opens in LibreOffice and a Python reader. We have not tried it in Microsoft Excel, so check it opens as you expect.

If you want a document rather than a workbook, export Word, with real equations, or print the report to PDF.

Moving a spreadsheet calculation over

Take the cell that holds the answer, and work backwards. Write each input as a line with its unit, then each formula as a line using those names. Keep the same numbers and check the result against the spreadsheet. A good first target is a calculation you repeat often, because you can turn its inputs into a template and reuse it as a form.

Questions

Can it replace Excel?

Not as a general tool. It replaces the spreadsheets you use to show a single calculation with its workings. For large tables of data, sorting and pivots, Excel remains the right tool.

Does the Excel export keep my formulas live?

No. The workbook holds calculated values and the expressions as text. It also has native charts. Do the recalculation in the sheet, not in the workbook.

Does it check units?

Yes. Units are part of every quantity, so multiplication and division combine them, results convert to the unit you ask for, and adding incompatible units is an error.

Can I import data from a spreadsheet?

A worksheet can read a matrix from a file kept in the browser library with the #read command; see the user guide. For a first calculation, typing the few input values is simpler.

Does it need an internet connection?

No. After the first visit it works offline, and nothing you calculate is sent to a server.

Open Calcs Read the guide