Home

Awesome

circuitSymbols

This extension will assist you creating electric symbols in Inkscape.

<img src="docs/images/Examples.png" width="900px"/>

NEWS: See the new section Changelog for new features!

TIP: If you want to create timing diagrams, please take a look at my newest project wavedromScape

main features

The main features of this extension are

This is a work-in-progress project. New components will be added in the future.

Current and older versions

Compatibility table

InkscapecircuitSymbolsinkscapeMadeEasyReceive updates?
1.01.0 (latest)1.0 (latest)YES
0.48, 0.91, 0.920.9x (obsolete)0.9x (obsolete)NO

Latest version: The latest version of circuitSymbols is 1.0. This version is compatible with Inkscape 1.0 and up only. It is incompatible with older Inkscape versions!

Older versions: If you have an older version of Inkscape, please use the files under the folder 0.9x on Github.

Important: Only the latest version will receive updates, new features, and bug fixes! The usage section in this documentation describes the latest version. In older versions, the disposition of the elements in the plugin's screen might be different. Some features might not be present or have different behavior.

Installation and requirements

Installation procedures for latest and older versions are described below.

Requirements (all versions)

Installation procedure (v1.0 only)

circuitSymbols was developed using Inkscape 1.0 in Linux (Kubuntu 18.04). It should work in different OSs too as long as all requirements are met.

  1. Install inkscapeMadeEasy, version 1.0 (latest). Follow the instructions in the manual page. Note: LaTeX text is used in circuitSymbols if the support is activated (nicer results), otherwise regular text elements will be used.

  2. circuitSymbols installation

    1. Go to Inkscape's extension directory with a file browser. Your inkscape extension directory can be accessed by opening Inkscape and selecting Edit > Preferences > System. Look for the item User Extensions field. There is a button on the right of the field that will open a file explorer window in that specific folder.

    2. Create a subfolder in the extension directory with the name circuitSymbols. Important: Be careful with upper and lower case letters. You must write as presented above.

    3. Download circuitSymbols files and place them inside the directory you just created.

      You don't have to copy all files from Github. The files you will need are inside the latest folder. In the end you must have the following files and directories in your Inkscape extension directory.

      LaTeX users: the file circuitSymbolsPreamble.tex contains the macros defined in this plugin. You can add your own macros to this file. You can also add macros to inkscapeMadeEasy/basicLatexPackages.tex. In this case the same macros will be accessible by all plugins that employ inkscapeMadeEasy.

      inkscape
       ┣━━extensions
       ┋   ┣━━ inkscapeMadeEasy      <-- inkscapeMadeEasy folder
           ┃    ┣━━ inkscapeMadeEasy_Base.py
           ┃    ┣━━ inkscapeMadeEasy_Draw.py
           ┃    ┣━━ inkscapeMadeEasy_Plot.py
           ┃    ┗━━ basicLatexPackages.tex
           ┃
           ┣━━ textext               <-- texText folder (if you installed textText)
           ┃    ┋
           ┃
           ┣━━ circuitSymbols        <-- circuitSymbols folder
           ┋    ┣━━ circuitSymbolsPreamble.tex
                ┣━━ circuitSymbols_semiconductors.inx
                ┣━━ circuitSymbols_general.inx
                ┣━━ circuitSymbols.py
                ┣━━ drawAmpOp.py
                ┣━━ drawArrows.py
                ┣━━ drawDiodes.py
                ┣━━ drawRLC.py
                ┣━━ drawSignals.py
                ┣━━ drawSources.py
                ┣━━ drawSwitches.py
                ┗━━ drawTransistors.py
      
      NOTE: You might have other sub folders inside the extensions directory. They don't interfere with the plugin.
      

Installation procedure (v0.9x only)

