Metadata-Version: 2.1
Name: siliconcompiler
Version: 0.17.0
Summary: A compiler framework that automates translation from source code to silicon.
Home-page: https://siliconcompiler.com
Author: Andreas Olofsson
Author-email: andreas.d.olofsson@gmail.com
License: Apache License 2.0
Project-URL: Documentation, https://docs.siliconcompiler.com
Project-URL: Source Code, https://github.com/siliconcompiler/siliconcompiler
Project-URL: Bug Tracker, https://github.com/siliconcompiler/siliconcompiler/issues
Project-URL: Forum, https://github.com/siliconcompiler/siliconcompiler/discussions
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy >=1.19
Requires-Dist: aiohttp >=3.7.4.post0
Requires-Dist: requests >=2.27.0
Requires-Dist: PyYAML >=5.4.1
Requires-Dist: defusedxml >=0.7.1
Requires-Dist: pandas >=1.1.5
Requires-Dist: Jinja2 >=2.11.3
Requires-Dist: graphviz >=0.18.1
Requires-Dist: netifaces >=0.11.0
Requires-Dist: distro >=1.6.0
Requires-Dist: packaging >=21.3
Requires-Dist: psutil >=5.8.0
Requires-Dist: Pillow >=8.4.0
Requires-Dist: GitPython >=3.1.0
Requires-Dist: sc-leflib ==0.1.0
Requires-Dist: streamlit
Requires-Dist: streamlit-agraph
Requires-Dist: streamlit-tree-select
Requires-Dist: streamlit-javascript
Requires-Dist: altair ==4
Provides-Extra: build
Requires-Dist: scikit-build >=0.14.1 ; extra == 'build'
Requires-Dist: cython ; extra == 'build'
Requires-Dist: cmake ; extra == 'build'
Provides-Extra: docker
Requires-Dist: docker ; extra == 'docker'
Provides-Extra: docs
Requires-Dist: Sphinx >=3.5.4 ; extra == 'docs'
Requires-Dist: pip-licenses ; extra == 'docs'
Requires-Dist: pydata-sphinx-theme ==0.9.0 ; extra == 'docs'
Requires-Dist: sphinx-design ; extra == 'docs'
Provides-Extra: test
Requires-Dist: pytest >=6.2.4 ; extra == 'test'
Requires-Dist: pytest-xdist >=2.3.0 ; extra == 'test'
Requires-Dist: pytest-timeout >=2.1.0 ; extra == 'test'
Requires-Dist: pytest-asyncio ; extra == 'test'
Requires-Dist: pytest-cov ; extra == 'test'
Requires-Dist: pyvirtualdisplay ; extra == 'test'
Requires-Dist: flake8 >=5.0.0 ; extra == 'test'

