ForHosting KIT · Developer Utilities

Two-node voltage analysis calculator

This two-node voltage analysis calculator solves a resistive circuit directly from its branch conductances and injected currents.

● BetaFree · in your browser
Use it from WebAPIEmailTelegramApp soon

Enter the conductance from each node to ground, the conductance connecting the two nodes, and the net current entering each node. The calculator builds the simultaneous nodal equations and returns both voltages relative to ground. It is useful for checking hand calculations, validating a compact circuit model, or adding a deterministic two-node solve to an engineering workflow without rearranging the equations yourself.

Describe the two-node circuit in conductance form

Represent the network with three conductances measured in siemens: one from node 1 to ground, one from node 2 to ground, and one between the two nodes. Conductance is the reciprocal of resistance, so a 1 kΩ branch becomes 0.001 S and a 2 kΩ branch becomes 0.0005 S. Then provide the net injected current at each node in amperes. Use a positive sign when a source pushes current into the node and a negative sign when the specified current leaves it. Keeping that sign convention consistent is essential because nodal analysis is an application of Kirchhoff’s current law. A branch may have zero conductance when it is absent. However, the overall network must include a conductive reference to ground; otherwise, both absolute node voltages can float together and the equations do not have a unique solution. The input fields describe topology explicitly, which avoids ambiguity about whether a given resistor is grounded or connects the two unknown nodes. Convert every branch to siemens before entering it, and use one consistent current unit throughout.

Understand the simultaneous equations

The calculator constructs a 2×2 conductance matrix. For node 1, the diagonal coefficient is the sum of the conductances touching node 1, while the coefficient multiplying node 2 is the negative of the conductance between the nodes. Node 2 follows the same pattern. In equation form, (G1 + G12)V1 − G12V2 = I1 and −G12V1 + (G2 + G12)V2 = I2. The solver evaluates the determinant and applies the closed-form solution for this linear system. A positive determinant gives a unique pair of voltages for a passive network with non-negative branch conductances. A zero determinant means the conductance matrix is singular, usually because neither node has an effective path to the ground reference. That condition is reported as invalid input instead of returning arbitrary or infinite voltages. The returned determinant is included as a useful diagnostic: it confirms what matrix was solved and can reveal a circuit that is approaching a poorly conditioned configuration, although it is not by itself a complete condition-number analysis.

Check units, signs, and the resulting voltages

Read the two voltage results as potentials relative to ground. With conductance in siemens and current in amperes, the result is in volts because the nodal system follows I = GV. Negative voltage is valid and does not indicate a solver error; it can arise whenever the net source directions pull a node below the chosen ground reference. For a quick verification, substitute both returned voltages into the original node equations. The calculated branch-current sums should reproduce the two injected currents, allowing for ordinary floating-point rounding. Also consider limiting cases. If the inter-node conductance is zero, each node should reduce to its independent current-over-ground-conductance result. If the inter-node conductance becomes large, the two voltages should move closer together. This capability is intended for linear, resistive, two-node models. Convert voltage sources with series resistance to equivalent Norton current sources and conductances before use. Do not apply the result directly to capacitors, inductors, nonlinear semiconductor models, or time-varying behavior unless those elements have already been replaced by a valid linear conductance model for the specific analysis point.

Check a hand-derived nodal solution

Compare both calculated node voltages with an engineering notebook or classroom derivation.

Solve a Norton-equivalent network

Combine current sources and parallel conductances into a compact two-node linear model.

Validate a circuit workflow

Use a deterministic result as a regression check for software that assembles small conductance matrices.

Which units should I use?

Enter conductances in siemens and injected currents in amperes. The returned node voltages are in volts.

What does a negative injected current mean?

It means the net specified current leaves that node. Positive current is defined as entering the node.

Can a branch conductance be zero?

Yes. Zero represents an absent or open branch, provided the remaining network still gives the nodes a conductive reference to ground.

Why is a singular circuit rejected?

A singular conductance matrix does not determine unique absolute node voltages. This commonly occurs when the network has no path to ground.

Can I enter resistance instead of conductance?

No. Convert each resistance R to conductance with G = 1/R before entering it.

Everything on this page is available programmatically. This section is for teams who want to wire it into their own systems; everyone else can just use the tool above.

POSThttps://api.kit.forhosting.com/elec/nodal-analysis-2

Prefer to automate it? One authenticated POST creates the task; the result comes back by webhook or a signed link. The same capability also runs here on the web, by email and from Telegram — and soon from our app too.

curl -X POST https://api.kit.forhosting.com/elec/nodal-analysis-2 \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conductance_1_ground":0.002,"conductance_2_ground":0.001,"conductance_12":0.0005,"current_1":0.01,"current_2":0.002}'
{
  "conductance_1_ground": 0.002,
  "conductance_2_ground": 0.001,
  "conductance_12": 0.0005,
  "current_1": 0.01,
  "current_2": 0.002
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "elec.nodal_analysis_2",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

The API is asynchronous: the call returns a task_id immediately and the result arrives by webhook. Polling is capped at 1 req/s per task.

Per request$0.002

Published price — no tokens, no invented credits. A failed task is never charged.

HTTPCodeMeaning
401unauthorizedMissing or invalid API key.
402insufficient_balanceYour balance doesn't cover the task price.
404unknown_typeThat task type doesn't exist.
429rate_limitedToo many requests. Use the webhook instead of polling.

Read the full KIT documentation →