circuitSymbols was developed using Inkscape 0.48 and 0.91 in Linux (Kubuntu 18.04). It should work in different OSs too as long as all requirements are met.

  1. Install inkscapeMadeEasy, version 1.0 (latest). Follow the instructions in the manual page. Note: LaTeX text is used in circuitSymbols if the support is activated (nicer results), otherwise regular text elements will be used.

  2. circuitSymbols installation

    1. Go to Inkscape's extension directory with a file browser.

    2. Download circuitSymbols files and place them inside the directory you just created.

      You don't have to copy all files from Github. The files you will need are inside the 0.9x folder. In the end you must have the following files and directories in your Inkscape extension directory.

      inkscape
       ┣━━ extensions
       ┋    ┣━━ inkscapeMadeEasy_Base.py
            ┣━━ inkscapeMadeEasy_Draw.py
            ┣━━ inkscapeMadeEasy_Plot.py
            ┃
            ┣━━ textextLib
            ┃    ┣━━ __init__.py
            ┃    ┣━━ basicLatexPackages.tex
            ┃    ┣━━ CircuitSymbolsLatexPreamble.tex     <-- from repository folder 0.9x!
            ┃    ┣━━ textext.inx
            ┃    ┗━━ textext.py
            ┃
            ┣━━ circuitSymbols.py                  <--
            ┣━━ drawAmpOp.py                       <--
            ┣━━ drawArrows.py                      <--
            ┣━━ drawDiodes.py                      <--
            ┣━━ drawRLC.py                         <--
            ┣━━ drawSignals.py                     <--   from repository folder 0.9x!
            ┣━━ drawSources.py                     <--
            ┣━━ drawSwitches.py                    <--
            ┣━━ drawTransistors.py                 <--
            ┣━━ circuitSymbols_semiconductors.inx  <--
            ┗━━ circuitSymbols_general.inx         <--
      

Usage

This extension is presented in two menu entries: General and Semiconductor. Both can be found under extensions > fsmMLK > Circuit symbols menu.

The first generates symbols of commonly used circuit elements like resistors, capacitors, inductors, switches and various independent and dependent voltage/current sources.

The second generates semiconductor elements like diodes, transistors and operational amplifiers.

Each entry has several tabs. Depending on which tab is on top, the extension will create different elements in your document as soon as you click on Apply button (or check live preview).

In addition to these elements, both menu entries has extra tabs to generate signal labels and annotations. They are repeated in both entries to facilitate its use.

GENERAL menu entry

RLC tab

In this tab you can create resistors, capacitors, inductors and fuses. The section Voltage and current indications serves to add voltage or current annotation arrows to the symbol and adjust their orientations.

<img src="docs/images/Tab_RLC.png" width="450px"/>

Type: You can select the type of bipole. The available types are:

<img src="docs/images/RLC_types.png" width="800px"/>

Important: 2-terminal potentiometer option was removed. You can have the same symbol with resistor + 'Variable' option turned on.

Standard: Here you can choose the standard. There are two options, IEEE Std 315-1975 (american) and IEC 60167 (europe). This option affects RLC tab only.

Orientation: Rotation angle in degrees.

<img src="docs/images/RLC_orientation.png" width="600px"/>

Extra wire length: You can adjust the length of the wires. You can choose any integer number between -10 and 10. (Defaults is 0).

Note: Keep in mind that negative numbers can cause current arrow indication to overlap other elements of the symbol. You can manually adjust if needed.

<img src="docs/images/WireExtraLength.png" width="400px"/>

Value: Literal or numeric value of the bipole. If you type numeric values, you can use M,k,m,u,n,p to indicate multiplier unit. If LaTeX support is enabled, this text will be included in a math environment $...$. Also for LaTeX, there are a couple of functions to specify values in terms of complex impedances. See image below for examples.

Variable: If selected, adds variable arrow on top of the symbol. This option has no effect in fuses and 3-terminal potentiometers.

<img src="docs/images/RLC_variable" width="700px"/>

Add unit: If selected, unit will be automatically added to the value. The unit will be selected accordingly with the type (ohm for resistors and generic bipole (impedance), farad for capacitors, henry for inductors).

Note: If LaTeX support is enabled, the unit will be inserted using siunitx package.

<img src="docs/images/RLC_values.png" width="800px"/>

