chore: upgrade to uv for venv management

Author: root-hbx

.gitignore

@@ -2,3 +2,7 @@
 *.h5
 *.pyc
 __pycache__/
+
+# UV virtual environment
+.venv/
+uv.lock

.python-version

@@ -0,0 +1 @@
+3.10

README.md

@@ -21,38 +21,46 @@ Now, we have made a major upgrade to StarPerf, extending its usability and enric
 
 Compared with StarPerf 1.0, StarPerf 2.0 is fully implemented in Python and no longer depends on any third-party orbit analysis or computation tools. You only need to ensure that **Python 3.10** or above is installed on your system.
 
-You can install all required dependencies at once using the following commands:
+## Installation
+
+We recommend using [uv](https://github.com/astral-sh/uv), a fast Python package and project manager, to manage dependencies and virtual environments for this project.
+
+**Install uv:**
+
+MacOS/Linux:
+
+```bash
+# MacOS/Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+# Alternative for MacOS
+brew install uv
+```
+
+Windows:
+
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+For more installation options, please refer to [official uv documentation](https://docs.astral.sh/uv/getting-started/installation/).
+
+**Installing Dependencies:**
+
+Once you have cloned the repository, you can install all required dependencies using the following `uv` command:
 
 ```bash
-cd StarPerf_Simulator
-pip install -r requirements.txt
+cd StarPerf_Simulator/
+uv sync
 ```
 
-This will automatically install all necessary libraries to ensure the system runs properly. Specifically, we used the following packages to support the simulation: 
-
-- h3==4.0.0b2
-- h5py==3.10.0
-- numpy==1.24.4
-- openpyxl==3.1.2
-- importlib-metadata==6.8.0
-- skyfield==1.46
-- sgp4==2.22
-- pandas==2.1.0
-- poliastro==0.17.0
-- astropy==5.3.3
-- networkx==3.1
-- requests==2.31.0
-- jenkspy==0.4.0
-- pyecharts==2.0.4
-- global_land_mask==1.0.0
-- ephem==4.2
+This will automatically create a virtual environment and install all necessary libraries to ensure the system runs properly.
 
 # StarPerf overview and processing flow
 
 You can directly run our simulation example using the following command:
 
 ```bash
-python3 StarPerf.py
+uv run python StarPerf.py
 ```
 
 Of course, you can also write your own simulation scripts. For specific guidelines and important notes, please refer to [interface\_convention](./docs/interface_convention.pdf).

pyproject.toml

@@ -0,0 +1,33 @@
+[project]
+name = "starperf"
+version = "2.0.0"
+description = "A Network Performance Simulator for Emerging Mega-Constellations"
+authors = [
+    { name = "StarPerf Team", email = "zeqilai@tsinghua.edu.cn" }
+]
+readme = "README.md"
+license = { text = "BSD-2-Clause" }
+requires-python = ">=3.10"
+dependencies = [
+    "h3==4.0.0b2",
+    "h5py==3.10.0",
+    "numpy==1.24.4",
+    "openpyxl==3.1.2",
+    "importlib-metadata==6.8.0",
+    "skyfield==1.46",
+    "sgp4==2.22",
+    "pandas==2.1.0",
+    "poliastro==0.17.0",
+    "astropy==5.3.3",
+    "networkx==3.1",
+    "requests==2.31.0",
+    "jenkspy==0.4.0",
+    "pyecharts==2.0.4",
+    "global-land-mask==1.0.0",
+    "ephem==4.2",
+    "ruptures==1.1.10",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"