From fe29652d7d026b0794ab00f6defcd1d38349928c Mon Sep 17 00:00:00 2001 From: Eryk Szpotanski Date: Mon, 21 Oct 2024 14:52:03 +0200 Subject: [PATCH] docs: user: Update installation and running commands for AutoTuner Signed-off-by: Eryk Szpotanski --- docs/user/InstructionsForAutoTuner.md | 26 ++++++++++++-------------- 1 file changed, 12 insertions(+), 14 deletions(-) diff --git a/docs/user/InstructionsForAutoTuner.md b/docs/user/InstructionsForAutoTuner.md index 0344379a06..b3bf6826ab 100644 --- a/docs/user/InstructionsForAutoTuner.md +++ b/docs/user/InstructionsForAutoTuner.md @@ -27,10 +27,6 @@ We have provided two convenience scripts, `./installer.sh` and `./setup.sh` that works in Python3.8 for installation and configuration of AutoTuner, as shown below: -```{note} -Make sure you run the following commands in the ORFS root directory. -``` - ```shell # Install prerequisites ./tools/AutoTuner/installer.sh @@ -104,7 +100,7 @@ For Global Routing parameters that are set on `fastroute.tcl` you can use: ### General Information -The `distributed.py` script located in `./tools/AutoTuner/src/autotuner` uses [Ray's](https://docs.ray.io/en/latest/index.html) job scheduling and management to +The `autotuner.distributed` module uses [Ray's](https://docs.ray.io/en/latest/index.html) job scheduling and management to fully utilize available hardware resources from a single server configuration, on-premise or over the cloud with multiple CPUs. @@ -115,35 +111,37 @@ The two modes of operation: The `sweep` mode is useful when we want to isolate or test a single or very few parameters. On the other hand, `tune` is more suitable for finding the best combination of a complex and large number of flow -parameters. Both modes rely on user-specified search space that is -defined by a `.json` file, they use the same syntax and format, -though some features may not be available for sweeping. +parameters. ```{note} The order of the parameters matter. Arguments `--design`, `--platform` and `--config` are always required and should precede *mode*. ``` +```{note} +The following commands should be run from `./tools/AutoTuner`. +``` + #### Tune only -* AutoTuner: `python3 distributed.py tune -h` +* AutoTuner: `python3 -m autotuner.distributed tune -h` Example: ```shell -python3 distributed.py --design gcd --platform sky130hd \ - --config ../../../../flow/designs/sky130hd/gcd/autotuner.json \ +python3 -m autotuner.distributed --design gcd --platform sky130hd \ + --config ../../flow/designs/sky130hd/gcd/autotuner.json \ tune --samples 5 ``` #### Sweep only -* Parameter sweeping: `python3 distributed.py sweep -h` +* Parameter sweeping: `python3 -m autotuner.distributed sweep -h` Example: ```shell -python3 distributed.py --design gcd --platform sky130hd \ - --config distributed-sweep-example.json \ +python3 -m autotuner.distributed --design gcd --platform sky130hd \ + --config src/autotuner/distributed-sweep-example.json \ sweep ```