Struct libreda_lefdef::def_impl::LEFDEF

struct LEFDEF<'a> {
    lef: &'a LEF,
    def: &'a DEF,
    components_by_name: HashMap<&'a str, &'a Component>,
    macro_references: HashMap<&'a str, Vec<&'a Component>>,
}

Fused LEF and DEF structure. Holds only references to LEF and DEF structs but creates indices for faster name lookup of components.

This data structure implements the HierarchyBase, NetlistBase and LayoutBase view traits.

Fields

lef: &'a LEF

Underlying LEF struct.

def: &'a DEF

Underlying DEF struct.

components_by_name: HashMap<&'a str, &'a Component>

Index for finding components by name.

macro_references: HashMap<&'a str, Vec<&'a Component>>

For each macro name a list of components that instantiate this macro.

Implementations

impl<'a> LEFDEF<'a>

pub fn new(lef: &'a LEF, def: &'a DEF) -> Self

Create a new fused LEF/DEF structure from a LEF and DEF struct.

fn top_cell_name(&self) -> &str

fn top_cell(&self) -> CellId

pub fn def(&self) -> &DEF

Access the underlying DEF struct.

pub fn lef(&self) -> &LEF

Access the underlying LEF struct.

fn component_by_name(&self, name: &str) -> Option<&Component>

Find a component by its name using the lookup table.

Trait Implementations

impl<'a> HierarchyBase for LEFDEF<'a>

type NameType = String

Type for names of cells, instances, etc.

fn cell_by_name(&self, name: &str) -> Option<Self::CellId>

Find a cell by its name. Return the cell with the given name. Returns None if the cell does not exist.

fn cell_instance_by_name( &self, CellId: &Self::CellId, name: &str ) -> Option<Self::CellInstId>

Find a cell instance by its name. Returns None if the name does not exist.

fn cell_name(&self, CellId: &Self::CellId) -> Self::NameType

Get the name of the cell.

fn cell_instance_name( &self, CellInstId: &Self::CellInstId ) -> Option<Self::NameType>

Get the name of the cell instance.

fn parent_cell(&self, cell_instance: &Self::CellInstId) -> Self::CellId

Get the ID of the parent cell of this instance.

fn template_cell(&self, CellInstId: &Self::CellInstId) -> Self::CellId

Get the ID of the template cell of this instance.

fn for_each_cell<F>(&self, f: F)where F: FnMut(Self::CellId),

Call a function on each cell of the netlist.

fn for_each_cell_instance<F>(&self, cell: &Self::CellId, f: F)where F: FnMut(Self::CellInstId),

Call a function on each instance in this cell.

fn for_each_cell_dependency<F>(&self, CellId: &Self::CellId, f: F)where F: FnMut(Self::CellId),

Call a function for each cell that is a child of this cell.

fn for_each_dependent_cell<F>(&self, CellId: &Self::CellId, f: F)where F: FnMut(Self::CellId),

Call a function for each cell that directly depends on cell.

fn for_each_cell_reference<F>(&self, CellId: &Self::CellId, f: F)where F: FnMut(Self::CellInstId),

Iterate over all instances of this cell, i.e. instances that use this cell as a template.

fn num_child_instances(&self, CellId: &Self::CellId) -> usize

Get the number of cell instances inside the cell.

fn num_cells(&self) -> usize

Get the number of cell templates.

fn each_cell_vec(&self) -> Vec<Self::CellId, Global>

Get a Vec of all cell IDs in this netlist.

fn each_cell(&self) -> Box<dyn Iterator<Item = Self::CellId>, Global>

Iterate over all cells.

fn each_cell_instance_vec( &self, cell: &Self::CellId ) -> Vec<Self::CellInstId, Global>

Get a Vec of the IDs of all instances in this cell.

fn each_cell_instance( &self, cell: &Self::CellId ) -> Box<dyn Iterator<Item = Self::CellInstId>, Global>

Iterate over all instances in a cell.

fn each_cell_dependency_vec( &self, cell: &Self::CellId ) -> Vec<Self::CellId, Global>

Get a Vec of each cell that is a child of this cell.

fn each_cell_dependency<'a>( &'a self, cell: &Self::CellId ) -> Box<dyn Iterator<Item = Self::CellId> + 'a, Global>

Iterate over all cells that are instantiated in this cell.

fn num_cell_dependencies(&self, cell: &Self::CellId) -> usize

Count all cells that are dependencies of cell.

fn each_dependent_cell_vec( &self, cell: &Self::CellId ) -> Vec<Self::CellId, Global>

Get a Vec of each cell that directly depends on cell.

fn each_dependent_cell<'a>( &'a self, cell: &Self::CellId ) -> Box<dyn Iterator<Item = Self::CellId> + 'a, Global>

Iterate over each cell that directly depends on cell.

fn num_dependent_cells(&self, cell: &Self::CellId) -> usize

Count all cells that are directly dependent on cell, i.e. contain an instance of cell.

fn each_cell_reference_vec( &self, cell: &Self::CellId ) -> Vec<Self::CellInstId, Global>

Get a Vec with all cell instances referencing this cell.

fn each_cell_reference( &self, cell: &Self::CellId ) -> Box<dyn Iterator<Item = Self::CellInstId>, Global>

Iterate over all instances of this cell, i.e. instances that use this cell as a template.

fn num_cell_references(&self, cell: &Self::CellId) -> usize

Count all instantiations of cell.

fn get_chip_property(&self, key: &Self::NameType) -> Option<PropertyValue>

Get a property of the top-level chip data structure.

fn get_cell_property( &self, cell: &Self::CellId, key: &Self::NameType ) -> Option<PropertyValue>

Get a property of a cell.

fn get_cell_instance_property( &self, inst: &Self::CellInstId, key: &Self::NameType ) -> Option<PropertyValue>

Get a property of a cell instance.

impl<'a> HierarchyIds for LEFDEF<'a>

type CellId = CellId

Cell/module identifier type.

type CellInstId = CellInstId

Cell instance identifier type.