安装运行指南

目前pyETRC列车运行图系统提供三种运行方式。

对于有一定开发基础的用户，我们建议采用源代码方式运行，这样可以从github上快速获得软件更新；其次推荐采用egg发行版。请注意win64版本暂不支持使用路网管理模块。

使用源代码运行

使用源代码方式运行本项目，需要具有以下环境。

Python 3.7及以上的版本。开发所用的版本是3.7.4.

注：本项目使用了大量的f-string语法，该语法在Python 3.6以后的版本才被支持。一些较新的代码中利用了Python 3.7中dict键值对顺序与添加顺序一致的特性。如果使用3.6.*版本，这部分代码可能出现一些问题。如果使用3.6以下版本，则会报错。
下列的Python第三方库，都可以用pip安装。
- PyQt5。必需。
- xlwt。可选。在涉及输出.xls的操作中需要用到。
- xlrd。可选。在涉及读取.xls的操作中需要用到。
- xpinyin。可选。在本系统2.3.0版本之前的线路数据库排序中用到。
- NetworkX。可选。在3.0.0版本引入的路网数据管理中，用于以图论算法计算经由给出的路径。
作者开发的另一支持库Timetable_new。该库需要使用github上的源代码安装。

在安装第三方库之前，需要配置好python环境，并将安装目录添加到PATH环境变量中，安装好pip库。相关教程可借助搜索引擎找到。

在shell中依次执行以下命令，无报错即可。

pip install PyQt5
pip install xlwt
pip install xlrd
pip install xpinyin
pip install networkx

依次执行：

git clone https://github.com/CDK6182CHR/Timetable_new
cd Timetable_new
.\install.bat

如果不用git，也可以在链接中下载并解压源代码，双击执行install.bat。

注：install.bat文件适合windows操作系统。如果是其他操作系统，请自行更改相关代码。

install.bat的代码如下。

python setup.py build
python setup.py sdist
python setup.py install
pause

运行main.py文件即可。

python main.py

egg包是可执行Python文件的打包，其作用类似于java语言中的*.jar文件。

使用egg发行版需安装Python环境和第三方库，但无需直接接触源代码，也无需手动安装Timetable_new支持库。

Python环境和第三方库的安装请参阅上一节中有关内容。

egg发行版中提供了run.cmd文件，运行该脚本即可。