Voltage and current indications section

Sign convention: Switches between passive and active sign conventions. This option affects the symbol only if you add voltage and current indications.

<img src="docs/images/sign_convention.png" width="350px"/>

Add voltage/current indications: Add voltage drop and current arrow indications. On the side there are fields for the labels of the annotations. If LaTeX support is enabled, this text will be included in a math environment $...$.

Invert V/I directions: invert the directions of the annotations. Keep in mind that they will still follow the sign convention you selected.

<img src="docs/images/RLC_annotation.png" width="350px"/>

Sources tab

In this tab you can create voltage and current sources. The sources can be independent or dependent (contolled).

This tab contains two subtabs, Independent and Dependent. The 'Apply' button will execute the action associated to the subtab that is on the top.

There is also a common section called Voltage and current indications that will serve both types of sources to add voltage or current annotation arrows to the symbol and adjust their orientations.

<img src="docs/images/Tab_Src.png" width="450px"/>

Independent source subtab

<img src="docs/images/Tab_SrcInd.png" width="450px"/>

Type: Here you can select the type of source. The available types are presented below.

<img src="docs/images/IndSrc_types.png" width="700px"/>

Standard: Here you can choose the standard. There are two options, IEEE Std 315-1975 (american) and IEC 60167 (europe). This option affects independent sources only. Old current source style (DIN?) is not affected by this option.

Orientation: Rotation angle in degrees. See RLC tab section for examples.

Extra wire length: You can adjust the length of the wires. See RLC tab section for examples.

Invert source direction: invert the direction of the source.

Value: Literal or numeric value of the bipole. If you type numeric values, you can use M,k,m,u,n,p to indicate multiplier unit. If LaTeX support is enabled, this text will be included in a math environment $...$. Also for LaTeX, there are a couple of functions to specify values in terms of phasors. See examples below.

Variable: If selected, adds variable arrow on top of the symbol. See RLC tab section for examples.

Add unit: If selected, unit will be automatically added to the value. The unit will be selected accordingly with the type (V for voltages and A for current).

Note: If LaTeX support is enabled, the unit will be inserted using siunitx package.

<img src="docs/images/indSrc_values.png" width="800px"/>

Dependent source subtab

<img src="docs/images/Tab_SrcDep.png" width="450px"/>

Type: Here you can select the type of source. The available types are presented below.

Standard: Here you can choose the standard. There are two options, IEEE Std 315-1975 (american) and IEC 60167 (europe). This option affects dependent sources only.

<img src="docs/images/DepSrc_types.png" width="900px"/>

Orientation: Rotation angle in degrees. See RLC tab section for examples.

Extra wire length: You can adjust the length of the wires. See RLC tab section for examples.

Invert source direction: invert the direction of the source.

Control: You can select the type of control, votage or current.

Gain: control gain of the source. If LaTeX support is enabled, this text will be included in a math environment $...$.

Control signal: Label of the control signal (voltage or current, depending on the type of control). If LaTeX support is enabled, this text will be included in a math environment $...$.

Draw congtrol indications: If selected, the extension will create control indication arrows in all possible directions. This allow you to choose from them the arrow that fits your situation.

<img src="docs/images/DepSrc_controlOptions.png" width="250px"/>

Voltage and current indications section

Sign convention: Switches between passive and active sign conventions. This option affects the symbol only if you add voltage and current indications. See RLC tab section for examples.

Add voltage/current indications: Add voltage drop and current arrow indications. On the side there are fields for the labels of the annotations. If LaTeX support is enabled, this text will be included in a math environment $...$.

Invert V or I directions: invert the directions of the indications. If activated, a negative sign will be automatically added to:

<img src="docs/images/IndSrc_conventions_invert.png" width="700px"/>

Switches tab

In this tab you can create switches. The section Commuting information allows you to configure commutation annotation. The section Voltage and current indications serves to add voltage or current annotation arrows to the symbol and adjust their orientations.

<img src="docs/images/Tab_switch.png" width="450px"/>

