Skip to content

Latest commit

 

History

History
59 lines (53 loc) · 3.74 KB

File metadata and controls

59 lines (53 loc) · 3.74 KB

进度日志

2026-06-15 教材化重写

  • 收到反馈:上一版注释不足以支持独立理解,需要改为真正的授课式教程。
  • 已检查仓库:上一版已提交为 a6622bc,当前工作区初始状态干净。
  • 已确认每章仅 22 至 87 行,决定新增独立 Markdown 教材层,而不是继续堆行内注释。
  • 已定义教材闭环和新的完成标准,开始核对 Brian2 技术细节。
  • 已核对 Brian2 官方用户指南中单位、方程、模型、突触、输入、记录、运行、多区室和代码生成页面。
  • 已完成 tutorials/00_environment.mdtutorials/05_monitors.md
  • 基础六章均已加入概念由来、数学解释、逐段代码、输出解读、误区和可验证练习。
  • 已完成第 6 至 10 章及综合项目教材,共 12 篇完整课程正文。
  • 已重写根 README,并新增 tutorials/README.md 课程目录。
  • 已在所有实验脚本顶部加入对应教材路径。
  • 已修正第 7 章对照实验,恢复快照时同时恢复随机数状态。
  • 开始进行章节结构、本地链接、语法和全量运行验收。
  • 12 篇教材均通过结构检查,全部包含误区、实验和小结;本地 Markdown 链接全部存在。
  • 全部 Python 文件通过 py_compile
  • run_all.py 全量运行通过,第 0 至 10 章和综合项目均成功完成。
  • 修正文案:没有 C++ 编译器时仍可运行本教程全部默认 NumPy 示例。
  • 教材化重写完成。

2026-06-14 教学注释补充

  • 已确认 Git 工作区初始状态干净,当前提交为 1a19e39
  • 已盘点 11 个课程脚本、1 个综合项目和 2 个辅助脚本。
  • 已确定注释标准,开始逐章补充中文教学说明。
  • 已为基础章节补充单位、方程、积分方法、输入机制和监视器说明。
  • 已为进阶章节补充 STDP 事件、自定义调度、多区室和代码生成说明。
  • 已为综合项目补充 E/I 分组、随机连接、平衡含义和结果图解读。
  • 已为 lesson_utils.pyrun_all.py 补充运行流程说明。
  • git diff --check 已通过;当前共新增约 200 行教学说明。
  • 首次语法检查因 Windows 未展开通配符而未执行,已改用显式文件列表。
  • 显式枚举全部 Python 文件后,py_compile 语法检查通过。
  • 使用项目虚拟环境运行 run_all.py,11 个章节和综合项目全部通过。
  • 本轮教学注释补充完成。

2026-06-14

  • 创建 Brian2完整教程 项目目录。
  • 创建任务计划、调研记录和进度日志。
  • 完成官方功能与本机运行环境调研。
  • 确定 Python 3.11 使用 Brian2==2.9.0;最新版 2.10.1 要求 Python 3.12。
  • 阶段 1 完成,开始创建教程结构。
  • 创建 README、依赖文件、共享输出工具和批量运行入口。
  • 完成第 0 至 10 章示例及兴奋/抑制平衡网络综合项目。
  • 完成功能全景表和推荐学习路径。
  • 开始创建隔离环境并验证全部示例。
  • .venv 创建成功,已安装 Brian2 2.9.0、NumPy 2.4.6 和 Matplotlib 3.11.0。
  • 首次安装耗时超过命令等待时限,但后台安装随后正常结束。
  • 第一轮执行发现 Brian2 2.9.0 与 NumPy 2.4.6 不兼容,依赖已改为 NumPy 1.26.4。
  • 第二轮中第 0 至 7 章、第 9 至 10 章均通过。
  • 第 8 章确认需要 SciPy;综合项目需要增强外部驱动。
  • 共享工具已固定 NumPy 代码生成目标,避免无编译器环境反复探测 Cython。
  • 安装 SciPy 1.14.1 后,第 8 章通过。
  • 调整综合项目输入后,兴奋性和抑制性群体平均放电率约为 35 Hz。
  • 最终执行 run_all.py:第 0 至 10 章及综合项目全部通过。
  • 生成 10 张课程图片、1 张综合项目图片和1份性能报告。
  • 全部计划阶段完成。