xref: /dports/cad/openroad/OpenROAD-2.0/src/OpenDB/include/opendb/db.h

///////////////////////////////////////////////////////////////////////////////
// BSD 3-Clause License
//
// Copyright (c) 2019, Nefelus Inc
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are met:
//
// * Redistributions of source code must retain the above copyright notice, this
//   list of conditions and the following disclaimer.
//
// * Redistributions in binary form must reproduce the above copyright notice,
//   this list of conditions and the following disclaimer in the documentation
//   and/or other materials provided with the distribution.
//
// * Neither the name of the copyright holder nor the names of its
//   contributors may be used to endorse or promote products derived from
//   this software without specific prior written permission.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
// POSSIBILITY OF SUCH DAMAGE.

#pragma once

#include <list>
#include <map>
#include <set>
#include <string>
#include <vector>

#include "ISdb.h"
#include "dbLogger.h"
#include "dbObject.h"
#include "dbSet.h"
#include "dbTypes.h"
#include "dbViaParams.h"
#include "geom.h"
#include "odb.h"

#define ADS_MAX_CORNER 10

namespace utl {
class Logger;
}

namespace odb {

class dbShape;
class lefout;
class dbViaParams;
class dbTransform;

template <class T>
class dbId;

// Forward declarations of all database objects
class dbDatabase;
class dbBox;
class dbJournalEntry;

// Property objects
class dbProperty;
class dbBoolProperty;
class dbStringProperty;
class dbIntProperty;
class dbDoubleProperty;

// Design objects
class dbChip;
class dbBlock;
class dbBTerm;
class dbNet;
class dbInst;
class dbITerm;
class dbVia;
class dbTrackGrid;
class dbObstruction;
class dbBlockage;
class dbWire;
class dbSWire;
class dbSBox;
class dbCapNode;
class dbRSeg;
class dbCCSeg;
class dbBlockSearch;
class dbRow;
class dbFill;
class dbTechAntennaPinModel;
class dbBlockCallBackObj;
class dbRegion;
class dbBPin;

// Lib objects
class dbLib;
class dbSite;
class dbMaster;
class dbMTerm;
class dbMPin;
class dbTarget;

// Tech objects
class dbTech;
class dbTechVia;
class dbTechViaRule;
class dbTechViaLayerRule;
class dbTechViaGenerateRule;
class dbTechNonDefaultRule;
class dbTechLayerRule;
class dbTechLayerSpacingRule;
class dbTechLayerAntennaRule;
class dbTechMinCutRule;
class dbTechMinEncRule;
class dbTechV55InfluenceEntry;
class dbTechSameNetRule;
class dbViaParams;

// Generator Code Begin ClassDeclarations
class dbTechLayer;
class dbTechLayerSpacingEolRule;
class dbTechLayerMinStepRule;
class dbTechLayerCornerSpacingRule;
class dbTechLayerSpacingTablePrlRule;
class dbTechLayerEolKeepOutRule;
class dbTechLayerCutClassRule;
class dbTechLayerCutSpacingRule;
class dbTechLayerCutSpacingTableOrthRule;
class dbTechLayerCutSpacingTableDefRule;
class dbTechLayerCutEnclosureRule;
class dbTechLayerEolExtensionRule;
class dbModule;
class dbModInst;
class dbGroup;
class dbGCellGrid;
// Generator Code End ClassDeclarations

// Extraction Objects
class dbExtControl;

///
/// dbProperty - Property base class.
///
class dbProperty : public dbObject
{
 public:
  enum Type
  {
    // Do not change the order or the values of this enum.
    STRING_PROP = 0,
    BOOL_PROP = 1,
    INT_PROP = 2,
    DOUBLE_PROP = 3
  };

  /// Get the type of this property.
  Type getType();

  /// Get thetname of this property.
  std::string getName();

  /// Get the owner of this property
  dbObject* getPropOwner();

  /// Find the named property. Returns NULL if the property does not exist.
  static dbProperty* find(dbObject* object, const char* name);

  /// Find the named property of the specified type. Returns NULL if the
  /// property does not exist.
  static dbProperty* find(dbObject* object, const char* name, Type type);

  /// Destroy a specific property
  static void destroy(dbProperty* prop);
  /// Destroy all properties of the specific object
  static void destroyProperties(dbObject* obj);
  static dbSet<dbProperty> getProperties(dbObject* object);
  static dbSet<dbProperty>::iterator destroy(dbSet<dbProperty>::iterator itr);
  // 5.8
  static void writeProperties(dbObject* object, FILE* out);
  static void writePropValue(dbProperty* prop, FILE* out);
};

///
/// dbProperty - Boolean property.
///
class dbBoolProperty : public dbProperty
{
 public:
  /// Get the value of this property.
  bool getValue();

  /// Set the value of this property.
  void setValue(bool value);

  /// Create a bool property. Returns NULL if a property with the same name
  /// already exists.
  static dbBoolProperty* create(dbObject* object, const char* name, bool value);

  /// Find the named property of type bool. Returns NULL if the property does
  /// not exist.
  static dbBoolProperty* find(dbObject* object, const char* name);
};

///
/// dbProperty - String property.
///
class dbStringProperty : public dbProperty
{
 public:
  /// Get the value of this property.
  std::string getValue();

  /// Set the value of this property.
  void setValue(const char* value);

  /// Create a string property. Returns NULL if a property with the same name
  /// already exists.
  static dbStringProperty* create(dbObject* object,
                                  const char* name,
                                  const char* value);

  /// Find the named property of type string. Returns NULL if the property does
  /// not exist.
  static dbStringProperty* find(dbObject* object, const char* name);
};

///
/// dbProperty - Int property.
///
class dbIntProperty : public dbProperty
{
 public:
  /// Get the value of this property.
  int getValue();

  /// Set the value of this property.
  void setValue(int value);

  /// Create a int property. Returns NULL if a property with the same name
  /// already exists.
  static dbIntProperty* create(dbObject* object, const char* name, int value);

  /// Find the named property of type int. Returns NULL if the property does not
  /// exist.
  static dbIntProperty* find(dbObject* object, const char* name);
};

///
/// dbProperty - Double property.
///
class dbDoubleProperty : public dbProperty
{
 public:
  /// Get the value of this property.
  double getValue();

  /// Set the value of this property.
  void setValue(double value);

  /// Create a double property. Returns NULL if a property with the same name
  /// already exists.
  static dbDoubleProperty* create(dbObject* object,
                                  const char* name,
                                  double value);

  /// Find the named property of type double. Returns NULL if the property does
  /// not exist.
  static dbDoubleProperty* find(dbObject* object, const char* name);
};

///////////////////////////////////////////////////////////////////////////////
///
/// This class encapsulates a persitant ADS database.
/// You can open multiple databases, however, the number
/// of open databases is limited to the amount
/// of physical memory available.
///
///////////////////////////////////////////////////////////////////////////////
class dbDatabase : public dbObject
{
 public:
  ///
  /// Return the libs contained in the database. A database can contain
  /// multiple libs.
  ///
  dbSet<dbLib> getLibs();

  ///
  /// Find a specific lib.
  /// Returns NULL if no lib was found.
  ///
  dbLib* findLib(const char* name);

  ///
  /// Find a specific master
  /// Returns NULL if no master is found.
  ///
  dbMaster* findMaster(const char* name);

  ///
  /// Get the chip of this database.
  /// Returns NULL if no chip has been created.
  ///
  dbChip* getChip();

  ///
  /// Get the technology of this database
  /// Returns NULL if no chip has been created.
  ///
  dbTech* getTech();

  ////////////////////////
  /// DEPRECIATED
  ////////////////////////
  /// Return the chips contained in the database. A database can contain
  /// multiple chips.
  ///
  dbSet<dbChip> getChips();

  ///
  /// Returns the number of masters
  ///
  uint getNumberOfMasters();

  ///
  /// Translate a database-name to a database object.
  ///
  // dbObject * resolveDbName( const char * dbname );

  ///
  /// Read a database from this stream.
  /// WARNING: This function destroys the data currently in the database.
  /// Throws ZIOError..
  ///
  void read(FILE* file);

  ///
  /// Write a database to this stream.
  /// Throws ZIOError..
  ///
  void write(FILE* file);

  /// Throws ZIOError..
  void writeTech(FILE* file);
  void writeLib(FILE* file, dbLib* lib);
  void writeLibs(FILE* file);
  void writeBlock(FILE* file, dbBlock* block);
  void writeChip(FILE* file);
  void writeWires(FILE* file, dbBlock* block);
  void writeNets(FILE* file, dbBlock* block);
  void writeParasitics(FILE* file, dbBlock* block);
  void readTech(FILE* file);
  void readLib(FILE* file, dbLib*);
  void readLibs(FILE* file);
  void readBlock(FILE* file, dbBlock* block);
  void readWires(FILE* file, dbBlock* block);
  void readNets(FILE* file, dbBlock* block);
  void readParasitics(FILE* file, dbBlock* block);
  void readChip(FILE* file);

  ///
  /// ECO - The following methods implement a simple ECO mechanism for capturing
  /// netlist changes. The intent of the ECO mechanism is to support delta
  /// changes that occur in a "remote" node that must be applied back to the
  /// "master" node. Being as such, the database on the "remote" must be an
  /// exact copy of the "master" database, prior to changes. Furthermore, the
  /// "master" database cannot change prior to commiting the eco to the block.
  ///
  /// WARNING: If these invariants does not hold then the results will be
  ///          unpredictable.
  ///

  ///
  /// Begin collecting netlist changes on specified block.
  ///
  /// NOTE: Eco changes can not be nested at this time.
  ///
  static void beginEco(dbBlock* block);

  ///
  /// End collecting netlist changes on specified block.
  ///
  static void endEco(dbBlock* block);

  ///
  /// Returns true of the pending eco is empty
  ///
  static bool ecoEmpty(dbBlock* block);

  ///
  /// Read the eco changes from the specified stream to be applied to the
  /// specified block.
  ///
  static void readEco(dbBlock* block, const char* filename);

  ///
  /// Write the eco netlist changes to the specified stream.
  ///
  static void writeEco(dbBlock* block, const char* filename);
  static int checkEco(dbBlock* block);

  ///
  /// Commit any pending netlist changes.
  ///
  static void commitEco(dbBlock* block);

  ///
  /// links to utl::Logger
  ///
  void setLogger(utl::Logger* logger);

  ///
  /// Initializes the database to nothing.
  ///
  void clear();

  ///
  /// Create an instance of a database
  ///
  static dbDatabase* create();

  ///
  /// Detroy an instance of a database
  ///
  static void destroy(dbDatabase* db);

  ///
  /// Create a duplicate (IN-MEMORY) instance of a database.
  ///
  /// WARNING: This action may result in an out-of-memory condition if
  ///          there is not enough memory (or swap space) to maintain
  ///          multiple in-core databases.
  ///
  static dbDatabase* duplicate(dbDatabase* db);

