Update README

Author: mental2008

README.md

@@ -36,7 +36,7 @@ $ bin/simon apply --extended-resources "gpu" \
 pip install -r requirements.txt
 ```
 
-1. Please refer to [README](data/README.md) under the `data` directory to prepare production traces
+1. Please refer to [README](data/README.md) under the `data` directory to prepare production traces.
 2. Then refer to [README](experiments/README.md) under the `experiments` directory to reproduce the results reported in the paper.
 
 ## 📝 Paper

data/README.md

@@ -1,13 +1,5 @@
 # Traces as Inputs for Simulator
 
-## 🚧 Environment Setup
-
-Install the required Python dependency environment.
-
-```bash
-$ pip install -r requirements.txt
-```
-
 ## 🛠 Usage
 
 Generate the YAML files needed for the simulation experiment based on the original CSV files.

experiments/README.md

@@ -7,14 +7,12 @@
 python run_scripts/generate_run_scripts.py > run_scripts/run_scripts_0511.sh
 ```
 
-Script parameters:
-- Date:
-- FileList:
-- PARALLEL: num vCPU / 2 (suggested)
-- NUM_REPEAT: repetited experiments (10 in paper)
-
 ### Execute
 
+`run_scripts_0511.sh` includes multiple executable commands that are executed sequentially by default.
+You can adjust the `--max-procs` parameter in the following command to modify the number of parallel threads based on the CPU resources available on your machine.
+It is recommended to configure the parallel thread pool size to **half the number of virtual CPUs available** (i.e., `# of vCPU / 2`).
+
 ```bash
 # pwd: kubernetes-scheduler-simulator/experiments
 cd ..
@@ -25,8 +23,9 @@ cat experiments/run_scripts/run_scripts_0511.sh | while read i; do printf "%q\n"
 ```
 
 ~~1 month later ...~~
-- 1 hour for 1 experiment on 2 vCPU.
-- 16 hours for 1020 experiments on a 256 vCPU machine with PARALLEL=128.
+
+- 10 minutes for 1 experiment on 2 vCPU.
+- Roughly 10 hours for 1020 experiments on a 256 vCPU machine with PARALLEL=128.
 
 ### Merge
 
@@ -42,6 +41,9 @@ bash bash_merge.sh
 
 ### Plot
 
+Automatically generate figures in the paper based on the analysis results and compare them with the results in the [expected_results](plot/expected_results) directory.
+For example, running `python plot_paib_alloc.py` will generate `paib_alloc.pdf` figure, which corresponds to Fig. 9(a) in the paper.
+
 ```bash
 # pwd: kubernetes-scheduler-simulator/experiments/analysis
 cd ..

experiments/plot/.gitignore

@@ -1 +1,2 @@
 *.csv
+*.pdf