Number of poles/throws: Here you can select the number of poles (1 to 4) and throws (1 to 8) of the switch (nPmT). See examples below.

<img src="docs/images/switch_poles_throws.png" width="850px"/>

Orientation: Rotation angle in degrees. See RLC tab section for examples.

Extra wire length: You can adjust the length of the wires. See RLC tab section for examples.

Label: Set the text of the label of the switch. If LaTeX support is enabled, this text will be included in a math environment $...$.

Push-button: Sets the switch to push-button. Activating this option will force number of throws to one (nT=1).

<img src="docs/images/switch_pushButton.png" width="400px"/>

Current state: Here you can select which output channel is connected to the input, if any (open switch). If the number selected here is larger than the number of outputs (nT), the last output will be connected.

<img src="docs/images/switch_channel.png" width="700px"/>

Commutating information section

Commutating arrow: Adds annotation arrow indicating change of state. See image below

Commuting text: Adds text near the commuting arrow. Useful to express the time when the switch changes state. See image below

Direction: invert commuting arrow direction. Used only if nT > 1

<img src="docs/images/switch_commuting.png" width="800px"/>

Voltage and current indications section

Sign convention: Switches between passive and active sign conventions. This option affects the symbol only if you add voltage and current indications. See RLC tab section for examples.

Add voltage/current indications: Add voltage drop and current arrow indications. On the side there are fields for the labels of the annotations. If LaTeX support is enabled, this text will be included in a math environment $...$. See RLC tab section for examples.

Invert V/I directions: invert the directions of the annotations. Keep in mind that they will still follow the sign convention you selected. See RLC tab section for examples.

Transformers tab

In this tab you can create transformers.

<img src="docs/images/Tab_transformers.png" width="450px"/>

Type: You can select the type of transformer. The available types are:

<img src="docs/images/transf_types.png" width="300px"/>

Orientation: Rotation angle in degrees. See RLC tab section for examples.

Extra wire length: You can adjust the length of the wires. See RLC tab section for examples.

Core type: You can choose between air, iron, and ferrite cores

<img src="docs/images/transf_coreTypes.png" width="600px"/>

Step type: You can choose between step up, step down, and one to one. This option affects transformers only.

<img src="docs/images/transf_stepTypes.png" width="600px"/>

Add coil polarity: You can add symbol to indicate the polarity of the coils. This option affects transformers only.

<img src="docs/images/transf_polaritySymbol.png" width="300px"/>

Primary/Secondary subtab

The subtabs control each coil of the transformer. Only the Primary subtab affects inductors.

Number of coils: You can choose the number of coils in the primary/secondary. You can choose between 1 or 2 coils. This option has not effect on inductors.

<img src="docs/images/transf_Ncoils.png" width="300px"/>

Coil tap: Adds a centra tap to the coil

Flip coil polarity: Flip the polarity indictaion in the coils

<img src="docs/images/transf_flipPolarity.png" width="300px"/>

Voltage and current indications

Voltage and current indications section

Sign convention: Switches between passive and active sign conventions. This option affects the symbol only if you add voltage and current indications. See RLC tab section for examples.

Add voltage/current indications: Add voltage drop and current arrow indications. On the side there are fields for the labels of the annotations. If LaTeX support is enabled, this text will be included in a math environment $...$. See RLC tab section for examples.

Invert V/I directions: invert the directions of the annotations. Keep in mind that they will still follow the sign convention you selected. See RLC tab section for examples.

Sig./Ind tab

This tab is presented in two subtabs, Signals and Indications. The first create signal nodes to add to your circuit. The second creates custom voltage and current arrow indications to use in your circuit. The 'Apply' button will execute the action associated to the subtab that is on the top

<img src="docs/images/Tab_Signals.png" width="450px"/>

Signals subtab

<img src="docs/images/Tab_SignalsSub.png" width="450px"/>

Type: Allows the selection of the type of signal. You can select a few commonly used signal or select Custom to customize its label. (see below)

<img src="docs/images/SignalTypes.png" width="700px"/>