  ///
  /// diff the two databases
  /// Returns true if differences were found.
  ///
  static bool diff(dbDatabase* db0,
                   dbDatabase* db1,
                   FILE* file,
                   int indent_per_level);
  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbDatabase* getDatabase(uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A box is the element used to represent layout shapes.
///
///////////////////////////////////////////////////////////////////////////////
class dbBox : public dbObject
{
 public:
  ///
  /// Get the lower coordinate.
  ///
  int xMin();

  ///
  /// Get the lower y coordinate.
  ///
  int yMin();

  ///
  /// Get the high x coordinate.
  ///
  int xMax();

  ///
  /// Get the high y coordinate.
  ///
  int yMax();

  ///
  /// Returns true if this box represents a via
  ///
  bool isVia();

  ///
  /// Get tech-via this box represents.
  /// returns NULL if this box does not represent a tech-via
  ///
  dbTechVia* getTechVia();

  ///
  /// Get block-via this box represents.
  /// returns NULL if this box does not represent a block-via
  ///
  dbVia* getBlockVia();

  ///
  /// Return the placed location of this via.
  ///
  void getViaXY(int& x, int& y);

  ///
  /// Get the box bounding points.
  ///
  void getBox(Rect& rect);

  ///
  /// Get the translated boxes of this via
  ///
  void getViaBoxes(std::vector<dbShape>& boxes);

  ///
  /// Get the width (xMax-xMin) of the box.
  ///
  int getDir();

  ///
  /// Get the width (xMax-xMin) of the box.
  ///
  uint getDX();

  int getDesignRuleWidth() const;

  void setDesignRuleWidth(int);

  ///
  /// Get the height (yMax-yMin) of the box.
  ///
  uint getDY();
  uint getWidth(uint dir = 1);
  uint getLength(uint dir = 1);

  ///
  /// Get GeomShape Interface
  ///
  GeomShape* getGeomShape();

  ///
  /// Set temporary flag visited
  ///
  void setVisited(bool value);
  bool isVisited();
  void setMarked(bool value);
  bool isMarked();

  ///
  /// Get the owner of this box
  ///
  dbObject* getBoxOwner();

  ///
  /// Get the owner type of this box
  ///
  dbBoxOwner getOwnerType();

  ///
  /// Get the layer of this box.
  /// Returns NULL if this shape is an object bbox.
  /// These bboxes have no layer.
  ///     dbBlock    - bbox has no layer
  ///     dbInst     - bbox has no layer
  ///     dbVia      - bbox has no layer
  ///     dbTechVia  - bbox has no layer
  ///
  /// These bboxes have no layer.
  ///    All dbBox(s) that represent VIA's.
  ///
  dbTechLayer* getTechLayer();

  ///
  /// Add a physical pin to a dbBPin.
  /// Returns NULL if this dbBPin already has a pin.
  ///
  static dbBox* create(dbBPin* bpin,
                       dbTechLayer* layer,
                       int x1,
                       int y1,
                       int x2,
                       int y2);

  ///
  /// Add a box to a block-via.
  ///
  static dbBox* create(dbVia* via,
                       dbTechLayer* layer,
                       int x1,
                       int y1,
                       int x2,
                       int y2);

  ///
  /// Add an obstruction to a master.
  ///
  static dbBox* create(dbMaster* master,
                       dbTechLayer* layer,
                       int x1,
                       int y1,
                       int x2,
                       int y2);

  ///
  /// Add a via obstrction to a master.
  /// This function may fail and return NULL if this via has no shapes.
  ///
  static dbBox* create(dbMaster* master, dbTechVia* via, int x, int y);

  ///
  /// Add a wire-shape to a master-pin.
  ///
  static dbBox* create(dbMPin* pin,
                       dbTechLayer* layer,
                       int x1,
                       int y1,
                       int x2,
                       int y2);

  ///
  /// Add a via obstrction to a master-pin.
  /// This function may fail and return NULL if this via has no shapes.
  ///
  static dbBox* create(dbMPin* pin, dbTechVia* via, int x, int y);

  ///
  /// Add a shape to a tech-via;
  ///
  static dbBox* create(dbTechVia* via,
                       dbTechLayer* layer,
                       int x1,
                       int y1,
                       int x2,
                       int y2);

  ///
  /// Add a boundary to a region
  ///
  static dbBox* create(dbRegion* region, int x1, int y1, int x2, int y2);

  ///
  /// Create a halo on an instance.
  ///
  static dbBox* create(dbInst* inst, int x1, int y1, int x2, int y2);

  ///
  /// Translate a database-id back to a pointer.
  /// This function translates any dbBox which is part of a block.
  ///
  static dbBox* getBox(dbBlock* block, uint oid);

  /// Translate a database-id back to a pointer.
  /// This function translates any dbBox which is part of a tech.
  ///
  static dbBox* getBox(dbTech* tech, uint oid);

  ///
  /// Translate a database-id back to a pointer.
  /// This function translates any dbBox whichs is part of a master.
  ///
  static dbBox* getBox(dbMaster* master, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A sbox is the element used to represent special layout shapes.
///
///////////////////////////////////////////////////////////////////////////////
class dbSBox : public dbBox
{
 public:
  /// Direction of segment
  enum Direction
  {
    UNDEFINED = 0,
    HORIZONTAL = 1,
    VERTICAL = 2,
    OCTILINEAR = 3
  };

  ///
  /// Get the shape type of this wire.
  ///
  dbWireShapeType getWireShapeType();

  ///
  /// Return the specified direction of this segment
  ///
  Direction getDirection();

  ///
  /// Get the swire of this shape
  ///
  dbSWire* getSWire();

  ///
  /// Get Oct Wire Shape
  ///
  Oct getOct();

  ///
  /// Add a rect to a dbSWire.
  ///
  /// If direction == UNDEFINED
  ///    |(x2-x1)| must be an even number or |(y2-y1)| must be an even number
  ///
  /// If direction == HORIZONTAL
  ///    |(y2-y1)| must be an even number
  ///
  /// If direction == VERTICAL
  ///    |(x2-x1)| must be an even number
  ///
  /// If the direction sementics are not met, this function will return NULL.
  ///
  /// These requirements are a result that the current DEF semantics (5.5) use
  /// PATH statements to output these rectangles, the paths must have even
  /// widths.
  static dbSBox* create(dbSWire* swire,
                        dbTechLayer* layer,
                        int x1,
                        int y1,
                        int x2,
                        int y2,
                        dbWireShapeType type,
                        Direction dir = UNDEFINED,
                        int width = 0);

  ///
  /// Add a block-via to a dbSWire
  /// This function may fail and return NULL if this via has no shapes.
  ///
  static dbSBox* create(dbSWire* swire,
                        dbVia* via,
                        int x,
                        int y,
                        dbWireShapeType type);

  ///
  /// Add a tech-via to a dbSWire.
  /// This function may fail and return NULL if this via has no shapes.
  ///
  static dbSBox* create(dbSWire* swire,
                        dbTechVia* via,
                        int x,
                        int y,
                        dbWireShapeType type);

  ///
  /// Translate a database-id back to a pointer.
  /// This function translates any dbBox whichs is part of a block
  ///
  static dbSBox* getSBox(dbBlock* block, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A Chip is the element the represents a VLSI/ASIC IC.
///
///////////////////////////////////////////////////////////////////////////////
class dbChip : public dbObject
{
 public:
  ///
  /// Get the top-block of this chip.
  /// Returns NULL if a top-block has NOT been created.
  ///
  dbBlock* getBlock();

  ///
  /// Create a new chip.
  /// Returns NULL if a chip already exists.
  /// Returns NULL if there is no database technology.
  ///
  static dbChip* create(dbDatabase* db);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbChip* getChip(dbDatabase* db, uint oid);

  ///
  /// Destroy a chip.
  ///
  static void destroy(dbChip* chip);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A Block is the element used to represent a layout-netlist.
/// A Block can have multiple children, however, currently only two-levels
/// of hierarchy is supported.
///
///////////////////////////////////////////////////////////////////////////////
class dbBlock : public dbObject
{
 public:
  ///
  /// Get block chip name.
  ///
  std::string getName();

  ///
  /// Get the block chip name.
  ///
  const char* getConstName();

  ///
  /// Get the bounding box of this block.
  ///
  dbBox* getBBox();

  ///
  /// Get the chip this block belongs too.
  ///
  dbChip* getChip();

  ///
  /// Get the database this block belongs too.
  ///
  dbDatabase* getDataBase();

  ///
  /// Get the parent block this block. Returns NULL if this block is the
  /// top-block of the chip.
  ///
  dbBlock* getParent();

  ///
  /// Returns the hierarchical parent of this block if it exists.
  ///
  dbInst* getParentInst();

  ///
  /// Returns the top module of this block.
  ///
  dbModule* getTopModule();

  ///
  /// Get the child blocks of this block.
  ///
  dbSet<dbBlock> getChildren();

  ///
  /// Find a specific child-block of this block.
  /// Returns NULL if the object was not found.
  ///
  dbBlock* findChild(const char* name);

  ///
  /// Get all the block-terminals of this block.
  ///
  dbSet<dbBTerm> getBTerms();

  ///
  /// Find a specific bterm of this block.
  /// Returns NULL if the object was not found.
  ///
  dbBTerm* findBTerm(const char* name);

  ///
  /// Get all the instance-terminals of this block.
  ///
  dbSet<dbITerm> getITerms();

  ///
  /// Get the instances of this block.
  ///
  dbSet<dbInst> getInsts();

  ///
  /// Get the modules of this block.
  ///
  dbSet<dbModule> getModules();

  ///
  /// Get the modinsts of this block.
  ///
  dbSet<dbModInst> getModInsts();

  ///
  /// Get the groups of this block.
  ///
  dbSet<dbGroup> getGroups();

  ///
  /// Find a specific instance of this block.
  /// Returns NULL if the object was not found.
  ///
  dbInst* findInst(const char* name);

  ///
  /// Find a specific module in this block.
  /// Returns NULL if the object was not found.
  ///
  dbModule* findModule(const char* name);

  ///
  /// Find a specific modinst in this block. path is
  /// master_module_name/modinst_name Returns NULL if the object was not found.
  ///
  dbModInst* findModInst(const char* path);

  ///
  /// Find a specific group in this block.
  /// Returns NULL if the object was not found.
  ///
  dbGroup* findGroup(const char* name);

  ///
  /// Find a set of insts. Each name can be real name, or Ixxx, or xxx,
  /// where xxx is the inst oid.
  ///
  bool findSomeInst(const char* names, std::vector<dbInst*>& insts);

  ///
  /// Find a set of masters. Each name can be real name
  ///
  bool findSomeMaster(const char* names, std::vector<dbMaster*>& masters);

  ///
  /// Find a specific iterm of this block.
  ///
  /// The iterm name must be of the form:
  ///
  ///     <instanceName><hierDelimeter><termName>
  ///
  /// For example:   inst0/A
  ///
  dbITerm* findITerm(const char* name);

  ///
  /// Get the obstructions of this block
  ///
  dbSet<dbObstruction> getObstructions();

  ///
  /// Get the blockages of this block
  ///
  dbSet<dbBlockage> getBlockages();

  ///
  /// Get the nets of this block
  ///
  dbSet<dbNet> getNets();

  ///
  /// Get the capNodes of this block
  ///
  dbSet<dbCapNode> getCapNodes();

  ///
  /// Get the rsegs of this block
  ///
  dbSet<dbRSeg> getRSegs();

  ///
  /// Find a specific net of this block.
  /// Returns NULL if the object was not found.
  ///
  dbNet* findNet(const char* name);

  ///
  /// Find a set of nets. Each name can be real name, or Nxxx, or xxx,
  /// where xxx is the net oid.
  ///
  bool findSomeNet(const char* names, std::vector<dbNet*>& nets);

  //
  // Utility to save_lef
  //
  // void dbBlock::saveLef(char *filename);
  void saveLef(char* filename);

  //
  // Utility to save_def
  //
  // void dbBlock::saveDef(char *filename, char *nets);
  void saveDef(char* filename, char* nets);

  //
  // Utility to write db file
  //
  // void dbBlock::writeDb(char *filename, int allNode=0);
  void writeDb(char* filename, int allNode = 0);

  ///
  /// Find a specific via of this block.
  /// Returns NULL if the object was not found.
  ///
  dbVia* findVia(const char* name);

  ///
  /// Get the vias of this block
  ///
  dbSet<dbVia> getVias();

  ///
  /// Get the GCell grid of this block
  /// Returns NULL if no grid exists.
  ///
  dbGCellGrid* getGCellGrid();

  ///
  /// Get the DEF units of this technology.
  ///
  int getDefUnits();

  ///
  /// Set the DEF units of this technology.
  ///
  void setDefUnits(int units);

  ///
  /// Get the Database units per micron.
  ///
  int getDbUnitsPerMicron();

  ///
  /// Get the hierarchy delimeter.
  /// Returns (0) if the delimeter was not set.
  /// A hierarchy delimeter can only be set at the time
  /// a block is created.
  ///
  char getHierarchyDelimeter();

  ///
  /// Set the bus name delimeters
  ///
  void setBusDelimeters(char left, char right);

  ///
  /// Get the bus name delimeters
  /// Left and Right are set to "zero" if the bus delimeters
  /// were not set.
  ///
  void getBusDelimeters(char& left, char& right);

  ///
  /// Get extraction counters
  ///
  void getExtCount(int& numOfNet,
                   int& numOfRSeg,
                   int& numOfCapNode,
                   int& numOfCCSeg);

  ///
  /// Copy RC values from one extDb to another.
  ///
  void copyExtDb(uint fr,
                 uint to,
                 uint extDbCnt,
                 double resFactor,
                 double ccFactor,
                 double gndcFactor);

  ///
  /// Adjust RC values.
  ///
  void adjustRC(double resFactor, double ccFactor, double gndcFactor);

  ///
  /// add cc capacitance to gnd capacitance of capNodes of this block
  ///
  bool groundCC(float gndFactor);

  ///
  /// adjust CC's of nets
  ///
  bool adjustCC(float adjFactor,
                double ccThreshHold,
                std::vector<dbNet*>& nets,
                std::vector<dbNet*>& halonets);

  ///
  /// undo adjusted CC
  ///
  void undoAdjustedCC(std::vector<dbNet*>& nets, std::vector<dbNet*>& halonets);

  ///
  /// Get the number of process corners.
  ///
  int getCornerCount();

  ///
  /// having independent extraction corners ?
  ///
  bool extCornersAreIndependent();

  ///
  /// Get the number of corners kept n this block
  ///
  int getCornersPerBlock();

  ///
  /// Get the number of ext dbs
  ///
  int getExtDbCount();

  ///
  /// Get ext corner name by the index in ext Db
  ///
  void getExtCornerName(int corner, char* cName);

  ///
  /// Get the index in ext Db by name
  ///
  int getExtCornerIndex(const char* cornerName);

  ///
  /// Set corner name list
  ///
  void setCornerNameList(char* name_list);

  ///
  /// Get corner name list
  ///
  char* getCornerNameList();

  ///
  /// Set the number of process corners. The maximum number of
  /// process corners is limited to 256. This method will
  /// delete all dbRCSeg, dbCCSeg, which depend on this value.
  ///
  void setCornerCount(int cornerCnt, int extDbCnt, const char* name_list);
  void setCornerCount(int cnt);

  ///
  /// Set the number of corners kept in this block
  ///
  void setCornersPerBlock(int cornersPerBlock);

  ///
  /// Initialize the parasitics value tables
  ///
  void initParasiticsValueTables();

  ///
  /// create child block for one extraction corner
  ///
  dbBlock* createExtCornerBlock(uint corner);
  ///
  /// find child block for one extraction corner
  ///
  dbBlock* findExtCornerBlock(uint corner);
  ///
  /// get extraction data block for one extraction corner
  ///
  dbBlock* getExtCornerBlock(uint corner);

  ///
  /// when stream out a hier. block it will not stream references to children
  ///
  void set_skip_hier_stream(bool value);

  ///
  /// Get the track-grids of this block.
  ///
  dbSet<dbTrackGrid> getTrackGrids();

  ///
  /// Find a specific track-grid.
  /// Returns NULL if a track-grid has not be defined for this layer.
  ///
  dbTrackGrid* findTrackGrid(dbTechLayer* layer);

  ///
  /// Get the rows of this block
  ///
  dbSet<dbRow> getRows();

  ///
  /// Get the fills in this block
  ///
  dbSet<dbFill> getFills();

  ///
  /// Get the list of masters used in this block.
  ///
  void getMasters(std::vector<dbMaster*>& masters);

  ///
  /// Set the die area. The die-area is considered a constant regardless
  /// of the geometric elements of the dbBlock. It is generally a constant
  /// declared in DEF.
  ///
  void setDieArea(const Rect& new_rect);

  ///
  /// Get the die area. The default die-area is (0,0,0,0).
  ///
  void getDieArea(Rect& rect);

  ///
  /// Get the core area. This computes the bbox of the rows
  /// and is O(#rows) in runtime.
  ///
  void getCoreArea(Rect& rect);

  void setPtFile(FILE* ptf);
  FILE* getPtFile();
  ///
  /// Set the extmain instance.
  ///
  void setExtmi(void* ext);

  ///
  /// Get the extmain instance.
  ///
  void* getExtmi();

  ///
  /// Get the extraction control settings
  ///
  dbExtControl* getExtControl();

  ///
  /// Get the extraction corner names
  ///
  void getExtCornerNames(std::list<std::string>& ecl);

  ///
  /// Get the capacitor-coupled segments.
  ///
  dbSet<dbCCSeg> getCCSegs();

  ///
  /// Allow bufferin of altered nes
  ///
  bool isBufferAltered();

  ///
  ///
  ///
  void setBufferAltered(bool value);

  ///
  /// Build search database for fast area searches for insts
  ///
  // uint makeInstSearchDB();

  ///
  /// Get search database object for fast area searches on physical objects
  ///
  dbBlockSearch* getSearchDb();

  ///
  /// reset _netSdb
  ///
  // void resetNetSdb();

  ///
  /// Get search database module for fast area searches on signal nets
  ///
  //    ZPtr<ISdb> getSignalNetSdb();
  ///
  /// Get search database module for fast area searches on signal nets
  /// Generate netSdb if it does not exist
  ///
  //    ZPtr<ISdb> getSignalNetSdb(ZContext & context, dbTech *tech);

  ///
  /// Get search database module for fast area searches on physical objects
  ///
  // ZPtr<ISdb> getNetSdb();
  ///
  /// Get search database module for fast area searches on physical objects
  /// Generate netSdb if it does not exist
  ///
  // ZPtr<ISdb> getNetSdb(ZContext & context, dbTech *tech);
  ///
  /// Remove search database
  ///
  // void removeSdb(std::vector<dbNet *> & nets);
  ///
  /// Put insts/nets/tracks on Search DB
  ///
  // dbBlockSearch *initSearchBlock(dbTech *tech, bool nets, bool insts,
  // ZContext & context, bool skipViaCuts=false);

  ///
  /// Get insts from Search DB given a bbox to do area search
  ///
  // uint getInsts(int x1, int y1, int x2, int y2, std::vector<dbInst *> &
  // result);

  void updateNetFlags(std::vector<dbNet*>& result);

  ///
  /// destroy coupling caps of nets
  ///
  void destroyCCs(std::vector<dbNet*>& nets);

  ///
  /// destroy RC segments of nets
  ///
  void destroyRSegs(std::vector<dbNet*>& nets);

  ///
  /// destroy capnodes of nets
  ///
  void destroyCNs(std::vector<dbNet*>& nets, bool cleanExtid);

  ///
  /// destroy parasitics of nets
  ///
  void destroyParasitics(std::vector<dbNet*>& nets);
  void destroyCornerParasitics(std::vector<dbNet*>& nets);

  ///
  /// get cc_halo_net's of input nets
  ///
  void getCcHaloNets(std::vector<dbNet*>& changedNets,
                     std::vector<dbNet*>& ccHaloNets);

  ///
  /// destroy old parasitics of nets
  ///
  void destroyOldParasitics(std::vector<dbNet*>& nets,
                            std::vector<uint>* capnn,
                            std::vector<uint>* rsegn);
  void destroyOldCornerParasitics(std::vector<dbNet*>& nets,
                                  std::vector<uint>& capnn,
                                  std::vector<uint>& rsegn);

  ///
  /// restore old parasitics of nets
  ///
  void restoreOldParasitics(std::vector<dbNet*>& nets,
                            bool coupled_rc,
                            std::vector<dbNet*>& ccHaloNets,
                            std::vector<uint>* capnn,
                            std::vector<uint>* rsegn);
  void restoreOldCornerParasitics(dbBlock* pBlock,
                                  std::vector<dbNet*>& nets,
                                  bool coupled_rc,
                                  std::vector<dbNet*>& ccHaloNets,
                                  std::vector<uint>& capnn,
                                  std::vector<uint>& rsegn);

  ///
  /// keep old parasitics of nets and replace by zeroRc's'
  ///
  void replaceOldParasitics(std::vector<dbNet*>& nets,
                            std::vector<uint>& capnn,
                            std::vector<uint>& rsegn);

  ///
  /// restore old parasitics
  ///
  void restoreOldParasitics(std::vector<dbNet*>& nets,
                            std::vector<uint>& capnn,
                            std::vector<uint>& rsegn);

  ///
  /// keep old parasitics of nets
  ///
  void keepOldParasitics(std::vector<dbNet*>& nets,
                         bool coupled_rc,
                         std::vector<dbNet*>& ccHaloNets,
                         std::vector<uint>* capnn,
                         std::vector<uint>* rsegn);
  void keepOldCornerParasitics(dbBlock* pBlock,
                               std::vector<dbNet*>& nets,
                               bool coupled_rc,
                               std::vector<dbNet*>& ccHaloNets,
                               std::vector<uint>& capnn,
                               std::vector<uint>& rsegn);

  ///
  /// merge rsegs before doing exttree
  ///
  void preExttreeMergeRC(double max_cap, uint corner);

  ///
  /// clear
  ///
  void clear();

  ///
  /// get wire_updated nets
  ///
  void getWireUpdatedNets(std::vector<dbNet*>& nets, Rect* bbox = NULL);

  ///
  /// return the regions of this design
  ///
  dbSet<dbRegion> getRegions();

  ///
  /// Find a specific region. Returns NULL if the region was not found.
  ///
  dbRegion* findRegion(const char* name);

  ///
  ///  Find the non-default-rule
  ///
  dbTechNonDefaultRule* findNonDefaultRule(const char* name);

  ///
  ///  Get the non-default-rules specific to this block.
  ///
  dbSet<dbTechNonDefaultRule> getNonDefaultRules();

  ///
  ///  Levelelize from set of insts
  ///
  uint levelize(std::vector<dbInst*>& startingInsts,
                std::vector<dbInst*>& instsToBeLeveled);

  ///
  ///  Levelelize from Primary inputs or inout to sequential
  ///
  uint levelizeFromPrimaryInputs();

  ///
  ///  Levelelize from sequential
  ///
  uint levelizeFromSequential();

  ///
  ///  Mark inst backwards usinh user flag 2
  ///
  int markBackwardsUser2(dbInst* firstInst,
                         bool mark,
                         std::vector<dbInst*>& resultTable);

  ///
  ///  Mark inst backwards usinh user flag 2
  ///
  int markBackwardsUser2(std::vector<dbInst*>& startingInsts,
                         std::vector<dbInst*>& instsToBeLeveled,
                         bool mark,
                         std::vector<dbInst*>& resultTable);

  ///
  ///  Mark net backwards using user flag 2
  ///
  int markBackwardsUser2(dbNet* net,
                         bool mark,
                         std::vector<dbInst*>& resultTable);

  ///
  ///  Mark net backwards using user flag 2
  ///
  int markBackwardsUser2(dbNet* net,
                         std::vector<dbInst*>& instsToMark,
                         bool mark,
                         std::vector<dbInst*>& resultTable);

  ///
  ///  Mark masters as sequential based on mterms being of "use clock"; mark
  ///  iterms as clocked
  ///
  void markClockIterms();

  ///
  /// set First driving iterm on all signal nets; set 0 is none exists
  void setDrivingItermsforNets();

  void clearUserInstFlags();

 private:
  friend class ZDB;

  ///
  /// Build search database for fast area searches
  ///
  void makeSearchDB(bool nets, bool insts, ZContext& context);

 public:
  ///
  /// Get the Container class for Nets Search DB
  ///
  // ZPtr<ISdb> getSearchDbNets();

  ///
  /// Get the Container class for Insts Search DB
  ///
  // ZPtr<ISdb> getSearchDbInsts();

  ///
  /// This method copies the via-table from the src block to the destination
  /// block.
  ///
  /// WARNING: This method deletes any vias previously defined in the
  /// destination block.
  ///          If there are wire which reference these vias, the references will
  ///          be left dangling.
  ///
  static void copyViaTable(dbBlock* dst, dbBlock* src);

  ///
  /// Get the Read Only Container class for Nets Search DB
  ///
  // TODO ZPtr<ISdb_r> getSearchDbNets_r();

  ///
  /// Get the Read Only Container class for Insts Search DB
  ///
  // TODO ZPtr<ISdb_r> getSearchDbInsts_r();

  ///
  /// Create a chip's top-block. Returns NULL of a top-block already
  /// exists.
  ///
  static dbBlock* create(dbChip* chip,
                         const char* name,
                         char hier_delimeter = 0);

  ///
  /// Create a hierachical/child block. This block has no connectivity.
  /// Returns NULL if a block with the same name exists.
  ///
  static dbBlock* create(dbBlock* block,
                         const char* name,
                         char hier_delimeter = 0);

  ///
  /// duplicate - Make a duplicate of the specified "child" block. If name ==
  /// NULL, the name of the block is also duplicated. If the duplicated block
  /// does not have a unique name, then "findChild" may return an incorrect
  /// block. UNIQUE child-block-names are not enforced! (This should be fixed)!
  ///
  /// A top-block can not be duplicated. This methods returns NULL if the
  /// specified block has not parent.
  ///
  static dbBlock* duplicate(dbBlock* block, const char* name = NULL);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbBlock* getBlock(dbChip* chip, uint oid);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbBlock* getBlock(dbBlock* block, uint oid);

  ///
  /// Destroy a block.
  ///
  static void destroy(dbBlock* block);

  ///
  /// Delete the bterm from the block.
  ///
  static dbSet<dbBlock>::iterator destroy(dbSet<dbBlock>::iterator& itr);

  ///
  /// Show the netlist differences of these blocks
  /// Returns true if differences were found.
  ///
  static bool differences(dbBlock* block1,
                          dbBlock* block2,
                          FILE* out,
                          int indent_per_level = 4);

 private:
  void ComputeBBox();
};

///////////////////////////////////////////////////////////////////////////////
///
/// A block-terminal is the element used to represent connections in/out of
/// a block.
///
///////////////////////////////////////////////////////////////////////////////
class dbBTerm : public dbObject
{
 public:
  ///
  /// Get the block-terminal name.
  ///
  std::string getName();

  ///
  /// Get the block-terminal name.
  ///
  const char* getConstName();

  ///
  /// Change the name of the bterm.
  /// Returns true if successful.
  /// Returns false if a bterm with the same name already exists.
  ///
  bool rename(const char* name);

  ///
  /// Get bbox of this term (ie the bbox of the bpins)
  ///
  Rect getBBox();

  ///
  /// Set the signal type of this block-terminal.
  ///
  void setSigType(dbSigType type);

  ///
  /// Get the signal type of this block-terminal.
  ///
  dbSigType getSigType();

  ///
  /// Set the IO direction of this block-terminal.
  ///
  void setIoType(dbIoType type);

  ///
  /// Get the IO direction of this block-terminal.
  ///
  dbIoType getIoType();

  ///
  /// Set spef mark of this block-terminal.
  ///
  void setSpefMark(uint v);

  ///
  /// get spef mark of this block-terminal.
  ///
  bool isSetSpefMark();

  ///
  /// Set mark of this block-terminal.
  ///
  void setMark(uint v);

  ///
  /// get mark of this block-terminal.
  ///
  bool isSetMark();

  ///
  /// set ext id of this block-terminal.
  ///
  void setExtId(uint v);

  ///
  /// get ext id of this block-terminal.
  ///
  uint getExtId();

  ///
  /// is this terminal SPECIAL (i.e. not for regular signal routing).
  ///
  bool isSpecial() const;

  ///
  /// set SPECIAL attribute -- expected to be done once by DEF parser.
  ///
  void setSpecial();

  /// Get the net of this block-terminal.
  ///
  dbNet* getNet();

  /// Disconnect the block-terminal from it's net.
  ///
  void disconnect();

  /// Connect the block-terminal to net.
  ///
  void connect(dbNet* net);

  ///
  /// Get the block of this block-terminal.
  ///
  dbBlock* getBlock();

  ///
  /// Get the hierarchical parent iterm of this bterm.
  ///
  /// Returns NULL if this bterm has no parent iterm.
  ///
  ///
  ///     (top-block)
  ///     +------------------------------------------------------------------+
  ///     |                                                                  |
  ///     |                                                                  |
  ///     |                                                                  |
  ///     |               (child-block / instance)                           |
  ///     |               +----------------------------------+               |
  ///     |               |                                  |               |
  ///     |B             I|B                                 |               |
  ///     |o.............o|o..........                       |               |
  ///     |  (net in      |  (net in child-block)            |               |
  ///     |   top-block)  |                                  |               |
  ///     |               |                                  |               |
  ///     |               |                                  |               |
  ///     |               |                                  |               |
  ///     |               |                                  |               |
  ///     |               +----------------------------------+               |
  ///     |                                                                  |
  ///     |                                                                  |
  ///     +------------------------------------------------------------------+
  ///
  ///
  /// B = dbBterm
  /// I = dbIterm
  ///
  dbITerm* getITerm();

  ///
  /// Get the bpins of this bterm.
  ///
  dbSet<dbBPin> getBPins();

  ///
  /// This method finds the first "placed" dbPin box.
  /// returns false if there are no placed bpins.
  ///
  bool getFirstPin(dbShape& shape);

  ///
  /// This method finds the location the first "placed" dbPin box.
  /// The location is the computed center of the bbox.
  /// returns false if there are no placed bpins. x and y are set to zero.
  //
  bool getFirstPinLocation(int& x, int& y);

  ///
  /// This method returns the placementstatus of the first dbBPin.
  /// Returns NONE if bterm has no dbPins.
  ///
  dbPlacementStatus getFirstPinPlacementStatus();

  ///
  /// Get the ground sensistivity pin (5.6 DEF)
  ///
  dbBTerm* getGroundPin();

  ///
  /// Set the ground sensistivity pin (5.6 DEF)
  ///
  void setGroundPin(dbBTerm* pin);

  ///
  /// Get the supply sensistivity pin (5.6 DEF)
  ///
  dbBTerm* getSupplyPin();

  ///
  /// Set the supply sensistivity pin (5.6 DEF)
  ///
  void setSupplyPin(dbBTerm* pin);

  ///
  /// Create a new block-terminal.
  /// Returns NULL if a bterm with this name already exists
  ///
  static dbBTerm* create(dbNet* net, const char* name);

  ///
  /// Delete the bterm from the block.
  ///
  static void destroy(dbBTerm* bterm);

  ///
  /// Delete the bterm from the block.

  static dbSet<dbBTerm>::iterator destroy(dbSet<dbBTerm>::iterator& itr);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbBTerm* getBTerm(dbBlock* block, uint oid);

  uint32_t staVertexId();
  void staSetVertexId(uint32_t id);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A BPIn is the element that represents a physical connection to a block
/// terminal.
///
///////////////////////////////////////////////////////////////////////////////

class dbBPin : public dbObject
{
 public:
  ///
  /// Get the placement status of this block-terminal.
  ///
  dbPlacementStatus getPlacementStatus();

  ///
  /// Set the placement status of this block-terminal.
  ///
  void setPlacementStatus(dbPlacementStatus status);

  ///
  /// Get bterm of this pin.
  ///
  dbBTerm* getBTerm();

  ///
  /// Get boxes of this pin
  ///
  dbSet<dbBox> getBoxes();

  ///
  /// Get bbox of this pin (ie the bbox of getBoxes())
  ///
  Rect getBBox();

  ///
  /// Returns true if this bpin has an effective-width rule.
  ///
  bool hasEffectiveWidth();

  ///
  /// Set the effective width rule.
  ///
  void setEffectiveWidth(int w);

  ///
  /// Return the effective width rule.
  ///
  int getEffectiveWidth();

  ///
  /// Returns true if this bpin has an min-spacing rule.
  ///
  bool hasMinSpacing();

  ///
  /// Set the min spacing rule.
  ///
  void setMinSpacing(int w);

  ///
  /// Return the min spacing rule.
  ///
  int getMinSpacing();

  ///
  /// Create a new block-terminal-pin
  ///
  static dbBPin* create(dbBTerm* bterm);

  ///
  /// Delete the bpin from this bterm
  ///
  static void destroy(dbBPin* bpin);

  ///
  /// Delete the bterm from the bterm.
  static dbSet<dbBPin>::iterator destroy(dbSet<dbBPin>::iterator& itr);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbBPin* getBPin(dbBlock* block, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A Net is the element that represents a "net" on a block.
///
///////////////////////////////////////////////////////////////////////////////
class dbNet : public dbObject
{
 public:
  ///
  /// Get the net name.
  ///
  std::string getName();

  ///
  /// Get the net name.
  ///
  const char* getConstName();

  ///
  /// Print net name with or without id and newline
  ///
  void printNetName(FILE* fp, bool idFlag = true, bool newLine = true);

  ///
  /// Change the name of the net.
  /// Returns true if successful.
  /// Returns false if a net with the same name already exists.
  ///
  bool rename(const char* name);

  ///
  /// RC netowork disconnect
  ///
  bool isRCDisconnected();

  ///
  ///
  ///
  void setRCDisconnected(bool value);

  ///
  /// Get the weight assigned to this net.
  /// (Default: 1)
  ///
  int getWeight();

  ///
  /// Set the weight assigned of this net.
  ///
  void setWeight(int weight);

  ///
  /// Get the source assigned to this net.
  ///
  dbSourceType getSourceType();

  ///
  /// Set the source assigned of this net.
  ///
  void setSourceType(dbSourceType type);

  ///
  /// Get the x-talk-class assigned to this net.
  /// (Default: 0)
  ///
  int getXTalkClass();

  ///
  /// Set the x-talk-class assigned of this net.
  ///
  void setXTalkClass(int value);

  ///
  /// Set the driving term id assigned of this net.
  ///
  void setDrivingITerm(int id);

  ///
  /// Returns driving term id assigned of this net. -1 if not set, 0 if non
  /// existent
  ///
  int getDrivingITerm();

  ///
  /// Returns true if a fixed-bump flag has been set.
  ///
  bool hasFixedBump();

  ///
  /// Set the value of the fixed-bump flag.
  ///
  void setFixedBump(bool value);

  ///
  /// Get the Regular Wiring of a net (TODO: per path)
  ///
  dbWireType getWireType();

  ///
  /// Set the Regular Wiring of a net (TODO: per path)
  ///
  void setWireType(dbWireType wire_type);

  ///
  /// Get the signal type of this block-net.
  ///
  dbSigType getSigType();

  ///
  /// Get the signal type of this block-net.
  ///
  void setSigType(dbSigType sig_type);

  ///
  /// Assuming no intersection, check if the net is in the bbox.
  ///
  bool isEnclosed(Rect* bbox);

  ///
  /// Returns the mark flag value. This flag specified that the
  /// net has been marked.
  ///
  bool isMarked();

  ///
  /// Returns the mark_1 flag value. This flag specified that the
  /// net has been mark_1ed.
  ///
  bool isMark_1ed();

  ///
  /// Set the mark flag to the specified value.
  ///
  void setMark(bool value);

  ///
  /// Set the mark_1 flag to the specified value.
  ///
  void setMark_1(bool value);

  ///
  /// Returns the select flag value. This flag specified that the
  /// net has been select.
  ///
  bool isSelect();

  /// Net
  /// Set the select flag to the specified value.
  ///
  void setSelect(bool value);

  ///
  /// check if wire of this net equals that of the target net
  /// return value = 0: equal
  ///                x: not equal
  ///                1x: wire seg after junction not equal
  ///
  uint wireEqual(dbNet* target);

  void wireMatch(dbNet* target);
  void printWire(int fid, int tid, char* type);
  void printWire();
  void printWire(char* type);
  ///
  /// Returns the wire-ordered flag value. This flag specified that the
  /// wires of this net have been ordered into a single dbWire.
  ///
  bool isWireOrdered();

  ///
  /// Set the wire-ordered flag to the specified value.
  /// Note: This flag is set to false any time a dbWire
  /// is created on this net.
  ///
  void setWireOrdered(bool value);

  ///
  /// Returns the buffered flag value. This flag specified that the
  /// net has been buffered.
  ///
  bool isBuffered();

  ///
  /// Set the buffered flag to the specified value.
  ///
  void setBuffered(bool value);

  ///
  /// Returns the disconnected flag value. This flag specified that the
  /// wire are connected to all the iterms of this net.
  ///
  bool isDisconnected();

  ///
  /// Set the disconnected flag to the specified value.
  /// Note: This flag is set to false any time a dbWire
  /// is created on this net.
  ///
  void setDisconnected(bool value);

  ///
  /// wire_update flag to be used at when the wire is replaced with a new wire
  /// NOTE: rcgraph, extracted, ordered, reduced all have to be reset
  ///
  void setWireAltered(bool value);
  bool isWireAltered();

  ///
  /// rc_graph flag set when Rseg and CapNodes were created
  ///
  void setRCgraph(bool value);
  bool isRCgraph();

  ///
  /// reduced flag set when Arnoldi modeling takes place
  ///
  void setReduced(bool value);
  bool isReduced();

  ///
  /// extracted flag set when net was extracted
  ///
  void setExtracted(bool value);
  bool isExtracted();

  ///
  /// Sinlge bit general purpose flag to be used at spef
  ///
  void setSpef(bool value);
  bool isSpef();

  ///
  /// Set/Reset the size-only flag
  ///
  void setSizeOnly(bool v);

  ///
  /// Returns true if the size-only flag is set.
  ///
  bool isSizeOnly();

  ///
  /// Set/Reset the don't-touch flag
  ///
  void setDoNotTouch(bool v);

  ///
  /// Returns true if the don't-touch flag is set.
  ///
  bool isDoNotTouch();

  ///
  /// Get the block of this block-terminal.
  ///
  dbBlock* getBlock();

  ///
  /// Get all the instance-terminals of this net.
  ///
  dbSet<dbITerm> getITerms();

  ///
  /// Get the 1st instance-terminal of this net.
  ///
  dbITerm* get1stITerm();

  ///
  /// Get the 1st inputSignal Iterm; can be
  ///
  dbITerm* get1stSignalInput(bool io);

  ///
  /// Get the 1st output Iterm; can be
  ///
  dbITerm* getFirstOutput();

  ///
  /// Get all the block-terminals of this net.
  ///
  dbSet<dbBTerm> getBTerms();

  ///
  /// Get the 1st block-terminal of this net.
  ///
  dbBTerm* get1stBTerm();

  ///
  /// Get the special-wires of this net.
  ///
  dbSet<dbSWire> getSWires();

  ///
  /// Get the wire of this net.
  /// Returns NULL if this net has no wire.
  ///
  dbWire* getWire();

  ///
  /// Get the first swire of this net.
  /// Returns NULL if this net has no swires.
  ///
  dbSWire* getFirstSWire();
  ///
  /// Move segements of the wire of this net to that of tnet
  ///
  void donateWire(dbNet* tnet, dbRSeg** new_rsegs);

  ///
  /// Get the global wire of thie net.
  /// Returns NULL if this net has no global wire.
  ///
  dbWire* getGlobalWire();

  ///
  /// Returns true if this dbNet is marked as special. Special nets/iterms are
  /// declared in the SPECIAL NETS section of a DEF file.
  ///
  bool isSpecial();

  ///
  /// Mark this dbNet as special.
  ///
  void setSpecial();

  ///
  /// Unmark this dbNet as special.
  ///
  void clearSpecial();

  ///
  /// Set the IO flag if there are any BTerms on net
  bool setIOflag();

  ///
  /// returns true if there are BTerms on net
  bool isIO();

  ///
  /// Returns true if this dbNet is was connected using a wild-card.
  ///
  bool isWildConnected();

  ///
  /// Mark this dbNet as wild-connected.
  ///
  void setWildConnected();

  ///
  /// Unmark this dbNet as wild-connected.
  ///
  void clearWildConnected();

  ///
  /// Get the gndc calibration factor of this net
  ///
  float getGndcCalibFactor();

  ///
  /// Set the gndc calibration factor of this net
  ///
  void setGndcCalibFactor(float gndcCalib);

  ///
  /// Calibrate the capacitance of this net
  ///
  void calibrateCapacitance();

  ///
  /// Calibrate the ground capacitance of this net
  ///
  void calibrateGndCap();

  ///
  /// Calibrate the coupling capacitance of this net
  ///
  void calibrateCouplingCap();
  void calibrateCouplingCap(int corner);

  ///
  /// Get the cc calibration factor of this net
  ///
  float getCcCalibFactor();

  ///
  /// Set the cc calibration factor of this net
  ///
  void setCcCalibFactor(float ccCalib);

  ///
  /// Adjust resistances of this net
  ///
  void adjustNetRes(float factor);

  ///
  /// Adjust resistances of this net for a corner
  ///
  void adjustNetRes(float factor, uint corner);

  ///
  /// Adjust ground cap of this net
  ///
  void adjustNetGndCap(float factor);

  ///
  /// Adjust ground cap of this net for a corner
  ///
  void adjustNetGndCap(uint corner, float factor);

  ///
  /// get ccAdjustFactor of this net
  ///
  float getCcAdjustFactor();

  ///
  /// set ccAdjustFactor of this net
  ///
  void setCcAdjustFactor(float factor);

  ///
  /// get ccAdjustOrder of this net
  ///
  uint getCcAdjustOrder();

  ///
  /// set ccAdjustOrder of this net
  ///
  void setCcAdjustOrder(uint order);

  ///
  /// adjust CC's of this net
  ///
  bool adjustCC(uint adjOrder,
                float adjFactor,
                double ccThreshHold,
                std::vector<dbCCSeg*>& adjustedCC,
                std::vector<dbNet*>& halonets);

  ///
  /// undo adjusted CC
  ///
  void undoAdjustedCC(std::vector<dbCCSeg*>& adjustedCC,
                      std::vector<dbNet*>& halonets);

  ///
  /// add cc capacitance to gnd capacitance of capNodes of this net
  ///
  bool groundCC(float gndFactor);

  ///
  /// Add to the dbCC of this net
  ///
  void addDbCc(float cap);

  ///
  /// Get dbCC of this net
  ///
  float getDbCc();

  ///
  /// Set dbCC of this net
  ///
  void setDbCc(float cap);

  ///
  /// Get refCC of this net
  ///
  float getRefCc();

  ///
  /// Set refCC of this net
  ///
  void setRefCc(float cap);

  ///
  /// get the CC match ratio against this net
  ///
  float getCcMatchRatio();

  ///
  /// set the CC match ratio against this net
  ///
  void setCcMatchRatio(float ratio);

  ///
  /// Get the gdn cap of this net to *gndcap, total cap to *totalcap
  ///
  void getGndTotalCap(double* gndcap, double* totalcap, double MillerMult);

  ///
  /// merge rsegs before doing exttree
  ///
  void preExttreeMergeRC(double max_cap, uint corner);

  ///
  /// Get Cap Node given a node_num
  ///
  dbCapNode* findCapNode(uint nodeId);

  ///
  /// Print the CapNodes of this net.
  ///
  void printCapN(char* type);

  ///
  /// donate parasitics
  ///
  void donateRC(dbITerm* donorterm,
                dbITerm* rcvterm,
                dbRSeg*& rtrseg,
                dbRSeg*& lastrrseg,
                dbCapNode*& lastrcapnd,
                uint& ricapndCnt,
                dbRSeg*& fstdrseg,
                dbRSeg*& dtrseg,
                dbCapNode*& fstdcapnd,
                std::vector<dbCCSeg*>* gndcc,
                dbRSeg*& bridgeRseg);

  ///
  /// reverse donate parasitics
  ///
  void unDonateRC(dbRSeg* rtrseg,
                  dbRSeg* lastrrseg,
                  dbITerm* it,
                  dbCapNode* lastrcapnd,
                  uint ricapndCnt,
                  dbRSeg* dtrseg,
                  dbRSeg* fstdrseg,
                  dbCapNode* fstdcapnd,
                  dbITerm* ot,
                  std::vector<dbCCSeg*>* gndcc);

  ///
  /// Get the Cap Nodes of this net.
  ///
  dbSet<dbCapNode> getCapNodes();

  ///
  /// delete the Cap Nodes of this net.
  ///
  void destroyCapNodes(bool cleanExtid);

  ///
  /// Reverse the rsegs seqence of this net.
  ///
  void reverseRSegs();

  ///
  /// create dummy zero rseg and capNodes
  ///
  void createZeroRc(bool foreign);

  ///
  /// Set the 1st R segment of this net.
  ///
  void set1stRSegId(uint rseg_id);

  ///
  /// Get the zeroth R segment of this net.
  ///
  dbRSeg* getZeroRSeg();

  ///
  /// Get the 1st R segment id of this net.
  ///
  uint get1stRSegId();

  ///
  /// find the rseg having srcn and tgtn
  ///
  dbRSeg* findRSeg(uint srcn, uint tgtn);

  ///
  /// Set the 1st Cap node of this net.
  ///
  void set1stCapNodeId(uint capn_id);

  ///
  /// Get the 1st Cap node of this net.
  ///
  uint get1stCapNodeId();

  ///
  /// Reset, or Set the extid of the bterms and iterms to the capnode id's
  ///
  void setTermExtIds(int capId);

  ///
  /// check if any of the RSegs has shape_id
  ///
  bool anchoredRSeg();

  ///
  /// Print the R segments of this net.
  ///
  void printRSeg(char* type);

  ///
  /// Print the Wire and Parasitics segments of this net.
  ///
  void printWnP(char* type);

  ///
  /// get rseg  count
  ///
  uint getRSegCount();

  ///
  /// Get the RSegs segments.
  ///
  dbSet<dbRSeg> getRSegs();

  ///
  /// compact internal capnode number'
  ///
  void collapseInternalCapNum(FILE* capNodeMap);
  ///
  /// find max number of cap nodes that are internal
  ///
  uint maxInternalCapNum();

  ///
  /// get capNode count
  ///
  uint getCapNodeCount();

  ///
  /// get CC seg count
  ///
  uint getCcCount();

  ///
  /// delete the R segments of this net.
  ///
  void destroyRSegs();

  ///
  /// reverse the link order of CCsegs of capNodes
  ///
  void reverseCCSegs();

  ///
  /// Get the source capacitor-coupled segments of this net..
  ///
  void getSrcCCSegs(std::vector<dbCCSeg*>& segs);

  ///
  /// Get the target capacitor-coupled segments of this net..
  ///
  void getTgtCCSegs(std::vector<dbCCSeg*>& segs);

  ///
  /// Get the nets having coupling caps with this net
  ///
  void getCouplingNets(uint corner,
                       double ccThreshold,
                       std::set<dbNet*>& cnets);

  ///
  /// delete the capacitor-coupled segments.
  ///
  void destroyCCSegs();

  ///
  /// destroy parasitics
  ///
  void destroyParasitics();

  ///
  /// Get total capacitance in FF
  ///
  double getTotalCapacitance(uint corner = 0, bool cc = false);

  ///
  /// Get total coupling capacitance in FF
  ///
  double getTotalCouplingCap(uint corner = 0);

  ///
  /// Get total resistance in mil ohms
  ///
  double getTotalResistance(uint corner = 0);

  ///
  /// Set the nondefault rule applied to this net for wiring.
  ///
  void setNonDefaultRule(dbTechNonDefaultRule* rule);

  ///
  /// Get the nondefault rule applied to this net for wiring.
  /// Returns NULLS if there is no nondefault rule.
  ///
  dbTechNonDefaultRule* getNonDefaultRule();

  ///
  /// Get stats of this net
  ///
  void getNetStats(uint& wireCnt,
                   uint& viaCnt,
                   uint& len,
                   uint& layerCnt,
                   uint* levelTable);

  ///
  /// Get wire counts of this net
  ///
  void getWireCount(uint& wireCnt, uint& viaCnt);

  ///
  /// Get wire counts of this signal net
  ///
  void getSignalWireCount(uint& wireCnt, uint& viaCnt);

  ///
  /// Get wire counts of this power net
  ///
  void getPowerWireCount(uint& wireCnt, uint& viaCnt);

  ///
  /// Get term counts of this net
  ///
  uint getTermCount();

  ///
  /// Get iterm counts of this signal net
  ///
  uint getITermCount();

  ///
  /// Get bterm counts of this signal net
  ///
  uint getBTermCount();

  ///
  /// Delete the swires of this net
  ///
  void destroySWires();

  ///
  /// Create a new net.
  /// Returns NULL if a net with this name already exists
  ///
  static dbNet* create(dbBlock* block,
                       const char* name,
                       bool skipExistingCheck = false);

  ///
  /// Delete this net from this block.
  ///
  static void destroy(dbNet* net);

  ///
  /// mark nets of a block.
  ///
  static void markNets(std::vector<dbNet*>& nets, dbBlock* block, bool mk);

  ///
  /// set level for fanout instances
  ///
  uint setLevelAtFanout(uint level,
                        bool fromPI,
                        std::vector<dbInst*>& instVector);

  ///
  /// Delete the net from the block.
  ///
  static dbSet<dbNet>::iterator destroy(dbSet<dbNet>::iterator& itr);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbNet* getNet(dbBlock* block, uint oid);

  ///
  /// Translate a valid database-id back to a pointer.
  ///
  static dbNet* getValidNet(dbBlock* block, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A dbInstance is the element used to represent instances of master-cells in
/// a block.
///
///////////////////////////////////////////////////////////////////////////////
class dbInst : public dbObject
{
 public:
  ///
  /// Get the instance name.
  ///
  std::string getName();

  ///
  /// Need a version that does not do strdup every time
  ///
  const char* getConstName();

  ///
  /// Compare, like !strcmp
  ///
  bool isNamed(const char* name);

  ///
  /// Change the name of the inst.
  /// Returns true if successful.
  /// Returns false if a inst with the same name already exists.
  ///
  bool rename(const char* name);

  /////////////////////////////////////////////////////////////////
  ///
  /// IMPORTANT -  INSTANCE PLACEMENT
  ///
  /// There are seven methods used to get/set the placement.
  ///
  ///     getOrigin           - Get the origin of this instance (Where the
  ///     master is setOrigin           - Set the origin of this instance
  ///     getOrient           - Get orient of this instance
  ///     setOrient           - Set orient of this instance
  ///     getLocation         - Get the lower-left corner of this instance
  ///     setLocation         - Set the lower-left corner of this instance
  ///     setLocationOrient   - Set the orient of this instance and maintain the
  ///     lower-left corner.
  ///
  /// The getLocation/setLocation are used to get and set the lower-left corner
  /// of the bounding box of the instance. These methods use the DEF semantics.
  ///
  ///
  ///  MASTER COORDINATE SYSTEM:
  ///
  ///                                              |
  ///                                            --o-- (0,0)
  ///                                              |
  ///
  ///
  ///   +----------------------+ (Master bbox after rotation applied)
  ///   |                      |
  ///   |                      |
  ///   |                      |
  ///   |                      |
  ///   |                      |
  ///   +----------------------+
  ///  Mx,My
  ///
  ///
  ///  BLOCK COORDINATE SYSTEM:
  ///
  ///                                              |
  ///                                            --o-- (x,y) (True origin
  ///                                            (getOrigin/setOrigin)
  ///                                              |
  ///
  ///
  ///   +----------------------+ (Master bbox after rotation applied)
  ///   |                      |
  ///   |                      |
  ///   |                      |
  ///   |                      |
  ///   |                      |
  ///   +----------------------+
  ///  Ix,Ix (Location getLocation/setLocation)
  ///
  ///
  /// getLocation returns:(Note Mx/My is the location of the bbox AFTER
  /// rotation)
  ///
  ///     Ix = x + Mx
  ///     Iy = y + My
  ///
  /// setLocation(x,y) is equivalent to:
  ///
  ///    dbMaster * master = inst->getMaster();
  ///    Rect bbox;
  ///    master->getBBox(bbox);
  ///    dbTransform t(getOrient());
  ///    t.apply(bbox);
  ///    inst->setOrigin(x - bbox.xMin(),y - bbox.yMin());
  ///
  /////////////////////////////////////////////////////////////////////////////////////////////////////////////
  ///  WARNING:
  ///
  ///     If dbInst::setLocation() is called BEFORE dbInst::setOrient() is
  ///     called with the proper orient the "real" origin will be computed
  ///     incorrectly and the instance will be placed INCORRECTLY.
  ///
  ///     If you want to change the orient relative to the "location" use
  ///     setLocationOrient(). Otherwise the bounding box will be recomputed
  ///     incorrectly.
  ///
  ///     getLocation/setLocation are provided for backward compatibility and
  ///     there use should be avoided.
  ///
  /// TRANSFORMS:
  ///
  ///     When using dbTransform() to translate the shapes/pins of an instance,
  ///     use getOrigin() to correctly set up the transform:
  ///
  ///         int x, y;
  ///         inst->getOrigin(x,y);
  ///         dbTransform transform( inst->getOrient(), Point(x,y) );
  ///
  ///         for all shapes of inst:
  ///             transform.apply( shape )
  ///
  /////////////////////////////////////////////////////////////////////////////////////////////////////////////

  ///
  /// Get the "placed" origin of this instance.
  ///
  void getOrigin(int& x, int& y);

  ///
  /// Set the "placed" origin of this instance.
  ///
  void setOrigin(int x, int y);

  ///
  /// Get the orientation of this instance.
  ///
  dbOrientType getOrient();

  ///
  /// Set the orientation of this instance.
  ///
  void setOrient(dbOrientType orient);

  ///
  /// This method returns the lower-left corner
  /// of the bounding box of this instance.
  ///
  void getLocation(int& x, int& y) const;

  ///
  /// This method sets the lower-left corner
  /// of the bounding box of this instance.
  ///
  void setLocation(int x, int y);

  ///
  /// Set the orientation of this instance.
  /// This method holds the instance lower-left corner in place and
  /// rotates the instance relative to the lower-left corner.
  ///
  /// This method is equivalent to the following:
  ///
  ///     int x, y;
  ///     inst->getLocation();
  ///     inst->setOrient( orient );
  ///     inst->setLocation(x,y);
  ///
  ///
  void setLocationOrient(dbOrientType orient);

  ///
  /// Get the transform of this instance.
  /// Equivalent to getOrient() and getOrigin()
  ///
  void getTransform(dbTransform& t);

  ///
  /// Set the transform of this instance.
  /// Equivalent to setOrient() and setOrigin()
  ///
  void setTransform(dbTransform& t);

  ///
  /// Get the hierarchical transform of this instance.
  ///
  void getHierTransform(dbTransform& t);

  /////////////////////////////////////////////////////////////////

  ///
  /// This method returns the lower-left corner
  /// of the bounding box of this instance.
  ///
  dbBox* getBBox();

  ///
  /// Get the placement status of this instance.
  ///
  dbPlacementStatus getPlacementStatus();

  ///
  /// Is the placement status of this instance fixed
  ///
  bool isFixed() { return getPlacementStatus().isFixed(); }

  ///
  /// Is the placement status of this instance placed
  ///
  bool isPlaced() { return getPlacementStatus().isPlaced(); }

  ///
  /// Set the placement status of this instance.
  ///
  void setPlacementStatus(dbPlacementStatus status);

  ///
  /// Get the eco state bits to be used when an ECO block is created
  ///
  bool getEcoCreate();
  bool getEcoDestroy();
  bool getEcoModify();

  ///
  /// Set the eco state bits to be used when an ECO block is created
  ///
  void setEcoCreate(bool v);
  void setEcoDestroy(bool v);
  void setEcoModify(bool v);

  ///
  /// Get the user-defined flag bit.
  ///
  bool getUserFlag1();

  ///
  /// Set the user-defined flag bit.
  ///
  void setUserFlag1();

  ///
  /// Clear the user-defined flag bit.
  ///
  void clearUserFlag1();

  ///
  /// Get the user-defined flag bit.
  ///
  bool getUserFlag2();

  ///
  /// Set the user-defined flag bit.
  ///
  void setUserFlag2();

  ///
  /// Clear the user-defined flag bit.
  ///
  void clearUserFlag2();

  ///
  /// Get the user-defined flag bit.
  ///
  bool getUserFlag3();

  ///
  /// Set the user-defined flag bit.
  ///
  void setUserFlag3();

  ///
  /// Clear the user-defined flag bit.
  ///
  void clearUserFlag3();

  ///
  /// Set/Reset the size-only flag
  ///
  void setSizeOnly(bool v);

  ///
  /// Returns true if the size-only flag is set.
  ///
  bool isSizeOnly();

  ///
  /// Set/Reset the don't-touch flag
  ///
  void setDoNotTouch(bool v);

  ///
  /// Returns true if the don't-touch flag is set.
  ///
  bool isDoNotTouch();

  ///
  /// Set/Reset the don't-size flag
  ///
  void setDoNotSize(bool v);

  ///
  /// Returns true if the don't-size flag is set.
  ///
  bool isDoNotSize();

  ///
  /// Get the block of this instance.
  ///
  dbBlock* getBlock();

  ///
  /// Get the Master of this instance.
  ///
  dbMaster* getMaster() const;

  ///
  /// Get the group of this instance.
  ///
  dbGroup* getGroup();

  ///
  /// Get the instance-terminals of this instance.
  ///
  dbSet<dbITerm> getITerms();

  ///
  /// Get the first output terminal of this instance.
  ///
  dbITerm* getFirstOutput();

  ///
  /// Get the region this instance belongs to. Returns NULL if instance has no
  /// assigned region.
  ///
  dbRegion* getRegion();

  ///
  /// Get the module this instance belongs to. Returns NULL if instance has no
  /// assigned module.
  ///
  dbModule* getModule();

  ///
  /// Find the iterm of the given terminal name.
  /// Returns NULL if no terminal was found.
  ///
  dbITerm* findITerm(const char* terminal_name);

  ///
  /// Find the iterm of the given terminal name given the master term order
  ///
  dbITerm* getITerm(uint mterm_order_id);
  dbITerm* getClockedTerm();
  dbITerm* getOutputTerm();

  ///
  /// Get the all the instances connected to the net of each iterm of this
  /// instance. Only traverse nets of the specified SigType. Default is
  /// dbSigType::SIGNAL.
  ///
  void getConnectivity(std::vector<dbInst*>& neighbors,
                       dbSigType::Value value = dbSigType::SIGNAL);

  ///
  /// Bind the hierarchical (child) block to this instance.
  ///
  /// This method creates connectivity across the hierarchy.
  ///
  ///     (block)
  ///     +------------------------------------------------------------------+
  ///     |                                                                  |
  ///     |                                                                  |
  ///     |                                                                  |
  ///     |               (child-block / instance)                           |
  ///     |               +----------------------------------+               |
  ///     |               |                                  |               |
  ///     |B             I|B                                 |               |
  ///     |o.............o|o..........                       |               |
  ///     |  (net in      |  (net in child-block)            |               |
  ///     |   top-block)  |                                  |               |
  ///     |               |                                  |               |
  ///     |               |                                  |               |
  ///     |               |                                  |               |
  ///     |               |                                  |               |
  ///     |               +----------------------------------+               |
  ///     |                                                                  |
  ///     |                                                                  |
  ///     +------------------------------------------------------------------+
  ///
  /// B = dbBterm
  /// I = dbIterm
  ///
  /// This method will return false under the following situations:
  ///
  ///    1) This instance is already bound to a block.
  ///    2) This block cannot already be bound to an instance.
  ///    2) The block must be a direct child of the instance block.
  ///    3) block bterms must map 1-to-1 (by name) to the master mterms.
  ///
  bool bindBlock(dbBlock* block, bool force = false);

  ///
  /// Unbind the hierarchical (child) block from this instance.
  /// Does nothing if this instance has no child block.
  ///
  void unbindBlock();

  //
  // reset _hierachy to 0; not fully understood and tested!!!
  //
  bool resetHierarchy(bool verbose);
  ///
  /// Get the hierarchical (child) block bound to this instance.
  /// Returns NULL if this instance has no child.
  ///
  dbBlock* getChild();

  ///
  /// Get the parent instance of this instance.
  /// Returns NULL if this instance has no parent.
  ///
  dbInst* getParent();

  ///
  /// Get the children of this instance.
  ///
  dbSet<dbInst> getChildren();

  ///
  /// Returns true if this instance has hierarchy.
  ///
  bool isHierarchical();

  ///
  /// Returns a halo assigned to this instance.
  /// Returns NULL if this instance has no halo.
  ///
  dbBox* getHalo();

  ///
  /// Get the weight assigned to this instance.
  /// (Default: 1)
  ///
  int getWeight();

  ///
  /// Set the weight assigned of this instance.
  ///
  void setWeight(int weight);

  ///
  /// Get the source assigned to this instance.
  ///
  dbSourceType getSourceType();

  ///
  /// Set the source assigned of this instance.
  ///
  void setSourceType(dbSourceType type);

  ///
  /// Get the iterm that represents this mterm
  ///
  dbITerm* getITerm(dbMTerm* mterm);

  ///
  /// Swap the master of this instance.
  ///
  /// Returns true if the operations succeeds.
  /// NOTE: If this instance is bound to a block hierarchy, the master cannot be
  /// swapped.
  ///
  /// This method invalidates any existing dbSet<dbITerm>::iterator.
  ///
  bool swapMaster(dbMaster* master);

  ///
  /// Level of instance; if negative belongs to Primary Input Logic cone, 0
  /// invalid.
  ///
  int getLevel();

  ///
  /// Set ;evel of instance; if fromPI true, logic cone is connected to Primiary
  /// inputs
  ///
  void setLevel(uint v, bool fromPI);

  ///
  /// Is the master's type BLOCK or any of its subtypes
  ///
  bool isBlock() const;

  ///
  /// Is the master's type CORE or any of its subtypes
  ///
  bool isCore() const;

  ///
  /// Is the master's type PAD or any of its subtypes
  ///
  bool isPad() const;

  ///
  /// Is the master's type ENDCAP or any of its subtypes
  ///
  bool isEndCap() const;

  ///
  /// Create a new instance.
  /// Returns NULL if an instance with this name already exists.
  /// Returns NULL if the master is not FROZEN.
  ///
  static dbInst* create(dbBlock* block, dbMaster* master, const char* name);

  ///
  /// Create a new instance within the specified region.
  /// Returns NULL if an instance with this name already exists.
  /// Returns NULL if the master is not FROZEN.
  ///
  static dbInst* create(dbBlock* block,
                        dbMaster* master,
                        const char* name,
                        dbRegion* region);

  ///
  /// Delete the instance from the block.
  ///
  static void destroy(dbInst* inst);

  ///
  /// Delete the net from the block.
  ///
  static dbSet<dbInst>::iterator destroy(dbSet<dbInst>::iterator& itr);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbInst* getInst(dbBlock* block, uint oid);

  ///
  /// Translate a valid database-id back to a pointer.
  ///
  static dbInst* getValidInst(dbBlock* block, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A dbITerm (instance-terminal) is the element that represents a connection
/// to a master-terminal of an instance.
///
///////////////////////////////////////////////////////////////////////////////
class dbITerm : public dbObject
{
 public:
  ///
  /// Get the instance of this instance-terminal.
  ///
  dbInst* getInst();

  ///
  /// Get the net of this instance-terminal.
  /// Returns NULL if this instance-terminal has NOT been connected
  /// to a net.
  ///
  dbNet* getNet();

  ///
  /// Get the master-terminal that this instance-terminal is representing.
  ///
  dbMTerm* getMTerm();

  ///
  /// Get bbox of this iterm (ie the transfromed bbox of the mterm)
  ///
  Rect getBBox();

  ///
  /// Get the block this instance-terminal belongs too.
  ///
  dbBlock* getBlock();

  ///
  /// Get the signal type of this instance-terminal.
  ///
  dbSigType getSigType();

  ///
  /// Get the IO direction of this instance-terminal.
  ///
  dbIoType getIoType();

  ///
  /// True is iterm is input of signal type; if io false INOUT is not considered
  /// iput
  ///
  bool isInputSignal(bool io = true);

  ///
  /// True is iterm is output of signal type; if io false INOUT is not
  /// considered iput
  ///
  bool isOutputSignal(bool io = true);

  ///
  /// Mark this dbITerm as spef. v should 1 or 0
  ///
  void setSpef(uint v);

  ///
  /// Return true if this dbITerm flag spef is set to 1
  ///
  bool isSpef();

  ///
  /// set ext id
  ///
  void setExtId(uint v);

  ///
  /// get ext id
  ///
  uint getExtId();

  ///
  /// Returns true if this dbITerm is marked as special. Special nets/iterms are
  /// declared in the SPECIAL NETS section of a DEF file.
  ///
  bool isSpecial();

  ///
  /// Mark this dbITerm as special.
  ///
  void setSpecial();

  ///
  /// Unmark this dbITerm as special.
  ///
  void clearSpecial();

  ///
  /// Set clocked of this instance-terminal.
  ///
  void setClocked(bool v);

  ///
  /// get clocked of this instance-terminal.
  ///
  bool isClocked();

  ///
  /// Set mark of this instance-terminal.
  ///
  void setMark(uint v);

  ///
  /// get mark of this instance-terminal.
  ///
  bool isSetMark();

  ///
  /// Returns true if this dbITerm has been marked as physically connected.
  ///
  bool isConnected();

  ///
  /// Mark this dbITerm as physically connected.
  ///
  void setConnected();

  ///
  /// Unmark this dbITerm as physically connected.
  ///
  void clearConnected();

  ///
  /// Get the hierarchical child bterm of this iterm.
  /// Returns NULL if there is no child bterm.
  ///
  ///
  ///     (top-block)
  ///     +------------------------------------------------------------------+
  ///     |                                                                  |
  ///     |                                                                  |
  ///     |                                                                  |
  ///     |               (child-block / instance)                           |
  ///     |               +----------------------------------+               |
  ///     |               |                                  |               |
  ///     |B             I|B                                 |               |
  ///     |o.............o|o..........                       |               |
  ///     |  (net in      |  (net in child-block)            |               |
  ///     |   top-block)  |                                  |               |
  ///     |               |                                  |               |
  ///     |               |                                  |               |
  ///     |               |                                  |               |
  ///     |               |                                  |               |
  ///     |               +----------------------------------+               |
  ///     |                                                                  |
  ///     |                                                                  |
  ///     +------------------------------------------------------------------+
  ///
  ///
  /// B = dbBterm
  /// I = dbIterm
  ///
  dbBTerm* getBTerm();

  ///
  /// Create a connection between a instance and a net using a specific
  /// master-terminal. The dbITerm representing the connection is returned.
  /// Returns NULL if that specific master-terminal of that instance is
  /// already connected to a net.
  ///
  static dbITerm* connect(dbInst* inst, dbNet* net, dbMTerm* terminal);

  ///
  /// Connect this iterm to this net.
  ///
  static void connect(dbITerm* iterm, dbNet* net);

  ///
  /// Disconnect this iterm from the net it is connected to.
  ///
  static void disconnect(dbITerm* iterm);

  ///
  /// Disconnect this iterm from the net it is connected to.
  ///
  static dbSet<dbITerm>::iterator disconnect(dbSet<dbITerm>::iterator& itr);

  ///
  /// Get the average of the centers for the iterm shapes
  /// Returns false if iterm has no shapes
  ///
  bool getAvgXY(int* x, int* y);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbITerm* getITerm(dbBlock* block, uint oid);

  uint32_t staVertexId();
  void staSetVertexId(uint32_t id);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A dbVia is the element that represents a block specific via definition.
/// These vias are typically generated to be used in power routing.
///
///////////////////////////////////////////////////////////////////////////////
class dbVia : public dbObject
{
 public:
  ///
  /// Get the via name.
  ///
  std::string getName();

  ///
  /// Get the via name.
  ///
  const char* getConstName();

  ///
  /// Get the pattern value of this via.
  /// Returns and empty ("") string if a pattern has not been set.
  ///
  std::string getPattern();

  ///
  /// Set the pattern value of this via.
  /// The pattern is ignored if the pattern is already set on this via
  ///
  void setPattern(const char* pattern);

  ///
  /// Set generate rule that was used to genreate this via.
  ///
  void setViaGenerateRule(dbTechViaGenerateRule* rule);

  ///
  /// Get the generate rule that was used to genreate this via.
  ///
  dbTechViaGenerateRule* getViaGenerateRule();

  ///
  /// Returns true if this via has params.
  ///
  bool hasParams();

  ///
  /// Set via params to generate this via. This method will create the shapes
  /// of this via. All previous shapes are destroyed.
  ///
  void setViaParams(const dbViaParams& params);

  ///
  /// Get the via params used to generate this via.
  ///
  void getViaParams(dbViaParams& params_return);

  ///
  /// Get the block this via belongs too.
  ///
  dbBlock* getBlock();

  ///
  /// Get the bbox of this via
  /// Returns NULL if this via has no shapes.
  ///
  dbBox* getBBox();

  ///
  /// Get the boxes of this via.
  ///
  dbSet<dbBox> getBoxes();

  ///
  /// Get the upper-most layer of this via reaches
  /// Returns NULL if this via has no shapes.
  ///
  dbTechLayer* getTopLayer();

  ///
  /// Get the lower-most layer of this via reaches
  /// Returns NULL if this via has no shapes.
  ///
  dbTechLayer* getBottomLayer();

  ///
  /// Returns true if this via is a rotated version of a block or tech via.
  ///
  /// Vias in DEF can now be rotated.
  ///
  bool isViaRotated();

  ///
  /// Get the rotation of this via.
  ///
  dbOrientType getOrient();

  //
  // Get the tech-via that this roated via represents.
  /// Returns NULL if this via does not represent a tech via
  //
  dbTechVia* getTechVia();

  //
  // Get the block-via that this roated via represents.
  /// Returns NULL if this via does not represent a block via
  //
  dbVia* getBlockVia();

  ///
  /// Create a block specific via.
  /// Returns NULL if a via with this name already exists.
  ///
  static dbVia* create(dbBlock* block, const char* name);

  ///
  /// Created a rotated version of the specified block-via.
  /// Returns NULL if a via with this name already exists.
  ///
  static dbVia* create(dbBlock* block,
                       const char* name,
                       dbVia* via,
                       dbOrientType type);

  ///
  /// Created a rotated version of the specified tech-via.
  /// Returns NULL if a via with this name already exists.
  ///
  static dbVia* create(dbBlock* block,
                       const char* name,
                       dbTechVia* via,
                       dbOrientType type);

  /// Copy all the VIA's from the src-block to the dst-block.
  /// Returns false the copy failed.
  static bool copy(dbBlock* dst, dbBlock* src);

  /// Copy the VIA to the dst-block.
  static dbVia* copy(dbBlock* dst, dbVia* src);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbVia* getVia(dbBlock* block, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
///  A dbWire is the element used to represent net wires. A wire object
///  represents a sequence of from-to paths, which may form either
///  a disjoint or non-disjoint set of paths. A wire is encoded using the
///  dbWireEncoder class, see "dbWireCodec.h". A wire is decoded using
///  the dbWireDecoder class.
///
///////////////////////////////////////////////////////////////////////////////
class dbWire : public dbObject
{
 public:
  ///
  /// Get the block this wire belongs too.
  ///
  dbBlock* getBlock();

  ///
  /// Get the net this wire is attached too.
  /// Returns NULL if this wire is not attached to a net.
  ///
  dbNet* getNet();

  ///
  /// Append the wire to this wire. This operation will fail if the wire
  /// is from another block and the wire contains bterms or iterms.
  ///
  void append(dbWire* wire, bool singleSegmentWire = false);

  ///
  /// Move segements of this wire to wires of other nets
  ///
  void shuffleWireSeg(dbNet** newNets, dbRSeg** new_rsegs);

  ///
  /// Get junction id associated with the term
  ///
  uint getTermJid(int termid);

  ///
  /// check if this wire equals the target wire
  /// return value = 0: equal
  ///                x: not equal
  ///                1x: wire seg after junction not equal
  ///
  uint equal(dbWire* target);

  // void match(dbWire *target);

  ///
  /// Get the shape of this shape-id.
  /// PRECONDITION: shape-id is a segment or via
  ///
  void getShape(int shape_id, dbShape& shape);

  ///
  /// Get the segment of this segment-id
  ///
  /// PRECONDITION: segment_id is a segment
  ///
  void getSegment(int segment_id, dbShape& shape);

  ///
  /// Get the segment of this segment-id, where layer is the layer of the
  /// segment
  ///
  /// PRECONDITION: segment_id is a segment
  ///
  void getSegment(int segment_id, dbTechLayer* layer, dbShape& shape);

  ///
  /// Get the previous via of this shape-id.
  /// returns false if the previous shape is not a via.
  ///
  bool getPrevVia(int shape_id, dbShape& shape);

  ///
  /// Get the via that follows of this shape-id.
  /// returns false if the next shape is not a via.
  ///
  bool getNextVia(int shape_id, dbShape& shape);

  ///
  /// Get the via boxes of this via_shape-id.
  ///
  /// returns false if this shape_id is not a via.
  ///
  bool getViaBoxes(int via_shape_id, std::vector<dbShape>& boxes);

  ///
  /// Returns true if this wire is a global-wire
  ///
  bool isGlobalWire();

  ///
  /// Get the bounding box of this wire
  ///
  bool getBBox(Rect& r);

  ///
  /// Get the total path length contained in this wire.
  ///
  uint64 getLength();

  ///
  /// Get the number of entries contained in this wire.
  ///
  uint length();

  ///
  /// Get the count of wire segments contained in this wire.
  ///
  uint count();
  ///
  /// Get junction coordinate.
  ///
  void getCoord(int jid, int& x, int& y);

  ///
  /// Get junction property
  ///
  bool getProperty(int jid, int& property);

  ///
  /// Set junction property
  ///
  bool setProperty(int jid, int property);

  ///
  /// Set one data entry
  ///
  int getData(int n);

  ///
  /// Set one opcode entry
  ///
  unsigned char getOpcode(int n);

  ///
  /// Print opcodes and data of this wire
  ///
  void printWire();
  void printWire(FILE* fp, int fid, int tid);

  ///
  /// Attach this wire to a net.
  ///   1) If the net is already attached to another wire, the other wire will
  ///      be destroyed.
  ///   2) If this wire is already attached to another net, thie wire will be
  ///   detachd from
  //       the other net.
  ///
  void attach(dbNet* net);

  ///
  /// Detach this wire from a net.
  ///
  void detach();

  ///
  /// Copy the src wire to the desintation wire.
  ///
  ///    removeITermBTerms - if true, then any iterms or bterms referenced in
  ///    the copied wire will be removed. copyVias - if true, then any reference
  ///    vias that do not exists in the dst-block are copied to the src-block.
  ///
  ///
  static void copy(dbWire* dst,
                   dbWire* src,
                   bool removeITermsBTerms = true,
                   bool copyVias = true);

  ///
  /// Copy the src wire to the desintation wire. Filter vias and segments that
  /// do not intersect bbox.
  ///
  ///    removeITermBTerms - if true, then any iterms or bterms referenced in
  ///    the copied wire will be removed. copyVias - if true, then any reference
  ///    vias that do not exists in the dst-block are copied to the src-block.
  ///
  ///
  static void copy(dbWire* dst,
                   dbWire* src,
                   const Rect& bbox,
                   bool removeITermsBTerms = true,
                   bool copyVias = true);

  ///
  /// Create a wire.
  /// Returns NULL if this net already has the specified wire dbWire.
  ///
  static dbWire* create(dbNet* net, bool global_wire = false);

  ///
  /// Create an unattached wire.
  ///
  static dbWire* create(dbBlock* block, bool global_wire = false);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbWire* getWire(dbBlock* block, uint oid);

  ///
  /// Destroy a wire.
  ///
  static void destroy(dbWire* wire);

 private:
  void addOneSeg(unsigned char op,
                 int value,
                 uint jj,
                 int* did,
                 dbRSeg** new_rsegs);
  void addOneSeg(unsigned char op, int value);
  void donateWireSeg(dbWire* w1, dbRSeg** new_rsegs);

  friend class dbNet;
};

///////////////////////////////////////////////////////////////////////////////
///
///  A dbSWire is the element used to represent special-net wires.
///
///////////////////////////////////////////////////////////////////////////////
class dbSWire : public dbObject
{
 public:
  ///
  /// Get the block this wire belongs too.
  ///
  dbBlock* getBlock();

  ///
  /// Get the net this wire is attached too.
  ///
  dbNet* getNet();

  ///
  /// Return the wire-type.
  ///
  dbWireType getWireType();

  ///
  /// Returns the shield net if the wire-type is dbWireType::SHIELD
  ///
  dbNet* getShield();

  ///
  /// Get the wires of this special wire.
  ///
  dbSet<dbSBox> getWires();

  ///
  /// Create a new special-wire.
  ///
  static dbSWire* create(dbNet* net, dbWireType type, dbNet* shield = NULL);

  ///
  /// Delete this wire
  ///
  static void destroy(dbSWire* swire);

  ///
  /// Delete this wire
  ///
  static dbSet<dbSWire>::iterator destroy(dbSet<dbSWire>::iterator& itr);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbSWire* getSWire(dbBlock* block, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A dbGCellGrid is the element that represents a block specific grid
/// definition.
///
///////////////////////////////////////////////////////////////////////////////

///////////////////////////////////////////////////////////////////////////////
///
/// A dbTrackGrid is the element that represents a block tracks.
///
///////////////////////////////////////////////////////////////////////////////
class dbTrackGrid : public dbObject
{
 public:
  ///
  /// Get the layer for this track-grid.
  ///
  dbTechLayer* getTechLayer();

  ///
  /// Get the "X" track coordinates for a this tech-layer.
  ///
  void getGridX(std::vector<int>& x_grid);

  ///
  /// Get the "Y" track coordinates for a this tech-layer.
  ///
  void getGridY(std::vector<int>& y_grid);

  ///
  /// Get the block this grid belongs too.
  ///
  dbBlock* getBlock();

  ///
  /// Add a "X" grid pattern.
  ///
  void addGridPatternX(int origin_x, int line_count, int step);

  ///
  /// Add a "Y" grid pattern.
  ///
  void addGridPatternY(int origin_y, int line_count, int step);

  ///
  /// Get the number of "X" grid patterns.
  ///
  int getNumGridPatternsX();

  ///
  /// Get the number of "Y" grid patterns.
  ///
  int getNumGridPatternsY();

  ///
  /// Get the "ith" "X" grid pattern.
  ///
  void getGridPatternX(int i, int& origin_x, int& line_count, int& step);

  ///
  /// Get the "ith" "Y" grid pattern.
  ///
  void getGridPatternY(int i, int& origin_y, int& line_count, int& step);
  ///
  /// Create an empty Track grid.
  /// Returns NULL if a the grid for this layer already exists.
  ///
  static dbTrackGrid* create(dbBlock* block, dbTechLayer* layer);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbTrackGrid* getTrackGrid(dbBlock* block, uint oid);

  ///
  /// destroy a grid
  ///
  static void destroy(dbTrackGrid* grid_);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A dbObstruction is the element that represents a routing
/// obstruction in a block.
///
///////////////////////////////////////////////////////////////////////////////
class dbObstruction : public dbObject
{
 public:
  ///
  /// Get the bbox of this obstruction.
  ///
  dbBox* getBBox();

  ///
  /// Get the instance associated with this obstruction.
  /// Returns NULL of no instance was associated with this obstruction
  ///
  dbInst* getInstance();

  ///
  /// Declare this obstruction to be a "slot" obstruction.
  ///
  void setSlotObstruction();

  ///
  /// Returns true if this obstruction is a "slot" obstruction.
  ///
  bool isSlotObstruction();

  ///
  /// Declare this obstruction to be a "fill" obstruction.
  ///
  void setFillObstruction();

  ///
  /// Returns true if this obstruction is a "fill" obstruction.
  ///
  bool isFillObstruction();

  ///
  /// Declare this obstruction to have been pushed into this block.
  ///
  void setPushedDown();

  ///
  /// Returns true if this obstruction was pushed into this block.
  ///
  bool isPushedDown();
  ///
  /// Returns true if this bpin has an effective-width rule.
  ///
  bool hasEffectiveWidth();

  ///
  /// Set the effective width rule.
  ///
  void setEffectiveWidth(int w);

  ///
  /// Return the effective width rule.
  ///
  int getEffectiveWidth();

  ///
  /// Returns true if this bpin has an min-spacing rule.
  ///
  bool hasMinSpacing();

  ///
  /// Set the min spacing rule.
  ///
  void setMinSpacing(int w);

  ///
  /// Return the min spacing rule.
  ///
  int getMinSpacing();

  ///
  /// Get the block this obstruction belongs too.
  ///
  dbBlock* getBlock();

  ///
  /// Delete this obstruction from this block.
  ///
  static void destroy(dbObstruction* obstruction);

  ///
  /// Create a routing obstruction.
  ///
  static dbObstruction* create(dbBlock* block,
                               dbTechLayer* layer,
                               int x1,
                               int y1,
                               int x2,
                               int y2,
                               dbInst* inst = NULL);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbObstruction* getObstruction(dbBlock* block, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A dbBlockage is the element that represents a placement blockage in a block.
///
///////////////////////////////////////////////////////////////////////////////
class dbBlockage : public dbObject
{
 public:
  ///
  /// Get the bbox of this obstruction.
  ///
  dbBox* getBBox();

  ///
  /// Get the instance associated with this blockage.
  /// Returns NULL of no instance was associated with this blockage
  ///
  dbInst* getInstance();

  ///
  /// Declare this blockage to have been pushed into this block.
  ///
  void setPushedDown();

  ///
  /// Returns true if this blockage was pushed into this block.
  ///
  bool isPushedDown();

  ///
  /// Declare this blockage is soft.
  ///
  void setSoft();

  ///
  /// Returns true if this blockage is soft.
  ///
  bool isSoft();

  ///
  /// Set the max placement density percentage in [0,100]
  ///
  void setMaxDensity(float max_density);

  ///
  /// Returns the max placement density percentage
  ///
  float getMaxDensity();

  ///
  /// Get the block this obstruction belongs too.
  ///
  dbBlock* getBlock();

  ///
  /// Create a placement obstruction.
  ///
  static dbBlockage* create(dbBlock* block,
                            int x1,
                            int y1,
                            int x2,
                            int y2,
                            dbInst* inst = NULL);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbBlockage* getBlockage(dbBlock* block, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A RCSeg is the element that represents an RC element in a RC network.
///
/// The segment junction nodes are denoted "source" and "target". However,
/// this namimg is just a convention and there is no implied directional
/// meaning.
///
///////////////////////////////////////////////////////////////////////////////
class dbCapNode : public dbObject
{
 protected:
  friend class dbRSeg;
  friend class extMain;
  friend class extSpef;
  friend class te_tile;
  friend class tilext;
  friend class dbJournal;

  ///
  /// Get the capacitance of this capNode segment for this process corner.
  /// Returns value in femto-fards.
  ///
  void getCapTable(double* cap);

 public:
  ///
  /// Add the capacitances of other capnode to this capnode
  ///
  void addCapnCapacitance(dbCapNode* other);

  ///
  /// Add the gndCap of this capnode to *gndcap and *totalcap
  ///
  void addGndCap(double* gndcap, double* totalcap);

  /// Add the gndCap to *gndcap and *totalcap, ccCap to *totalcap
  ///
  void addGndTotalCap(double* gndcap, double* totalcap, double MillerMult);

  ///
  /// Get the gndCap of this capnode to *gndcap and *totalcap
  ///
  void getGndCap(double* gndcap, double* totalcap);

  ///
  /// Get the gndCap to *gndcap and *totalcap, ccCap to *totalcap
  ///
  void getGndTotalCap(double* gndcap, double* totalcap, double MillerMult);

  ///
  /// Add the caps of all corners of CC's from this capnode to *totalcap
  ///
  void accAllCcCap(double* totalcap, double MillerMult);

  ///
  /// Set the capacitance of this CapNode segment for this process corner. Value
  /// must be in femto-fards.
  ///
  void setCapacitance(double cap, int corner = 0);

  ///
  /// Add the capacitance of this CapNode segment for this process corner. Value
  /// must be in femto-fards.
  ///
  void addCapacitance(double cap, int corner = 0);

  ///
  /// add cc capacitance to gnd capacitance of this capNode
  ///
  bool groundCC(float gndFactor);

  ///
  ///  Adjust the capacitance of this capNode for this process corner
  ///
  void adjustCapacitance(float factor, uint corner);

  ///
  ///  Adjust the capacitance of this capNode
  ///
  void adjustCapacitance(float factor);

  ///
  /// check if having CC's with capacitnce greater than ccThreshHold
  ///
  bool needAdjustCC(double ccThreshHold);

  ///
  /// adjust CC's of this capNode
  ///
  void adjustCC(uint adjOrder,
                float adjFactor,
                std::vector<dbCCSeg*>& adjustedCC,
                std::vector<dbNet*>& halonets);

  ///
  /// Get the capacitance of this capNode segment for this process corner.
  /// Returns value in femto-fards.
  ///
  double getCapacitance(uint corner = 0);

  ///
  /// Get the rc-network cap node.
  ///
  uint getNode();

  ///
  /// Get the shapeId of the cap node.
  ///
  uint getShapeId();

  ///
  /// Set the rc-network cap node.
  ///
  void setNode(uint nodeid);

  ///
  /// Get next cap node in same net
  ///
  //  dbCapNode *getNext(dbBlock *block_);

  ///
  ///  is this node iterm/bterm/internal/branch/dangling/foreign .
  ///
  bool isName();
  bool isITerm();
  bool isBTerm();
  bool isInternal();
  bool isBranch();
  bool isDangling();
  bool isForeign();
  bool isTreeNode();  // bterm, iterm, branch
  // bool isSourceNodeBterm();
  bool isSourceTerm(dbBlock* mblock = NULL);
  bool isInoutTerm(dbBlock* mblock = NULL);

  ///
  /// Returns the select flag value. This flag specified that the
  /// net has been select.
  ///
  bool isSelect();

  ///
  /// Set the select flag to the specified value.
  ///
  void setSelect(bool value);

  ///
  ///  increase children cnt; capNode is a branch of the rooted tree.
  ///
  uint incrChildrenCnt();
  uint getChildrenCnt();
  void setChildrenCnt(uint cnt);

  ///
  ///  set iterm/bterm/internal/branch/foreign flag of this cap node.
  ///
  void setNameFlag();
  void setBTermFlag();
  void setITermFlag();
  void setInternalFlag();
  void setBranchFlag();
  void setForeignFlag();

  ///
  ///  reset iterm/bterm/internal/branch/foreign flag of this cap node.
  ///
  void resetNameFlag();
  void resetBTermFlag();
  void resetITermFlag();
  void resetInternalFlag();
  void resetBranchFlag();
  void resetForeignFlag();

  ///
  /// Get the sort index of this node
  ///
  uint getSortIndex();

  ///
  /// Set the sort index of this node
  ///
  void setSortIndex(uint idx);

  ///
  /// Get the coordinates of this node if iterm or bterm
  ///
  bool getTermCoords(int& x, int& y, dbBlock* mblock = NULL);

  ///
  /// Get the iterm of this node
  ///
  dbITerm* getITerm(dbBlock* mblock = NULL);

  ///
  /// Get the bterm of this node
  ///
  dbBTerm* getBTerm(dbBlock* mblock = NULL);

  ///
  /// Set the _ycoord of this node
  ///
  /// void setCoordY(int y);

  ///
  /// Get the _ycoord of this node
  ///
  /// void getCoordY(int & y);

  ///
  /// print the ccsegs of the capn
  ///
  void printCC();

  ///
  /// check the ccsegs of the capn
  ///
  bool checkCC();

  ///
  /// Get the coupling caps bound to this node
  ///
  dbSet<dbCCSeg> getCCSegs();

  ///
  /// Net given the capNode id
  ///
  dbNet* getNet();

  ///
  /// set net
  ///
  void setNet(uint netid);

  ///
  /// set next
  ///
  void setNext(uint nextid);

  ///
  /// Create a new rc-segment
  /// The default values for each process corner is 0.0.
  ///
  static dbCapNode* create(dbNet* net, uint node, bool foreign);

  ///
  /// add a seg onto a net
  ///
  void addToNet();

  ///
  /// Destroy a rc-segment.
  ///
  static void destroy(dbCapNode* seg, bool destroyCC = true);

  ///
  /// Destroy a rc-segment.
  ///
  static dbSet<dbCapNode>::iterator destroy(dbSet<dbCapNode>::iterator& itr);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbCapNode* getCapNode(dbBlock* block, uint oid);

  // friend void test_eco();
};
///////////////////////////////////////////////////////////////////////////////
///
/// A RSeg is the element that represents an Res element in a Res network.
///
/// The segment junction nodes are denoted "source" and "target". However,
/// this namimg is just a convention and there is no implied directional
/// meaning.
///
///////////////////////////////////////////////////////////////////////////////
class dbRSeg : public dbObject
{
 public:
  ///
  /// Add the resistances of other rseg to this rseg
  ///
  void addRSegResistance(dbRSeg* other);

  ///
  /// Add the capacitances of other rseg to this rseg
  ///
  void addRSegCapacitance(dbRSeg* other);

  ///
  /// Get the resistance of this RC segment for this process corner. Returns
  /// value in ohms.
  ///
  double getResistance(int corner = 0);

  ///
  /// Get the resistance of this RC segment to *res
  ///
  void getAllRes(double* res);

  ///
  /// Add the resistance of this RC segment to *res
  ///
  void addAllRes(double* res);

  ///
  /// Get the gdn cap of this RC segment to *gndcap and *totalcap
  ///
  void getGndCap(double* gndcap, double* totalcap);

  ///
  /// Add the gdn cap of this RC segment to *gndcap and *totalcap
  ///
  void addGndCap(double* gndcap, double* totalcap);

  ///
  /// Get the gdn cap of this RC segment to *gndcap, total cap to *totalcap
  ///
  void getGndTotalCap(double* gndcap, double* totalcap, double MillerMult);

  ///
  /// Add the gdn cap of this RC segment to *gndcap, total cap to *totalcap
  ///
  void addGndTotalCap(double* gndcap, double* totalcap, double MillerMult);

  ///
  /// do merge rsegs
  ///
  void mergeRCs(std::vector<dbRSeg*>& mrsegs);

  ///
  /// Adjust the capacitance of this RC segment for this process corner.
  ///
  void adjustCapacitance(float factor, uint corner);

  ///
  /// Adjust the capacitance of the src capNode of this RC segment for the
  /// process corner.
  ///
  void adjustSourceCapacitance(float factor, uint corner);

  ///
  /// Adjust the capacitance of this RC segment.
  ///
  void adjustCapacitance(float factor);

  ///
  /// Set the capacitance of this RC segment for this process corner. Value must
  /// in FF.
  ///
  void setCapacitance(double cap, int corner = 0);

  ///
  /// Returns the _update_cap flag value. This flag specified that the
  /// rseg has been updated
  ///
  bool updatedCap();

  ///
  /// Get the capacitance of this RC segment for this process corner. Returns
  /// value in FF.
  ///
  double getCapacitance(int corner = 0);

  ///
  /// Get the capacitance of this RC segment for this process corner,
  /// plus coupling capacitance. Returns value in FF.
  ///
  double getSourceCapacitance(int corner = 0);

  ///
  /// Get the first capnode capacitance of this RC segment
  /// for this process corner, if foreign,
  /// plus coupling capacitance. Returns value in FF.
  ///
  double getCapacitance(int corner, double MillerMult);

  ///
  /// Get the CC segs of this RC segment,
  ///
  void getCcSegs(std::vector<dbCCSeg*>& ccsegs);

  ///
  /// print the CC segs of this RC segment,
  ///
  void printCcSegs();
  void printCC();
  bool checkCC();

  ///
  /// Get the capacitance table of this RC segment. value is in FF
  ///
  void getCapTable(double* cap);

  ///
  /// Set the resistance of this RC segment for this process corner. Value must
  /// be in ohms.
  ///
  void setResistance(double res, int corner = 0);

  ///
  ///  Adjust the resistance of this RC segment for this process corner
  ///
  void adjustResistance(float factor, int corner);

  ///
  ///  Adjust the resistance of this RC segment
  ///
  void adjustResistance(float factor);

  ///
  /// Set the next rseg
  ///
  void setNext(uint next_id);

  ///
  /// Get the rc-network source node of this segment,
  ///
  uint getSourceNode();

  ///
  /// Get the rc-network source node of this segment,
  ///
  dbCapNode* getSourceCapNode();

  ///
  /// Set the rc-network source node of this segment,
  ///
  void setSourceNode(uint nodeid);

  ///
  /// Get the rc-network target node of this segment,
  ///
  uint getTargetNode();

  ///
  /// Get the rc-network target node of this segment,
  ///
  dbCapNode* getTargetCapNode();

  ///
  /// Set the rc-network target node of this segment,
  ///
  void setTargetNode(uint nodeid);

  ///
  /// Get shape-id of this RC-segment.
  ///
  uint getShapeId();

  ///
  /// Set coordinates of this RC-segment.
  ///
  void setCoords(int x, int y);

  ///
  /// Get coordinates of this RC-segment.
  ///
  void getCoords(int& x, int& y);

  ///
  /// Set shape-id of this RC-segment, and the target capNode if internal.
  ///
  void updateShapeId(uint nsid);

  ///
  /// check path direction
  ///
  bool pathLowToHigh();

  ///
  /// check if cap allocated
  ///
  bool allocatedCap();

  ///
  /// returns length and width.
  ///
  uint getLengthWidth(uint& w);

  ///
  /// add a seg onto a net
  ///
  bool addToNet();

  ///
  /// Get the net of this RC-segment.
  ///
  dbNet* getNet();

  ///
  /// Create a new r-segment
  /// The default values for each process corner is 0.0.
  ///
  static dbRSeg* create(dbNet* net,
                        int x,
                        int y,
                        uint path_dir,
                        bool allocate_cap);

  ///
  /// Destroy a rc-segment.
  ///
  static void destroy(dbRSeg* seg);
  static void destroy(dbRSeg* seg, dbNet* net);

  ///
  /// simple destroy a disconnected rc-segment
  ///
  static void destroyS(dbRSeg* seg);

  ///
  /// Destroy a rc-segment.
  ///
  static dbSet<dbRSeg>::iterator destroy(dbSet<dbRSeg>::iterator& itr);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbRSeg* getRSeg(dbBlock* block, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A CCSeg is the element that represents an coupling capacitance element
/// in a RC network.
///
/// The segment junction nodes are denoted "source" and "target". However,
/// this namimg is just a convention and there is no implied directional
/// meaning.
///
///////////////////////////////////////////////////////////////////////////////
class dbCCSeg : public dbObject
{
 public:
  ///
  /// Adjust the capacitance of this CC segment
  ///
  void adjustCapacitance(float factor);

  ///
  /// Adjust the capacitance of a corner this CC segment
  ///
  void adjustCapacitance(float factor, int corner);

  ///
  /// Get the capacitance of this CC segment for this process corner. Returns
  /// value in femto-fards.
  ///
  double getCapacitance(int corner = 0);

  ///
  /// Set the capacitance of this CC segment for this process corner. Value must
  /// be in femto-fards.
  ///
  void setCapacitance(double cap, int corner = 0);

  ///
  /// Add the capacitance of this CC segment for this process corner. Value must
  /// be in femto-fards.
  ///
  void addCapacitance(double cap, int corner = 0);

  ///
  /// Add the capacitance of all corners of this CC segment to *ttcap
  ///
  void accAllCcCap(double* ttcap, double MillerMult);

  ///
  /// Get the capacitance of all corners of this CC segment to *ttcap
  ///
  void getAllCcCap(double* ttcap);

  ///
  /// Set the capacitance of all corners of this CC segment by *ttcap
  ///
  void setAllCcCap(double* ttcap);

  dbCapNode* getSourceCapNode();
  dbCapNode* getTargetCapNode();

  ///
  /// Add capacitance of other CC segment to this CC segment
  ///
  void addCcCapacitance(dbCCSeg* other);

  ///
  /// Change this CC segement's capNode orig to capNode new
  ///
  void swapCapnode(dbCapNode* orig, dbCapNode* newn);

  ///
  /// Get the capNode of this CC segment, other than oneCap
  ///
  dbCapNode* getTheOtherCapn(dbCapNode* oneCap, uint& cid);

  /// Get the rc-network source node of this segment,
  ///
  uint getSourceNodeNum();

  ///
  /// Set the rc-network source node of this segment,
  ///
  // void setSourceNode( uint nodeid );

  ///
  /// Get the rc-network target node of this segment,
  ///
  uint getTargetNodeNum();

  ///
  /// Set the rc-network target node of this segment,
  ///
  // void setTargetNode( uint nodeid );

  ///
  /// Get the source net of this CC-segment.
  ///
  dbNet* getSourceNet();

  ///
  /// Get the target net of this CC-segment.
  ///
  dbNet* getTargetNet();

  ///
  /// Get the infile cnt of this CC-segment.
  ///
  uint getInfileCnt();

  ///
  /// Increment the infile cnt of this CC-segment.
  ///
  void incrInfileCnt();

  ///
  /// Returns the mark flag value. This flag specified that the
  /// CC seg has been marked.
  ///
  bool isMarked();

  ///
  /// Set the mark flag to the specified value.
  ///
  void setMark(bool value);

  ///
  /// print CC's of capn
  ///
  void printCapnCC(uint capn);

  ///
  /// check CC's of capn
  ///
  bool checkCapnCC(uint capn);

  ///
  /// unlink cc from capn
  ///
  void unLink_cc_seg(dbCapNode* capn);

  ///
  /// link cc to capn
  ///
  void Link_cc_seg(dbCapNode* capn, uint cseq);

  ///
  /// relink _cc_tgt_segs of a net
  /// Used in re-reading the CC part of a spef file.
  ///

  // static dbCCSeg * relinkTgtCC (dbNet *net_, dbCCSeg *pseg_, uint
  // src_cap_node, uint tgt_cap_node);

  ///
  /// Returns NULL if not found
  ///
  static dbCCSeg* findCC(dbCapNode* nodeA, dbCapNode* nodeB);

  ///
  /// Create a new cc-segment.
  /// The default values for each process corner is 0.0.
  ///
  static dbCCSeg* create(dbCapNode* nodeA,
                         dbCapNode* nodeB,
                         bool mergeParallel = false);

  ///
  /// Destroy a cc-segment.
  ///
  static void destroy(dbCCSeg* seg);

  ///
  /// simple destroy disconnected cc-segment
  ///
  static void destroyS(dbCCSeg* seg);

  ///
  /// Destroy a cc-segment.
  ///
  static dbSet<dbCCSeg>::iterator destroy(dbSet<dbCCSeg>::iterator& itr);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbCCSeg* getCCSeg(dbBlock* block, uint oid);

  ///
  /// disconnect a cc-segment
  ///
  static void disconnect(dbCCSeg* tcc_);

  ///
  /// connect a cc-segment
  ///
  static void connect(dbCCSeg* tcc_);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A Row is the element that represents placement sites.
///
///////////////////////////////////////////////////////////////////////////////
class dbRow : public dbObject
{
 public:
  ///
  /// Get the row name.
  ///
  std::string getName();

  ///
  /// Get the row name.
  ///
  const char* getConstName();

  ///
  /// Get the row site.
  ///
  dbSite* getSite();

  ///
  /// Get the origin of this row
  ///
  void getOrigin(int& x, int& y);

  ///
  /// Get the site-orientation of this row
  ///
  dbOrientType getOrient();

  ///
  /// Get the direction of this row
  ///
  dbRowDir getDirection();

  ///
  /// Get the number of sites in this row.
  ///
  int getSiteCount();

  ///
  /// Get the spacing between sites. The spacing is measured from the
  /// origin of each site.
  ///
  int getSpacing();

  ///
  /// Get the bounding box of this row
  ///
  void getBBox(Rect& bbox);

  ///
  /// Create a new row.
  ///
  static dbRow* create(dbBlock* block,
                       const char* name,
                       dbSite* site,
                       int origin_x,
                       int origin_y,
                       dbOrientType orient,
                       dbRowDir direction,
                       int num_sites,
                       int spacing);

  ///
  /// Destroy a row.
  ///
  static void destroy(dbRow* row);

  ///
  /// Destroy a row.
  ///
  static dbSet<dbRow>::iterator destroy(dbSet<dbRow>::iterator& itr);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbRow* getRow(dbBlock* block, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A fill is the element that one metal fill shape
///
///////////////////////////////////////////////////////////////////////////////
class dbFill : public dbObject
{
 public:
  ///
  /// Get the fill bounding box.
  ///
  void getRect(Rect& rect);

  ///
  /// Returns true if this fill requires OPC (Optical proximity correction)
  ///
  bool needsOPC();

  ///
  /// Which mask is used for double or triple patterning.  Zero is returned for
  /// unassigned.  Values are typically in [1,3].
  ///
  uint maskNumber();

  ///
  /// Get the layer of this fill.
  ///
  dbTechLayer* getTechLayer();

  ///
  /// Create a new fill.
  ///
  static dbFill* create(dbBlock* block,
                        bool needs_opc,
                        uint mask_number,
                        dbTechLayer* layer,
                        int x1,
                        int y1,
                        int x2,
                        int y2);

  ///
  /// Destroy a fill.
  ///
  static void destroy(dbFill* fill);

  ///
  /// Destroy fills.
  ///
  static dbSet<dbFill>::iterator destroy(dbSet<dbFill>::iterator& itr);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbFill* getFill(dbBlock* block, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A Region is the element that represents a placement region.
///
///////////////////////////////////////////////////////////////////////////////
class dbRegion : public dbObject
{
 public:
  ///
  /// Get the region name.
  ///
  std::string getName();

  ///
  /// Get the region type.
  ///
  dbRegionType getRegionType();

  ///
  /// Set the region type.
  ///
  void setRegionType(dbRegionType type);

  ///
  /// Get the instances of this region.
  ///
  dbSet<dbInst> getRegionInsts();

  ///
  // Set the value of the invalid flag.
  ///
  void setInvalid(bool v);

  ///
  /// Returns true if the invalid flag is set.
  ///
  bool isInvalid();

  ///
  /// Get the boundaries of this region.
  /// A region may have no boundaries. In this case, you may have to check the
  /// parents of this region. This case can occur when reading DEF GROUPS and
  /// REGIONS. The result is two levels of hierarchy with the boundaries on the
  /// parent.
  ///
  dbSet<dbBox> getBoundaries();

  ///
  /// Add this instance to the region
  ///
  void addInst(dbInst* inst);

  ///
  /// Remove this instance from the region
  ///
  void removeInst(dbInst* inst);

  ///
  /// Get the parent of this region. Returns null of this region has no parent.
  ///
  dbRegion* getParent();

  ///
  /// Get the children of this region.
  ///
  dbSet<dbRegion> getChildren();

  ///
  /// Add child region to this region.
  ///
  /// This method will do nothing if this child already has a parent.
  ///
  void addChild(dbRegion* region);

  ///
  /// Get the block of this region
  ///
  dbBlock* getBlock();

  ///
  /// Create a new region. Returns NULL if a region with this name already
  /// exists in the block.
  ///
  static dbRegion* create(dbBlock* block, const char* name);

  ///
  /// Create a new region. The region will become a child region of parent.
  /// Returns NULL if a region with this name already exists in the block.
  ///
  static dbRegion* create(dbRegion* parent, const char* name);

  ///
  /// Destroy a region.
  ///
  static void destroy(dbRegion* region);

  ///
  /// Destroy a region.
  ///
  static dbSet<dbRegion>::iterator destroy(dbSet<dbRegion>::iterator& itr);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbRegion* getRegion(dbBlock* block, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A Library is the element that represents a collection of library-cells,
/// called Masters.
///
///////////////////////////////////////////////////////////////////////////////
class dbLib : public dbObject
{
 public:
  ///
  /// Get the library name.
  ///
  std::string getName();

  ///
  /// Get the library name.
  ///
  const char* getConstName();

  ///
  /// Get the Database units per micron.
  ///
  int getDbUnitsPerMicron();

  ///
  /// Get the technology of this library
  ///
  dbTech* getTech();

  ///
  /// Get the master-cells of this library
  ///
  dbSet<dbMaster> getMasters();

  ///
  /// Finds a specific master-cell in the library
  /// Returns NULL if the object was not found.
  ///
  dbMaster* findMaster(const char* name);

  ///
  /// Get the sites of this library
  ///
  dbSet<dbSite> getSites();

  ///
  /// Finds a specific site in the library
  /// Returns NULL if the object was not found.
  ///
  dbSite* findSite(const char* name);

  ///
  /// Get the LEF units of this technology.
  ///
  int getLefUnits();

  ///
  /// Set the LEF units of this technology.
  ///
  void setLefUnits(int units);

  ///
  /// Get the HierarchyDelimeter.
  /// Returns (0) if the delimeter was not set.
  /// A hierarchy delimeter can only be set at the time
  /// a library is created.
  ///
  char getHierarchyDelimeter();

  ///
  /// Set the Bus name delimeters
  ///
  void setBusDelimeters(char left, char right);

  ///
  /// Get the Bus name delimeters
  /// Left and Right are set to "zero" if the bus delimeters
  /// were not set.
  ///
  void getBusDelimeters(char& left, char& right);

  ///
  /// Create a new library.
  ///
  static dbLib* create(dbDatabase* db,
                       const char* name,
                       char hierarchy_delimeter = 0);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbLib* getLib(dbDatabase* db, uint oid);

  ///
  /// Destroy a library.
  ///
  static void destroy(dbLib* lib);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A Site is the element that represents a placement site for cells in this
/// library.
///
///////////////////////////////////////////////////////////////////////////////
class dbSite : public dbObject
{
 public:
  ///
  /// Get the site name.
  ///
  std::string getName();

  ///
  /// Get the site name.
  ///
  const char* getConstName();

  ///
  /// Get the width of this site
  ///
  uint getWidth();

  ///
  /// Set the width of this site
  ///
  void setWidth(uint width);

  ///
  /// Get the height of this site
  ///
  uint getHeight();

  ///
  /// Set the height of this site
  ///
  void setHeight(uint height);

  ///
  /// Get the class of this site.
  ///
  dbSiteClass getClass();

  ///
  /// Set the class of this site
  ///
  void setClass(dbSiteClass site_class);

  ///
  /// Mark that this site has X-Symmetry
  ///
  void setSymmetryX();

  ///
  /// Returns true if this site has X-Symmetry
  ///
  bool getSymmetryX();

  ///
  /// Mark that this site has Y-Symmetry
  ///
  void setSymmetryY();

  ///
  /// Returns true if this site has Y-Symmetry
  ///
  bool getSymmetryY();

  ///
  /// Mark that this site has R90-Symmetry
  ///
  void setSymmetryR90();

  ///
  /// Returns true if this site has R90-Symmetry
  ///
  bool getSymmetryR90();

  ///
  /// Get the library of this site.
  ///
  dbLib* getLib();

  ///
  /// Create a new site.
  /// Returns NULL if a site with this name already exists
  ///
  static dbSite* create(dbLib* lib, const char* name);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbSite* getSite(dbLib* lib, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A Master is the element that represents a master-cell from the library.
///
///////////////////////////////////////////////////////////////////////////////
class dbMaster : public dbObject
{
 public:
  ///
  /// Get the master cell name.
  ///
  std::string getName();

  ///
  /// Get the master cell name.
  ///
  const char* getConstName();

  ///
  /// Get the x,y origin of this master
  ///
  void getOrigin(int& x, int& y);

  ///
  /// Set the x,y origin of this master, default is (0,0)
  ///
  void setOrigin(int x, int y);

  ///
  /// Get the width of this master cell.
  ///
  uint getWidth() const;

  ///
  /// Set the width of this master cell.
  ///
  void setWidth(uint width);

  ///
  /// Get the height of this master cell.
  ///
  uint getHeight() const;

  ///
  /// Set the height of this master cell.
  ///
  void setHeight(uint height);

  ///
  /// is filler cell
  ///
  bool isFiller();

  ///
  /// Get the type of this master cell
  ///
  dbMasterType getType() const;

  ///
  /// Is the type BLOCK or any of its subtypes
  ///
  bool isBlock() const { return getType().isBlock(); }

  ///
  /// Is the type CORE or any of its subtypes
  ///
  bool isCore() const { return getType().isCore(); }

  ///
  /// Is the type PAD or any of its subtypes
  ///
  bool isPad() const { return getType().isPad(); }

  ///
  /// Is the type ENDCAP or any of its subtypes
  ///
  bool isEndCap() const { return getType().isEndCap(); }

  ///
  /// This master can be placed automatically in the core.
  /// Pad, ring, cover, and none are false.
  ///
  bool isCoreAutoPlaceable();

  ///
  /// Set the type of this master cell
  ///
  void setType(dbMasterType type);

  ///
  /// Get the Logical equivalent of this master
  /// Returns NULL if no equivalent was set.
  ///
  dbMaster* getLEQ();

  ///
  /// Set the Logical equivalent of this master
  /// NOTE: When setting the LEQ, the LEQ should be
  /// constructed to form a LEQ ring. The database
  /// does not enforce this. Typically, if the LEQ is
  /// set in the LEF file, than the LEQ's form a ring.
  ///
  void setLEQ(dbMaster* master);

  ///
  /// Get the Electical equivalent of this master
  /// Returns NULL if no equivalent was set.
  ///
  dbMaster* getEEQ();

  ///
  /// Set the Electical equivalent of this master
  /// NOTE: When setting the EEQ, the EEQ should be
  /// constructed to form a EEQ ring. The database
  /// does not enforce this. Typically, if the EEQ is
  /// set in the LEF file, than the EEQ's form a ring.
  ///
  void setEEQ(dbMaster* master);

  ///
  /// Mark that this site has X-Symmetry
  ///
  void setSymmetryX();

  ///
  /// Returns true if this site has X-Symmetry
  ///
  bool getSymmetryX();

  ///
  /// Mark that this site has Y-Symmetry
  ///
  void setSymmetryY();

  ///
  /// Returns true if this site has Y-Symmetry
  ///
  bool getSymmetryY();

  ///
  /// Mark that this site has R90-Symmetry
  ///
  void setSymmetryR90();

  ///
  /// Returns true if this site has R90-Symmetry
  ///
  bool getSymmetryR90();

  ///
  /// Get the terminals of this master.
  ///
  dbSet<dbMTerm> getMTerms();

  ///
  /// Find a specific master-terminal
  /// Returns NULL if the object was not found.
  ///
  dbMTerm* findMTerm(const char* name);
  dbMTerm* findMTerm(dbBlock* block, const char* name);

  ///
  /// Get the library of this master.
  ///
  dbLib* getLib();

  ///
  /// Get the obstructions of this master
  ///
  dbSet<dbBox> getObstructions();

  ///
  /// Get the placement bounding box of this master.
  ///
  void getPlacementBoundary(Rect& r);

  ///
  /// Apply the suppiled transform to the master obsutrctions and pin
  /// geometries.
  ///
  void transform(dbTransform& t);

  ///
  /// Freeze this master. dbMTerms cannot be added or delete from the master
  /// once it is frozen.
  ///
  void setFrozen();

  ///
  /// Returns true if the master is frozen
  ///
  bool isFrozen();

  int getOutputIndex();
  void setOutputIndex(int v);
  void setClockedIndex(int v);
  int getClockedIndex();

  ///
  /// Set _sequential of this master.
  ///
  void setSequential(uint v);

  ///
  /// Returns _sequential this master
  ///
  bool isSequential();

  ///
  /// Set _mark of this master.
  ///
  void setMark(uint mark);

  ///
  /// Returns _mark this master
  ///
  uint isMarked();

  bool isSpecialPower();
  void setSpecialPower(bool v);

  ///
  /// Returns the number of mterms of this master.
  ///
  int getMTermCount();

  ///
  /// Set the site of this master.
  /// h
  void setSite(dbSite* site);

  ///
  /// Set the site of this master.
  /// Returns NULL if no site has been set.
  ///
  dbSite* getSite();

  ///
  /// Returns a database unique id for this master.
  ///
  int getMasterId();

  ///
  /// Create a new master.
  /// Returns NULL if a master with this name already exists
  ///
  static dbMaster* create(dbLib* lib, const char* name);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbMaster* getMaster(dbLib* lib, uint oid);

  void* staCell();
  void staSetCell(void* cell);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A MTerm is the element that represents a terminal on a Master.
///
///////////////////////////////////////////////////////////////////////////////
class dbMTerm : public dbObject
{
 public:
  ///
  /// Get the master term name.
  ///
  std::string getName();

  ///
  /// Get the master term name.
  ///
  const char* getConstName();

  ///
  /// Get the master term name. Change lib_bus_del to blk_bus_del if needed
  ///
  char* getName(dbInst* inst, char* ttname);
  char* getName(dbBlock* block, dbMaster* master, char* ttname);

  ///
  /// Get the signal type of this master-terminal.
  ///
  dbSigType getSigType();

  ///
  /// Get the IO direction of this master-terminal.
  ///
  dbIoType getIoType();

  ///
  /// Set mark of this master-terminal.
  ///
  void setMark(uint v);

  ///
  /// get mark of this master-terminal.
  ///
  bool isSetMark();

  ///
  /// Get the master this master-terminal belongs too.
  ///
  dbMaster* getMaster();

  ///
  /// Get the physical pins of this terminal.
  ///
  dbSet<dbMPin> getMPins();

  ///
  /// Get bbox of this term (ie the bbox of the getMPins())
  ///
  Rect getBBox();

  ///
  /// Get the target points of this terminal.
  ///
  dbSet<dbTarget> getTargets();

  ///
  /// Add antenna info that is not specific to an oxide model.
  ///
  void addPartialMetalAreaEntry(double inval, dbTechLayer* refly = NULL);
  void addPartialMetalSideAreaEntry(double inval, dbTechLayer* refly = NULL);
  void addPartialCutAreaEntry(double inval, dbTechLayer* refly = NULL);
  void addDiffAreaEntry(double inval, dbTechLayer* refly = NULL);

  ///
  /// Antenna info that is specific to an oxide model.
  ///
  dbTechAntennaPinModel* createDefaultAntennaModel();
  dbTechAntennaPinModel* createOxide2AntennaModel();

  ///
  /// Access and write antenna rule models -- get functions will return NULL
  /// if model not created.
  ///
  bool hasDefaultAntennaModel() const;
  bool hasOxide2AntennaModel() const;
  dbTechAntennaPinModel* getDefaultAntennaModel() const;
  dbTechAntennaPinModel* getOxide2AntennaModel() const;
  void writeAntennaLef(lefout& writer) const;

  // From LEF's ANTENNADIFFAREA on the MACRO's PIN
  void getDiffArea(std::vector<std::pair<double, dbTechLayer*>>& data);

  void* staPort();
  void staSetPort(void* port);

  ///
  /// Return the index of this mterm on this master.
  /// PREQ: master must be frozen.
  ///
  int getIndex();

  ///
  /// Create a new master terminal.
  /// Returns NULL if a master terminal with this name already exists
  ///
  static dbMTerm* create(dbMaster* master,
                         const char* name,
                         dbIoType io_type = dbIoType(),
                         dbSigType sig_type = dbSigType());

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbMTerm* getMTerm(dbMaster* master, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A MPin is the element that represents a physical pin on a master-terminal.
///
///////////////////////////////////////////////////////////////////////////////
class dbMPin : public dbObject
{
 public:
  ///
  /// Get the master-terminal this pin belongs too.
  ///
  dbMTerm* getMTerm();

  ///
  /// Get the master this pin belongs too.
  ///
  dbMaster* getMaster();

  ///
  /// Get the geometry of this pin.
  ///
  dbSet<dbBox> getGeometry();

  ///
  /// Get bbox of this pin (ie the bbox of getGeometry())
  ///
  Rect getBBox();

  ///
  /// Create a new physical pin.
  ///
  static dbMPin* create(dbMTerm* mterm);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbMPin* getMPin(dbMaster* master, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A Target is the element that represents a physical target point on a MTerm.
///
///////////////////////////////////////////////////////////////////////////////
class dbTarget : public dbObject
{
 public:
  ///
  /// Get the master this target belongs too.
  ///
  dbMaster* getMaster();

  ///
  /// Get the mterm this target
  ///
  dbMTerm* getMTerm();

  ///
  /// Get the tech-layer this target
  ///
  dbTechLayer* getTechLayer();

  ///
  /// Get the target point of this target.
  ///
  Point getPoint();

  ///
  /// Create a new master terminal.
  /// Returns NULL if a master terminal with this name already exists
  ///
  static dbTarget* create(dbMTerm* mterm, dbTechLayer* layer, Point point);

  ///
  /// Destroy a target
  ///
  static void destroy(dbTarget* t);

  ///
  /// Destroy a target
  ///
  static dbSet<dbTarget>::iterator destroy(dbSet<dbTarget>::iterator& itr);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbTarget* getTarget(dbMaster* master, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A Tech is the element that represents technology specific data.
///
///////////////////////////////////////////////////////////////////////////////
class dbTech : public dbObject
{
 public:
  ///
  /// Set the Database distance units per micron.
  ///
  /// Legal values are 100, 200, 1000, 2000, 10000, 20000
  ///
  void setDbUnitsPerMicron(int value);

  ///
  /// Get the Database units per micron.
  ///
  int getDbUnitsPerMicron();

  ///
  /// Get the technolgy layers. The layers are ordered from the
  /// bottom mask number to the top mask number.
  ///
  dbSet<dbTechLayer> getLayers();

  ///
  /// Find the technology layer.
  /// Returns NULL if the object was not found.
  ///
  dbTechLayer* findLayer(const char* name);

  ///
  /// Find the technology layer.
  /// Returns NULL if the object was not found.
  ///
  dbTechLayer* findLayer(int layer_number);

  ///
  /// Find the technology routing layer.
  /// Returns NULL if the object was not found.
  ///
  dbTechLayer* findRoutingLayer(int level_number);

  ///
  /// Get the technolgy vias. This includes non-default-rule-vias.
  ///
  dbSet<dbTechVia> getVias();

  ///
  /// Find the technology via.
  /// Returns NULL if the object was not found.
  ///
  dbTechVia* findVia(const char* name);

  ///
  /// Get the LEF units of this technology.
  ///
  int getLefUnits();

  ///
  /// Set the LEF units of this technology.
  ///
  void setLefUnits(int units);

  ///
  /// Get the LEF version in this technology as a number or as a string.
  ///
  double getLefVersion() const;
  const char* getLefVersionStr() const;

  ///
  /// Set the LEF version of this technology, in both number and string form.
  ///
  void setLefVersion(double inver);

  ///
  ///  Get and set the NOWIREEXTENSIONATPIN construct
  ///
  bool hasNoWireExtAtPin() const;
  dbOnOffType getNoWireExtAtPin() const;
  void setNoWireExtAtPin(dbOnOffType intyp);

  ///
  ///  Get and set the NAMESCASESENSITIVE construct
  ///
  dbOnOffType getNamesCaseSensitive() const;
  void setNamesCaseSensitive(dbOnOffType intyp);

  ///
  /// Handle LEF CLEARANCEMEASURE construct
  ///
  bool hasClearanceMeasure() const;
  dbClMeasureType getClearanceMeasure() const;
  void setClearanceMeasure(dbClMeasureType inmeas);

  ///
  /// Handle LEF USEMINSPACING for pins and obstruction separately.
  ///
  bool hasUseMinSpacingObs() const;
  dbOnOffType getUseMinSpacingObs() const;
  void setUseMinSpacingObs(dbOnOffType inval);

  bool hasUseMinSpacingPin() const;
  dbOnOffType getUseMinSpacingPin() const;
  void setUseMinSpacingPin(dbOnOffType inval);

  ///
  ///  Handle MANUFACTURINGGRID construct
  ///  NOTE: Assumes conversion to internal DB units,
  ///  NOT microns or LEF/DEF units
  ///
  bool hasManufacturingGrid() const;
  int getManufacturingGrid() const;
  void setManufacturingGrid(int ingrd);

  ///
  /// Get the number of layers in this technology.
  ///
  int getLayerCount();

  ///
  /// Get the number of routing-layers in this technology.
  ///
  int getRoutingLayerCount();

  ///
  /// Get the number of vias in this technolgy.
  ///
  int getViaCount();

  ///
  /// Get the non-default rules
  ///
  dbSet<dbTechNonDefaultRule> getNonDefaultRules();

  ///
  /// Find a specific rule
  ///
  dbTechNonDefaultRule* findNonDefaultRule(const char* rulename);

  ///
  /// Find a specific rule
  /// Returns NULL if no rule exists.
  ///
  dbTechSameNetRule* findSameNetRule(dbTechLayer* l1, dbTechLayer* l2);

  ///
  /// Get the same-net rules of this non-default rule.
  ///
  void getSameNetRules(std::vector<dbTechSameNetRule*>& rules);

  ///
  ///
  ///
  dbSet<dbTechViaRule> getViaRules();

  ///
  ///
  ///
  dbSet<dbTechViaGenerateRule> getViaGenerateRules();

  ///
  ///
  ///
  dbTechViaRule* findViaRule(const char* name);

  ///
  ///
  ///
  dbTechViaGenerateRule* findViaGenerateRule(const char* name);

  ///
  ///
  ///
  void checkLayer(bool typeChk, bool widthChk, bool pitchChk, bool spacingChk);

  ///
  /// Create a new technology.
  /// Returns NULL if a database technology already exists
  ///
  static dbTech* create(dbDatabase* db, int dbu_per_micron = 1000);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbTech* getTech(dbDatabase* db, uint oid);

  ///
  /// Destroy a technology.
  /// TODO: Define what happens to the libs and the chip.
  ///
  static void destroy(dbTech* tech);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A TechVia is the element that represents a specific process VIA in
/// a technolgy.
///
///////////////////////////////////////////////////////////////////////////////
class dbTechVia : public dbObject
{
 public:
  ///
  /// Get the via name.
  ///
  std::string getName();

  ///
  /// Get the via name.
  ///
  const char* getConstName();

  ///
  /// Returns true if this via is a default
  ///
  bool isDefault();

  ///
  /// Set the default flag to true.
  ///
  void setDefault();

  ///
  /// Returns true if this via is a top-of-stack
  ///
  bool isTopOfStack();

  ///
  /// Set the top-of-stack flag to true.
  ///
  void setTopOfStack();

  ///
  /// Get the resitance per square nm
  ///
  double getResistance();

  ///
  /// Set the resitance per square nm
  ///
  void setResistance(double res);

  ///
  /// Set the pattern value of this via.
  /// The pattern is ignored if the pattern is already set on this via
  ///
  void setPattern(const char* pattern);

  ///
  /// Get the pattern value of this via.
  /// Returns and empty ("") string if a pattern has not been set.
  ///
  std::string getPattern();

  ///
  /// Set generate rule that was used to genreate this via.
  ///
  void setViaGenerateRule(dbTechViaGenerateRule* rule);

  ///
  /// Get the generate rule that was used to genreate this via.
  ///
  dbTechViaGenerateRule* getViaGenerateRule();

  ///
  /// Returns true if this via has params.
  ///
  bool hasParams();

  ///
  /// Set via params to generate this via. This method will create the shapes
  /// of this via. All previous shapes are destroyed.
  ///
  void setViaParams(const dbViaParams& params);

  ///
  /// Get the via params used to generate this via.
  ///
  void getViaParams(dbViaParams& params_return);

  ///
  /// Get the technology this via belongs too.
  ///
  dbTech* getTech();

  ///
  /// Get the bbox of this via.
  /// Returns NULL if this via has no shapes.
  ///
  dbBox* getBBox();

  ///
  /// Get the boxes of this VIA
  ///
  dbSet<dbBox> getBoxes();

  ///
  /// Get the upper-most layer of this via reaches
  /// Returns NULL if this via has no shapes.
  ///
  dbTechLayer* getTopLayer();

  ///
  /// Get the lower-most layer of this via reaches
  /// Returns NULL if this via has no shapes.
  ///
  dbTechLayer* getBottomLayer();

  ///
  /// Returns the non-default rule this via belongs too.
  /// Returns NULL if this via is not part of a non-default rule.
  ///
  dbTechNonDefaultRule* getNonDefaultRule();

  ///
  /// Create a new via.
  /// Returns NULL if a via with this name already exists.
  ///
  static dbTechVia* create(dbTech* tech, const char* name);

  ///
  /// Create a new non-default-rule via.
  /// Returns NULL if a via with this name already exists.
  ///
  static dbTechVia* create(dbTechNonDefaultRule* rule, const char* name);
  ///
  /// Create a new non-default-rule via by cloning an existing via (not
  /// necessarily from the same non-default rule
  /// Returns NULL if a via with this name already exists.
  ///
  static dbTechVia* clone(dbTechNonDefaultRule* rule,
                          dbTechVia* invia_,
                          const char* new_name);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbTechVia* getTechVia(dbTech* tech, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A TechViaRule is the element that represents a LEF VIARULE
///
///////////////////////////////////////////////////////////////////////////////
class dbTechViaRule : public dbObject
{
 public:
  ///
  /// Get the via-rule name.
  ///
  std::string getName();

  ///
  /// Add this via to this rule
  ///
  void addVia(dbTechVia* via);

  ///
  /// Get the number of vias assigned to this rule
  ///
  uint getViaCount();

  ///
  /// Return the via of this index. The index ranges from [0 ... (viaCount-1)]
  ///
  dbTechVia* getVia(uint indx);

  ///
  /// Get the number of layer-rules assigned to this rule
  ///
  uint getViaLayerRuleCount();

  ///
  /// Return the layer-rule of this index. The index ranges from [0 ...
  /// (viaCount-1)]
  ///
  dbTechViaLayerRule* getViaLayerRule(uint indx);

  ///
  /// Create a new via.
  /// Returns NULL if a via-rule with this name already exists.
  ///
  static dbTechViaRule* create(dbTech* tech, const char* name);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbTechViaRule* getTechViaRule(dbTech* tech, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A TechViaLayerRule is the element that represents a LEF VIARULE LAYER
///
///////////////////////////////////////////////////////////////////////////////
class dbTechViaLayerRule : public dbObject
{
 public:
  ///
  /// Get the layer
  ///
  dbTechLayer* getLayer();

  ///
  /// Get the rule direction
  ///
  dbTechLayerDir getDirection();

  ///
  /// Set the rule direction
  ///
  void setDirection(dbTechLayerDir dir);

  ///
  /// Returns true if width rule is set
  ///
  bool hasWidth();

  ///
  /// Returns the width rule
  ///
  void getWidth(int& minWidth, int& maxWidth);

  ///
  /// Set the width rule
  ///
  void setWidth(int minWidth, int maxWidth);

  ///
  /// Returns true if the enclosure rule is set.
  ///
  bool hasEnclosure();

  ///
  /// Returns the enclosure rule
  ///
  void getEnclosure(int& overhang1, int& overhang2);

  ///
  /// Set the enclosure rule
  ///
  void setEnclosure(int overhang1, int overhang2);

  ///
  /// Returns true if the overhang rule is set.
  ///
  bool hasOverhang();

  ///
  /// Returns the overhang rule
  ///
  int getOverhang();

  ///
  /// Set the overhang rule
  ///
  void setOverhang(int overhang);

  ///
  /// Returns true if the metal-overhang rule is set.
  ///
  bool hasMetalOverhang();

  ///
  /// Returns the overhang rule
  ///
  int getMetalOverhang();

  ///
  /// Set the overhang rule
  ///
  void setMetalOverhang(int overhang);

  ///
  /// returns true if the rect rule is set
  ///
  bool hasRect();

  ///
  /// Get the rect rule
  ///
  void getRect(Rect& r);

  ///
  /// Set the rect rule
  ///
  void setRect(const Rect& r);

  ///
  /// returns true if the spacing rule is set
  ///
  bool hasSpacing();

  ///
  /// Get the spacing rule.
  ///
  void getSpacing(int& x_spacing, int& y_spacing);

  ///
  /// Set the spacing rule.
  ///
  void setSpacing(int x_spacing, int y_spacing);

  ///
  /// Returns true if the resistance rule is set.
  ///
  bool hasResistance();

  ///
  /// Set the resistance
  ///
  void setResistance(double r);

  ///
  /// Get the resistance
  ///
  double getResistance();

  ///
  /// Create a new via-layer_rule.
  ///
  static dbTechViaLayerRule* create(dbTech* tech,
                                    dbTechViaRule* rule,
                                    dbTechLayer* layer);

  ///
  /// Create a new via-layer_rule.
  ///
  static dbTechViaLayerRule* create(dbTech* tech,
                                    dbTechViaGenerateRule* rule,
                                    dbTechLayer* layer);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbTechViaLayerRule* getTechViaLayerRule(dbTech* tech, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A TechViaGenerateRule is the element that represents a LEF VIARULE GENERATE
///
///////////////////////////////////////////////////////////////////////////////
class dbTechViaGenerateRule : public dbObject
{
 public:
  ///
  /// Get the via-rule name.
  ///
  std::string getName();

  ///
  /// Returns true if this is the default rule.
  ///
  bool isDefault();

  ///
  /// Get the number of layer-rules assigned to this rule
  ///
  uint getViaLayerRuleCount();

  ///
  /// Return the layer-rule of this index. The index ranges from [0 ...
  /// (viaCount-1)]
  ///
  dbTechViaLayerRule* getViaLayerRule(uint indx);

  ///
  /// Create a new via.
  /// Returns NULL if a via-rule with this name already exists.
  ///
  static dbTechViaGenerateRule* create(dbTech* tech,
                                       const char* name,
                                       bool is_default);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbTechViaGenerateRule* getTechViaGenerateRule(dbTech* tech, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A TechLayerSpacingRule stores a design rule in LEF V5.4 format.
/// These are bound to layers -- a layer may have several design rules to
/// describe required spacing among different widths and parallel lengths.
///
///////////////////////////////////////////////////////////////////////////////

class dbTechLayerSpacingRule : public dbObject
{
 public:
  /// Combine data and predicates for elements of rule
  bool isUnconditional() const;
  uint getSpacing() const;
  bool getLengthThreshold(uint& threshold) const;
  bool getLengthThresholdRange(uint& rmin, uint& rmax) const;
  bool getRange(uint& rmin, uint& rmax) const;
  void setSpacingNotchLengthValid(bool val);
  void setSpacingEndOfNotchWidthValid(bool val);
  bool hasSpacingNotchLength() const;
  bool hasSpacingEndOfNotchWidth() const;
  bool hasRange() const;
  bool hasLengthThreshold() const;
  bool hasUseLengthThreshold() const;
  bool getInfluence(uint& influence) const;
  bool getInfluenceRange(uint& rmin, uint& rmax) const;
  bool getRangeRange(uint& rmin, uint& rmax) const;
  bool getAdjacentCuts(uint& numcuts,
                       uint& within,
                       uint& spacing,
                       bool& except_same_pgnet) const;
  bool getCutLayer4Spacing(dbTechLayer*& outly) const;
  bool getCutStacking() const;
  bool getCutCenterToCenter() const;
  bool getCutSameNet() const;
  bool getCutParallelOverlap() const;
  uint getCutArea() const;
  void writeLef(lefout& writer) const;

  void setSameNetPgOnly(bool pgonly);
  bool getSameNetPgOnly();
  void setLengthThreshold(uint threshold);
  void setSpacing(uint spacing);
  void setLengthThresholdRange(uint rmin, uint rmax);
  void setRange(uint rmin, uint rmax);
  void setUseLengthThreshold();
  void setInfluence(uint influence);
  void setInfluenceRange(uint rmin, uint rmax);
  void setRangeRange(uint rmin, uint rmax);
  void setAdjacentCuts(uint numcuts,
                       uint within,
                       uint spacing,
                       bool except_same_pgnet);
  void setCutLayer4Spacing(dbTechLayer* cutly);
  void setCutStacking(bool stacking);
  void setCutCenterToCenter(bool c2c);
  void setCutSameNet(bool same_net);
  void setCutParallelOverlap(bool overlap);
  void setCutArea(uint area);
  void setEol(uint width,
              uint within,
              bool parallelEdge,
              uint parallelSpace,
              uint parallelWithin,
              bool twoEdges);
  bool getEol(uint& width,
              uint& within,
              bool& parallelEdge,
              uint& parallelSpace,
              uint& parallelWithin,
              bool& twoEdges) const;

  ///
  /// Create a new layer spacing rule.
  /// Returns pointer to newly created object
  ///
  static dbTechLayerSpacingRule* create(dbTechLayer* inly);
  static dbTechLayerSpacingRule* getTechLayerSpacingRule(dbTechLayer* inly,
                                                         uint dbid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A dbTechMinCutRule stores rules for minimum cuts
/// in LEF V5.5 format.
/// These are bound to layers -- a layer may have several minimum cut rules to
/// describe required cuts at intersections of  different widths and
/// protrusion lengths.
///
///////////////////////////////////////////////////////////////////////////////

class dbTechMinCutRule : public dbObject
{
 public:
  bool getMinimumCuts(uint& numcuts, uint& width) const;
  void setMinimumCuts(uint numcuts,
                      uint width,
                      bool above_only,
                      bool below_only);
  bool getCutDistance(uint& cut_distance) const;
  void setCutDistance(uint cut_distance);
  bool getLengthForCuts(uint& length, uint& distance) const;
  void setLengthForCuts(uint length, uint distance);
  bool isAboveOnly() const;
  bool isBelowOnly() const;
  void writeLef(lefout& writer) const;
  static dbTechMinCutRule* create(dbTechLayer* inly);
  static dbTechMinCutRule* getMinCutRule(dbTechLayer* inly, uint dbid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A dbTechMinEncRule stores rules for minimum enclosure area
/// in LEF V5.5 format.
/// These are bound to layers -- a layer may have several minimum enclosure
/// rules to describe connections to wires of different widths
///
///////////////////////////////////////////////////////////////////////////////

class dbTechMinEncRule : public dbObject
{
 public:
  bool getEnclosure(uint& area) const;
  void setEnclosure(uint area);
  bool getEnclosureWidth(uint& width) const;
  void setEnclosureWidth(uint width);
  void writeLef(lefout& writer) const;

  static dbTechMinEncRule* create(dbTechLayer* inly);
  static dbTechMinEncRule* getMinEncRule(dbTechLayer* inly, uint dbid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A dbTechV55InfluenceEntry stores an entry in the table for V5.5 format
/// influence spacing rules.
/// Influence spacing in V5.5 describes the required spacing (_spacing) for
/// any wire within a distance (_within) a wire of width (_width).
/// These are bound to layers.
///
///////////////////////////////////////////////////////////////////////////////

class dbTechV55InfluenceEntry : public dbObject
{
 public:
  bool getV55InfluenceEntry(uint& width, uint& within, uint& spacing) const;
  void setV55InfluenceEntry(const uint& width,
                            const uint& within,
                            const uint& spacing);
  void writeLef(lefout& writer) const;

  static dbTechV55InfluenceEntry* create(dbTechLayer* inly);
  static dbTechV55InfluenceEntry* getV55InfluenceEntry(dbTechLayer* inly,
                                                       uint dbid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A dbTechLayerAntennaRule expresses a single antenna rule for a given layer.
///
///////////////////////////////////////////////////////////////////////////////

class dbTechLayerAntennaRule : public dbObject
{
 public:
  bool isValid() const;
  void writeLef(lefout& writer) const;

  void setGatePlusDiffFactor(double factor);
  void setAreaMinusDiffFactor(double factor);

  void setAreaFactor(double factor, bool diffuse = false);
  void setSideAreaFactor(double factor, bool diffuse = false);

  bool hasAreaFactor() const;
  bool hasSideAreaFactor() const;

  double getAreaFactor() const;
  double getSideAreaFactor() const;

  bool isAreaFactorDiffUseOnly() const;
  bool isSideAreaFactorDiffUseOnly() const;

  bool hasAntennaCumRoutingPlusCut() const;
  void setAntennaCumRoutingPlusCut(bool value = true);

  // If return value is 0 then the value is unset
  double getPAR() const;
  double getCAR() const;
  double getPSR() const;
  double getCSR() const;
  double getGatePlusDiffFactor() const;
  double getAreaMinusDiffFactor() const;

  void setPAR(double ratio);
  void setCAR(double ratio);
  void setPSR(double ratio);
  void setCSR(double ratio);

  // if indices.size()==0 then these are unset
  // if indices.size()==1 then this is a single value rather than a PWL
  struct pwl_pair
  {
    const std::vector<double>& indices;
    const std::vector<double>& ratios;
  };

  pwl_pair getDiffPAR() const;
  pwl_pair getDiffCAR() const;
  pwl_pair getDiffPSR() const;
  pwl_pair getDiffCSR() const;
  pwl_pair getAreaDiffReduce() const;

  // PWL
  void setDiffPAR(const std::vector<double>& diff_idx,
                  const std::vector<double>& ratios);
  void setDiffCAR(const std::vector<double>& diff_idx,
                  const std::vector<double>& ratios);
  void setDiffPSR(const std::vector<double>& diff_idx,
                  const std::vector<double>& ratios);
  void setDiffCSR(const std::vector<double>& diff_idx,
                  const std::vector<double>& ratios);

  // Single value
  void setDiffPAR(double ratio);
  void setDiffCAR(double ratio);
  void setDiffPSR(double ratio);
  void setDiffCSR(double ratio);

  void setAreaDiffReduce(const std::vector<double>& areas,
                         const std::vector<double>& factors);

  static dbTechLayerAntennaRule* getAntennaRule(dbTech* inly, uint dbid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A dbTechAntennaPinModel contains model specific antenna info for a pin
///
///////////////////////////////////////////////////////////////////////////////

class dbTechAntennaPinModel : public dbObject
{
 public:
  void addGateAreaEntry(double inval, dbTechLayer* refly = NULL);
  void addMaxAreaCAREntry(double inval, dbTechLayer* refly = NULL);
  void addMaxSideAreaCAREntry(double inval, dbTechLayer* refly = NULL);
  void addMaxCutCAREntry(double inval, dbTechLayer* refly = NULL);

  void getGateArea(std::vector<std::pair<double, dbTechLayer*>>& data);
  void getMaxAreaCAR(std::vector<std::pair<double, dbTechLayer*>>& data);
  void getMaxSideAreaCAR(std::vector<std::pair<double, dbTechLayer*>>& data);
  void getMaxCutCAR(std::vector<std::pair<double, dbTechLayer*>>& data);

  void writeLef(dbTech* tech, lefout& writer) const;

  static dbTechAntennaPinModel* getAntennaPinModel(dbMaster* master, uint dbid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A NonDefaultRule is the element that represents a Non-default technology
/// rule.
///
///////////////////////////////////////////////////////////////////////////////
class dbTechNonDefaultRule : public dbObject
{
 public:
  ///
  /// Get the rule name.
  ///
  std::string getName();

  ///
  /// Get the rule name.
  ///
  const char* getConstName();

  ///
  /// Returns true if this rule is a block rule
  ///
  bool isBlockRule();

  ///
  /// Find a specific layer-rule.
  /// Returns NULL if there is no layer-rule.
  ///
  dbTechLayerRule* getLayerRule(dbTechLayer* layer);

  ///
  /// Get the vias of this non-default rule.
  ///
  void getLayerRules(std::vector<dbTechLayerRule*>& layer_rules);

  ///
  /// Get the vias of this non-default rule.
  ///
  void getVias(std::vector<dbTechVia*>& vias);

  ///
  /// Find a specific rule
  /// Returns NULL if no rule exists.
  ///
  dbTechSameNetRule* findSameNetRule(dbTechLayer* l1, dbTechLayer* l2);

  ///
  /// Get the same-net rules of this non-default rule.
  ///
  void getSameNetRules(std::vector<dbTechSameNetRule*>& rules);

  /////////////////////////
  // 5.6 DEF additions
  /////////////////////////

  ///
  /// Set the hard spacing rule.
  ///
  bool getHardSpacing();

  ///
  /// Get the hard spacing rule.
  ///
  void setHardSpacing(bool value);

  ///
  ///  Add a use via.
  ///
  void addUseVia(dbTechVia* via);

  ///
  ///  Get vias to use.
  ///
  void getUseVias(std::vector<dbTechVia*>& vias);

  ///
  ///  Add a use via.
  ///
  void addUseViaRule(dbTechViaGenerateRule* rule);

  ///
  ///  Get vias to use.
  ///
  void getUseViaRules(std::vector<dbTechViaGenerateRule*>& rules);

  ///
  /// Assign a minimum number of cuts to this cut-layer
  ///
  void setMinCuts(dbTechLayer* cut_layer, int count);

  ///
  /// Get the minimum number of cuts for this cut-layer.
  ///
  /// Returns false if a value has not been specified.
  ///
  bool getMinCuts(dbTechLayer* cut_layer, int& count);

  ///
  /// Create a new non-default-rule.
  /// Returns NULL if a non-default-rule with this name already exists
  ///
  static dbTechNonDefaultRule* create(dbTech* tech, const char* name);

  ///
  /// Create a new non-default-rule.
  /// Returns NULL if a non-default-rule with this name already exists
  ///
  static dbTechNonDefaultRule* create(dbBlock* block, const char* name);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbTechNonDefaultRule* getTechNonDefaultRule(dbTech* tech, uint oid);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbTechNonDefaultRule* getTechNonDefaultRule(dbBlock* block, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A TechLayerRule is the element that represents a non-default layer
/// rule.
///
///////////////////////////////////////////////////////////////////////////////
class dbTechLayerRule : public dbObject
{
 public:
  ///
  /// Get the layer this rule represents
  ///
  dbTechLayer* getLayer();

  ///
  /// Returns true if this rule is a block rule
  ///
  bool isBlockRule();

  ///
  /// Get the non-default-rule this layer-rule belongs too.
  ///
  dbTechNonDefaultRule* getNonDefaultRule();

  ///
  /// Get the minimum path-width.
  ///
  int getWidth();

  ///
  /// Set the minimum path-width.
  ///
  void setWidth(int width);

  ///
  /// Get the minimum object-to-object spacing.
  ///
  int getSpacing();

  ///
  /// Set the minimum object-to-object spacing.
  ///
  void setSpacing(int spacing);

  ///
  /// Get the resitance per square nm
  ///
  double getResistance();

  ///
  /// Set the resitance per square nm
  ///
  void setResistance(double res);

  ///
  /// Get the capacitance per square nm
  ///
  double getCapacitance();

  ///
  /// Set the capacitance per square nm
  ///
  void setCapacitance(double cap);

  ///
  /// Get the edge capacitance
  ///
  double getEdgeCapacitance();

  ///
  /// Set the edge capacitance
  ///
  void setEdgeCapacitance(double cap);

  ///
  /// Get the edge capacitance
  ///
  uint getWireExtension();

  ///
  /// Set the edge capacitance
  ///
  void setWireExtension(uint ext);

  ///
  /// Create a new layer-rule.
  /// Returns NULL if a layer-rule for this layer already exists.
  ///
  static dbTechLayerRule* create(dbTechNonDefaultRule* rule,
                                 dbTechLayer* layer);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbTechLayerRule* getTechLayerRule(dbTech* tech, uint oid);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbTechLayerRule* getTechLayerRule(dbBlock* block, uint oid);
};

///////////////////////////////////////////////////////////////////////////////
///
/// A TechSameNetRule
///
///////////////////////////////////////////////////////////////////////////////
class dbTechSameNetRule : public dbObject
{
 public:
  ///
  /// Get the layer this rule represents
  ///
  dbTechLayer* getLayer1();

  ///
  /// Get the layer this rule represents
  ///
  dbTechLayer* getLayer2();

  ///
  /// Get the minimum net-to-net spacing.
  ///
  int getSpacing();

  ///
  /// Set the minimum net-to-net spacing.
  ///
  void setSpacing(int spacing);

  ///
  /// Set the flag to allow stacked vias, the default value is false.
  ///
  void setAllowStackedVias(bool value);

  ///
  /// Get the allow stacked vias flag.
  ///
  bool getAllowStackedVias();

  ///
  /// Create a new default samenet rule.
  /// Returns NULL if a rule already exists between these layers.
  ///
  static dbTechSameNetRule* create(dbTechLayer* layer1, dbTechLayer* layer2);
  ///
  /// Create a new non-default samenet rule.
  /// Returns NULL if a rule already exists between these layers.
  ///
  static dbTechSameNetRule* create(dbTechNonDefaultRule* rule,
                                   dbTechLayer* layer1,
                                   dbTechLayer* layer2);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbTechSameNetRule* getTechSameNetRule(dbTech* tech, uint oid);
};

class dbViaParams : private _dbViaParams
// class dbViaParams : public _dbViaParams
{
  friend class dbVia;
  friend class dbTechVia;
  dbTech* _tech;

  dbViaParams(const _dbViaParams& p);

 public:
  dbViaParams();
  dbViaParams(const dbViaParams& p);
  ~dbViaParams();

  int getXCutSize() const;
  int getYCutSize() const;
  int getXCutSpacing() const;
  int getYCutSpacing() const;
  int getXTopEnclosure() const;
  int getYTopEnclosure() const;
  int getXBottomEnclosure() const;
  int getYBottomEnclosure() const;
  int getNumCutRows() const;
  int getNumCutCols() const;
  int getXOrigin() const;
  int getYOrigin() const;
  int getXTopOffset() const;
  int getYTopOffset() const;
  int getXBottomOffset() const;
  int getYBottomOffset() const;
  dbTechLayer* getTopLayer() const;
  dbTechLayer* getCutLayer() const;
  dbTechLayer* getBottomLayer() const;

  void setXCutSize(int value);
  void setYCutSize(int value);
  void setXCutSpacing(int value);
  void setYCutSpacing(int value);
  void setXTopEnclosure(int value);
  void setYTopEnclosure(int value);
  void setXBottomEnclosure(int value);
  void setYBottomEnclosure(int value);
  void setNumCutRows(int value);
  void setNumCutCols(int value);
  void setXOrigin(int value);
  void setYOrigin(int value);
  void setXTopOffset(int value);
  void setYTopOffset(int value);
  void setXBottomOffset(int value);
  void setYBottomOffset(int value);
  void setTopLayer(dbTechLayer* layer);
  void setCutLayer(dbTechLayer* layer);
  void setBottomLayer(dbTechLayer* layer);
};

// Generator Code Begin ClassDefinition

class dbTechLayer : public dbObject
{
 public:
  enum LEF58_TYPE
  {
    NONE,
    NWELL,
    PWELL,
    ABOVEDIEEDGE,
    BELOWDIEEDGE,
    DIFFUSION,
    TRIMPOLY,
    MIMCAP
  };
  // User Code Begin dbTechLayerEnums
  // User Code End dbTechLayerEnums

  dbSet<dbTechLayerCutClassRule> getTechLayerCutClassRules() const;

  dbTechLayerCutClassRule* findTechLayerCutClassRule(const char* name) const;

  dbSet<dbTechLayerSpacingEolRule> getTechLayerSpacingEolRules() const;

  dbSet<dbTechLayerCutSpacingRule> getTechLayerCutSpacingRules() const;

  dbSet<dbTechLayerMinStepRule> getTechLayerMinStepRules() const;

  dbSet<dbTechLayerCornerSpacingRule> getTechLayerCornerSpacingRules() const;

  dbSet<dbTechLayerSpacingTablePrlRule> getTechLayerSpacingTablePrlRules()
      const;

  dbSet<dbTechLayerCutSpacingTableOrthRule>
  getTechLayerCutSpacingTableOrthRules() const;

  dbSet<dbTechLayerCutSpacingTableDefRule> getTechLayerCutSpacingTableDefRules()
      const;

  dbSet<dbTechLayerCutEnclosureRule> getTechLayerCutEnclosureRules() const;

  dbSet<dbTechLayerEolExtensionRule> getTechLayerEolExtensionRules() const;

  dbSet<dbTechLayerEolKeepOutRule> getTechLayerEolKeepOutRules() const;

  void setRectOnly(bool rect_only);

  bool isRectOnly() const;

  void setRightWayOnGridOnly(bool right_way_on_grid_only);

  bool isRightWayOnGridOnly() const;

  void setRightWayOnGridOnlyCheckMask(bool right_way_on_grid_only_check_mask);

  bool isRightWayOnGridOnlyCheckMask() const;

  void setRectOnlyExceptNonCorePins(bool rect_only_except_non_core_pins);

  bool isRectOnlyExceptNonCorePins() const;

  // User Code Begin dbTechLayer
  int findV55Spacing(const int width, const int prl) const;

  int findTwSpacing(const int width1, const int width2, const int prl) const;

  void setLef58Type(LEF58_TYPE type);

  LEF58_TYPE getLef58Type() const;

  ///
  /// Get the layer name.
  ///
  std::string getName() const;

  ///
  /// Get the layer name.
  ///
  const char* getConstName() const;

  ///
  /// Returns true if this layer has an alias.
  ///
  bool hasAlias();

  ///
  /// Get the layer alias.
  ///
  std::string getAlias();

  ///
  /// Set the layer alias.
  ///
  void setAlias(const char* alias);

  ///
  /// Get the minimum path-width.
  ///
  uint getWidth() const;
  void setWidth(int width);

  ///
  /// Get the minimum object-to-object spacing.
  ///
  int getSpacing();
  void setSpacing(int spacing);

  ///
  /// Get the minimum spacing to a wide line.
  ///
  int getSpacing(int width, int length = 0);

  ///
  /// The number of masks for this layer (aka double/triple patterning).
  /// Allowable values are in [1, 3].
  ///
  uint getNumMasks() const;
  void setNumMasks(uint number);

  ///
  /// Get the low end of the uppermost range for wide wire design rules.
  ///
  void getMaxWideDRCRange(int& owidth, int& olength);
  void getMinWideDRCRange(int& owidth, int& olength);

  /// Get the collection of spacing rules for the object, assuming
  /// coding in LEF 5.4 format.
  /// Return false if rules not encoded in this format.
  /// Contents of sp_rules are undefined if function returns false.
  ///
  bool getV54SpacingRules(dbSet<dbTechLayerSpacingRule>& sp_rules) const;

  ///
  /// API for version 5.5 spacing rules, expressed as a 2D matrix with
  /// index tables  LEF 5.4 and 5.5 rules should not co-exist -- although
  /// this is not enforced here.
  /// V5.4 and V5.5 spacing rules are optional -- in this case there is a
  /// single spacing value for all length/width combinations.
  ///
  bool hasV55SpacingRules() const;
  bool getV55SpacingWidthsAndLengths(std::vector<uint>& width_idx,
                                     std::vector<uint>& length_idx) const;
  void printV55SpacingRules(lefout& writer) const;
  bool getV55SpacingTable(std::vector<std::vector<uint>>& sptbl) const;

  void initV55LengthIndex(uint numelems);
  void addV55LengthEntry(uint length);
  void initV55WidthIndex(uint numelems);
  void addV55WidthEntry(uint width);
  void initV55SpacingTable(uint numrows, uint numcols);
  void addV55SpacingTableEntry(uint inrow, uint incol, uint spacing);

  bool getV55InfluenceRules(std::vector<dbTechV55InfluenceEntry*>& inf_tbl);
  dbSet<dbTechV55InfluenceEntry> getV55InfluenceEntries();

  ///
  /// API for version 5.7 two widths spacing rules, expressed as a 2D matrix
  /// with index tables
  ///
  bool hasTwoWidthsSpacingRules() const;
  void printTwoWidthsSpacingRules(lefout& writer) const;
  bool getTwoWidthsSpacingTable(std::vector<std::vector<uint>>& sptbl) const;
  uint getTwoWidthsSpacingTableNumWidths() const;
  uint getTwoWidthsSpacingTableWidth(uint row) const;
  bool getTwoWidthsSpacingTableHasPRL(uint row) const;
  uint getTwoWidthsSpacingTablePRL(uint row) const;
  uint getTwoWidthsSpacingTableEntry(uint row, uint col) const;

  void initTwoWidths(uint num_widths);
  void addTwoWidthsIndexEntry(uint width, int parallel_run_length = -1);
  void addTwoWidthsSpacingTableEntry(uint inrow, uint incol, uint spacing);
  ///
  ///  create container for layer specific antenna rules
  ///  currently only oxide1 (default) and oxide2 models supported.
  ///
  dbTechLayerAntennaRule* createDefaultAntennaRule();
  dbTechLayerAntennaRule* createOxide2AntennaRule();

  ///
  /// Access and write antenna rule models -- get functions will return NULL
  /// if model not created.
  ///
  bool hasDefaultAntennaRule() const;
  bool hasOxide2AntennaRule() const;
  dbTechLayerAntennaRule* getDefaultAntennaRule() const;
  dbTechLayerAntennaRule* getOxide2AntennaRule() const;
  void writeAntennaRulesLef(lefout& writer) const;

  ///
  ///
  /// Get collection of minimum cuts, minimum enclosure rules, if exist
  ///
  bool getMinimumCutRules(std::vector<dbTechMinCutRule*>& cut_rules);
  bool getMinEnclosureRules(std::vector<dbTechMinEncRule*>& enc_rules);

  dbSet<dbTechMinCutRule> getMinCutRules();
  dbSet<dbTechMinEncRule> getMinEncRules();

  ///
  /// Get/Set the minimum feature size (pitch).
  ///
  int getPitch();
  int getPitchX();
  int getPitchY();
  void setPitch(int pitch);
  void setPitchXY(int pitch_x, int pitch_y);
  bool hasXYPitch();

  int getOffset();
  int getOffsetX();
  int getOffsetY();
  void setOffset(int pitch);
  void setOffsetXY(int pitch_x, int pitch_y);
  bool hasXYOffset();

  ///
  ///  Get THICKNESS in DB units, and return indicator of existence.
  ///  Do not trust value of output parm if return value is false.
  ///
  bool getThickness(uint& inthk) const;
  void setThickness(uint thickness);

  ///
  ///  Get/set AREA parameter.  This interface is used when a
  ///  reasonable default exists.
  ///
  bool hasArea() const;
  double getArea() const;
  void setArea(double area);

  ///
  ///  Get/set MAXWIDTH parameter.  This interface is used when a
  ///  reasonable default exists.
  ///
  bool hasMaxWidth() const;
  uint getMaxWidth() const;
  void setMaxWidth(uint max_width);

  ///
  ///  Get/set min width parameter.
  ///
  uint getMinWidth() const;
  void setMinWidth(uint max_width);

  ///
  ///  Get/set MINSTEP parameter.  This interface is used when a
  ///  reasonable default exists.
  ///
  bool hasMinStep() const;
  uint getMinStep() const;
  void setMinStep(uint min_step);

  dbTechLayerMinStepType getMinStepType() const;
  void setMinStepType(dbTechLayerMinStepType type);

  bool hasMinStepMaxLength() const;
  uint getMinStepMaxLength() const;
  void setMinStepMaxLength(uint length);

  bool hasMinStepMaxEdges() const;
  uint getMinStepMaxEdges() const;
  void setMinStepMaxEdges(uint edges);

  ///
  ///  Get/set PROTRUSIONWIDTH parameter.  This interface is used when a
  ///  reasonable default exists.
  ///
  bool hasProtrusion() const;
  uint getProtrusionWidth() const;
  uint getProtrusionLength() const;
  uint getProtrusionFromWidth() const;
  void setProtrusion(uint pt_width, uint pt_length, uint pt_from_width);

  /// Get the layer-type
  ///
  dbTechLayerType getType();

  ///
  /// Get/Set the layer-direction
  ///
  dbTechLayerDir getDirection();
  void setDirection(dbTechLayerDir direction);

  ///
  /// Get/Set the resistance (ohms per square for routing layers;
  ///                         ohms per cut on via layers)
  ///
  double getResistance();
  void setResistance(double res);

  ///
  /// Get/Set the capacitance (pF per square micron)
  ///
  double getCapacitance();
  void setCapacitance(double cap);

  ///
  /// Get/Set the edge capacitance (pF per micron)
  ///
  double getEdgeCapacitance();
  void setEdgeCapacitance(double cap);

  ///
  /// Get/Set the wire extension
  ///
  uint getWireExtension();
  void setWireExtension(uint ext);

  ///
  /// Get mask-order number of this layer.
  ///
  int getNumber() const;

  ///
  /// Get routing-level of this routing layer. The routing level
  /// is from [1-num_layers]. This function returns 0, if this
  /// layer is not a routing layer.
  ///
  int getRoutingLevel();

  ///
  /// Get the layer below this layer.
  /// Returns NULL if at bottom of layer stack.
  ///
  dbTechLayer* getLowerLayer();

  ///
  /// Get the layer above this layer.
  /// Returns NULL if at top of layer stack.
  ///
  dbTechLayer* getUpperLayer();

  ///
  /// Get the technology this layer belongs too.
  ///
  dbTech* getTech();

  ///
  /// Create a new layer. The mask order is implicit in the create order.
  /// Returns NULL if a layer with this name already exists
  ///
  static dbTechLayer* create(dbTech* tech,
                             const char* name,
                             dbTechLayerType type);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbTechLayer* getTechLayer(dbTech* tech, uint oid);
  // User Code End dbTechLayer
};

class dbTechLayerSpacingEolRule : public dbObject
{
 public:
  // User Code Begin dbTechLayerSpacingEolRuleEnums
  // User Code End dbTechLayerSpacingEolRuleEnums

  void setEolSpace(int eol_space);

  int getEolSpace() const;

  void setEolWidth(int eol_width);

  int getEolWidth() const;

  void setWrongDirSpace(int wrong_dir_space);

  int getWrongDirSpace() const;

  void setOppositeWidth(int opposite_width);

  int getOppositeWidth() const;

  void setEolWithin(int eol_within);

  int getEolWithin() const;

  void setWrongDirWithin(int wrong_dir_within);

  int getWrongDirWithin() const;

  void setExactWidth(int exact_width);

  int getExactWidth() const;

  void setOtherWidth(int other_width);

  int getOtherWidth() const;

  void setFillTriangle(int fill_triangle);

  int getFillTriangle() const;

  void setCutClass(int cut_class);

  int getCutClass() const;

  void setWithCutSpace(int with_cut_space);

  int getWithCutSpace() const;

  void setEnclosureEndWidth(int enclosure_end_width);

  int getEnclosureEndWidth() const;

  void setEnclosureEndWithin(int enclosure_end_within);

  int getEnclosureEndWithin() const;

  void setEndPrlSpace(int end_prl_space);

  int getEndPrlSpace() const;

  void setEndPrl(int end_prl);

  int getEndPrl() const;

  void setEndToEndSpace(int end_to_end_space);

  int getEndToEndSpace() const;

  void setOneCutSpace(int one_cut_space);

  int getOneCutSpace() const;

  void setTwoCutSpace(int two_cut_space);

  int getTwoCutSpace() const;

  void setExtension(int extension);

  int getExtension() const;

  void setWrongDirExtension(int wrong_dir_extension);

  int getWrongDirExtension() const;

  void setOtherEndWidth(int other_end_width);

  int getOtherEndWidth() const;

  void setMaxLength(int max_length);

  int getMaxLength() const;

  void setMinLength(int min_length);

  int getMinLength() const;

  void setParSpace(int par_space);

  int getParSpace() const;

  void setParWithin(int par_within);

  int getParWithin() const;

  void setParPrl(int par_prl);

  int getParPrl() const;

  void setParMinLength(int par_min_length);

  int getParMinLength() const;

  void setEncloseDist(int enclose_dist);

  int getEncloseDist() const;

  void setCutToMetalSpace(int cut_to_metal_space);

  int getCutToMetalSpace() const;

  void setMinAdjLength(int min_adj_length);

  int getMinAdjLength() const;

  void setMinAdjLength1(int min_adj_length1);

  int getMinAdjLength1() const;

  void setMinAdjLength2(int min_adj_length2);

  int getMinAdjLength2() const;

  void setNotchLength(int notch_length);

  int getNotchLength() const;

  void setExactWidthValid(bool exact_width_valid);

  bool isExactWidthValid() const;

  void setWrongDirSpacingValid(bool wrong_dir_spacing_valid);

  bool isWrongDirSpacingValid() const;

  void setOppositeWidthValid(bool opposite_width_valid);

  bool isOppositeWidthValid() const;

  void setWithinValid(bool within_valid);

  bool isWithinValid() const;

  void setWrongDirWithinValid(bool wrong_dir_within_valid);

  bool isWrongDirWithinValid() const;

  void setSameMaskValid(bool same_mask_valid);

  bool isSameMaskValid() const;

  void setExceptExactWidthValid(bool except_exact_width_valid);

  bool isExceptExactWidthValid() const;

  void setFillConcaveCornerValid(bool fill_concave_corner_valid);

  bool isFillConcaveCornerValid() const;

  void setWithcutValid(bool withcut_valid);

  bool isWithcutValid() const;

  void setCutClassValid(bool cut_class_valid);

  bool isCutClassValid() const;

  void setWithCutAboveValid(bool with_cut_above_valid);

  bool isWithCutAboveValid() const;

  void setEnclosureEndValid(bool enclosure_end_valid);

  bool isEnclosureEndValid() const;

  void setEnclosureEndWithinValid(bool enclosure_end_within_valid);

  bool isEnclosureEndWithinValid() const;

  void setEndPrlSpacingValid(bool end_prl_spacing_valid);

  bool isEndPrlSpacingValid() const;

  void setPrlValid(bool prl_valid);

  bool isPrlValid() const;

  void setEndToEndValid(bool end_to_end_valid);

  bool isEndToEndValid() const;

  void setCutSpacesValid(bool cut_spaces_valid);

  bool isCutSpacesValid() const;

  void setExtensionValid(bool extension_valid);

  bool isExtensionValid() const;

  void setWrongDirExtensionValid(bool wrong_dir_extension_valid);

  bool isWrongDirExtensionValid() const;

  void setOtherEndWidthValid(bool other_end_width_valid);

  bool isOtherEndWidthValid() const;

  void setMaxLengthValid(bool max_length_valid);

  bool isMaxLengthValid() const;

  void setMinLengthValid(bool min_length_valid);

  bool isMinLengthValid() const;

  void setTwoSidesValid(bool two_sides_valid);

  bool isTwoSidesValid() const;

  void setEqualRectWidthValid(bool equal_rect_width_valid);

  bool isEqualRectWidthValid() const;

  void setParallelEdgeValid(bool parallel_edge_valid);

  bool isParallelEdgeValid() const;

  void setSubtractEolWidthValid(bool subtract_eol_width_valid);

  bool isSubtractEolWidthValid() const;

  void setParPrlValid(bool par_prl_valid);

  bool isParPrlValid() const;

  void setParMinLengthValid(bool par_min_length_valid);

  bool isParMinLengthValid() const;

  void setTwoEdgesValid(bool two_edges_valid);

  bool isTwoEdgesValid() const;

  void setSameMetalValid(bool same_metal_valid);

  bool isSameMetalValid() const;

  void setNonEolCornerOnlyValid(bool non_eol_corner_only_valid);

  bool isNonEolCornerOnlyValid() const;

  void setParallelSameMaskValid(bool parallel_same_mask_valid);

  bool isParallelSameMaskValid() const;

  void setEncloseCutValid(bool enclose_cut_valid);

  bool isEncloseCutValid() const;

  void setBelowValid(bool below_valid);

  bool isBelowValid() const;

  void setAboveValid(bool above_valid);

  bool isAboveValid() const;

  void setCutSpacingValid(bool cut_spacing_valid);

  bool isCutSpacingValid() const;

  void setAllCutsValid(bool all_cuts_valid);

  bool isAllCutsValid() const;

  void setToConcaveCornerValid(bool to_concave_corner_valid);

  bool isToConcaveCornerValid() const;

  void setMinAdjacentLengthValid(bool min_adjacent_length_valid);

  bool isMinAdjacentLengthValid() const;

  void setTwoMinAdjLengthValid(bool two_min_adj_length_valid);

  bool isTwoMinAdjLengthValid() const;

  void setToNotchLengthValid(bool to_notch_length_valid);

  bool isToNotchLengthValid() const;

  // User Code Begin dbTechLayerSpacingEolRule
  static dbTechLayerSpacingEolRule* create(dbTechLayer* layer);

  static dbTechLayerSpacingEolRule* getTechLayerSpacingEolRule(
      dbTechLayer* inly,
      uint dbid);

  static void destroy(dbTechLayerSpacingEolRule* rule);
  // User Code End dbTechLayerSpacingEolRule
};

class dbTechLayerMinStepRule : public dbObject
{
 public:
  // User Code Begin dbTechLayerMinStepRuleEnums
  // User Code End dbTechLayerMinStepRuleEnums

  void setMinStepLength(int min_step_length);

  int getMinStepLength() const;

  void setMaxEdges(uint max_edges);

  uint getMaxEdges() const;

  void setMinAdjLength1(int min_adj_length1);

  int getMinAdjLength1() const;

  void setMinAdjLength2(int min_adj_length2);

  int getMinAdjLength2() const;

  void setEolWidth(int eol_width);

  int getEolWidth() const;

  void setMinBetweenLength(int min_between_length);

  int getMinBetweenLength() const;

  void setMaxEdgesValid(bool max_edges_valid);

  bool isMaxEdgesValid() const;

  void setMinAdjLength1Valid(bool min_adj_length1_valid);

  bool isMinAdjLength1Valid() const;

  void setNoBetweenEol(bool no_between_eol);

  bool isNoBetweenEol() const;

  void setMinAdjLength2Valid(bool min_adj_length2_valid);

  bool isMinAdjLength2Valid() const;

  void setConvexCorner(bool convex_corner);

  bool isConvexCorner() const;

  void setMinBetweenLengthValid(bool min_between_length_valid);

  bool isMinBetweenLengthValid() const;

  void setExceptSameCorners(bool except_same_corners);

  bool isExceptSameCorners() const;

  // User Code Begin dbTechLayerMinStepRule
  static dbTechLayerMinStepRule* create(dbTechLayer* layer);

  static dbTechLayerMinStepRule* getTechLayerMinStepRule(dbTechLayer* inly,
                                                         uint dbid);

  static void destroy(dbTechLayerMinStepRule* rule);
  // User Code End dbTechLayerMinStepRule
};

class dbTechLayerCornerSpacingRule : public dbObject
{
 public:
  enum CornerType
  {
    CONVEXCORNER,
    CONCAVECORNER
  };
  // User Code Begin dbTechLayerCornerSpacingRuleEnums
  // User Code End dbTechLayerCornerSpacingRuleEnums

  void setWithin(int within);

  int getWithin() const;

  void setEolWidth(int eol_width);

  int getEolWidth() const;

  void setJogLength(int jog_length);

  int getJogLength() const;

  void setEdgeLength(int edge_length);

  int getEdgeLength() const;

  void setMinLength(int min_length);

  int getMinLength() const;

  void setExceptNotchLength(int except_notch_length);

  int getExceptNotchLength() const;

  void setSameMask(bool same_mask);

  bool isSameMask() const;

  void setCornerOnly(bool corner_only);

  bool isCornerOnly() const;

  void setExceptEol(bool except_eol);

  bool isExceptEol() const;

  void setExceptJogLength(bool except_jog_length);

  bool isExceptJogLength() const;

  void setEdgeLengthValid(bool edge_length_valid);

  bool isEdgeLengthValid() const;

  void setIncludeShape(bool include_shape);

  bool isIncludeShape() const;

  void setMinLengthValid(bool min_length_valid);

  bool isMinLengthValid() const;

  void setExceptNotch(bool except_notch);

  bool isExceptNotch() const;

  void setExceptNotchLengthValid(bool except_notch_length_valid);

  bool isExceptNotchLengthValid() const;

  void setExceptSameNet(bool except_same_net);

  bool isExceptSameNet() const;

  void setExceptSameMetal(bool except_same_metal);

  bool isExceptSameMetal() const;

  // User Code Begin dbTechLayerCornerSpacingRule
  void setType(CornerType _type);

  CornerType getType() const;

  void addSpacing(uint width, uint spacing1, uint spacing2 = 0);

  void getSpacingTable(std::vector<std::pair<int, int>>& tbl);

  void getWidthTable(std::vector<int>& tbl);

  static dbTechLayerCornerSpacingRule* create(dbTechLayer* layer);

  static dbTechLayerCornerSpacingRule* getTechLayerCornerSpacingRule(
      dbTechLayer* inly,
      uint dbid);
  static void destroy(dbTechLayerCornerSpacingRule* rule);
  // User Code End dbTechLayerCornerSpacingRule
};

class dbTechLayerSpacingTablePrlRule : public dbObject
{
 public:
  // User Code Begin dbTechLayerSpacingTablePrlRuleEnums
  // User Code End dbTechLayerSpacingTablePrlRuleEnums

  void setEolWidth(int eol_width);

  int getEolWidth() const;

  void setWrongDirection(bool wrong_direction);

  bool isWrongDirection() const;

  void setSameMask(bool same_mask);

  bool isSameMask() const;

  void setExceeptEol(bool exceept_eol);

  bool isExceeptEol() const;

  // User Code Begin dbTechLayerSpacingTablePrlRule
  static dbTechLayerSpacingTablePrlRule* getTechLayerSpacingTablePrlRule(
      dbTechLayer* inly,
      uint dbid);

  static dbTechLayerSpacingTablePrlRule* create(dbTechLayer* _layer);

  static void destroy(dbTechLayerSpacingTablePrlRule* rule);

  void setTable(std::vector<int> width_tbl,
                std::vector<int> length_tbl,
                std::vector<std::vector<int>> spacing_tbl,
                std::map<uint, std::pair<int, int>> excluded_map);
  void getTable(std::vector<int>& width_tbl,
                std::vector<int>& length_tbl,
                std::vector<std::vector<int>>& spacing_tbl,
                std::map<uint, std::pair<int, int>>& excluded_map);

  void setSpacingTableInfluence(
      std::vector<std::tuple<int, int, int>> influence_tbl);

  int getSpacing(const int width, const int length) const;

  bool hasExceptWithin(int width) const;

  std::pair<int, int> getExceptWithin(int width) const;

  // User Code End dbTechLayerSpacingTablePrlRule
};

class dbTechLayerEolKeepOutRule : public dbObject
{
 public:
  // User Code Begin dbTechLayerEolKeepOutRuleEnums
  // User Code End dbTechLayerEolKeepOutRuleEnums

  void setEolWidth(int eol_width);

  int getEolWidth() const;

  void setBackwardExt(int backward_ext);

  int getBackwardExt() const;

  void setForwardExt(int forward_ext);

  int getForwardExt() const;

  void setSideExt(int side_ext);

  int getSideExt() const;

  void setWithinLow(int within_low);

  int getWithinLow() const;

  void setWithinHigh(int within_high);

  int getWithinHigh() const;

  void setClassName(std::string class_name);

  std::string getClassName() const;

  void setClassValid(bool class_valid);

  bool isClassValid() const;

  void setCornerOnly(bool corner_only);

  bool isCornerOnly() const;

  void setExceptWithin(bool except_within);

  bool isExceptWithin() const;

  // User Code Begin dbTechLayerEolKeepOutRule
  static dbTechLayerEolKeepOutRule* create(dbTechLayer* layer);

  static dbTechLayerEolKeepOutRule* getTechLayerEolKeepOutRule(
      dbTechLayer* inly,
      uint dbid);
  static void destroy(dbTechLayerEolKeepOutRule* rule);
  // User Code End dbTechLayerEolKeepOutRule
};

class dbTechLayerCutClassRule : public dbObject
{
 public:
  // User Code Begin dbTechLayerCutClassRuleEnums
  // User Code End dbTechLayerCutClassRuleEnums

  const char* getName() const;

  void setWidth(int width);

  int getWidth() const;

  void setLength(int length);

  int getLength() const;

  void setNumCuts(int num_cuts);

  int getNumCuts() const;

  void setLengthValid(bool length_valid);

  bool isLengthValid() const;

  void setCutsValid(bool cuts_valid);

  bool isCutsValid() const;

  // User Code Begin dbTechLayerCutClassRule
  static dbTechLayerCutClassRule* getTechLayerCutClassRule(dbTechLayer* inly,
                                                           uint dbid);

  static dbTechLayerCutClassRule* create(dbTechLayer* _layer, const char* name);

  static void destroy(dbTechLayerCutClassRule* rule);
  // User Code End dbTechLayerCutClassRule
};

class dbTechLayerCutSpacingRule : public dbObject
{
 public:
  enum CutSpacingType
  {
    NONE,
    MAXXY,
    SAMEMASK,
    LAYER,
    ADJACENTCUTS,
    PARALLELOVERLAP,
    PARALLELWITHIN,
    SAMEMETALSHAREDEDGE,
    AREA
  };
  // User Code Begin dbTechLayerCutSpacingRuleEnums
  // User Code End dbTechLayerCutSpacingRuleEnums

  void setCutSpacing(int cut_spacing);

  int getCutSpacing() const;

  void setSecondLayer(dbTechLayer* second_layer);

  void setOrthogonalSpacing(int orthogonal_spacing);

  int getOrthogonalSpacing() const;

  void setWidth(int width);

  int getWidth() const;

  void setEnclosure(int enclosure);

  int getEnclosure() const;

  void setEdgeLength(int edge_length);

  int getEdgeLength() const;

  void setParWithin(int par_within);

  int getParWithin() const;

  void setParEnclosure(int par_enclosure);

  int getParEnclosure() const;

  void setEdgeEnclosure(int edge_enclosure);

  int getEdgeEnclosure() const;

  void setAdjEnclosure(int adj_enclosure);

  int getAdjEnclosure() const;

  void setAboveEnclosure(int above_enclosure);

  int getAboveEnclosure() const;

  void setAboveWidth(int above_width);

  int getAboveWidth() const;

  void setMinLength(int min_length);

  int getMinLength() const;

  void setExtension(int extension);

  int getExtension() const;

  void setEolWidth(int eol_width);

  int getEolWidth() const;

  void setNumCuts(uint num_cuts);

  uint getNumCuts() const;

  void setWithin(int within);

  int getWithin() const;

  void setSecondWithin(int second_within);

  int getSecondWithin() const;

  void setCutClass(dbTechLayerCutClassRule* cut_class);

  void setTwoCuts(uint two_cuts);

  uint getTwoCuts() const;

  void setPrl(uint prl);

  uint getPrl() const;

  void setParLength(uint par_length);

  uint getParLength() const;

  void setCutArea(int cut_area);

  int getCutArea() const;

  void setCenterToCenter(bool center_to_center);

  bool isCenterToCenter() const;

  void setSameNet(bool same_net);

  bool isSameNet() const;

  void setSameMetal(bool same_metal);

  bool isSameMetal() const;

  void setSameVia(bool same_via);

  bool isSameVia() const;

  void setStack(bool stack);

  bool isStack() const;

  void setOrthogonalSpacingValid(bool orthogonal_spacing_valid);

  bool isOrthogonalSpacingValid() const;

  void setAboveWidthEnclosureValid(bool above_width_enclosure_valid);

  bool isAboveWidthEnclosureValid() const;

  void setShortEdgeOnly(bool short_edge_only);

  bool isShortEdgeOnly() const;

  void setConcaveCornerWidth(bool concave_corner_width);

  bool isConcaveCornerWidth() const;

  void setConcaveCornerParallel(bool concave_corner_parallel);

  bool isConcaveCornerParallel() const;

  void setConcaveCornerEdgeLength(bool concave_corner_edge_length);

  bool isConcaveCornerEdgeLength() const;

  void setConcaveCorner(bool concave_corner);

  bool isConcaveCorner() const;

  void setExtensionValid(bool extension_valid);

  bool isExtensionValid() const;

  void setNonEolConvexCorner(bool non_eol_convex_corner);

  bool isNonEolConvexCorner() const;

  void setEolWidthValid(bool eol_width_valid);

  bool isEolWidthValid() const;

  void setMinLengthValid(bool min_length_valid);

  bool isMinLengthValid() const;

  void setAboveWidthValid(bool above_width_valid);

  bool isAboveWidthValid() const;

  void setMaskOverlap(bool mask_overlap);

  bool isMaskOverlap() const;

  void setWrongDirection(bool wrong_direction);

  bool isWrongDirection() const;

  void setAdjacentCuts(uint adjacent_cuts);

  uint getAdjacentCuts() const;

  void setExactAligned(bool exact_aligned);

  bool isExactAligned() const;

  void setCutClassToAll(bool cut_class_to_all);

  bool isCutClassToAll() const;

  void setNoPrl(bool no_prl);

  bool isNoPrl() const;

  void setSameMask(bool same_mask);

  bool isSameMask() const;

  void setExceptSamePgnet(bool except_same_pgnet);

  bool isExceptSamePgnet() const;

  void setSideParallelOverlap(bool side_parallel_overlap);

  bool isSideParallelOverlap() const;

  void setExceptSameNet(bool except_same_net);

  bool isExceptSameNet() const;

  void setExceptSameMetal(bool except_same_metal);

  bool isExceptSameMetal() const;

  void setExceptSameMetalOverlap(bool except_same_metal_overlap);

  bool isExceptSameMetalOverlap() const;

  void setExceptSameVia(bool except_same_via);

  bool isExceptSameVia() const;

  void setAbove(bool above);

  bool isAbove() const;

  void setExceptTwoEdges(bool except_two_edges);

  bool isExceptTwoEdges() const;

  void setTwoCutsValid(bool two_cuts_valid);

  bool isTwoCutsValid() const;

  void setSameCut(bool same_cut);

  bool isSameCut() const;

  void setLongEdgeOnly(bool long_edge_only);

  bool isLongEdgeOnly() const;

  void setPrlValid(bool prl_valid);

  bool isPrlValid() const;

  void setBelow(bool below);

  bool isBelow() const;

  void setParWithinEnclosureValid(bool par_within_enclosure_valid);

  bool isParWithinEnclosureValid() const;

  // User Code Begin dbTechLayerCutSpacingRule
  dbTechLayerCutClassRule* getCutClass() const;

  dbTechLayer* getSecondLayer() const;

  dbTechLayer* getTechLayer() const;

  void setType(CutSpacingType _type);

  CutSpacingType getType() const;

  static dbTechLayerCutSpacingRule* getTechLayerCutSpacingRule(
      dbTechLayer* inly,
      uint dbid);

  static dbTechLayerCutSpacingRule* create(dbTechLayer* _layer);

  static void destroy(dbTechLayerCutSpacingRule* rule);
  // User Code End dbTechLayerCutSpacingRule
};

class dbTechLayerCutSpacingTableOrthRule : public dbObject
{
 public:
  // User Code Begin dbTechLayerCutSpacingTableOrthRuleEnums
  // User Code End dbTechLayerCutSpacingTableOrthRuleEnums
  void getSpacingTable(std::vector<std::pair<int, int>>& tbl) const;

  // User Code Begin dbTechLayerCutSpacingTableOrthRule
  void setSpacingTable(std::vector<std::pair<int, int>> tbl);

  static dbTechLayerCutSpacingTableOrthRule* create(dbTechLayer* parent);

  static dbTechLayerCutSpacingTableOrthRule*
  getTechLayerCutSpacingTableOrthSubRule(dbTechLayer* parent, uint dbid);

  static void destroy(dbTechLayerCutSpacingTableOrthRule* rule);
  // User Code End dbTechLayerCutSpacingTableOrthRule
};

class dbTechLayerCutSpacingTableDefRule : public dbObject
{
 public:
  // User Code Begin dbTechLayerCutSpacingTableDefRuleEnums
  // User Code End dbTechLayerCutSpacingTableDefRuleEnums

  void setDefault(int spacing);

  int getDefault() const;

  void setSecondLayer(dbTechLayer* second_layer);

  void setPrl(int prl);

  int getPrl() const;

  void setExtension(int extension);

  int getExtension() const;

  void setDefaultValid(bool default_valid);

  bool isDefaultValid() const;

  void setSameMask(bool same_mask);

  bool isSameMask() const;

  void setSameNet(bool same_net);

  bool isSameNet() const;

  void setSameMetal(bool same_metal);

  bool isSameMetal() const;

  void setSameVia(bool same_via);

  bool isSameVia() const;

  void setLayerValid(bool layer_valid);

  bool isLayerValid() const;

  void setNoStack(bool no_stack);

  bool isNoStack() const;

  void setNonZeroEnclosure(bool non_zero_enclosure);

  bool isNonZeroEnclosure() const;

  void setPrlForAlignedCut(bool prl_for_aligned_cut);

  bool isPrlForAlignedCut() const;

  void setCenterToCenterValid(bool center_to_center_valid);

  bool isCenterToCenterValid() const;

  void setCenterAndEdgeValid(bool center_and_edge_valid);

  bool isCenterAndEdgeValid() const;

  void setNoPrl(bool no_prl);

  bool isNoPrl() const;

  void setPrlValid(bool prl_valid);

  bool isPrlValid() const;

  void setMaxXY(bool max_x_y);

  bool isMaxXY() const;

  void setEndExtensionValid(bool end_extension_valid);

  bool isEndExtensionValid() const;

  void setSideExtensionValid(bool side_extension_valid);

  bool isSideExtensionValid() const;

  void setExactAlignedSpacingValid(bool exact_aligned_spacing_valid);

  bool isExactAlignedSpacingValid() const;

  void setHorizontal(bool horizontal);

  bool isHorizontal() const;

  void setPrlHorizontal(bool prl_horizontal);

  bool isPrlHorizontal() const;

  void setVertical(bool vertical);

  bool isVertical() const;

  void setPrlVertical(bool prl_vertical);

  bool isPrlVertical() const;

  void setNonOppositeEnclosureSpacingValid(
      bool non_opposite_enclosure_spacing_valid);

  bool isNonOppositeEnclosureSpacingValid() const;

  void setOppositeEnclosureResizeSpacingValid(
      bool opposite_enclosure_resize_spacing_valid);

  bool isOppositeEnclosureResizeSpacingValid() const;

  // User Code Begin dbTechLayerCutSpacingTableDefRule
  void addPrlForAlignedCutEntry(dbTechLayerCutClassRule* from,
                                dbTechLayerCutClassRule* to);

  std::vector<std::pair<dbTechLayerCutClassRule*, dbTechLayerCutClassRule*>>
  getPrlForAlignedCutTable() const;

  void addCenterToCenterEntry(dbTechLayerCutClassRule* from,
                              dbTechLayerCutClassRule* to);

  std::vector<std::pair<dbTechLayerCutClassRule*, dbTechLayerCutClassRule*>>
  getCenterToCenterTable() const;

  void addCenterAndEdgeEntry(dbTechLayerCutClassRule* from,
                             dbTechLayerCutClassRule* to);

  std::vector<std::pair<dbTechLayerCutClassRule*, dbTechLayerCutClassRule*>>
  getCenterAndEdgeTable() const;

  void addPrlEntry(dbTechLayerCutClassRule* from,
                   dbTechLayerCutClassRule* to,
                   int ccPrl);

  std::vector<
      std::tuple<dbTechLayerCutClassRule*, dbTechLayerCutClassRule*, int>>
  getPrlTable() const;

  void addEndExtensionEntry(dbTechLayerCutClassRule* cls, int ext);

  std::vector<std::pair<dbTechLayerCutClassRule*, int>> getEndExtensionTable()
      const;

  void addSideExtensionEntry(dbTechLayerCutClassRule* cls, int ext);

  std::vector<std::pair<dbTechLayerCutClassRule*, int>> getSideExtensionTable()
      const;

  void addExactElignedEntry(dbTechLayerCutClassRule* cls, int spacing);

  std::vector<std::pair<dbTechLayerCutClassRule*, int>> getExactAlignedTable()
      const;

  void addNonOppEncSpacingEntry(dbTechLayerCutClassRule* cls, int spacing);

  std::vector<std::pair<dbTechLayerCutClassRule*, int>>
  getNonOppEncSpacingTable() const;

  void addOppEncSpacingEntry(dbTechLayerCutClassRule* cls,
                             int rsz1,
                             int rsz2,
                             int spacing);

  std::vector<std::tuple<dbTechLayerCutClassRule*, int, int, int>>
  getOppEncSpacingTable() const;

  dbTechLayer* getSecondLayer() const;

  void setSpacingTable(std::vector<std::vector<std::pair<int, int>>> table,
                       std::map<std::string, uint> row_map,
                       std::map<std::string, uint> col_map);

  void getSpacingTable(std::vector<std::vector<std::pair<int, int>>>& table,
                       std::map<std::string, uint>& row_map,
                       std::map<std::string, uint>& col_map);

  std::pair<int, int> getSpacing(const char* class1,
                                 bool SIDE1,
                                 const char* class2,
                                 bool SIDE2);

  dbTechLayer* getTechLayer() const;

  static dbTechLayerCutSpacingTableDefRule* create(dbTechLayer* parent);

  static dbTechLayerCutSpacingTableDefRule*
  getTechLayerCutSpacingTableDefSubRule(dbTechLayer* parent, uint dbid);

  static void destroy(dbTechLayerCutSpacingTableDefRule* rule);
  // User Code End dbTechLayerCutSpacingTableDefRule
};

class dbTechLayerCutEnclosureRule : public dbObject
{
 public:
  enum ENC_TYPE
  {
    DEFAULT,
    EOL,
    ENDSIDE,
    HORZ_AND_VERT
  };
  // User Code Begin dbTechLayerCutEnclosureRuleEnums
  /*
  ENC_TYPE describes the enclosure overhang values as following (from the
  lefdefref):
  * DEFAULT       : overhang1 overhang2
  * EOL           : EOL eolWidth ... eolOverhang otherOverhang ...
  * ENDSIDE       : END overhang1 SIDE overhang2
  * HORZ_AND_VERT : HORIZONTAL overhang1 VERTICAL overhang2
  */
  // User Code End dbTechLayerCutEnclosureRuleEnums

  void setCutClass(dbTechLayerCutClassRule* cut_class);

  dbTechLayerCutClassRule* getCutClass() const;

  void setEolWidth(int eol_width);

  int getEolWidth() const;

  void setEolMinLength(int eol_min_length);

  int getEolMinLength() const;

  void setFirstOverhang(int first_overhang);

  int getFirstOverhang() const;

  void setSecondOverhang(int second_overhang);

  int getSecondOverhang() const;

  void setSpacing(int spacing);

  int getSpacing() const;

  void setExtension(int extension);

  int getExtension() const;

  void setForwardExtension(int forward_extension);

  int getForwardExtension() const;

  void setBackwardExtension(int backward_extension);

  int getBackwardExtension() const;

  void setMinWidth(int min_width);

  int getMinWidth() const;

  void setCutWithin(int cut_within);

  int getCutWithin() const;

  void setMinLength(int min_length);

  int getMinLength() const;

  void setParLength(int par_length);

  int getParLength() const;

  void setSecondParLength(int second_par_length);

  int getSecondParLength() const;

  void setParWithin(int par_within);

  int getParWithin() const;

  void setSecondParWithin(int second_par_within);

  int getSecondParWithin() const;

  void setBelowEnclosure(int below_enclosure);

  int getBelowEnclosure() const;

  void setNumCorners(uint num_corners);

  uint getNumCorners() const;

  void setCutClassValid(bool cut_class_valid);

  bool isCutClassValid() const;

  void setAbove(bool above);

  bool isAbove() const;

  void setBelow(bool below);

  bool isBelow() const;

  void setEolMinLengthValid(bool eol_min_length_valid);

  bool isEolMinLengthValid() const;

  void setEolOnly(bool eol_only);

  bool isEolOnly() const;

  void setShortEdgeOnly(bool short_edge_only);

  bool isShortEdgeOnly() const;

  void setSideSpacingValid(bool side_spacing_valid);

  bool isSideSpacingValid() const;

  void setEndSpacingValid(bool end_spacing_valid);

  bool isEndSpacingValid() const;

  void setOffCenterLine(bool off_center_line);

  bool isOffCenterLine() const;

  void setWidthValid(bool width_valid);

  bool isWidthValid() const;

  void setIncludeAbutted(bool include_abutted);

  bool isIncludeAbutted() const;

  void setExceptExtraCut(bool except_extra_cut);

  bool isExceptExtraCut() const;

  void setPrl(bool prl);

  bool isPrl() const;

  void setNoSharedEdge(bool no_shared_edge);

  bool isNoSharedEdge() const;

  void setLengthValid(bool length_valid);

  bool isLengthValid() const;

  void setExtraCutValid(bool extra_cut_valid);

  bool isExtraCutValid() const;

  void setExtraOnly(bool extra_only);

  bool isExtraOnly() const;

  void setRedundantCutValid(bool redundant_cut_valid);

  bool isRedundantCutValid() const;

  void setParallelValid(bool parallel_valid);

  bool isParallelValid() const;

  void setSecondParallelValid(bool second_parallel_valid);

  bool isSecondParallelValid() const;

  void setSecondParWithinValid(bool second_par_within_valid);

  bool isSecondParWithinValid() const;

  void setBelowEnclosureValid(bool below_enclosure_valid);

  bool isBelowEnclosureValid() const;

  void setConcaveCornersValid(bool concave_corners_valid);

  bool isConcaveCornersValid() const;

  // User Code Begin dbTechLayerCutEnclosureRule
  void setType(ENC_TYPE type);

  ENC_TYPE getType() const;

  static dbTechLayerCutEnclosureRule* create(dbTechLayer* layer);

  static dbTechLayerCutEnclosureRule* getTechLayerCutEnclosureRule(
      dbTechLayer* inly,
      uint dbid);
  static void destroy(dbTechLayerCutEnclosureRule* rule);
  // User Code End dbTechLayerCutEnclosureRule
};

class dbTechLayerEolExtensionRule : public dbObject
{
 public:
  // User Code Begin dbTechLayerEolExtensionRuleEnums
  // User Code End dbTechLayerEolExtensionRuleEnums

  void setSpacing(int spacing);

  int getSpacing() const;

  void getExtensionTable(std::vector<std::pair<int, int>>& tbl) const;

  void setParallelOnly(bool parallel_only);

  bool isParallelOnly() const;

  // User Code Begin dbTechLayerEolExtensionRule

  void addEntry(int eol, int ext);

  static dbTechLayerEolExtensionRule* create(dbTechLayer* layer);

  static dbTechLayerEolExtensionRule* getTechLayerEolExtensionRule(
      dbTechLayer* inly,
      uint dbid);

  static void destroy(dbTechLayerEolExtensionRule* rule);
  // User Code End dbTechLayerEolExtensionRule
};

class dbModule : public dbObject
{
 public:
  // User Code Begin dbModuleEnums
  // User Code End dbModuleEnums
  const char* getName() const;

  dbModInst* getModInst() const;

  // User Code Begin dbModule
  void addInst(dbInst* inst);

  void removeInst(dbInst* inst);

  dbSet<dbInst> getInsts();

  dbSet<dbModInst> getChildren();

  dbModInst* findModInst(const char* name);

  static dbModule* create(dbBlock* block, const char* name);

  static void destroy(dbModule* module);

  static dbModule* getModule(dbBlock* block_, uint dbid_);

  // User Code End dbModule
};

class dbModInst : public dbObject
{
 public:
  // User Code Begin dbModInstEnums
  // User Code End dbModInstEnums

  dbModule* getParent() const;

  dbModule* getMaster() const;

  dbGroup* getGroup() const;

  // User Code Begin dbModInst
  static dbModInst* create(dbModule* parentModule,
                           dbModule* masterModule,
                           const char* name);

  static void destroy(dbModInst* modinst);

  static dbSet<dbModInst>::iterator destroy(dbSet<dbModInst>::iterator& itr);

  static dbModInst* getModInst(dbBlock* block_, uint dbid_);

  std::string getName() const;

  std::string getHierarchalName() const;
  // User Code End dbModInst
};

class dbGroup : public dbObject
{
 public:
  enum dbGroupType
  {
    PHYSICAL_CLUSTER,
    VOLTAGE_DOMAIN
  };
  // User Code Begin dbGroupEnums
  // User Code End dbGroupEnums

  const char* getName() const;

  Rect getBox() const;

  void setParentGroup(dbGroup* parent_group);

  dbGroup* getParentGroup() const;

  // User Code Begin dbGroup

  void setType(dbGroupType _type);

  dbGroupType getType() const;

  void setBox(Rect _box);

  bool hasBox();

  void addModInst(dbModInst* modinst);

  void removeModInst(dbModInst* modinst);

  dbSet<dbModInst> getModInsts();

  void addInst(dbInst* inst);

  void removeInst(dbInst* inst);

  dbSet<dbInst> getInsts();

  void addGroup(dbGroup* group);

  void removeGroup(dbGroup* group);

  dbSet<dbGroup> getGroups();

  void addPowerNet(dbNet* net);

  void addGroundNet(dbNet* net);

  void removeNet(dbNet* net);

  dbSet<dbNet> getPowerNets();

  dbSet<dbNet> getGroundNets();

  static dbGroup* create(dbBlock* block, const char* name);

  static dbGroup* create(dbBlock* block,
                         const char* name,
                         int x1,
                         int y1,
                         int x2,
                         int y2);

  static dbGroup* create(dbGroup* parent, const char* name);

  static void destroy(dbGroup* group);

  static dbGroup* getGroup(dbBlock* block_, uint dbid_);

  // User Code End dbGroup
};

class dbGCellGrid : public dbObject
{
 public:
  struct GCellData
  {
    uint horizontal_usage = 0;
    uint vertical_usage = 0;
    uint up_usage = 0;
    uint horizontal_capacity = 0;
    uint vertical_capacity = 0;
    uint up_capacity = 0;
    uint horizontal_blockage = 0;
    uint vertical_blockage = 0;
    uint up_blockage = 0;
  };
  // User Code Begin dbGCellGridEnums
  // User Code End dbGCellGridEnums

  // User Code Begin dbGCellGrid

  ///
  /// Get the "X" grid coordinates
  ///
  void getGridX(std::vector<int>& x_grid);

  ///
  /// Get the "Y" grid coordinates
  ///
  void getGridY(std::vector<int>& y_grid);

  ///
  /// Get the block this grid belongs too.
  ///
  dbBlock* getBlock();

  ///
  /// Add a "X" grid pattern.
  ///
  void addGridPatternX(int origin_x, int line_count, int step);

  ///
  /// Add a "Y" grid pattern.
  ///
  void addGridPatternY(int origin_y, int line_count, int step);

  ///
  /// Get the number of "X" grid patterns.
  ///
  int getNumGridPatternsX();

  ///
  /// Get the number of "Y" grid patterns.
  ///
  int getNumGridPatternsY();

  ///
  /// Get the "ith" "X" grid pattern.
  ///
  void getGridPatternX(int i, int& origin_x, int& line_count, int& step);

  ///
  /// Get the "ith" "Y" grid pattern.
  ///
  void getGridPatternY(int i, int& origin_y, int& line_count, int& step);
  ///
  /// Create an empty GCell grid.
  /// Returns NULL if a grid already exists.
  ///
  static dbGCellGrid* create(dbBlock* block);

  ///
  /// Translate a database-id back to a pointer.
  ///
  static dbGCellGrid* getGCellGrid(dbBlock* block, uint oid);

  uint getXIdx(int x);

  uint getYIdx(int y);

  uint getHorizontalCapacity(dbTechLayer* layer, uint x_idx, uint y_idx) const;

  uint getVerticalCapacity(dbTechLayer* layer, uint x_idx, uint y_idx) const;

  uint getUpCapacity(dbTechLayer* layer, uint x_idx, uint y_idx) const;

  uint getHorizontalUsage(dbTechLayer* layer, uint x_idx, uint y_idx) const;

  uint getVerticalUsage(dbTechLayer* layer, uint x_idx, uint y_idx) const;

  uint getUpUsage(dbTechLayer* layer, uint x_idx, uint y_idx) const;

  uint getHorizontalBlockage(dbTechLayer* layer, uint x_idx, uint y_idx) const;

  uint getVerticalBlockage(dbTechLayer* layer, uint x_idx, uint y_idx) const;

  uint getUpBlockage(dbTechLayer* layer, uint x_idx, uint y_idx) const;

  void setHorizontalCapacity(dbTechLayer* layer,
                             uint x_idx,
                             uint y_idx,
                             uint capacity);

  void setVerticalCapacity(dbTechLayer* layer,
                           uint x_idx,
                           uint y_idx,
                           uint capacity);

  void setUpCapacity(dbTechLayer* layer, uint x_idx, uint y_idx, uint capacity);

  void setHorizontalUsage(dbTechLayer* layer, uint x_idx, uint y_idx, uint use);

  void setVerticalUsage(dbTechLayer* layer, uint x_idx, uint y_idx, uint use);

  void setUpUsage(dbTechLayer* layer, uint x_idx, uint y_idx, uint use);

  void setHorizontalBlockage(dbTechLayer* layer,
                             uint x_idx,
                             uint y_idx,
                             uint blockage);

  void setVerticalBlockage(dbTechLayer* layer,
                           uint x_idx,
                           uint y_idx,
                           uint blockage);

  void setUpBlockage(dbTechLayer* layer, uint x_idx, uint y_idx, uint blockage);

  void setCapacity(dbTechLayer* layer,
                   uint x_idx,
                   uint y_idx,
                   uint horizontal,
                   uint vertical,
                   uint up);

  void setUsage(dbTechLayer* layer,
                uint x_idx,
                uint y_idx,
                uint horizontal,
                uint vertical,
                uint up);

  void setBlockage(dbTechLayer* layer,
                   uint x_idx,
                   uint y_idx,
                   uint horizontal,
                   uint vertical,
                   uint up);

  void getCapacity(dbTechLayer* layer,
                   uint x_idx,
                   uint y_idx,
                   uint& horizontal,
                   uint& vertical,
                   uint& up) const;

  void getUsage(dbTechLayer* layer,
                uint x_idx,
                uint y_idx,
                uint& horizontal,
                uint& vertical,
                uint& up) const;

  void getBlockage(dbTechLayer* layer,
                   uint x_idx,
                   uint y_idx,
                   uint& horizontal,
                   uint& vertical,
                   uint& up) const;

  void resetCongestionMap();

  void resetGrid();

  std::map<std::pair<uint, uint>, GCellData> getCongestionMap(dbTechLayer* layer
                                                              = nullptr);
  // User Code End dbGCellGrid
};

// Generator Code End ClassDefinition

}  // namespace odb