ep-sdk-4pd 0.1.2__tar.gz → 0.1.3__tar.gz

ep_sdk_4pd-0.1.3/PKG-INFO

@@ -0,0 +1,225 @@
+Metadata-Version: 2.1
+Name: ep_sdk_4pd
+Version: 0.1.3
+Summary: 4paradigm Electricity Platform Service SDK Library for Python
+Home-page: https://gitlab.4pd.io/electricityproject/electricity-platform-sdk
+Author: 4paradigm Electricity Platform SDK
+Author-email: 
+Keywords: 4pd_electricity_platform
+Platform: any
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Software Development
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+
+# SDK 帮助文档
+
+本说明文档旨在指导策略开发者如何使用平台提供的远程 SDK 仓库 `ep-sdk-4pd`，完成特征数据获取、模型开发与调试流程。
+
+> ⚠️ ep-sdk-4pd SDK是平台为策略开发者提供的本地数据访问工具，用于访问结构化的示例数据，模拟真实环境中的策略开发流程。SDK 会自动识别运行环境，在本地开发时返回脱敏示例数据，结构与线上一致；在正式部署时连接真实数据库。
+
+## 一、SDK 安装方式
+
+SDK 已托管于远程私有仓库，用户可通过以下命令在本地完成安装：
+
+```bash
+pip install ep-sdk-4pd
+```
+
+安装成功后，策略脚本中可直接引入 SDK 提供的功能模块。
+
+## 二、模块导入方式
+
+平台策略执行环境中已预置 SDK 包 `ep-sdk-4pd`，用户在本地开发时可通过如下方式导入核心方法：
+
+```python
+from ep_sdk_4pd.ep_system import EpSystem
+from ep_sdk_4pd.ep_data import EpData
+```
+
+## 三、系统环境接口（EpSystem）
+
+系统接口统一封装于 `EpSystem` 类中，主要用于策略运行环境感知和训练/预测流程控制。
+
+### 3.1 模型输出路径：`EpSystem.model_output_dir()`
+
+- **定义**：获取模型输出目录路径
+
+- **线上环境返回**：`/home/{user}/strategyId/`
+
+- **本地调试返回**：`/home/{user}/test/`
+
+### 3.2 获取系统时间：`EpSystem.get_system_date()`
+
+- **定义**：获取平台运行时系统时间，作为训练或预测数据的参考时间基准。用户不可自定义修改。
+
+- **本地调试返回**：固定测试值，如 `"2024-12-31"`
+
+- **线上运行返回**：随运行时间变化，如 `"2025-04-01"`
+
+### 3.3 获取运行策略信息：`EpSystem.get_run_strategy()`
+
+- **定义**：获取当前正在运行的策略上下文信息
+
+- **返回示例（测试环境）**：
+
+```python
+{
+  "id": 1,
+  "name": "空仓策略",
+  "description": "不参考任何信息，96节点全部报0",
+  "plant": "test站点",
+  "countyCode": 1000100
+}
+```
+
+### 3.4 训练完成通知：`EpSystem.call_train_done()`
+
+- **定义**：用于回调通知平台当前策略训练已完成。
+
+- **默认行为**：调用时会自动读取当前运行策略 ID，用户无需传参。
+
+- **返回值**：`True`（成功）或 `False`（失败）
+
+
+
+## 四、特征数据接口（EpData）
+
+数据接口封装于 `EpData` 类中，用于获取结构化输入数据，包括天气、市场、电厂等特征。数据按系统时间校验，不可穿越未来。
+
+### 4.1 数据获取规则
+
+- 可获取数据时间段为：`2024-01-01 ~ 2024-12-31`
+
+- 推理模拟从 `2025-01-01` 开始顺序执行
+
+### 4.2 获取历史数据：`EpData.get_history_data(scope: List[str], days: int)`
+
+- **定义**：获取当前系统时间向前指定天数的数据（最晚支持到 D-2）
+
+- **参数说明：**
+
+  - `scope`：选择数据模块，支持 `["weather", "plant", "market"]`
+
+  - `days`：获取当前系统时间前 N 天的数据
+
+- **示例调用：**
+
+```python
+from ep_sdk_4pd.ep_data import EpData
+
+# 获取全量的历史特征
+data = EpData.get_history_data(days=7)
+# 获取天气的历史特征
+weather_data = EpData.get_history_data(scope=["weather"], days=7)
+```
+
+- **返回格式：**
+
+```python
+data = {
+    "weather": pd.DataFrame(...),
+    "plant": pd.DataFrame(...),
+    "market": pd.DataFrame(...)
+}
+weather_data = {
+    "weather": pd.DataFrame(...)
+}
+```
+
+- **字段详解：**
+
+  - `market`：聚合电力交易市场相关信息，如价格、电量、调度负荷、联络线、新能源出力等
+
+  - `plant`：聚合特定发电场站相关运行指标，站点电价、电量等
+
+  - `weather`：聚合天气相关数据，如天气实况、未来预报、气象背景等
+
+- 更多字段说明，请参考平台对应的「数据字典文档」。
+
+### 4.3 获取预测数据：`EpData.get_predict_data(scope: List[str])`
+
+- **定义**：获取当前系统时间的预测数据（最晚为 D-1）
+
+- **参数说明：**
+
+  - `scope`：可选数据范围，与 `get_history_data` 相同
+
+- **示例调用：**
+
+```python
+from ep_sdk_4pd.ep_data import EpData
+
+# 获取市场和天气的预测特征
+data = EpData.get_predict_data(scope=["market", "weather"])
+```
+
+- **返回格式：**
+
+```python
+data = {
+    "weather": pd.DataFrame(...),
+    "market": pd.DataFrame(...)
+}
+```
+
+## 五、环境适配说明
+
+- 本地调试环境下，SDK 返回脱敏示例数据，用于验证模型逻辑与调试开发流程。
+
+- 部署上线后，SDK 自动连接真实数据库，返回真实交易场景中的数据。
+
+- 开发者无需修改代码逻辑，环境判断与数据源切换由 SDK 内部自动处理。
+
+## 六、常见问题 FAQ
+
+### Q1：如何确定当前系统时间？
+
+可通过 `EpSystem.get_system_date()` 获取，格式为 `YYYY-MM-DD`。
+
+### Q2：为什么我的数据不包含最新日期？
+
+`get_history_data` 返回最晚到系统时间的 D-2 日数据，`get_predict_data` 返回系统时间的 D-1 日预测数据。
+
+### Q3：模型训练完成后如何保存模型？
+
+平台会在运行策略时创建独立的模型输出目录（通过 `EpSystem.model_output_dir()` 获取），用于保存用户的模型对象或其他中间结果。
+
+建议使用常见的 Python 序列化方案保存模型，如：
+
+**方式一：pickle 序列化（推荐用于简单对象）**
+
+```Python
+import pickle
+from ep_sdk_4pd.ep_system import EpSystem
+
+out_dict = {"price_model": model1, "power_model": model2}
+with open(f"{EpSystem.model_output_dir()}/model.pickle", "wb") as f:
+    pickle.dump(out_dict, f)
+```
+
+**方式二：joblib 序列化（推荐用于大型模型）**
+
+```Python
+from joblib import dump
+from ep_sdk_4pd.ep_system import EpSystem
+
+model_path = f"{EpSystem.model_output_dir()}/model.joblib"
+dump(your_model, model_path)
+```
+
+**方式三：自定义格式存储（如 JSON/CSV/HDF5 等）** 对于不适合直接 pickle 的模型（如深度学习框架模型、含依赖项对象），也可通过保存权重、参数配置等方式进行落盘。
+
+### Q4：如何判断当前策略运行上下文？
+
+通过 `EpSystem.get_run_strategy()` 可获取策略 ID、配置等元信息，便于调试和日志输出。
+
+如需获取最新数据字段说明、SDK 更新日志或接口文档，请前往平台「数据文档中心」或联系管理员。

