# transientClassify

**Repository Path**: mseeworld/transient-classify

## Basic Information

- **Project Name**: transientClassify
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-10-05
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 瞬变源数据展示系统

这是一个基于Flask的Web应用，用于展示和分析瞬变源分类结果。
gweb的conda环境：transient-classify

## Docker部署

项目支持通过Docker进行容器化部署，包含以下特性：
- 自动启动瞬变源分类服务（定时查询新瞬变源进行分类）
- 同时启动Web服务器展示查询及分类结果
- 映射数据目录便于数据持久化

## 功能特性

1. **数据展示**：
   - 展示瞬变源列表和统计信息
   - 显示每个瞬变源的详细信息，包括图像和属性
   - 提供图像浏览功能

2. **分类功能**：
   - 显示自动分类结果
   - 支持人工分类标注
   - 保存人工分类结果到数据文件

3. **用户界面**：
   - 响应式设计，适配不同屏幕尺寸
   - 直观的数据展示和操作界面
   - 现代化的UI设计

## 安装和运行

### 直接运行

1. **安装依赖**：
   ```bash
   pip install -r requirements.txt
   pip install -r funs/requirements.txt
   ```

2. **启动应用**：
   ```bash
   python app.py
   ```

3. **访问应用**：
   在浏览器中打开 `http://127.0.0.1:5001`

### Docker部署

项目Dockerfile采用了优化的构建策略：
- 先复制依赖文件并安装依赖，再复制程序文件，以利用Docker的层缓存机制
- 使用.dockerignore文件排除数据目录和不必要的文件，减小镜像大小

1. **构建镜像**：
   ```bash
   docker build -t transient-classify .
   ```

2. **运行容器**：
   ```bash
   docker run -d -p 5001:5001 \
     -v ./data/datasets:/app/data/datasets \
     -v ./ot_classify_service/data:/app/ot_classify_service/data \
     --name transient-classify-service \
     transient-classify
   ```

   或使用docker-compose：
   ```bash
   docker-compose up -d
   ```

3. **访问应用**：
   在浏览器中打开 `http://127.0.0.1:5001`

## 项目结构

```
.
├── app.py                 # Flask应用主文件
├── requirements.txt       # 项目依赖
├── README.md             # 项目说明文档
├── templates/            # HTML模板文件
│   ├── base.html         # 基础模板
│   ├── index.html        # 首页模板
│   └── detail.html       # 详情页模板
├── static/               # 静态文件目录
├── data/                 # 数据目录
│   └── datasets/         # 数据集目录
└── funs/                 # 功能模块目录
```

## 使用说明

1. **首页**：
   - 显示所有瞬变源的统计信息
   - 展示各类别瞬变源的数量
   - 提供瞬变源列表，点击可查看详细信息

2. **详情页**：
   - 显示瞬变源的名称、坐标和分类结果
   - 展示瞬变源图像（610×200尺寸）
   - 显示观测图像、模板图像和残差图像的属性表格
   - 提供人工分类标注功能
   - 保存人工分类结果

## 数据文件

应用使用以下数据文件：
- `data/datasets/20251004_161049/transient_classify_rst.json`：瞬变源分类结果文件
- `data/datasets/20251004_161049/images/`：瞬变源图像目录

## 技术栈

- **后端**：Python, Flask
- **前端**：HTML, CSS, JavaScript, Bootstrap 5
- **数据格式**：JSON