Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nicklasvraa/draw-io-ece
Custom-made draw.io-shapes - in the form of an importable library - for drawing circuits and conceptual drawings in draw.io.
https://github.com/nicklasvraa/draw-io-ece
circuits control diagrams documentation drawio ece electronics engineering graphing latex schematics
Last synced: 3 days ago
JSON representation
Custom-made draw.io-shapes - in the form of an importable library - for drawing circuits and conceptual drawings in draw.io.
- Host: GitHub
- URL: https://github.com/nicklasvraa/draw-io-ece
- Owner: NicklasVraa
- License: gpl-3.0
- Created: 2023-03-11T15:33:21.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-08-17T12:03:38.000Z (5 months ago)
- Last Synced: 2024-10-12T21:42:24.626Z (3 months ago)
- Topics: circuits, control, diagrams, documentation, drawio, ece, electronics, engineering, graphing, latex, schematics
- Homepage:
- Size: 1.78 MB
- Stars: 157
- Watchers: 8
- Forks: 18
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# Draw.io for ECE
This repository contains custom-made draw.io-shapes - in the form of an importable [library](ECE.xml) - for drawing **electrical engineering** and **computer-science** related diagrams, such as circuits and control-architectures in **draw.io**.
## Motivation
Other than LaTeX with the CircuiTikZ package, there aren't really any good ECE-drawing tools available, which can:
- Run offline on all OS's
- Produce textbook-quality circuit diagrams.
- Supports LaTeX math typesetting.
- Export vector-graphics, i.e. SVG.
- Auto-connect and update connections when moving components.
CircuiTikZ produces beautiful results, but it's time-consuming. Most people drawing circuits need a GUI. **Draw.io** is a general-purpose diagramming tool, which already contains libraries for drawing circuits.
The problem is that many of the shapes do not align themselves - or their connectors - to the drawing grid and are completely mismatched in size. They are also not setup to handle text-labels from the get-go, e.g. if you rotate an element, the symbol will be obscured by its own label. This means that drawing circuits in **Draw.io** becomes much more of an exercise in aligning and scaling shapes, which is annoying and time-comsuming.
Hence this simple [library](ECE.xml).
## Importing
In draw.io, simply click `File` in the menu-bar, and then choose `Open library...`, then navigate to the `xml`-file. I highly recommend turning off `view`->`guides` to make componenents only align to the grid.
These are some the ECE-components, which are currently available.
| | |
|---|---|
|   |  |
## Themes
Another benefit of Draw.io: Dark mode and customizable UI.
| Default Dark | [Nord Theme](themes/nord.json) |
|---|---|
|  |  |
To apply a theme, click `Extras` in the menu-bar, then `Configuration...` and paste the contents of `themes/some_theme.json`, like [nord.json](themes/nord.json), into the text-area. Before applying a darkish theme, like nord, have the built-in theme set to dark, and vice-versa for light themes.
## Exporting
To use your drawings in your LaTeX-report, export them as a cropped PDF from Draw.io and then import them into your `.tex` document. This ensures that everything is formatted and positioned correctly.
You can optionally remove the white background by opening the PDF-file in Inkscape or similar, and delete it, then save as SVG. Here is a tiny Inkscape script that does exactly that, assuming that "$*" is the input. I use it with Nemo's (Linux Mint's file explorer) right-click script-runner.
```
inkscape --actions="select-by-id:path1;delete;select-all;page-fit-to-selection;" --export-type=svg "$*";
mv "$*.svg" "$(basename "$*.svg" | cut -d. -f1).svg";
rm "$*"
```
## Examples
| Single transistor circuits | Operational Amplifiers | Analog Filters |
|---|---|---|
|  |  |  |
## Contributing
Want to add more components to the library?
- To create custom shapes in Draw.io, click `arrange` in the menu-bar, and then choose `insert` and then `shape`, which brings up an xml-editor with a preview. Check out the [example xml-files](components/) for inspiration.
- Make sure that your components align with the grid - especially their connection-points - when the element has its proper scaling.
- Remember to setup the text-label and try it in all four orientations.
I encourage you to read this [tutorial](https://www.drawio.com/doc/faq/shape-complex-create-edit), if you want to add complex custom shapes.
If you know of a better tool for drawing ECE-diagrams such as circuits for academic reports, let me know.
---
**LEGAL NOTICE**: This repository, including any and all of its forks and derivatives, may NOT be used in the development or training of any machine learning model of any kind, without the explicit permission of the owner of the original repository.