![SiliconCompiler](https://raw.githubusercontent.com/siliconcompiler/siliconcompiler/main/docs/_images/sc_logo_with_text.png)

[![Python CI Tests](https://github.com/siliconcompiler/siliconcompiler/actions/workflows/python_ci.yml/badge.svg)](https://github.com/siliconcompiler/siliconcompiler/actions/workflows/python_ci.yml)
[![Tools CI Tests](https://github.com/siliconcompiler/siliconcompiler/actions/workflows/tools_ci.yml/badge.svg)](https://github.com/siliconcompiler/siliconcompiler/actions/workflows/tools_ci.yml)
[![Daily CI Tests](https://github.com/siliconcompiler/siliconcompiler/actions/workflows/daily_ci.yml/badge.svg)](https://github.com/siliconcompiler/siliconcompiler/actions/workflows/daily_ci.yml)
[![Wheels](https://github.com/siliconcompiler/siliconcompiler/actions/workflows/wheels.yml/badge.svg?event=schedule)](https://github.com/siliconcompiler/siliconcompiler/actions/workflows/wheels.yml)
[![Lint](https://github.com/siliconcompiler/siliconcompiler/actions/workflows/lint.yml/badge.svg)](https://github.com/siliconcompiler/siliconcompiler/actions/workflows/lint.yml)
[![Documentation Status](https://readthedocs.org/projects/siliconcompiler/badge/?version=latest)](https://docs.siliconcompiler.com/en/latest/?badge=latest)
[![codecov](https://codecov.io/github/siliconcompiler/siliconcompiler/branch/main/graph/badge.svg?token=V5BQR42Q8C)](https://codecov.io/github/siliconcompiler/siliconcompiler)
[![Downloads](https://static.pepy.tech/personalized-badge/siliconcompiler?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Downloads)](https://pepy.tech/project/siliconcompiler)

# SiliconCompiler Introduction?

SiliconCompiler is a modular hardware build system ("make for silicon"). The project philosophy is to "make the complex possible while keeping the simple simple".

The SiliconCompiler project includes:
 
 * An easy to use Python API. 
 * A standardized JSON schema for job/metric tracking. 
 * A runtime engine with support for local and remote compilation.
 * A command line application ('sc') that enables single line hardware compilation.
 * Support for over 30 open source and commercial ASIC and FPGA EDA tools.

# Getting Started

SiliconCompiler is available as wheel packages on PyPI for macOS, Windows and
Linux platforms. For working Python 3.8-3.11 environment, just use pip.

```sh
python -m pip install --upgrade siliconcompiler
```

Converting RTL into DRC clean GDS takes less than 10 lines of simple Python code.

```python
import siliconcompiler                             # import python package
chip = siliconcompiler.Chip('heartbeat')           # create chip object
chip.load_target('skywater130_demo')               # load a pre-defined target
chip.input('heartbeat.v')                          # set input sources
chip.clock('clk', period=10)                       # set constraints
chip.set('option','remote', True)                  # enable remote execution
chip.run()                                         # run compilation
chip.summary()                                     # print summary
chip.show()                                        # show layout
```

Simple designs can be compiled in a single line using the built in command line 'sc' app:

```sh
sc -remote -target "asic_demo"
```

# Why SiliconCompiler?

* **Ease-of-use**: Programmable with a simple [Python API](https://docs.siliconcompiler.com/en/stable/reference_manual/core_api.html)
* **Portability:** Powerful dynamic JSON [schema](https://docs.siliconcompiler.com/en/stable/reference_manual/schema.html) supports ASIC and FPGA design and simulation
* **Speed:** Flowgraph [execution model](https://docs.siliconcompiler.com/en/stable/user_guide/execution_model.html) enables cloud scale execution.
* **Friction-less:** [Remote execution model](https://docs.siliconcompiler.com/en/stable/user_guide/remote_processing.html) enables "zero install" compilation
* **Modularity:** [Tool abstraction layer](https://docs.siliconcompiler.com/en/latest/development_guide/tools.html) makes it easy to add/port new tools to the project.
* **Provenance:** [Compilation manifests](https://docs.siliconcompiler.com/en/stable/user_guide/data_model.html) created automatically during execution.
* **Documented:** An extensive set of auto-generated high quality [reference documents](https://docs.siliconcompiler.com/).
* **In-use:** Actively used by Zero ASIC for commercial tapeouts at advanced process nodes.

# Documentation

The full reference manual and tutorials can be found [HERE](https://docs.siliconcompiler.com/).

# License

[Apache License 2.0](LICENSE)

# How to Cite

If you want to cite our work, please use the following paper:

A. Olofsson, W. Ransohoff, N. Moroze, "[Invited: A Distributed Approach to Silicon Compilation](docs/papers/sc_dac2022.pdf)", 59th Design Automation Conference (DAC), 10-14 July 2022, San Francisco, CA, USA. Published, 7/2022.

Bibtex:
```
@inproceedings{10.1145/3489517.3530673,
author = {Olofsson, Andreas and Ransohoff, William and Moroze, Noah},
title = {A Distributed Approach to Silicon Compilation: Invited},
year = {2022},
booktitle = {Proceedings of the 59th ACM/IEEE Design Automation Conference},
pages = {1343–1346},
location = {San Francisco, California}
}
```

# Supported Technologies

| Type | Supported|
|------|----------|
|**Languages**| C, Verilog, SV, VHDL, Chisel, Migen/Amaranth, Bluespec
|**Simulation**| Verilator, Icarus, GHDL
|**Synthesis**| Yosys, Vivado, Synopsys, Cadence
|**ASIC APR**| OpenRoad, Synopsys, Cadence
|**FPGA APR**| VPR, nextpnr, Vivado
|**Layout Viewer**| Klayout, OpenRoad, Cadence, Synopsys
|**DRC/LVS**| Magic, Synopsys, Siemens
|**PDKs**| sky130, asap7, freepdk45, gf12lp, gf22fdx, intel16

# Installation

Complete installation instructions are available in the [Installation Guide](https://docs.siliconcompiler.com/en/stable/user_guide/installation.html).

To install the project from source (recommended for developers only).

```bash
git clone https://github.com/siliconcompiler/siliconcompiler
cd siliconcompiler
python -m pip install -e .             # Required install step
python -m pip install -e .[docs,test]  # Optional install step for generating docs and running tests
```

# EDA Tool Installation

Installation instructions for all external tools can be found in the
[External Tools](https://docs.siliconcompiler.com/en/stable/user_guide/installation.html#external-tools) section
of the user guide. We have included shell setup scripts (Ubuntu) for most of the supported tools.
See the [./setup](./setup) directory for a complete set of scripts and [./setup/_tools.json](./setup/_tools.json) for the currently recommended tool versions.

# Contributing

SiliconCompiler is an open-source project and welcomes contributions. To find out
how to contribute to the project, see our
[Contributing Guidelines.](./CONTRIBUTING.md)

# Issues / Bugs

We use [GitHub Issues](https://github.com/siliconcompiler/siliconcompiler/issues)
for tracking requests and bugs.

# More information

| Resources | Link|
|-----------|-----|
| **Website**|  https://www.siliconcompiler.com
| **Documentation**|  https://docs.siliconcompiler.com
| **Sources**|  https://github.com/siliconcompiler/siliconcompiler
| **Issues**|  https://github.com/siliconcompiler/siliconcompiler/issues
| **RFCs**|  https://github.com/siliconcompiler/rfcs
| **Discussion**| https://github.com/siliconcompiler/siliconcompiler/discussions
