.. jupyter-execute::
    :hide-code:
    
    %config InlineBackend.figure_format = 'svg'
    import schemdraw
    from schemdraw import elements as elm


.. _integratedcircuit:

Integrated Circuits
-------------------

The :py:class:`schemdraw.elements.intcircuits.Ic` class is used to make integrated circuits, multiplexers, and other black box elements. The :py:class:`schemdraw.elements.intcircuits.IcPin` class is used to define each input/output pin before adding it to the Ic.

All pins will be given an anchor name of `inXY` where X is the side (L, R, T, B), and Y is the pin number along that side.
Pins also define anchors based on the `name` parameter.
If the `anchorname` parameter is provided for the pin, this name will be used, so that the pin `name` can be any string even if it cannot be used as a Python variable name.

Here, a J-K flip flop, as part of an HC7476 integrated circuit, is drawn with input names and pin numbers.

.. jupyter-execute::

    JK = elm.Ic(pins=[elm.IcPin(name='>', pin='1', side='left'),
                      elm.IcPin(name='K', pin='16', side='left'),
                      elm.IcPin(name='J', pin='4', side='left'),
                      elm.IcPin(name=r'$\overline{Q}$', pin='14', side='right', anchorname='QBAR'),
                      elm.IcPin(name='Q', pin='15', side='right')],
                edgepadW = .5,  # Make it a bit wider
                pinspacing=1).label('HC7476', 'bottom', fontsize=12)
    display(JK)


Notice the use of `$\overline{Q}$` to acheive the label on the inverting output.
The anchor positions can be accessed using attributes, such as `JK.Q` for the
non-inverting output. However, inverting output is named `$\overline{Q}`, which is
not accessible using the typical dot notation. It could be accessed using 
`getattr(JK, r'$\overline{Q}$')`, but to avoid this an alternative anchorname of `QBAR`
was defined.


Multiplexers
^^^^^^^^^^^^

Multiplexers and demultiplexers are drawn with the :py:class:`schemdraw.elements.intcircuits.Multiplexer` class which wraps the Ic class.


.. jupyter-execute::

    elm.Multiplexer(
        pins=[elm.IcPin(name='C', side='L'),
              elm.IcPin(name='B', side='L'),
              elm.IcPin(name='A', side='L'),
              elm.IcPin(name='Q', side='R'),
              elm.IcPin(name='T', side='B', invert=True)],
        edgepadH=-.5)
        
See the :ref:`gallery` for more examples.


Seven-Segment Display
^^^^^^^^^^^^^^^^^^^^^

A seven-segment display, in :py:class:`schemdraw.elements.intcircuits.SevenSegment`, provides a single digit
with several options including decimal point and common anode or common cathode mode. The :py:meth:`schemdraw.elements.intcircuits.sevensegdigit` method generates a list of Segment objects that can be used to add
a digit to another element, for example to make a multi-digit display.

.. jupyter-execute::
    :hide-code:

    elm.SevenSegment()


DIP Integrated Circuits
^^^^^^^^^^^^^^^^^^^^^^^

Integrated circuits can be drawn in dual-inline package style with :py:class:`schemdraw.elements.intcircuits.IcDIP`.
Anchors allow connecting elements externally to show the IC in a circuit, or interanally to show the internal
configuration of the IC (see :ref:`dip741`.)

.. jupyter-execute::
    :hide-code:
    
    elm.IcDIP()


Predefined ICs
^^^^^^^^^^^^^^

A few common integrated circuits are predefined as shown below.

.. jupyter-execute::
    :hide-code:
    
    elm.Ic555().label('Ic555()', 'bottom')


.. jupyter-execute::
    :hide-code:
    
    elm.VoltageRegulator().label('VoltageRegulator()', 'bottom')


.. jupyter-execute::
    :hide-code:
    
    elm.DFlipFlop().label('DFlipFlop()', 'bottom')


.. jupyter-execute::
    :hide-code:
    
    elm.JKFlipFlop().label('JKFlipFlop()', 'bottom')