Moving Python example to top of README.
The Python interface is the architecture, sc is an app.
@@ -15,16 +15,36 @@ SiliconCompiler is an open source compiler framework that aims to enable automat
- **RFCs:** https://github.com/siliconcompiler/rfcs
- **Disussion:** https://github.com/siliconcompiler/siliconcompiler/discussions
-## Command Line Interface
-SiliconCompiler supports a simple command line interface 'sc' and an advanced
-Python API. Both models offer full access to 300+ standardized compiler
-schema parameters. For a complete set of parameters, functions, and examples
-read the [DOCUMENTATION](https://docs.siliconcompiler.com)!
+## Programming Interface
+The SiliconCompiler project is based on an expansive compilation configuration
+[SCHEMA](https://docs.siliconcompiler.com/reference_manual/schema.html) and a
+simple [PYTHON API](https://docs.siliconcompiler.com/reference_manual/schema.html).
+The Python interface enables sophisticated compilation flows that leverage the
+full power of the Python programming language and package platform.
+
+```python
+
+import siliconcompiler # import python package
+chip = siliconcompiler.Chip() # create chip object
+chip.set('source', 'heartbeat.v') # define list of sources
+chip.set('design', 'heartbeat') # set top module name
+chip.clock(name='clk', pin='clk', period=1.0) # define a clock
+chip.target('asicflow_freepdk45') # load pre-defined flow
+chip.run() # run compilation
+chip.summary() # print run summary
+chip.show() # show layout
+
+```
+## Command Line Interface
+To simplify the on-ramp and to maximize experimentation productivity, the
+SiliconCompiler project includes a command line program 'sc', with full
+support for all compiler schema parameters.
#### Hello world
+
For very simple designs, compiling using *sc* is as easy as using gcc or llvm.
```bash
@@ -32,17 +52,6 @@ pip install siliconcompiler
sc hello.v
```
-#### Remote Compilation
-
-To simplify tool installation and job scheduling, SiliconCompiler supports a
-"-remote" option, which directs the compiler to send all steps to a remote
-server for processing. The -remote option relies on a credentials file located at
-~/.sc/credentials on Linux or macOS, or at C:\Users\USERNAME\\.sc\credentials on Windows.
-
-```bash
-sc hello.v -remote
-```
-
#### Complex design
More complex designs are handled by adding more options. For
scenarios with more than five command line options, the SiliconCompiler
@@ -53,25 +62,15 @@ sc hello.v add.v -constraint hello.sdc -target "asicflow_skywater130"
```
-## Python Interface
-The SiliconCompiler
-[PYTHON API]((https://docs.siliconcompiler.com/reference_manual/schema.html) is
-a abstraction layer that sits on top of the compilation configuration
-[SCHEMA](https://docs.siliconcompiler.com/reference_manual/schema.html). The Python interface enables sophisticated design compilations that leverage the
-full power of the Python programming language and package platform.
+## Remote Compilation
-```python
-
-import siliconcompiler # import python package
-chip = siliconcompiler.Chip() # create chip object
-chip.set('source', 'heartbeat.v') # define list of sources
-chip.set('design', 'heartbeat') # set top module name
-chip.clock(name='clk', pin='clk', period=1.0) # define a clock
-chip.target('asicflow_freepdk45') # load pre-defined flow
-chip.run() # run compilation
-chip.summary() # print run summary
-chip.show() # show layout
+To simplify tool installation and job scheduling, SiliconCompiler also supports a
+"-remote" option, which directs the compiler to send all steps to a remote
+server for processing. The -remote option relies on a credentials file located at
+~/.sc/credentials on Linux or macOS, or at C:\Users\USERNAME\\.sc\credentials on Windows.
+```bash
+sc hello.v -remote
```
## Installation