Direction: Direction of the signal line. This option is used only if Draw signal line option is enabled.

Label: Label of the signal. This option is used only if Custom or Digital is selected in Signal type. If LaTeX support is enabled the text will be inserted in a mathematical environment $...$

<img src="docs/images/SignalDirection.png" width="400px"/>

Draw signal line: signal line toggle.

<img src="docs/images/SignalLines.png" width="200px"/>

Indication subtab

This tab allows you to create custom voltage or current indications to add to your circuits.

<img src="docs/images/Tab_Arrows.png" width="450px"/>

Type: You can select voltage or current indication arrows.

<img src="docs/images/Anno_types.png" width="250px"/>

Orientation: Rotation angle in degrees. See RLC tab section for examples.

Invert direction: invert the directions of the arrows.

Invert disposition: invert disposition of the indications. See image below.

<img src="docs/images/Anno_orientation.png" width="700px"/>

Label: Label of the indication. If LaTeX support is enabled the text will be inserted in a mathematical environment $...$

Add unit: If selected, unit will be automatically added to the value. The unit will be selected accordingly with the type (V for voltage and A for current).

Indication size: Sizes of the arrows. There is one field for voltage and another for current arrows.

Color Setup section

This section controls the color of current and voltage indications.

In both cases, you have two options in the Color drop down menu:

<img src="docs/images/Anno_types.png" width="250px"/>

SEMICONDUCTOR menu entry

Diodes tab

In this tab you can create diodes and LEDs.

<img src="docs/images/Tab_Diodes.png" width="450px"/>

Type: You can select the type of semiconductor. The available types are:

<img src="docs/images/Semi_types.png" width="600px"/>

Orientation: Rotation angle in degrees. See RLC tab section for examples.

Extra wire length: You can adjust the length of the wires. See RLC tab section for examples.

Invert diode direction: invert the direction of the diode.

Label: Label of the indication. If LaTeX support is enabled the text will be inserted in a mathematical environment $...$

Voltage and current indications section

Sign convention: Switches between passive and active sign conventions. This option affects the symbol only if you add voltage and current indications. See RLC tab section for examples.

Add voltage/current indications: Add voltage drop and current arrow indications. On the side there are fields for the labels of the annotations. If LaTeX support is enabled, this text will be included in a math environment $...$.

Invert V/I directions: invert the directions of the annotations. Keep in mind that they will still follow the sign convention you selected. See RLC tab section for examples.

BJT tab

In this tab you can create BJT (photo)transistors.

<img src="docs/images/Tab_BJT.png" width="450px"/>

Type/Phototransistor: You can select the type of transistor.

<img src="docs/images/BJT_types.png" width="700px"/>

Orientation: Rotation angle in degrees. See RLC tab section for examples.

Extra wire length: You can adjust the length of the wires. See RLC tab section for examples.

Phototransistor: Turns the BJT into a phototransistor. See image above.

Draw Envelope: Draws an envelope circle around the transistor

<img src="docs/images/BJT_envelope.png" width="400px"/>

Switch Emitter/Collector terminals: Switch terminals. Attention: This will not switch between NPN and PNP transistors.

<img src="docs/images/BJT_switch_EC.png" width="400px"/>

Add E/B/C tags: Add emitter, base and collector labels to the symbols. See image below.

Voltage and current indications section

Add v_CE/v_CB/v_BE indications: Add voltage drop indications across the transistor. On the side there are fields for the labels of the annotations. If LaTeX support is enabled, this text will be included in a math environment $...$. See image below.

Add i_C/i_B/i_E indications: Add collector, base and emitter current indications. On the side there are fields for the labels of the annotations. If LaTeX support is enabled, this text will be included in a math environment $...$. See image below.

<img src="docs/images/BJT_annotations.png" width="800px"/>

FET tab

In this tab you can create MOSFET and JFET transistors.

<img src="docs/images/Tab_FET.png" width="450px"/>

FET Type / Channel type: Specifies the type of FET.

