Merge pull request #2131 from KLayout/vias-development

Vias development

Author: klayoutmatthias

src/db/db/db.pro

@@ -112,6 +112,7 @@ SOURCES = \
   dbUserObject.cc \
   dbUtils.cc \
   dbVector.cc \
+  dbVia.cc \
   dbWriter.cc \
   dbWriterTools.cc \
   dbVariableWidthPath.cc \
@@ -239,7 +240,8 @@ SOURCES = \
   dbNetShape.cc \
   dbShapeCollection.cc \
   gsiDeclDbShapeCollection.cc \
-  dbShapeCollectionUtils.cc
+  dbShapeCollectionUtils.cc \
+  gsiDeclDbVia.cc
 
 HEADERS = \
   dbArray.h \
@@ -354,6 +356,7 @@ HEADERS = \
   dbUserObject.h \
   dbUtils.h \
   dbVector.h \
+  dbVia.h \
   dbWriter.h \
   dbWriterTools.h \
   dbGlyphs.h \

src/db/db/dbCell.cc

@@ -777,6 +777,7 @@ Cell::get_pcell_parameters (const instance_type &ref) const
 Cell::instance_type 
 Cell::change_pcell_parameters (const instance_type &ref, const std::vector<tl::Variant> &new_parameters)
 {
+  tl_assert (mp_layout != 0);
   cell_index_type new_cell_index = mp_layout->get_pcell_variant_cell (ref.cell_index (), new_parameters);
   if (new_cell_index != ref.cell_index ()) {
 
@@ -790,6 +791,61 @@ Cell::change_pcell_parameters (const instance_type &ref, const std::vector<tl::V
   }
 }
 
+Cell::instance_type
+Cell::change_pcell_parameters (const instance_type &ref, const std::map<std::string, tl::Variant> &map)
+{
+  tl_assert (mp_layout != 0);
+
+  const db::PCellDeclaration *pcd = pcell_declaration_of_inst (ref);
+  if (! pcd) {
+    return Cell::instance_type ();
+  }
+
+  const std::vector<db::PCellParameterDeclaration> &pcp = pcd->parameter_declarations ();
+
+  std::vector<tl::Variant> p = get_pcell_parameters (ref);
+  bool needs_update = false;
+
+  for (size_t i = 0; i < pcp.size () && i < p.size (); ++i) {
+    std::map<std::string, tl::Variant>::const_iterator pm = map.find (pcp [i].get_name ());
+    if (pm != map.end () && p [i] != pm->second) {
+      p [i] = pm->second;
+      needs_update = true;
+    }
+  }
+
+  if (needs_update) {
+    return change_pcell_parameters (ref, p);
+  } else {
+    return ref;
+  }
+
+}
+
+const db::PCellDeclaration *
+Cell::pcell_declaration_of_inst (const db::Cell::instance_type &ref) const
+{
+  tl_assert (mp_layout != 0);
+  return mp_layout->cell (ref.cell_index ()).pcell_declaration ();
+}
+
+const db::PCellDeclaration *
+Cell::pcell_declaration () const
+{
+  tl_assert (mp_layout != 0);
+  std::pair<bool, db::pcell_id_type> pc = mp_layout->is_pcell_instance (cell_index ());
+  if (pc.first) {
+    db::Library *lib = mp_layout->defining_library (cell_index ()).first;
+    if (lib) {
+      return lib->layout ().pcell_declaration (pc.second);
+    } else {
+      return mp_layout->pcell_declaration (pc.second);
+    }
+  } else {
+    return 0;
+  }
+}
+
 void 
 Cell::sort_inst_tree (bool force)
 {

src/db/db/dbCell.h

@@ -57,6 +57,7 @@ class Library;
 class ImportLayerMapping;
 class CellMapping;
 class LayerMapping;
+class PCellDeclaration;
 
 /**
  *  @brief The cell object
@@ -473,6 +474,27 @@ class DB_PUBLIC Cell
    */
   instance_type change_pcell_parameters (const instance_type &ref, const std::vector<tl::Variant> &new_parameters);
 
+  /**
+   *  @brief Changes the PCell parameters of a PCell instance using a dict
+   *
+   *  @return A reference to the new instance. The original reference may be invalid.
+   */
+  instance_type change_pcell_parameters (const instance_type &ref, const std::map<std::string, tl::Variant> &new_parameters);
+
+  /**
+   *  @brief Gets the PCellDeclaration object of the instance if the instance is a PCell instance
+   *
+   *  If the instance is not a PCell instance, 0 is returned.
+   */
+  const db::PCellDeclaration *pcell_declaration_of_inst (const db::Cell::instance_type &ref) const;
+
+  /**
+   *  @brief Gets the PCellDeclaration object of the cell is the cell is a PCell variant
+   *
+   *  If the cell is not a PCell variant, 0 is returned.
+   */
+  const db::PCellDeclaration *pcell_declaration () const;
+
   /**
    *  @brief The cell index accessor method
    *

src/db/db/dbManager.cc

@@ -122,7 +122,9 @@ Manager::transaction (const std::string &description, transaction_id_t join_with
     tl_assert (! m_replay);
 
     if (! m_transactions.empty () && reinterpret_cast<transaction_id_t> (& m_transactions.back ()) == join_with) {
-      m_transactions.back ().second = description;
+      if (! description.empty ()) {
+        m_transactions.back ().second = description;
+      }
     } else {
       //  delete all following transactions and add a new one
       erase_transactions (m_current, m_transactions.end ());

src/db/db/dbPCellDeclaration.h

@@ -28,6 +28,7 @@
 
 #include "gsiObject.h"
 #include "dbLayout.h"
+#include "dbVia.h"
 #include "tlVariant.h"
 #include "tlObject.h"
 #include "tlOptional.h"
@@ -672,6 +673,16 @@ class DB_PUBLIC PCellDeclaration
     return std::string ();
   }
 
+  /**
+   *  @brief Returns the description text of the PCell
+   *
+   *  The description text is a for human interpretation only. By default, the name will be returned.
+   */
+  virtual std::string get_description () const
+  {
+    return m_name;
+  }
+
   /**
    *  @brief Returns true, if the PCell can be created from the given shape on the given layer
    *
@@ -717,6 +728,25 @@ class DB_PUBLIC PCellDeclaration
     return false;
   }
 
+  /**
+   *  @brief Returns the via types the PCell can provide
+   *
+   *  This method returns a list of via types the PCell can support.
+   *  If this list is non-empty, the PCell will be used to implement
+   *  vias of one of the given type.
+   *
+   *  Such a PCell needs to support the following (maybe hidden) parameters
+   *  * "via" (string): the name of the via type
+   *  * "w_bottom" (float): the bottom wire width in um or 0 if not specified
+   *  * "h_bottom" (float): the bottom wire height in um or 0 if not specified
+   *  * "w_top" (float): the top wire width in um or 0 if not specified
+   *  * "h_top" (float): the top wire height in um or 0 if not specified
+   */
+  virtual std::vector<ViaType> via_types () const
+  {
+    return std::vector<ViaType> ();
+  }
+
   /**
    *  @brief Gets the Layout object the PCell is registered inside or NULL if it is not registered
    */

src/db/db/dbVia.cc

@@ -0,0 +1,81 @@
+
+/*
+
+  KLayout Layout Viewer
+  Copyright (C) 2006-2025 Matthias Koefferlein
+
+  This program is free software; you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation; either version 2 of the License, or
+  (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+
+*/
+
+#include "dbVia.h"
+#include "dbLibraryManager.h"
+#include "dbPCellDeclaration.h"
+
+namespace db
+{
+
+void
+ViaType::init ()
+{
+  wbmin = 0.0;
+  wbmax = -1.0;
+  hbmin = 0.0;
+  hbmax = -1.0;
+  wtmin = 0.0;
+  wtmax = -1.0;
+  htmin = 0.0;
+  htmax = -1.0;
+  bottom_wired = true;
+  bottom_grid = 0.0;
+  top_wired = true;
+  top_grid = 0.0;
+}
+
+// ---------------------------------------------------------------------------------------
+
+std::vector<SelectedViaDefinition>
+find_via_definitions_for (const std::string &technology, const db::LayerProperties &layer, int dir)
+{
+  std::vector<SelectedViaDefinition> via_defs;
+
+  //  Find vias with corresponding top an bottom layers
+  for (auto l = db::LibraryManager::instance ().begin (); l != db::LibraryManager::instance ().end (); ++l) {
+
+    db::Library *lib = db::LibraryManager::instance ().lib (l->second);
+    if (lib->for_technologies () && ! lib->is_for_technology (technology)) {
+      continue;
+    }
+
+    for (auto pc = lib->layout ().begin_pcells (); pc != lib->layout ().end_pcells (); ++pc) {
+
+      const db::PCellDeclaration *pcell = lib->layout ().pcell_declaration (pc->second);
+
+      auto via_types = pcell->via_types ();
+      for (auto vt = via_types.begin (); vt != via_types.end (); ++vt) {
+        if ((dir >= 0 && vt->bottom.log_equal (layer) && vt->bottom_wired) ||
+            (dir <= 0 && vt->top.log_equal (layer) && vt->top_wired)) {
+          via_defs.push_back (SelectedViaDefinition (lib, pc->second, *vt));
+        }
+      }
+
+    }
+
+  }
+
+  return via_defs;
+}
+
+}