规划典型日生成

功能介绍

规划典型日生成功能是综合能源系统规划与设计中的重要模块。通过该功能，用户可以生成并获取综合能源系统在典型日和典型月的电负荷曲线数据，从而为能源系统的优化和调度提供有力支持。

使用说明

用到的 API

实例方法
方法功能
IESLabPlan.iesLabTypicalDayRun(job=None, name=None, **kwargs) 运行典型日计算
静态方法
方法功能
IESLabPlan.fetch(simulationId) 获取算例信息

方法	功能
`IESLabPlan.iesLabTypicalDayRun(job=None, name=None, **kwargs)`	运行典型日计算

方法	功能
`IESLabPlan.fetch(simulationId)`	获取算例信息

实例方法

方法	功能
`IESLabTypicalDayResult.GetTypical`	获取所有的典型日数据
`IESLabTypicalDayResult.GetTypicalDayNum`	获取典型日总数
`IESLabTypicalDayResult.GetTypicalDayInfo(dayID)`	获取 `dayID` 对应典型日的基础信息
`IESLabTypicalDayResult.GetTypicalMonthID(monthID)`	获取第 `monthID` 月各类型的典型日数据
`IESLabTypicalDayResult.GetTypicalDayCurve(dayID, dataType)`	获取 `dayID` 对应典型日下 `dataType` 参数的时序曲线

调用方法

通过 IESLabPlan.iesLabTypicalDayRun(job=None, name=None, **kwargs) 方法获取算例信息，通过 IESLabPlan.iesLabTypicalDayRun(job=None, name=None, **kwargs) 方法调用典型日生成程序并计算。
通过 IESLabTypicalDayResult 类的相应方法获取典型日的详细结果数据。

案例介绍

接下来，通过一个完整的案例来展示如何基于上述 API 编写 Python 脚本。案例旨在展示如何利用 IESLab 平台典型日生成模块，方便快速生成综合能源系统规划的典型日生成。您可以通过编写 Python 脚本自动化地获取指定项目的典型日数据，如辐射强度、环境温度、负荷数据等。

代码解析

首先进行算例准备工作。包括设置网址与账户 token、获取获取算例。

import os
import cloudpss

if __name__ == '__main__':
    # 申请并设置自己账户的token
    cloudpss.setToken('{token}')  

    # 将'https://cloudpss.net/'替换为用户当前使用的平台网址地址
    os.environ['CLOUDPSS_API_URL'] = 'https://cloudpss.net/'

    # 规划设计典型场景生成测试——获取指定 simuid 的项目
    iesplanProject = cloudpss.IESLabPlan.fetch(207)

通过 iesplanProject.iesLabTypicalDayRun() 启动典型日生成模块的计算，耐心等待计算完成。

    #典型场景生成模块计算测试
    typical_runner = iesplanProject.iesLabTypicalDayRun()
    while not typical_runner.status():
        pass
    print('计算完成')
    iesplan_result = typical_runner.result

使用 iesplan_result.GetTypical()、iesplan_result.GetTypicalDayNum() 方法分别获取所有典型日信息以及典型日的数量。通过 iesplan_result.GetTypicalDayCurve(0,'电负荷') 获取第一个典型日的电负荷曲线数据。参数 0 表示第一个典型日,'电负荷' 指定要获取的曲线类型。通过 iesplan_result.GetTypicalMonthCurve(12,'电负荷') 获取 12 月的典型日电负荷曲线数据。参数 12 表示12月,'电负荷' 指定要获取的曲线类型。

    # 综合能源典型场景的典型日曲线
    typical = iesplan_result.GetTypical()
    typical_num = iesplan_result.GetTypicalDayNum()
    typical_info = iesplan_result.GetTypicalDayInfo(0)
    typical_curve = iesplan_result.GetTypicalDayCurve(0,'电负荷')

