Limbo.Parsers.BookshelfParser

Table of Contents

• Introduction
• Examples
  • Flex/Bison Parser
  • All Examples
• References

Introduction

Bookshelf format is widely used in VLSI physical design such as placement and routing. It is originally developed by UCSD. The Bookshelf parser can read .aux file and extract all other files. Then it parses the rest files and invokes user-defined callback functions.

Examples

Flex/Bison Parser

See documented version: test/parsers/bookshelf/test_bison.cpp

 
#include <iostream>
#include <fstream>
 
#include <limbo/parsers/bookshelf/bison/BookshelfDriver.h>
 
using std::cout;
using std::cin;
using std::endl;
using std::string;

class BookshelfDataBase : public BookshelfParser::BookshelfDataBase
{
    public:
        BookshelfDataBase()
        {
            cout << "BookshelfDataBase::" << __func__ << endl;
        }
        virtual void resize_bookshelf_node_terminals(int nn, int nt) 
        {
            cout << __func__ << " => " << nn << ", " << nt << endl;
        }
        virtual void resize_bookshelf_net(int n)
        {
            cout << __func__ << " => " << n << endl;
        }
        virtual void resize_bookshelf_pin(int n)
        {
            cout << __func__ << " => " << n << endl;
        }
        virtual void resize_bookshelf_row(int n)
        {
            cout << __func__ << " => " << n << endl;
        }
        virtual void resize_bookshelf_shapes(int n)
        {
            cout << __func__ << " => " << n << endl;
        }
        virtual void resize_bookshelf_niterminal_layers(int n)
        {
            cout << __func__ << " => " << n << endl; 
        }
        virtual void resize_bookshelf_blockage_layers(int n)
        {
            cout << __func__ << " => " << n << endl; 
        }
        virtual void add_bookshelf_terminal(string& name, int w, int h)
        {
            cout << __func__ << " => " << name << ", " << w << ", " << h << endl;
        }
        virtual void add_bookshelf_terminal_NI(string& name, int w, int h)
        {
            cout << __func__ << " => " << name << ", " << w << ", " << h << endl;
        }
        virtual void add_bookshelf_node(string& name, int w, int h, bool is_cell)
        {
            cout << __func__ << " => " << name << ", " << w << ", " << h << ", " << is_cell << endl;
        }
        virtual void add_bookshelf_net(BookshelfParser::Net const& net)
        {
            net.print(cout);
        }
        virtual void add_bookshelf_row(BookshelfParser::Row const& row)
        {
            row.print(cout);
        }
        virtual void set_bookshelf_node_position(string const& name, double x, double y, string const& orient, string const& status, bool plFlag)
        {
            cout << __func__ << " => " << name << ", " << x << ", " << y << ", " << orient << ", " << status << ", plFlag = " << plFlag << endl;
        }
        virtual void set_bookshelf_net_weight(string const& name, double w)
        {
            cout << __func__ << " => " << name << ", " << w << endl; 
        }
        virtual void set_bookshelf_shape(BookshelfParser::NodeShape const& shape)
        {
            shape.print(cout); 
        }
        virtual void set_bookshelf_route_info(BookshelfParser::RouteInfo const& info)
        {
            info.print(cout);
        }
        virtual void add_bookshelf_niterminal_layer(string const&, string const&)
        {
        }
        virtual void add_bookshelf_blockage_layers(string const&, std::vector<string> const&)
        {
        }
        virtual void set_bookshelf_design(string& name)
        {
            cout << __func__ << " => " << name << endl;
        }
        virtual void bookshelf_end()
        {
            cout << __func__ << endl;
        }
};

void test1(string const& filename)
{
    cout << "////////////// test1 ////////////////" << endl;
    BookshelfDataBase db;
    BookshelfParser::read(db, filename);
}

void test2(string const& filename)
{
    cout << "////////////// test2 ////////////////" << endl;
    BookshelfDataBase db;
    BookshelfParser::Driver driver (db);
    //driver.trace_scanning = true;
    //driver.trace_parsing = true;
 
    driver.parse_file(filename);
}

int main(int argc, char** argv)
{
 
    if (argc > 1)
    {
        test1(argv[1]);
        test2(argv[1]);
    }
    else 
        cout << "at least 1 argument is required" << endl;
 
    return 0;
}

Compiling and running commands (assuming LIMBO_DIR is exported as the environment variable to the path where limbo library is installed)

g++ -o test_bison test_bison.cpp -I $LIMBO_DIR/include -L $LIMBO_DIR/lib -lbookshelfparser
./test_bison benchmarks/simple/acc64.aux

All Examples

• test/parsers/bookshelf/test_bison.cpp

References

• limbo/parsers/bookshelf/bison/BookshelfDataBase.h
• limbo/parsers/bookshelf/bison/BookshelfDriver.h