Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/emilamaj/js-circuit-solver
Electric circuit solving library in Javascript
https://github.com/emilamaj/js-circuit-solver
circuit-simulation electric-circuit electrical-engineering equation-solver javascript
Last synced: 12 days ago
JSON representation
Electric circuit solving library in Javascript
- Host: GitHub
- URL: https://github.com/emilamaj/js-circuit-solver
- Owner: emilamaj
- Created: 2023-03-01T11:51:21.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2023-04-20T15:09:51.000Z (almost 2 years ago)
- Last Synced: 2024-04-27T04:22:30.330Z (9 months ago)
- Topics: circuit-simulation, electric-circuit, electrical-engineering, equation-solver, javascript
- Language: JavaScript
- Homepage:
- Size: 57.6 KB
- Stars: 1
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# js-circuit-solver
Lightweight library aimed at solving/simulating simple electrical circuits
# Install
Available as [js-circuit-solver](https://www.npmjs.com/package/js-circuit-solver) on npm. \
Run:
`npm install js-circuit-solver`
# Functions
This library currently provides a single function to solve simple resistive circuits. It takes in a circuit object and returns a solved circuit object. \
## solveResistiveCircuit
`function solveResistiveCircuit(circuit, groundNode, sourceNode, sourceVoltage)`
Usage:
- circuit: Object containing circuit information. Array where element at index i is the array of the connections that node i has with other nodes.
- groundNode: Node to be considered as ground
- sourceNode: Node to be considered as source
- sourceVoltage: Voltage of the source node
_circuit_ Object
The following is an example circuit consisting of the source and ground nodes connected by 3 parallel branches each having 2 resistors.
Example circuit diagram:
```
|---R1---R2---|
| |
S---R3---R4---G
| |
|---R5---R6---|
```
Since the circuit only contains resistors, we can solve it using the function `solveResistiveCircuit(circuit, groundNode, sourceNode, sourceVoltage)`.
We want to set the source node (node 0) at 1V and ground node (node 1) at 0V. We can represent this circuit as the following circuit object:
```
[
[
{
to: 2,
resistance: 1
},
{
to: 3,
resistance: 1
},
{
to: 4,
resistance: 1
}
],
[
{
to: 2,
resistance: 1
},
{
to: 3,
resistance: 1
},
{
to: 4,
resistance: 1
}
],
[
{
to: 0,
resistance: 1
},
{
to: 1,
resistance: 1
}
],
[
{
to: 0,
resistance: 1
},
{
to: 1,
resistance: 1
}
],
[
{
to: 0,
resistance: 1
},
{
to: 1,
resistance: 1
}
]
]
```
We get in return the following result, which is an array of objects specifying the *i-th* node's voltage and current flowing to each connected node:
```
[
{
voltage: 1,
connections: [
{
to: 2,
current: 0.5
},
{
to: 3,
current: 0.5
},
{
to: 4,
current: 0.5
}
]
},
{
voltage: 0,
connections: [
{
to: 2,
current: -0.5
},
{
to: 3,
current: -0.5
},
{
to: 4,
current: -0.5
}
]
},
{
voltage: 0.5,
connections: [
{
to: 0,
current: -0.5
},
{
to: 1,
current: 0.5
}
]
},
{
voltage: 0.5,
connections: [
{
to: 0,
current: -0.5
},
{
to: 1,
current: 0.5
}
]
},
{
voltage: 0.5,
connections: [
{
to: 0,
current: -0.5
},
{
to: 1,
current: 0.5
}
]
}
]
```