Metadata-Version: 2.1
Name: siliconcompiler
Version: 0.26.5
Summary: A compiler framework that automates translation from source code to silicon.
Author-email: Andreas Olofsson <andreas.d.olofsson@gmail.com>
License: Apache License 2.0
Project-URL: Homepage, https://www.siliconcompiler.com
Project-URL: Documentation, https://docs.siliconcompiler.com
Project-URL: Repository, https://github.com/siliconcompiler/siliconcompiler
Project-URL: Issues, https://github.com/siliconcompiler/siliconcompiler/issues
Project-URL: Discussion, https://github.com/siliconcompiler/siliconcompiler/discussions
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp ==3.10.5
Requires-Dist: requests ==2.32.3
Requires-Dist: PyYAML ==6.0.2
Requires-Dist: pandas >=1.1.5
Requires-Dist: Jinja2 >=2.11.3
Requires-Dist: graphviz ==0.20.3
Requires-Dist: distro ==1.9.0
Requires-Dist: packaging <24,>=21.3
Requires-Dist: psutil >=5.8.0
Requires-Dist: Pillow ==10.4.0
Requires-Dist: GitPython ==3.1.43
Requires-Dist: lambdapdk >=0.1.25
Requires-Dist: PyGithub ==2.4.0
Requires-Dist: urllib3 >=1.26.0
Requires-Dist: fasteners ==0.19
Requires-Dist: fastjsonschema ==2.20.0
Requires-Dist: docker ==7.1.0
Requires-Dist: sc-surelog ==1.84.1
Requires-Dist: streamlit ==1.37.1
Requires-Dist: streamlit-agraph ==0.0.45
Requires-Dist: streamlit-tree-select ==0.0.5
Requires-Dist: streamlit-javascript ==0.1.5
Requires-Dist: importlib-metadata ; python_version < "3.10"
Provides-Extra: docs
Requires-Dist: Sphinx ==8.0.2 ; extra == 'docs'
Requires-Dist: pip-licenses ==5.0.0 ; extra == 'docs'
Requires-Dist: pydata-sphinx-theme ==0.15.4 ; extra == 'docs'
Requires-Dist: sc-leflib >=0.2.0 ; extra == 'docs'
Provides-Extra: examples
Requires-Dist: migen ==0.9.2 ; extra == 'examples'
Requires-Dist: lambdalib ==0.2.9 ; extra == 'examples'
Provides-Extra: profile
Requires-Dist: gprof2dot ==2024.6.6 ; extra == 'profile'
Provides-Extra: test
Requires-Dist: pytest ==8.3.2 ; extra == 'test'
Requires-Dist: pytest-xdist ==3.6.1 ; extra == 'test'
Requires-Dist: pytest-timeout ==2.3.1 ; extra == 'test'
Requires-Dist: pytest-asyncio ==0.24.0 ; extra == 'test'
Requires-Dist: pytest-cov ==5.0.0 ; extra == 'test'
Requires-Dist: PyVirtualDisplay ==3.0 ; extra == 'test'
Requires-Dist: flake8 ==7.1.1 ; extra == 'test'
Requires-Dist: tclint ==0.3.2 ; extra == 'test'
Requires-Dist: codespell ==2.3.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?branch=main)](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?branch=main)](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?branch=main)](https://github.com/siliconcompiler/siliconcompiler/actions/workflows/daily_ci.yml)
[![Wheels](https://github.com/siliconcompiler/siliconcompiler/actions/workflows/wheels.yml/badge.svg?branch=main)](https://github.com/siliconcompiler/siliconcompiler/actions/workflows/wheels.yml)
[![Lint](https://github.com/siliconcompiler/siliconcompiler/actions/workflows/lint.yml/badge.svg?branch=main)](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)

# 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".

# Supported Technologies

| Type | Supported|
|------|----------|
|**Design Languages**| C, Verilog, SV, VHDL, Chisel, Migen/Amaranth, Bluespec
|**Simulation Tools**| Verilator, Icarus, GHDL, Xyce
|**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, gf180, asap7, freepdk45, gf12lp, gf22fdx, intel16

# Getting Started

SiliconCompiler is available as wheel packages on PyPI for macOS, Windows and
Linux platforms. For working Python 3.8-3.12 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/development_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}
}
```



# 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
