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 and date. The version you are using is shown under Help / About in the app.

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.