Skip to content

Latest commit

 

History

History
45 lines (31 loc) · 3.5 KB

README.md

File metadata and controls

45 lines (31 loc) · 3.5 KB

Manim-Circuit Plugin

Description

A manim-plugin that adds customized Mobject and VMobject(s) to create some electrical components. Some electrical components include: Resistors, Inductors, and Capacitors.

Ok... But WHY?

Manim is an animation library for mathematics. So... what am I doing over here, making some basic circuit elements in the form of customized Mobjects? Well, as it turns out, much of circuit analysis has some pretty cool mathematics behind it, and so I wished that there was a library that could give me those customized Mobjects. I am making this library alongside the production of my Practical Engineering series on YouTube.

"airight man, but you do know that other libraries exist, you know... CircuiTikz via LaTex, circuitanimlib for ManimGL just to name a few... Stop insisting on re-inventing the wheel".

Alright, let's talk about CircuiTikz. I am fully aware that this wonderful LaTex package exists. You can choose to use CircuitTikz to render the circuit, but you cannot select components of that Tex Mobject like you would when using this manim-plugin. Also, I saw a few bugs on forums relating manim and CircuitTikz together, on other GitHub repositories.CircuitTikz is great at making PDFs, drawing circuit diagrams in papers, but it just simply does not fit nicely with Manim.

And for circuitanimlib, the library seemed promising, until I realized its latest commit renders it broken, and its unmaintained. Also, it uses ManimGL which, although faster, has limited documentation on it.

This library is written for ManimCE, not ManimGL. Additionally, there are more resrouces for ManimCE as opposed to ManimGL. Additionally still, ManimCE even has a nice plugin repository and active community plugins. I'd like to make a contribution onto it!

Inspiration

Why I made this library

Roadmap/To-Do

  • Add transistors
  • If I have time, make logic gates too

Completed

  • Make this my first open-source package that I, FuzzyPenguin (online alias: Pete Aptenodyte Forsteri) will maintain.
  • Release this to Pypi
  • Make this a manim-plugin named manim-circuit
  • Clean up the Code
  • Prettify by using VMobjects, and make the point selection more accurate.
  • Optimized Resistors, fully prettified.
  • Maybe make a Circuit Mobject in order to help with circuit analysis
  • Use this library for AT LEAST one of my future videos whatever it may be*

*Supernode Analysis. Unfortunately, the code for this is not published, as I was using ManimGL, and a local fork of manim-circuit to make it compatible with ManimGL. The video is here if you want some inspiration/ideas as to what you could use this library for! I might consider releasing the source code if enough people show interest, but I don't have the time to write a proper disclaimer and make it compatible with ManimCE. I would love to put it in examples/ in the near future though. Leave some comments on the video if you're interested!

Documentation

Resistor(), Inductor(), Capacitor(), supports labels. For example: Inductor(label="0.3", direction=UP) will make a 0.3 H inductor with a label on the top.

All customized Mobjects will have a .get_terminals(self, val) method where passing something in val will return the coordinate of a pin of any circuit Element.

Examples in examples/

License

MIT