berricake 0.1.3

a modular simulation software.

软件名称

BerriCake

概述

这是一个模块化构建能源系统仿真的实用工具库，计划用来构建光伏、风力发电等系统，后续会补充其他可再生能源模块。

• 简单的光伏模块

• 简单的风力发电模块

• 阴影表面组计算模块

本软件依赖于 scipy 和 numpy 等科学计算库，以下是详细的安装和使用说明。

环境要求

• Python 3.12

• pip 包管理工具

colorama==0.4.6

numpy==2.2.5

scipy==1.15.2

setuptools==79.0.0

安装程序

pip install barricake

使用示例

首先编辑配置文件示例

!- in.txt

! 地点信息部分

Site,

    Shenyang,          !- 站点名称

    8,                 !- 时区

    41.8,              !- 纬度（单位：度）

    123.43,            !- 经度（单位：度）

    45;                !- 海拔高度（单位：米）



! 模拟控制相关设置

SimulationControl,

    No,                !- 是否针对 sizing periods 运行模拟，No 表示不运行

    Yes,               !- 是否针对 run periods 运行模拟，Yes 表示运行

    50;                !- 每个模拟步骤的最大迭代次数



! 时间步长设置

Timestep,

    3600.0;            !- 每个时间步长的秒数



! 运行周期设置

RunPeriod,

    Annual_Simulation_2025,  !- 运行周期名称

    2025,               !- 开始年份

    1,                  !- 开始月份

    1,                  !- 开始日期（当月的第几天）

    2025,               !- 结束年份

    12,                 !- 结束月份

    31;                 !- 结束日期（当月的第几天）



! EPW 文件读取器设置

EPWReader,

    weather_shenyang,                       !- 名称

    CHN_Liaoning.Shenyang.543420_CSWD.epw;  !- EPW 文件路径



! 风力模块设置

WindModule,

    wind,  !- 风力模块名称

    1,     !- 风力发电容量（单位：千瓦）

    0;     !- 风速（单位：米/秒）



! 输出设置

Output,

    out,                             !- 输出名称

    C:\Users\29574\Desktop\out.csv,  !- 输出文件路径

    wind_power;                      !- 输出变量名称



! 链接设置，连接气象数据的风速变量到风力模块的风速变量

Link,

    weather_shenyang,      !- 源对象名称（来自气象数据文件读取器）

    wind_speed,            !- 源对象的变量名称（风速）

    wind,                  !- 目标对象名称（风力模块）

    wind_speed;            !- 目标对象的变量名称（风速）



! 链接设置，连接风力模块的功率变量到输出文件的风力功率变量

Link,

    wind,                  !- 源对象名称（风力模块）

    power,                 !- 源对象的变量名称（功率）

    out,                   !- 目标对象名称（输出模块）

    wind_power;            !- 目标对象的变量名称（风力功率）

上述输入文件配置了3类对象，分别是全局参数、基本组件和链接。

然后创建代码

# -*- coding: utf-8 -*-

from core.berricake import BerriCake



if __name__ == "__main__":

    file_path = 'in.txt'      # 输入文件路径

    bc = BerriCake(file_path) # 创建 Manager 实例

    bc.run()                  # 运行

更新日志

2025-05-01 0.1.3 新增简单的光伏计算模块

2025-04-28 0.1.2 第一个能正常运行的版本

2025-04-28 0.1.0 第一个发布版本 删除了