Write a "cell index / table" generator for the documentation

[mithro]

It is very useful to have tables of the cells available in each library. This should be included in the Sphinx generated PDK documentation. The task here is to auto-generate these tables as either;

• part of the Sphinx generation directly, or
• As a standalone script in (python-skywater-pdk package) which generates rst files committed to the repository (like the generated verilog or image files).

This should be easily be done due to the library structure being based around each cell having its own directory and a definition.json file which describes the basic shape and features of the cell.

Here is an example from a spreadsheet I created;

Here is an example from the libresilicon Standard Cell Library Build Report;

Here is an example from this random document

Here is another example from a random thesis on creating standard cells

[mithro]

Example cell - https://foss-eda-tools.googlesource.com/skywater-pdk/libs/sky130_fd_sc_hd/+/refs/heads/master/cells/a2111o/

Definition file which contains a summary of the cell info - https://foss-eda-tools.googlesource.com/skywater-pdk/libs/sky130_fd_sc_hd/+/refs/heads/master/cells/a2111o/definition.json

[PiotrZierhoffer]

I used some of the definitions.json data to create a basic list. The script just takes a path to the library and creates a file. I also modified the README.rst manually to include the file inline (so we don't have to parse it when regenerating).

How do I submit the results for review? Create a sample PR in one of the submodules maybe?

[PiotrZierhoffer]

Also it now takes data both from cells and models. This can obviously be changed if needed, but seemed to make sense

[mithro]

The issue at #143 does some initial work here.

[proppy]

@kgugala @PiotrZierhoffer found #143 #256 and #266 that all seem to contribute to fixing this, could you advise on the best way to merge them (rebase, apply in order, drop duplicate changes?). Are there other changes from https://github.com/antmicro/skywater-pdk/ that need to be added as well?

[wgryncewicz]

@proppy I'll take a look into this.