ep_sdk_4pd-0.1.3/README.md

@@ -0,0 +1,203 @@
+# SDK 帮助文档
+
+本说明文档旨在指导策略开发者如何使用平台提供的远程 SDK 仓库 `ep-sdk-4pd`，完成特征数据获取、模型开发与调试流程。
+
+> ⚠️ ep-sdk-4pd SDK是平台为策略开发者提供的本地数据访问工具，用于访问结构化的示例数据，模拟真实环境中的策略开发流程。SDK 会自动识别运行环境，在本地开发时返回脱敏示例数据，结构与线上一致；在正式部署时连接真实数据库。
+
+## 一、SDK 安装方式
+
+SDK 已托管于远程私有仓库，用户可通过以下命令在本地完成安装：
+
+```bash
+pip install ep-sdk-4pd
+```
+
+安装成功后，策略脚本中可直接引入 SDK 提供的功能模块。
+
+## 二、模块导入方式
+
+平台策略执行环境中已预置 SDK 包 `ep-sdk-4pd`，用户在本地开发时可通过如下方式导入核心方法：
+
+```python
+from ep_sdk_4pd.ep_system import EpSystem
+from ep_sdk_4pd.ep_data import EpData
+```
+
+## 三、系统环境接口（EpSystem）
+
+系统接口统一封装于 `EpSystem` 类中，主要用于策略运行环境感知和训练/预测流程控制。
+
+### 3.1 模型输出路径：`EpSystem.model_output_dir()`
+
+- **定义**：获取模型输出目录路径
+
+- **线上环境返回**：`/home/{user}/strategyId/`
+
+- **本地调试返回**：`/home/{user}/test/`
+
+### 3.2 获取系统时间：`EpSystem.get_system_date()`
+
+- **定义**：获取平台运行时系统时间，作为训练或预测数据的参考时间基准。用户不可自定义修改。
+
+- **本地调试返回**：固定测试值，如 `"2024-12-31"`
+
+- **线上运行返回**：随运行时间变化，如 `"2025-04-01"`
+
+### 3.3 获取运行策略信息：`EpSystem.get_run_strategy()`
+
+- **定义**：获取当前正在运行的策略上下文信息
+
+- **返回示例（测试环境）**：
+
+```python
+{
+  "id": 1,
+  "name": "空仓策略",
+  "description": "不参考任何信息，96节点全部报0",
+  "plant": "test站点",
+  "countyCode": 1000100
+}
+```
+
+### 3.4 训练完成通知：`EpSystem.call_train_done()`
+
+- **定义**：用于回调通知平台当前策略训练已完成。
+
+- **默认行为**：调用时会自动读取当前运行策略 ID，用户无需传参。
+
+- **返回值**：`True`（成功）或 `False`（失败）
+
+
+
+## 四、特征数据接口（EpData）
+
+数据接口封装于 `EpData` 类中，用于获取结构化输入数据，包括天气、市场、电厂等特征。数据按系统时间校验，不可穿越未来。
+
+### 4.1 数据获取规则
+
+- 可获取数据时间段为：`2024-01-01 ~ 2024-12-31`
+
+- 推理模拟从 `2025-01-01` 开始顺序执行
+
+### 4.2 获取历史数据：`EpData.get_history_data(scope: List[str], days: int)`
+
+- **定义**：获取当前系统时间向前指定天数的数据（最晚支持到 D-2）
+
+- **参数说明：**
+
+  - `scope`：选择数据模块，支持 `["weather", "plant", "market"]`
+
+  - `days`：获取当前系统时间前 N 天的数据
+
+- **示例调用：**
+
+```python
+from ep_sdk_4pd.ep_data import EpData
+
+# 获取全量的历史特征
+data = EpData.get_history_data(days=7)
+# 获取天气的历史特征
+weather_data = EpData.get_history_data(scope=["weather"], days=7)
+```
+
+- **返回格式：**
+
+```python
+data = {
+    "weather": pd.DataFrame(...),
+    "plant": pd.DataFrame(...),
+    "market": pd.DataFrame(...)
+}
+weather_data = {
+    "weather": pd.DataFrame(...)
+}
+```
+
+- **字段详解：**
+
+  - `market`：聚合电力交易市场相关信息，如价格、电量、调度负荷、联络线、新能源出力等
+
+  - `plant`：聚合特定发电场站相关运行指标，站点电价、电量等
+
+  - `weather`：聚合天气相关数据，如天气实况、未来预报、气象背景等
+
+- 更多字段说明，请参考平台对应的「数据字典文档」。
+
+### 4.3 获取预测数据：`EpData.get_predict_data(scope: List[str])`
+
+- **定义**：获取当前系统时间的预测数据（最晚为 D-1）
+
+- **参数说明：**
+
+  - `scope`：可选数据范围，与 `get_history_data` 相同
+
+- **示例调用：**
+
+```python
+from ep_sdk_4pd.ep_data import EpData
+
+# 获取市场和天气的预测特征
+data = EpData.get_predict_data(scope=["market", "weather"])
+```
+
+- **返回格式：**
+
+```python
+data = {
+    "weather": pd.DataFrame(...),
+    "market": pd.DataFrame(...)
+}
+```
+
+## 五、环境适配说明
+
+- 本地调试环境下，SDK 返回脱敏示例数据，用于验证模型逻辑与调试开发流程。
+
+- 部署上线后，SDK 自动连接真实数据库，返回真实交易场景中的数据。
+
+- 开发者无需修改代码逻辑，环境判断与数据源切换由 SDK 内部自动处理。
+
+## 六、常见问题 FAQ
+
+### Q1：如何确定当前系统时间？
+
+可通过 `EpSystem.get_system_date()` 获取，格式为 `YYYY-MM-DD`。
+
+### Q2：为什么我的数据不包含最新日期？
+
+`get_history_data` 返回最晚到系统时间的 D-2 日数据，`get_predict_data` 返回系统时间的 D-1 日预测数据。
+
+### Q3：模型训练完成后如何保存模型？
+
+平台会在运行策略时创建独立的模型输出目录（通过 `EpSystem.model_output_dir()` 获取），用于保存用户的模型对象或其他中间结果。
+
+建议使用常见的 Python 序列化方案保存模型，如：
+
+**方式一：pickle 序列化（推荐用于简单对象）**
+
+```Python
+import pickle
+from ep_sdk_4pd.ep_system import EpSystem
+
+out_dict = {"price_model": model1, "power_model": model2}
+with open(f"{EpSystem.model_output_dir()}/model.pickle", "wb") as f:
+    pickle.dump(out_dict, f)
+```
+
+**方式二：joblib 序列化（推荐用于大型模型）**
+
+```Python
+from joblib import dump
+from ep_sdk_4pd.ep_system import EpSystem
+
+model_path = f"{EpSystem.model_output_dir()}/model.joblib"
+dump(your_model, model_path)
+```
+
+**方式三：自定义格式存储（如 JSON/CSV/HDF5 等）** 对于不适合直接 pickle 的模型（如深度学习框架模型、含依赖项对象），也可通过保存权重、参数配置等方式进行落盘。
+
+### Q4：如何判断当前策略运行上下文？
+
+通过 `EpSystem.get_run_strategy()` 可获取策略 ID、配置等元信息，便于调试和日志输出。
+
+如需获取最新数据字段说明、SDK 更新日志或接口文档，请前往平台「数据文档中心」或联系管理员。

