Documentation

Everything you need to go from a blank canvas to a solved, downloadable model. Docs are the support channel: if something here is unclear or missing, that's a bug; tell us via the contact form.

Quickstart

Build a minimal system and solve it in under ten minutes.

  1. Open the app. Launch Levelised and sign in with your work email. Sign-in is by magic link; there is no password.
  2. Add components. Drag a generator, a load and a bus onto the canvas and connect them.
  3. Set the load and costs. Give the load a demand profile (or a flat MW figure) and the generator a capital and operating cost.
  4. Solve. Hit Solve, and the optimiser sizes and dispatches the system across 8,760 hourly snapshots.
  5. Read the results. Costs, energy balances and the Sankey view.
  6. Save and download. Save your project to the cloud and download the results as CSV on the Demo tier. The paid tier also downloads the project file and a PyPSA netCDF.

Video walkthrough

Two minutes through the example microgrid, covering the same ground as the in-app guided tour: buses, weather-driven renewables, links, solving, and the levelised cost of electricity.

Worked examples

One complete, solved model for each sector we serve. Each link takes you to the app; sign in with your work email and the example loads. If it's your first visit you'll be offered a short guided tour first to get oriented; the tour is also in the app's main menu whenever you want it later.

Reference

Levelised is built on PyPSA and uses the same component terminology throughout (Buses, Generators, Links, Stores, Loads), so if you want to go deeper on how a component behaves or how the optimisation is formulated, the PyPSA documentation is a useful companion to what's here.

For your IT team

If Levelised is blocked or only half works on a company network, send your IT team the link to this section. Levelised runs entirely in the browser over HTTPS, with nothing to install, and every address it uses is under levelised.com.

Allow levelised.com and *.levelised.com, HTTPS on port 443. Where a wildcard isn't possible, these are the individual hostnames:

Hostname Used for
levelised.com
www.levelised.com 		Website and documentation
app.levelised.com The application and its optimisation engine
auth.levelised.com Sign-in and saved projects
api.levelised.com Feedback, enquiries and usage statistics
tiles.levelised.com Background map when choosing a location

Sign-in emails come from signin@levelised.com. They carry a link to app.levelised.com and a code that can be typed in instead, so sign-in still works where email security rewrites or opens links.

This website also loads an analytics script from posthog.com. Blocking it affects nothing. The app does not use it. Security contact: hello@levelised.com (security.txt).

Release notes

What changed in the app, by version. The version you are using is shown under Help / About in the app.

1.10.2 Maintenance

Maintenance release with no change to the app.

1.10.1 Bug fixes

Bug fixes: double-clicking anywhere on a component now renames it reliably, including locked components, and the optimisation engine is updated.

1.10.0 An assistant in closed beta

An assistant that builds and fixes models from a conversation is in closed beta with the Levelised team ahead of release to paid accounts; the optimisation engine is updated.

1.9.0 Failed solves record why

When a solve fails, the app now records why, so we can help if something goes wrong in your model.

1.8.0 Every input can carry a source

Every number in a model can now carry a source: open the Sources view (the book icon in the Attributes panel) to see, add or edit where each value came from, in the Base case and in scenarios, and export the full assumptions register from the main menu. The bundled examples cite their sources, models built by the AI model builder record theirs, and example buses are now coloured by what they carry.

1.7.1 Maintenance release

Maintenance release with no change to the app.

1.7.0 Imported and generated models are laid out as rows and columns

Models that arrive without a canvas, from an import or a generated file, now open laid out as rows and columns, with supply on the left, storage above and below its bus and by-products off to the top right, and buses coloured by carrier.

1.6.1 Sign-in follow-up

When a sign-in doesn’t go through, we can now see which organisation it came from and get in touch to help.

1.6.0 Cost and efficiency curves

Generators, storage and conversion links can now take piecewise curves for capital cost (economies of scale), running cost and part-load efficiency, with new example projects showing each one, and the optimisation engine is updated.

1.5.3 Clearer sign-in on company networks

If a company network blocks sign-in, the app now says so and links to the addresses your IT team needs to allow.

1.5.2 Works behind company web filters

Sign-in, saving and maps now run from levelised.com addresses only, so the app works on company networks once levelised.com is allowed.

1.5.1 Sign-in fixes

Sign-in emails now work behind company email security, and they include a code you can type in instead of using the link.

1.5.0 Faster solve start

Solves start sooner, and the solver log now shows each step and a running timer while you wait.

1.4.0 Version numbers

Help / About shows the version you are using and links to these release notes.

1.3.0 A map that works on every network

The resource map’s background is served from Levelised’s own hosting, so it loads on corporate and site networks that block third-party map tiles.

1.2.0 Project-wide weather years

One weather year applies to every map-picked trace, feedback moves to the top bar, and the paid tier gains project file and netCDF downloads and netCDF import.

1.1.0 Clearer flows and a newer engine

Sankey diagrams get a scale per bus with storage charge and discharge drawn separately, link efficiencies respect the units on each side, and the optimisation engine is updated.

1.0.0 Levelised is live

First public release: build an energy system on the canvas, solve it hourly over a full year, pick wind and solar traces from the map, open four worked examples, take a guided tour, save to the cloud and download results as CSV.