<img src="docs/images/MOSFET_Types.png" width="800px"/> <img src="docs/images/JFET_Types.png" width="300px"/>

MOSFET symbol type (MOSFET only): Switch between different symbol schemes. See figure below.

<img src="docs/images/MOSFET_symbolType.png" width="600px"/>

Orientation: Rotation angle in degrees. See RLC tab section for examples.

Extra wire length: You can adjust the length of the wires. See RLC tab section for examples.

Add body diode (3-terminal MOSFET-E only): Draws the body diode of power MOSFETs.

<img src="docs/images/FET_bodyDiode.png" width="400px"/>

Move gate towards the source (JFET only): Moves gate terminal.

<img src="docs/images/JFET_gate_position.png" width="400px"/>

Draw Envelope: Draws an envelope circle around the transistor

<img src="docs/images/FET_envelope.png" width="400px"/>

Switch Source/Drain terminals: Switch terminals. Attention: This will not switch between different channel types.

<img src="docs/images/FET_switch_SD.png" width="900px"/>

Add S/G/D tags: Add source, gate and drain labels. See image below.

Voltage and current indications section

Add v_GS/v_DS/v_DG indications: Add voltage drop indications across the transistor. On the side there are fields for the labels of the indication. If LaTeX support is enabled, this text will be included in a math environment $...$. See image below.

Add i_D/i_S/i_G indications: Add drain, source and gate current indications. On the side there are fields for the labels of the indication. If LaTeX support is enabled, this text will be included in a math environment $...$. See image below.

<img src="docs/images/FET_annotations.png" width="800px"/>

Operational amplifier tab

In this tab you can create operational amplifiers.

<img src="docs/images/Tab_OpAmp.png" width="450px"/>

Type: You can select the type of operational amplifier. At the moment there is only one type of OpAmp.

<img src="docs/images/OpAmp_types.png" width="150px"/>

Invert inputs: invert the position between inverting and non inverting inputs

Supply section

Add supply terminals: draw power supply terminals. See image below

Add supply values: Add signal nodes to supply terminals. This parameter has effect only if Add supply terminals is checked. See image below

Symmetric supply: Force symmetric supply. This parameter has effect only if Add supply values is checked. See image below

+V/-V supply label: positive/negative supply values. -V is used only if Symmetric supply is unchecked. See image below

<img src="docs/images/OpAmp_supply.png" width="850px"/>

Voltage and current indications section

Add (v+) (v-) indications: add input nodal voltage indications. On the side there are fields for the labels of the indications. If LaTeX support is enabled, this text will be included in a math environment $...$. See image below.

Add (i+) (i-) indications: add input current indications. On the side there are fields for the labels of the indications. If LaTeX support is enabled, this text will be included in a math environment $...$. See image below.

Add V_out indication: add output nodal voltage indication. On the side there is a text field for the label of the indication. If LaTeX support is enabled, this text will be included in a math environment $...$. See image below.

Add I_out indication: add output current indication. On the side there is a text field for the label of the indication. If LaTeX support is enabled, this text will be included in a math environment $...$. See image below

Add V_d indication: add input differential voltage indication. On the side there is a text field for the label of the indication. If LaTeX support is enabled, this text will be included in a math environment $...$. See image below

<img src="docs/images/OpAmp_annotation.png" width="950px"/>

Sig./Ind tab

This tab is identical to the tab with the same name on GENERAL menu entry. Check the documentation there.

Observations

<img src="docs/images/latex_commands.png" width="900px"/>

Examples

<img src="docs/images/Example_B.png" width="550px"/> <img src="docs/images/Example_D.png" width="450px"/> <img src="docs/images/Example_E.png" width="450px"/> <img src="docs/images/Example_C.png" width="900px"/> <img src="docs/images/Example_A.png" width="450px"/> <img src="docs/images/Example_F.png" width="450px"/> <img src="docs/images/Example_G.png" width="700px"/> <img src="docs/images/Example_H.png" width="450px"/> <img src="docs/images/Example_I.png" width="250px"/>

Changelog

2022-02feb-19