# PhotCodeXt

**Repository Path**: Photlab/phot-code-xt

## Basic Information

- **Project Name**: PhotCodeXt
- **Description**: 光纤通信仿真组件集成开发环境插件
- **Primary Language**: TypeScript
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-27
- **Last Updated**: 2025-12-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PhotCode

一个用于光学计算和光组件开发的 PhotCode 扩展，提供完整的 Python 开发工具链。

## 安装

1. 安装 PhotCode;
2. 在 `PhotCodeXT-1.0.1.vsix` 文件目录下运行：
   ```shell
   code --install-extension PhotCodeXT-1.0.1.vsix
   ```
3. 重启 PhotCode，点击左侧的 PhotCode 图标开始使用

## 主要功能

- 🚀 **一键创建 Python 工程** - 创建空白工程或基于 XML 模板
- 🐍 **Python 环境管理** - 自动检测和安装 Python 环境
- 📦 **依赖管理** - 自动安装科学计算包
- 🔬 **光组件开发** - 基于 XML 配置自动生成代码模板
- 🛠️ **完整工具链** - 从项目创建到代码测试的全流程支持

## 使用指南

### 快速开始

**方法一：创建空白工程**
1. 创建新的 Python 工程
2. 自动配置 Python 环境和依赖库
3. 开始编写您的光学计算代码

**方法二：基于 XML 模板**
1. 选择 XML 配置文件
2. 自动生成 Python 代码模板和项目结构
3. 在模板基础上开发光组件

## 如何使用该插件开发python代码

### 方法一：创建空白工程
1.  创建空白python工程。
2.  检查并配置本机python环境。
3.  自动安装底层运算库。
4.  在该工程文件中编写代码。
5.  调用底层运算库提供的接口，完善代码以及测试代码。

### 方法二：基于XML模板创建工程
1.  选择XML配置文件创建光组件工程。
2.  插件自动解析XML文件并生成Python代码模板。
3.  检查并配置本机python环境。
4.  自动安装底层运算库。
5.  在生成的代码模板基础上开发您的光组件。
6.  调用底层运算库提供的接口，完善代码以及测试代码。

如下：

`qam_modulate_v1.py`

```python
# qam_modulate_v1.py : 用户编写的光组件代码
def qam_modulate(bits, bits_per_symbol):
    """QAM 调制器"""
    print(f"输入比特序列长度: {len(bits)}")
    print(f"调制格式: {2**bits_per_symbol}QAM")
    return modulated_signal

# 测试代码
import phot
num_symbols = 2**16
bits_per_symbol = 4
bits = phot.gen_bits(num_symbols * bits_per_symbol)
result = qam_modulate(bits, bits_per_symbol)
```

## 核心特性

### 🔧 自动环境配置
- 一键安装科学计算库：`numpy`、`scipy`、`matplotlib`、`pandas`
- 内置光学计算库 `phot` 
- 支持深度学习框架：`torch`、`tensorflow`
- 自动生成 `requirements.txt` 依赖文件

### 📄 XML 模板工程
- 支持 VPI Photonics XML 格式
- 自动生成完整项目结构：
  - Python 类文件和配置文件
  - 项目文档和版本控制文件
- 智能代码模板生成

## 开发

```bash
# 克隆项目
git clone -b dev git@gitee.com:opticalab_1/PhotCodext.git
cd PhotCodeXT

# 安装依赖
npm run install:all

# 构建项目
npm run build:webview

# 在 VS Code 中打开项目
code .

# 按 F5 启动调试模式
```