.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "auto_basic/merge_instance.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_merge_instance.py>`
        to download the full example code.

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

.. _sphx_glr_auto_basic_merge_instance.py:


===================================
Merging two instances in the design
===================================

This example demonstrate how to merge two instance in the design to create a new
merged definition

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

**Output1** Merged design Instance

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

.. GENERATED FROM PYTHON SOURCE LINES 18-44

.. 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
    inst1 = next(top.get_instances("inst_1_0"))
    inst2 = next(top.get_instances("inst_1_1"))

    top.merge_instance(
        [inst1, inst2],
        new_definition_name="merged_module",
        new_instance_name="merged_module_instance_0",
    )

    top.create_unconn_wires()

    composer = SVGComposer()
    composer.run(netlist, file_out="_merged_design.svg")


.. _sphx_glr_download_auto_basic_merge_instance.py:

.. only:: html

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

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

      :download:`Download Jupyter notebook: merge_instance.ipynb <merge_instance.ipynb>`

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

      :download:`Download Python source code: merge_instance.py <merge_instance.py>`

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

      :download:`Download zipped: merge_instance.zip <merge_instance.zip>`


.. only:: html

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

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