Skip to content

FAQ & troubleshooting ​

The app is slow to load. ​

The first visit downloads the app, including its simulation engine (a few megabytes). Subsequent visits use the browser cache and should load in well under a second. If you've cleared cache or are on a slow connection, give it a moment.

My circuit doesn't run. ​

If a run is refused, a message says how many validation errors it found. Click Show logs (in the message, or Logs in the status bar at the bottom) to open the Logs panel, which lists each problem; click a row to highlight the component on the canvas. The most common reasons:

  • Duplicate signal names. Two wires or measurements named the same thing. Rename one of them.
  • Transmission line problems. Every Transmission Line needs a name no other line uses and a line type, and a split line's far end must still have its line. A nominal-PI line can't have its two ends in different subsystems.
  • Parameter problems. Some components require parameters in a specific range (e.g. a positive resistance). The log says which.

An unconnected port doesn't stop a run on its own; check the log for warnings if a result looks wrong.

A display is empty. ​

Check three things:

  • The signal has a name. Only named signals are recorded: double-click a wire to name it, or turn on a measurement in a component's properties dialog. See Observables.
  • The display has a trace. Open the Oscilloscope and use Add trace, or open the Plot's Properties…, or pick the Meter's Signal. See Displays.
  • Recording is on. In the Observables panel (status bar), make sure the signal's Record box is ticked and its tStart / tEnd window covers the run.

A trace looks like a flat line. ​

Either the signal genuinely doesn't change, or the Y-axis is auto-fit to a huge range. Double-click the chart to auto-fit, or move the trace to its own sub-plot for an independent Y range.

Can I export results to CSV? ​

Not at the moment. Results stay in the displays until the next run replaces them.

Download doesn't work. ​

Download (in the editor's ☰ menu) needs a free account. Browsers that support it open their standard save dialog; others save the file straight to your downloads folder. If nothing happens, check whether the browser blocked the download, and look in the address bar for a denied permission. See Saving and loading.

I can't connect two ports. ​

A wire refuses to connect when the two ports don't carry the same kind of signal:

  • Three-phase to single-phase. Three-phase wires are drawn thicker. Use a Breakout (3φ → 3 wires) or a Combine (3 wires → 3φ) to go between the two, or pick the three-phase version of the component.
  • Integer to real. Some control ports carry whole numbers (integers) rather than real numbers. Put an Int → Double or a Double → Int in between.

The log warns about a floating subnetwork. ​

Part of the electrical circuit has no path to a Ground. The run still goes ahead, but voltages to ground in that part may read near zero (voltages between its own nodes are still correct). Each separate electrical circuit needs at least one Ground; add one to the part whose nodes the warning lists.

A From block reads zero. ​

A From block outputs zero when no GoTo, named wire or component measurement publishes the name it asks for, or when more than one does. The log names the block; check the spelling, and make sure exactly one source uses that name. See Signal routing & buses.

Load flow says there's no slack bus. ​

A load flow needs buses placed with the Bus tool, and exactly one of them must have Type set to Slack in Bus Properties. Components only take part when they're wired to a bus. See Load flow.

A run is very slow. ​

Run time grows with the number of steps (Duration ÷ Time Step) and the size of the circuit. Use the largest time step that still resolves the fastest thing you care about, or put the fast part in a subsystem that steps faster than the rest. The progress bar shows the speed as a multiple of real time. See Choosing the time step and duration.

Do I need an account to run a circuit? ​

No. Opening a sample or a shared link, running it and viewing it are free for everyone and need no sign-up — the engine runs locally in your browser. You only need an account to create, edit, save or download a circuit, or to open a .numasim.json file from your computer. See Plans & limits.

What's the difference between running and editing? ​

Running, opening, viewing, and analysis (scopes, observables, plots) are always allowed, at any circuit size. Editing — adding or moving components, drawing wires, and changing parameter values — needs a (free) account, and the size of the circuit you can build depends on your plan.

What counts toward the free size limit? ​

A free account edits circuits up to 51 electrical nodes and 200 components; Circuit info (the i button in the status bar) shows your live usage. See What counts toward the free limit for exactly what is counted.

I opened a circuit bigger than the free limit. Why can't I add to it? ​

You can still run it, change parameter values, and move or delete components. Adding components is paused while the circuit is over the cap — see How each plan behaves.

When can I get Pro? ​

Pro is coming soon; there's no upgrade step yet. It lifts the size cap and adds the AI assistant. See Plans & limits.

Can I use the AI assistant? ​

Not yet. The chat assistant arrives with Pro, and there will be no API key to configure. See The AI assistant.