iesplan_result.GetTypicalMonth 方法可以获取到所有月份的典型日信息。通过 iesplan_result.GetTypicalMonthNum(12) 获取指定月份（在此例中为 12 月）的典型日数量，电负荷曲线数据。通过 iesplan_result.GetTypicalMonthCurve(12,'电负荷') 获取指定月份的典型日的电负荷曲线数据。

    # 综合能源典型场景某月的典型日曲线
    typical_month = iesplan_result.GetTypicalMonth()
    typical_month12 = iesplan_result.GetTypicalMonthNum(12)
    typical_monthcurve = iesplan_result.GetTypicalMonthCurve(12,'电负荷')  

结果展示

由于结果过长，在此只展示 iesplan_result.GetTypicalDayCurve(0,'电负荷') 的输出结果。

计算完成
1月典型日1电负荷曲线： [39.60529993363616, 35.71495216067563, 32.56108447836463, 31.616657068002272, 29.329236551161326, 30.17835477332198, 31.824604387715084, 35.74094557563972, 43.417667461704404, 48.63367939783412, 49.56077786488708, 49.283514771936645, 47.28202181970084, 44.578706663434275, 40.29845766601221, 45.670430091926555, 46.814140350347024, 48.31309394661021, 49.16221216877085, 46.623521973943596, 47.524627026032455, 45.48847618717783, 41.00027987004295, 35.446353539379906]

调试技巧

确保 API 访问令牌设置正确且未过期，同时确认访问的网址设置是否正确。
特别注意参数的顺序和必填项，并确认每个 API 调用的返回值是否符合预期，查阅 CloudPSS 官方 API 文档，了解各个函数的详细用法和参数说明。
确保 GetTypicalMonthID 和其他月份相关方法的参数正确，并确认月份 ID 在合理范围内。

常见问题

Q1:请求的数据不存在是什么原因呢？
A1:请仔细检查您的系统中是否包含此数据，例如您的系统中元件没有绑定负荷数据，或者数据管理模块没有创建相应的数据卡，则会出现数据不存在的情况。此外，您还需要仔细核查索引是否超出范围以及请求的曲线类型标识符是否存在。
Q2:如何获取不同类型的曲线数据,比如辐射强度或环境温度?
A2:您可以将 GetTypicalDayCurve() 或 GetTypicalMonthCurve() 的第二个曲线类型参数更改为其他类型,如 辐射强度 或 环境温度。可用的曲线类型标识符请查阅 CloudPSS API 文档。

完整代码

import os
import cloudpss

if __name__ == '__main__':
    # 申请并设置自己账户的token
    cloudpss.setToken('{token}')  

    # 将'https://cloudpss.net/'替换为用户当前使用的平台网址地址
    os.environ['CLOUDPSS_API_URL'] = 'https://cloudpss.net/'

    # 规划设计典型场景生成测试——获取指定 simuid 的项目
    iesplanProject = cloudpss.IESLabPlan.fetch(207)

    #典型场景生成模块计算测试
    typical_runner = iesplanProject.iesLabTypicalDayRun()
    while not typical_runner.status():
        pass
    print('计算完成')
    iesplan_result = typical_runner.result

    # 综合能源典型场景的典型日曲线
    typical = iesplan_result.GetTypical()
    typical_num = iesplan_result.GetTypicalDayNum()
    typical_info = iesplan_result.GetTypicalDayInfo(0)
    typical_curve = iesplan_result.GetTypicalDayCurve(0,'电负荷')

    # 综合能源典型场景某月的典型日曲线
    typical_month = iesplan_result.GetTypicalMonth()
    typical_month12 = iesplan_result.GetTypicalMonthNum(12)
    typical_monthcurve = iesplan_result.GetTypicalMonthCurve(12,'电负荷')  

功能介绍​

使用说明​

用到的 API​

调用方法​

案例介绍​

代码解析​

结果展示​

调试技巧​

常见问题​

完整代码​