Skip to content

v1.3.0 - Stable Release

Choose a tag to compare

View all tags
@chrisKLP-sys chrisKLP-sys released this 22 Nov 16:05
· 20 commits to main since this release
V1.3.0
048157c

Release Notes / 发布说明 - v1.3.0

🎉 Stable Release / 稳定版本发布

Release Date / 发布日期: 2025-11-22

This is a stable release of the Intersection Traffic Flow Visualize tool. This version includes new visualization features and important bug fixes that enhance the user experience and visual clarity.

这是交叉口交通流量流向可视化工具的稳定版本。此版本包含新的可视化功能和重要的错误修复，提升了用户体验和视觉清晰度。

What's New / 新功能

✨ New Features / 新特性

  • Exit Width Bar Arrows / 出口宽度条箭头

    • Added solid arrows at the end of exit width bars to clearly indicate traffic direction
    • 在出口宽度条末端添加实心箭头，清晰指示交通流向
    • Arrow length: 45 units
    • 箭头长度：45单位
    • Arrow width: 1.8 times the exit width bar width
    • 箭头宽度：出口宽度条宽度的1.8倍
    • Arrow color matches the exit width bar color
    • 箭头颜色与出口宽度条颜色一致

  • Extended Entry Width Bars / 延长进口宽度条

    • Entry width bars now extend 45 units outward for better visibility
    • 进口宽度条现在向外延长45单位，提高可见性
    • Improves visual clarity of entry traffic flows
    • 提高了进口交通流的视觉清晰度

  • Expanded Plot Window / 扩大绘图窗口

    • Plot window range expanded from (-330, 330) to (-375, 375)
    • 绘图窗口范围从(-330, 330)扩大到(-375, 375)
    • Accommodates extended entry bars and arrows
    • 适应延长的进口条和箭头

  • Adjusted Entry Name Labels / 调整进口名称标签

    • Entry name labels moved 45 units outward along azimuth angle direction
    • 进口名称标签沿方位角方向向外移动45单位
    • Better positioning relative to extended entry bars
    • 相对于延长的进口条位置更合理

🐛 Bug Fixes / 错误修复

  • Startup Dialog Close Handling / 启动界面关闭处理
    • Fixed error when closing the startup dialog (intersection type selection)
    • 修复了关闭启动界面（交叉口类型选择）时的错误
    • Now properly terminates all processes without errors
    • 现在能正确终止所有进程，不会报错
    • Improved error handling with try-except blocks
    • 使用try-except块改进了错误处理

Visual Improvements / 视觉改进

This release focuses on enhancing the visual clarity of traffic flow diagrams:

此版本专注于提高交通流量图的视觉清晰度：

  • Clearer Direction Indication / 更清晰的方向指示

    • Arrows on exit bars make traffic direction immediately obvious
    • 出口条上的箭头使交通方向一目了然

  • Better Layout / 更好的布局

    • Extended entry bars and adjusted labels improve overall diagram readability
    • 延长的进口条和调整后的标签提高了整体图表的可读性

  • Larger Drawing Area / 更大的绘图区域

    • Expanded window allows all elements to be displayed without crowding
    • 扩大的窗口允许所有元素显示而不拥挤

Installation / 安装

From Source / 从源码安装

git clone https://github.com/chrisKLP-sys/intersection-traffic-flow.git
cd intersection-traffic-flow
git checkout v1.3.0  # 切换到稳定版本标签
python setup_venv.py
pip install -r requirements.txt
python 交叉口交通流量流向可视化工具1.3.py

Pre-built Executable / 预编译可执行文件

Download the Windows executable from the Releases page.

从 Releases 页面下载Windows可执行文件。

Upgrade Notes / 升级说明

If you're upgrading from v1.2.0 or earlier:

如果您从v1.2.0或更早版本升级：

  1. Backup your data files - Save any custom data files before upgrading

    • 备份数据文件 - 在升级前保存任何自定义数据文件

  2. File compatibility - Data files from previous versions are fully compatible

    • 文件兼容性 - 以前版本的数据文件完全兼容

  3. Visual changes - The new arrows and extended bars will appear in all new diagrams

    • 视觉变化 - 新的箭头和延长的条将在所有新图表中显示

  4. No data migration needed - Existing data files work without modification

    • 无需数据迁移 - 现有数据文件无需修改即可使用

Technical Details / 技术细节

Arrow Implementation / 箭头实现

  • Uses matplotlib.patches.Polygon for solid arrow rendering
  • 使用 matplotlib.patches.Polygon 进行实心箭头渲染
  • Arrow shape: Isosceles triangle with vertex at the end point
  • 箭头形状：顶点在终点的等腰三角形
  • Direction calculated from exit inner to exit outer points
  • 方向从出口内点到出口外点计算

Window Expansion / 窗口扩大

  • Plot limits updated: PLOT_XLIM and PLOT_YLIM from (-330, 330) to (-375, 375)
  • 绘图限制更新：PLOT_XLIM 和 PLOT_YLIM 从(-330, 330)到(-375, 375)
  • Symmetric expansion to accommodate all new elements
  • 对称扩大以容纳所有新元素

Process Termination / 进程终止

  • Uses os._exit(0) to ensure complete process termination
  • 使用 os._exit(0) 确保完全终止进程
  • Prevents hanging processes when closing startup dialog
  • 防止关闭启动对话框时进程挂起

Known Issues / 已知问题

None at this time. If you encounter any issues, please report them on the Issues page.

目前没有已知问题。如果您遇到任何问题，请在 Issues 页面上报告。

Credits / 致谢

Support / 支持

For questions, bug reports, or feature requests, please visit:
如有问题、错误报告或功能请求，请访问：

Changelog / 更新日志

For a complete list of changes, see CHANGELOG.md.

完整的更改列表，请参阅 CHANGELOG.md。

Thank you for using Intersection Traffic Flow Visualize! / 感谢使用交叉口交通流量流向可视化工具！ 🚦

Assets 3
Loading