ep_sdk_4pd-0.1.3/ep_sdk_4pd/__init__.py

@@ -0,0 +1 @@
+__version__ = '0.1.3'

{ep_sdk_4pd-0.1.2 → ep_sdk_4pd-0.1.3}/ep_sdk_4pd/ep_data.py

@@ -1,25 +1,31 @@
 import json
+from datetime import timedelta, datetime
 
 import requests
 
 from ep_sdk_4pd import models as ep_sdk_4pd_models
+from ep_sdk_4pd.ep_system import EpSystem
 from ep_sdk_4pd.models import HistoryDataRequest, PredictDataRequest
 
 # test 地址
-endpoint = 'http://172.27.88.56:6001'
+# endpoint = 'http://172.27.88.56:6001'
 
 
 # prod 地址
-# endpoint = 'http://82.157.231.254:6001'
+endpoint = 'http://82.157.231.254:6001'
 
 class EpData:
 
     @staticmethod
     def get_history_data(
-            scope,
-            system_date,
-            days
+            scope = None,
+            days = 0
     ):
+        # 最晚时间为系统时间 D-2
+        date_str = EpSystem.get_system_date(is_online=True)
+        calculated_date = datetime.strptime(date_str, "%Y-%m-%d") - timedelta(days=2)
+        system_date = calculated_date.strftime("%Y-%m-%d")  # 转换回字符串
+
         request = HistoryDataRequest(
             scope=scope,
             system_date=system_date,
@@ -64,9 +70,13 @@ class EpData:
 
     @staticmethod
     def get_predict_data(
-            scope,
-            system_date
+            scope
     ):
+        # 最晚时间为系统时间 D-1
+        date_str = EpSystem.get_system_date(is_online=True)
+        calculated_date = datetime.strptime(date_str, "%Y-%m-%d") - timedelta(days=1)
+        system_date = calculated_date.strftime("%Y-%m-%d")  # 转换回字符串
+
         request = PredictDataRequest(
             scope=scope,
             system_date=system_date,

{ep_sdk_4pd-0.1.2 → ep_sdk_4pd-0.1.3}/ep_sdk_4pd/ep_system.py

@@ -7,14 +7,14 @@ import requests
 from ep_sdk_4pd import models as ep_sdk_4pd_models
 from datetime import datetime
 
-from ep_sdk_4pd.models import ModelOutputDirRequest, RunStrategyRequest
+from ep_sdk_4pd.models import ModelOutputDirRequest, RunStrategyRequest, CallTrainDoneRequest
 
 # test 地址
-endpoint = 'http://172.27.88.56:6001'
+# endpoint = 'http://172.27.88.56:6001'
 
 
 # prod 地址
-# endpoint = 'http://82.157.231.254:6001'
+endpoint = 'http://82.157.231.254:6001'
 
 class EpSystem:
 
@@ -118,4 +118,38 @@ class EpSystem:
         if response.code == 200:
             return response.data
         else:
-            return None
+            return None
+
+    @staticmethod
+    def call_train_done(strategy_id: int = None):
+        if strategy_id is None:
+            return False
+
+        request = CallTrainDoneRequest(strategy_id=strategy_id)
+        full_url = f'{endpoint}{request.api}'
+        headers = {
+            'content-type': request.content_type,
+        }
+
+        payload = {
+            'strategy_id': request.strategy_id
+        }
+
+        response = requests.request(
+            method=request.method,
+            url=full_url,
+            headers=headers,
+            data=json.dumps(payload),
+        )
+
+        base_resp = ep_sdk_4pd_models.BaseResponse(
+            code=response.json().get('code', None),
+            data=response.json().get('data', None),
+            message=response.json().get('message', None),
+        )
+        response = ep_sdk_4pd_models.CallTrainDoneResponse(response=base_resp)
+
+        if response.code == 200:
+            return True
+        else:
+            return False

{ep_sdk_4pd-0.1.2 → ep_sdk_4pd-0.1.3}/ep_sdk_4pd/models.py

@@ -162,6 +162,40 @@ class RunStrategyResponse(BaseResponse):
     Model for RunStrategyResponse
     """
 
+    def __init__(self, response: BaseResponse = None, **kwargs):
+        super().__init__(
+            code=response.code if response else None,
+            data=response.data if response else None,
+            message=response.message if response else None,
+            **kwargs,
+        )
+
+class CallTrainDoneRequest(BaseRequest):
+    """
+    Model for CallTrainDoneRequest
+
+    回调设置模型策略训练完成，考虑是框架层调用 还是 用户自由设定
+    输入：无，默认为EpSystem.get_run_strategy()["id"]
+    """
+
+    def __init__(self, strategy_id: int = None):
+        """
+        Args:
+            strategy_id: 是否线上环境
+        """
+        self.strategy_id = strategy_id
+
+        super().__init__()
+        self.api = f'/ep/api/sdk/call_train_done'
+        self.method = 'POST'
+        self.content_type = 'application/json'
+
+
+class CallTrainDoneResponse(BaseResponse):
+    """
+    Model for CallTrainDoneResponse
+    """
+
     def __init__(self, response: BaseResponse = None, **kwargs):
         super().__init__(
             code=response.code if response else None,

ep_sdk_4pd-0.1.3/ep_sdk_4pd.egg-info/PKG-INFO

@@ -0,0 +1,225 @@
+Metadata-Version: 2.1
+Name: ep_sdk_4pd
+Version: 0.1.3
+Summary: 4paradigm Electricity Platform Service SDK Library for Python
+Home-page: https://gitlab.4pd.io/electricityproject/electricity-platform-sdk
+Author: 4paradigm Electricity Platform SDK
+Author-email: 
+Keywords: 4pd_electricity_platform
+Platform: any
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Software Development
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+
+# SDK 帮助文档
+
+本说明文档旨在指导策略开发者如何使用平台提供的远程 SDK 仓库 `ep-sdk-4pd`，完成特征数据获取、模型开发与调试流程。
+
+> ⚠️ ep-sdk-4pd SDK是平台为策略开发者提供的本地数据访问工具，用于访问结构化的示例数据，模拟真实环境中的策略开发流程。SDK 会自动识别运行环境，在本地开发时返回脱敏示例数据，结构与线上一致；在正式部署时连接真实数据库。
+
+## 一、SDK 安装方式
+
+SDK 已托管于远程私有仓库，用户可通过以下命令在本地完成安装：
+
+```bash
+pip install ep-sdk-4pd
+```
+
+安装成功后，策略脚本中可直接引入 SDK 提供的功能模块。
+
+## 二、模块导入方式
+
+平台策略执行环境中已预置 SDK 包 `ep-sdk-4pd`，用户在本地开发时可通过如下方式导入核心方法：
+
+```python
+from ep_sdk_4pd.ep_system import EpSystem
+from ep_sdk_4pd.ep_data import EpData
+```
+
+## 三、系统环境接口（EpSystem）
+
+系统接口统一封装于 `EpSystem` 类中，主要用于策略运行环境感知和训练/预测流程控制。
+
+### 3.1 模型输出路径：`EpSystem.model_output_dir()`
+
+- **定义**：获取模型输出目录路径
+
+- **线上环境返回**：`/home/{user}/strategyId/`
+
+- **本地调试返回**：`/home/{user}/test/`
+
+### 3.2 获取系统时间：`EpSystem.get_system_date()`
+
+- **定义**：获取平台运行时系统时间，作为训练或预测数据的参考时间基准。用户不可自定义修改。
+
+- **本地调试返回**：固定测试值，如 `"2024-12-31"`
+
+- **线上运行返回**：随运行时间变化，如 `"2025-04-01"`
+
+### 3.3 获取运行策略信息：`EpSystem.get_run_strategy()`
+
+- **定义**：获取当前正在运行的策略上下文信息
+
+- **返回示例（测试环境）**：
+
+```python
+{
+  "id": 1,
+  "name": "空仓策略",
+  "description": "不参考任何信息，96节点全部报0",
+  "plant": "test站点",
+  "countyCode": 1000100
+}
+```
+
+### 3.4 训练完成通知：`EpSystem.call_train_done()`
+
+- **定义**：用于回调通知平台当前策略训练已完成。
+
+- **默认行为**：调用时会自动读取当前运行策略 ID，用户无需传参。
+
+- **返回值**：`True`（成功）或 `False`（失败）
+
+
+
+## 四、特征数据接口（EpData）
+
+数据接口封装于 `EpData` 类中，用于获取结构化输入数据，包括天气、市场、电厂等特征。数据按系统时间校验，不可穿越未来。
+
+### 4.1 数据获取规则
+
+- 可获取数据时间段为：`2024-01-01 ~ 2024-12-31`
+
+- 推理模拟从 `2025-01-01` 开始顺序执行
+
+### 4.2 获取历史数据：`EpData.get_history_data(scope: List[str], days: int)`
+
+- **定义**：获取当前系统时间向前指定天数的数据（最晚支持到 D-2）
+
+- **参数说明：**
+
+  - `scope`：选择数据模块，支持 `["weather", "plant", "market"]`
+
+  - `days`：获取当前系统时间前 N 天的数据
+
+- **示例调用：**
+
+```python
+from ep_sdk_4pd.ep_data import EpData
+
+# 获取全量的历史特征
+data = EpData.get_history_data(days=7)
+# 获取天气的历史特征
+weather_data = EpData.get_history_data(scope=["weather"], days=7)
+```
+
+- **返回格式：**
+
+```python
+data = {
+    "weather": pd.DataFrame(...),
+    "plant": pd.DataFrame(...),
+    "market": pd.DataFrame(...)
+}
+weather_data = {
+    "weather": pd.DataFrame(...)
+}
+```
+
+- **字段详解：**
+
+  - `market`：聚合电力交易市场相关信息，如价格、电量、调度负荷、联络线、新能源出力等
+
+  - `plant`：聚合特定发电场站相关运行指标，站点电价、电量等
+
+  - `weather`：聚合天气相关数据，如天气实况、未来预报、气象背景等
+
+- 更多字段说明，请参考平台对应的「数据字典文档」。
+
+### 4.3 获取预测数据：`EpData.get_predict_data(scope: List[str])`
+
+- **定义**：获取当前系统时间的预测数据（最晚为 D-1）
+
+- **参数说明：**
+
+  - `scope`：可选数据范围，与 `get_history_data` 相同
+
+- **示例调用：**
+
+```python
+from ep_sdk_4pd.ep_data import EpData
+
+# 获取市场和天气的预测特征
+data = EpData.get_predict_data(scope=["market", "weather"])
+```
+
+- **返回格式：**
+
+```python
+data = {
+    "weather": pd.DataFrame(...),
+    "market": pd.DataFrame(...)
+}
+```
+
+## 五、环境适配说明
+
+- 本地调试环境下，SDK 返回脱敏示例数据，用于验证模型逻辑与调试开发流程。
+
+- 部署上线后，SDK 自动连接真实数据库，返回真实交易场景中的数据。
+
+- 开发者无需修改代码逻辑，环境判断与数据源切换由 SDK 内部自动处理。
+
+## 六、常见问题 FAQ
+
+### Q1：如何确定当前系统时间？
+
+可通过 `EpSystem.get_system_date()` 获取，格式为 `YYYY-MM-DD`。
+
+### Q2：为什么我的数据不包含最新日期？
+
+`get_history_data` 返回最晚到系统时间的 D-2 日数据，`get_predict_data` 返回系统时间的 D-1 日预测数据。
+
+### Q3：模型训练完成后如何保存模型？
+
+平台会在运行策略时创建独立的模型输出目录（通过 `EpSystem.model_output_dir()` 获取），用于保存用户的模型对象或其他中间结果。
+
+建议使用常见的 Python 序列化方案保存模型，如：
+
+**方式一：pickle 序列化（推荐用于简单对象）**
+
+```Python
+import pickle
+from ep_sdk_4pd.ep_system import EpSystem
+
+out_dict = {"price_model": model1, "power_model": model2}
+with open(f"{EpSystem.model_output_dir()}/model.pickle", "wb") as f:
+    pickle.dump(out_dict, f)
+```
+
+**方式二：joblib 序列化（推荐用于大型模型）**
+
+```Python
+from joblib import dump
+from ep_sdk_4pd.ep_system import EpSystem
+
+model_path = f"{EpSystem.model_output_dir()}/model.joblib"
+dump(your_model, model_path)
+```
+
+**方式三：自定义格式存储（如 JSON/CSV/HDF5 等）** 对于不适合直接 pickle 的模型（如深度学习框架模型、含依赖项对象），也可通过保存权重、参数配置等方式进行落盘。
+
+### Q4：如何判断当前策略运行上下文？
+
+通过 `EpSystem.get_run_strategy()` 可获取策略 ID、配置等元信息，便于调试和日志输出。
+
+如需获取最新数据字段说明、SDK 更新日志或接口文档，请前往平台「数据文档中心」或联系管理员。

{ep_sdk_4pd-0.1.2 → ep_sdk_4pd-0.1.3}/ep_sdk_4pd.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ ep_sdk_4pd.egg-info/SOURCES.txt
 ep_sdk_4pd.egg-info/dependency_links.txt
 ep_sdk_4pd.egg-info/requires.txt
 ep_sdk_4pd.egg-info/top_level.txt
+tests/test_call_train_done.py
 tests/test_get_run_strategy.py
 tests/test_get_system_date.py
 tests/test_history_data.py

{ep_sdk_4pd-0.1.2 → ep_sdk_4pd-0.1.3}/setup.py

@@ -8,7 +8,7 @@ DESCRIPTION = '4paradigm Electricity Platform Service SDK Library for Python'
 AUTHOR = '4paradigm Electricity Platform SDK'
 AUTHOR_EMAIL = ''
 URL = 'https://gitlab.4pd.io/electricityproject/electricity-platform-sdk'
-VERSION = '0.1.2'
+VERSION = '0.1.3'
 REQUIRES = ['requests']
 
 LONG_DESCRIPTION = ''

ep_sdk_4pd-0.1.3/tests/test_call_train_done.py

@@ -0,0 +1,13 @@
+from ep_sdk_4pd.ep_system import EpSystem
+
+
+def test_call_train_done():
+    print('-------------test_call_train_done-------------')
+
+    data = EpSystem.call_train_done(strategy_id=None)
+    print(data)
+    print('-------------------------------------')
+
+
+if __name__ == '__main__':
+    test_call_train_done()

{ep_sdk_4pd-0.1.2 → ep_sdk_4pd-0.1.3}/tests/test_get_run_strategy.py

@@ -1,4 +1,3 @@
-from ep_sdk_4pd.ep_data import EpData
 from ep_sdk_4pd.ep_system import EpSystem
 
 

{ep_sdk_4pd-0.1.2 → ep_sdk_4pd-0.1.3}/tests/test_history_data.py

@@ -4,7 +4,7 @@ from ep_sdk_4pd.ep_data import EpData
 def test_history_data():
     print('-------------test_history_data-------------')
 
-    data = EpData.get_history_data(scope="weather", system_date="2025-04-17", days=2)
+    data = EpData.get_history_data(scope="weather", days=2)
     print(data)
     print('-------------------------------------')
 

{ep_sdk_4pd-0.1.2 → ep_sdk_4pd-0.1.3}/tests/test_predict_data.py

@@ -4,7 +4,7 @@ from ep_sdk_4pd.ep_data import EpData
 def test_predict_data():
     print('-------------test_predict_data-------------')
 
-    data = EpData.get_predict_data(scope="weather", system_date="2025-04-15")
+    data = EpData.get_predict_data(scope="weather")
     print(data)
     print('-------------------------------------')
 

ep_sdk_4pd-0.1.2/PKG-INFO

@@ -1,21 +0,0 @@
-Metadata-Version: 2.1
-Name: ep_sdk_4pd
-Version: 0.1.2
-Summary: 4paradigm Electricity Platform Service SDK Library for Python
-Home-page: https://gitlab.4pd.io/electricityproject/electricity-platform-sdk
-Author: 4paradigm Electricity Platform SDK
-Author-email: 
-Keywords: 4pd_electricity_platform
-Platform: any
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Topic :: Software Development
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-Requires-Dist: requests

ep_sdk_4pd-0.1.2/ep_sdk_4pd/__init__.py

@@ -1 +0,0 @@
-__version__ = '0.1.2'

ep_sdk_4pd-0.1.2/ep_sdk_4pd.egg-info/PKG-INFO

@@ -1,21 +0,0 @@
-Metadata-Version: 2.1
-Name: ep_sdk_4pd
-Version: 0.1.2
-Summary: 4paradigm Electricity Platform Service SDK Library for Python
-Home-page: https://gitlab.4pd.io/electricityproject/electricity-platform-sdk
-Author: 4paradigm Electricity Platform SDK
-Author-email: 
-Keywords: 4pd_electricity_platform
-Platform: any
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Topic :: Software Development
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-Requires-Dist: requests