# pysagin

**Repository Path**: WangXi_Chn/pysagin

## Basic Information

- **Project Name**: pysagin
- **Description**: 基于Python的空天地一体化网络场景构建器
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-27
- **Last Updated**: 2025-07-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PySAGIN 介绍

基于Python的空天地一体化网络场景构建器

## 安装指南

本项目依赖于**Python3.10**及以上版本，请确保您的机器上已安装。

首先，克隆本项目仓库：

```bash
git clone https://gitee.com/WangXi_Chn/pysagin.git
```

然后使用setup.py文件安装相关依赖库（建议使用虚拟环境以及-e选项进行开发者模式安装）：

```bash
pip install -e .
```

完成以上步骤后，您就可以开始探索PySAGIN的功能了。

## 开始使用

PySAGIN的主要功能是构建空天地一体化网络场景，包括平台节点、链路、设备等。

### 运行基本示例

#### 绘制场景

进入pysagin/examples/drawgif/目录并执行如下命令以启动一个场景绘制示例：

```bash
python main_drawgif.py
```

可生成场景的gif文件以显示各个平台和链路运动过程

#### 导出数据

进入pysagin/examples/writejson/目录并执行如下命令以启动一个场景数据导出示例：

```bash
python main_writejson.py
```

可生成一个包含全部json文件的场景数据文件夹data，在该文件夹下存放着以时间戳命名的json文件，每个文件包含了场景中各个平台之间的连接关系信息，可运行 data_read.py 脚本可读取这些json文件并提取SAGIN网络的拓扑信息组成邻接矩阵绘制灰度图，存放于 figs 文件夹下

```bash
python data_read.py
```

#### 可用于MiniSFC的SAGIN场景示例

Mini-SFC 是一个针对服务功能链(SFC)编排算法设计的仿真框架，该框架同时支持基于离散事件构建的纯数值仿真和基于真实时间的容器模拟仿真，特别适用于研究基于MANO架构的SFC部署与迁移问题。关于MiniSFC的更多信息，请访问[MiniSFC说明文档](https://wangxichn.github.io/mini_sfc/)。其中MiniSFC的空天地一体化网络拓扑下的数值仿真示例需要来自外部的网络拓扑数据，即可通过PySAGIN进行构建。

进入pysagin/examples/zhengzhou/目录并执行如下命令以启动一个与MiniSFC SAGIN示例相关的场景构建示例：

```bash
python main_zhengzhou_data.py
```

可生成一个包含全部json文件的场景数据文件夹data，在该文件夹下存放着以时间戳命名的json文件，每个文件包含了场景中各个平台之间的连接关系信息，可运行 data_read.py 脚本可读取这些json文件并提取SAGIN网络的拓扑信息组成邻接矩阵绘制灰度图，存放于 figs 文件夹下

如果想通过GIF动画展示场景的运动过程，可运行 main_zhengzhou_gif.py 脚本：

```bash
python main_zhengzhou_gif.py
```

可生成一个包含场景运动过程的gif文件 SAGIN.gif