.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "auto_basic/12_buffer_net.py"
.. LINE NUMBERS ARE GIVEN BELOW.

.. only:: html

    .. note::
        :class: sphx-glr-download-link-note

        :ref:`Go to the end <sphx_glr_download_auto_basic_12_buffer_net.py>`
        to download the full example code.

.. rst-class:: sphx-glr-example-title

.. _sphx_glr_auto_basic_12_buffer_net.py:


=============
Buffering net
=============

This example demonstrate how to buffer a net with single
``fan_in`` and single ``fan_out``


**Before buffering**

.. image:: ../auto_sample_verilog/nested_hierarchy.svg
   :align: center

**After buffering**

.. image:: ../../../examples/basic/_buffered_netlist.svg
    :align: center

.. GENERATED FROM PYTHON SOURCE LINES 21-70

.. code-block:: Python

    import logging

    import spydrnet as sdn
    import spydrnet_physical as sdnphy
    from spydrnet_physical.composers.svg.composer import SVGComposer

    logger = logging.getLogger("spydrnet_logs")
    sdn.enable_file_logging(LOG_LEVEL="INFO")

    netlist = sdnphy.load_netlist_by_name("nested_hierarchy")
    top = netlist.top_instance.reference

    # Create buffer dummy module
    library = top.library
    buffer = library.create_definition("buffer_x1")
    buffer.create_port("A", pins=1, direction=sdn.IN)
    buffer.create_port("Y", pins=1, direction=sdn.OUT)
    a_cable = buffer.create_cable("A", wires=1)
    y_cable = buffer.create_cable("Y", wires=1)
    a_cable.assign_cable(y_cable)

    # Add Buffer on Wire0
    inst = next(top.get_instances("inst_1_0"))
    out_wire = inst.get_port_cables("out")[0]
    top.add_buffer(out_wire, buffer, instance_name="buff0")

    # Add Buffer on Output Nets
    out_wire = next(top.get_cables("out0"))
    top.add_buffer(out_wire, buffer, instance_name="OBuf")

    # # Add Buffer on Passthrough buffer
    # out_wire = next(top.get_cables("out_ft"))
    # top.add_buffer(out_wire, buffer, instance_name="ft_bufer")

    # Add Buffer on Passthrough buffer
    out_wire = next(top.get_cables("out_ft"))
    top.add_buffer(out_wire.wires[0], buffer, instance_name="ft_bufer")

    # Add Buffer on Input Nets
    try:
        out_wire = next(top.get_cables("in0"))
        top.add_buffer(out_wire, buffer, instance_name="IBuf")
    except NotImplementedError:
        pass

    # Write netlist and render SVG
    sdn.compose(netlist, "_buffered_nested_hierarchy.v", skip_constraints=True)
    composer = SVGComposer()
    composer.run(netlist, file_out="_buffered_netlist.svg", top_module="top")


.. _sphx_glr_download_auto_basic_12_buffer_net.py:

.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-example

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download Jupyter notebook: 12_buffer_net.ipynb <12_buffer_net.ipynb>`

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download Python source code: 12_buffer_net.py <12_buffer_net.py>`

    .. container:: sphx-glr-download sphx-glr-download-zip

      :download:`Download zipped: 12_buffer_net.zip <12_buffer_net.zip>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_