# sinoshop-energy

**Repository Path**: sinoshop/sinoshop-energy

## Basic Information

- **Project Name**: sinoshop-energy
- **Description**: SINOSHOP 星系｜智慧海洋能源基础设施技术基座 —— 多能源协同仿真引擎、30 米模块化接口规范与 TENG 硬件参考设计。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-14
- **Last Updated**: 2026-11-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<!-- SINOSHOP SYSTEM STRIP:BEGIN -->
<table align="center">
<tr>
<td><b>🌊 SINOSHOP 星系</b></td>
<td><a href="https://gitee.com/sinoshop/sinoshop-hub">星系导航</a></td>
<td><a href="https://sinoshop-open.github.io/webpage/">官网</a></td>
<td><a href="https://sinoshop-open.github.io/webpage/docs/evidence/index.html">验证证据</a></td>
<td><a href="https://sinoshop-open.github.io/webpage/docs/datasets/index.html">数据集总览</a></td>
<td><a href="https://sinoshop-open.github.io/webpage/whitepaper.html">技术白皮书</a></td>
</tr>
</table>
<!-- SINOSHOP SYSTEM STRIP:END -->
# SINOSHOP Energy / 智慧海洋能源基础设施

[![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/)
[![Streamlit](https://img.shields.io/badge/Streamlit-1.28+-red.svg)](https://streamlit.io/)

**sinoshop-energy** 是全球首个面向智慧海洋能源基础设施的模块化技术基座。

---

## 核心开源内容

- 🌊 **多能源系统协同仿真引擎**：洋流涡轮 + 波浪发电 + TENG 联合建模
- 📐 **30米标准化模块接口规范**：造船业可复用设计蓝图
- ⚙️ **TENG 硬件参考设计**：可自由制造、修改
- 🖥️ **在线交互式仿真沙盒**：浏览器中体验系统特性

## 快速开始

```bash
# 1. 克隆仓库
git clone https://gitee.com/sinoshop/sinoshop-energy.git
cd sinoshop-energy

# 2. 安装依赖
pip install -r requirements.txt

# 3. 启动仿真沙盒
streamlit run sandbox/web/app.py

# 4. 浏览器打开 http://localhost:8501
许可证
代码部分：Apache-2.0

硬件设计：CERN-OHL-P-2.0

参与贡献
欢迎提交 Issue 和 Pull Request！

Fork 本仓库

创建特性分支

提交更改 (git commit -s -m 'feat: add feature')

发起 Pull Request

text

5. 保存文件（Ctrl+S）并关闭记事本

---

#### 2. 创建 .gitignore

同样方法，在 `sinoshop-energy` 文件夹中：

1. 右键 → **新建** → **文本文档**
2. 重命名为 `.gitignore`（注意开头有个点）
3. 用记事本打开，粘贴以下内容：
Python
pycache/
*.pyc
*.pyo
*.pyd
.Python
env/
venv/
.venv/
pip-log.txt
pip-delete-this-directory.txt
.pytest_cache/
.coverage
*.cover

IDE
.vscode/
.idea/
*.swp
*.swo

OS
.DS_Store
Thumbs.db

Data
*.csv
.xlsx
!sample_.csv

Logs
*.log

Streamlit
.streamlit/

text

4. 保存并关闭

---

#### 3. 创建 requirements.txt

1. 右键 → **新建** → **文本文档**
2. 重命名为 `requirements.txt`
3. 用记事本打开，粘贴以下内容：
streamlit>=1.28.0
pandas>=2.0.0
numpy>=1.24.0
matplotlib>=3.7.0
plotly>=5.14.0
scikit-learn>=1.3.0

text

4. 保存并关闭

---

#### 4. 创建 LICENSE 文件

1. 打开浏览器，访问：https://www.apache.org/licenses/LICENSE-2.0.txt
2. 按 `Ctrl+A` 全选，`Ctrl+C` 复制
3. 在 `sinoshop-energy` 文件夹中新建文本文档，重命名为 `LICENSE`
4. 粘贴内容，保存

---

#### 5. 创建目录和 Python 文件

在 `sinoshop-energy` 文件夹中：

**创建目录：**
- `algorithms`
- `algorithms\energy_sources`
- `algorithms\dispatch`
- `hardware`
- `hardware\teng_hinge_module`
- `hardware\pcb`
- `sandbox`
- `sandbox\web`
- `simulation`
- `docs`
- `datasets`

**创建空文件：**
- `algorithms\__init__.py`（空文件）
- `algorithms\energy_sources\__init__.py`（空文件）
- `algorithms\dispatch\__init__.py`（空文件）

---

#### 6. 创建调度算法文件

在 `algorithms\dispatch` 文件夹中，新建 `tri_energy_dispatch.py`，粘贴以下内容：

```python
"""
多能融合调度算法
"""

class TriEnergyDispatch:
    def __init__(self):
        self.modes = ['ocean_cruise', 'nearshore_surge', 'polar_ice']

    def dispatch(self, load_mw=50.0, sea_state=None, storage_soc=80.0):
        """
        根据负载、海况和储能状态分配各能源出力
        
        Args:
            load_mw: 当前负载 (MW)
            sea_state: 海况参数 {'sig_wave_height': float, 'ice_cover': float}
            storage_soc: 储能系统荷电状态 (%)
        
        Returns:
            dict: 各能源功率分配
            str: 运行模式
        """
        if sea_state is None:
            sea_state = {'sig_wave_height': 2.0, 'ice_cover': 0.0}

        # 简化调度逻辑
        if sea_state['sig_wave_height'] > 3.0:
            mode = 'nearshore_surge'
            p_ref = {'turbine': 20.0, 'wave': 25.0, 'teng': 5.0}
        elif sea_state['ice_cover'] > 30.0:
            mode = 'polar_ice'
            p_ref = {'turbine': 35.0, 'wave': 10.0, 'teng': 5.0}
        else:
            mode = 'ocean_cruise'
            p_ref = {'turbine': 35.0, 'wave': 10.0, 'teng': 5.0}

        return p_ref, mode

## 许可证

- 代码部分：Apache-2.0
- 硬件设计：CERN-OHL-P-2.0

## 参与贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支
3. 提交更改 (`git commit -s -m 'feat: add feature'`)
4. 发起 Pull Request

---

## 📬 联系方式

🌊 **SINOSHOP** — 自浮式智能海洋城市运营平台  
基于悬浮隧道（SFT）核心技术，构建自浮式·智能·网络化·海洋城市·运营平台。

🏠 **项目主页**：[https://sinoshop-open.github.io/webpage/](https://sinoshop-open.github.io/webpage/)  
📂 **开源仓库**：[https://gitee.com/sinoshop/sinoshop-os](https://gitee.com/sinoshop/sinoshop-os)  
- **GitHub 国际镜像**：[SINOSHOP-OPEN](https://github.com/SINOSHOP-OPEN)
📧 **联系邮箱**：standards@sinoshop.org

> 🌊观天之道，执天之行，造福人民。  
> 🌊 **海生电、电养船、船搭桥、桥造城、城惠民、航天海、众生安。**
> ✨ **贞忠昭日月，惠民播春秋。**

---