CZ_OpenSpice/README.md

190 lines
8.7 KiB
Markdown
Raw Normal View History

2021-01-20 12:20:42 +00:00
# CZ_OpenSpice
2021-01-26 12:47:02 +00:00
## 项目简介
2021-01-20 12:20:42 +00:00
本项目旨在搭建一个web版本的spice电路仿真平台。当前项目仍处于不断更新中。
2021-01-31 09:53:07 +00:00
本项目在gitee和github上同步更新。
* github地址为`https://github.com/ColsonZhang/CZ_OpenSpice`
* gitee地址为`https://gitee.com/colson-zhang/CZ_OpenSpice`
2021-01-31 09:51:24 +00:00
2021-01-26 12:47:02 +00:00
## 项目框架
2021-01-20 12:20:42 +00:00
整个项目的后端服务器代码主要基于Tornado、Bokeh框架开发。
2021-02-08 08:05:18 +00:00
```
+doc ----项目日志文件
+handler ----项目服务器python文件
+spice ----spice仿真测试文件
+static ----静态文件
...+login ----登录界面网页资源
...+register ----注册界面网页资源
...+schematic ----前端绘制电路图界面网页资源
+template ----网页模板
...+auth ----登录、注册界面网页
...+schematic ----绘制电路图界面网页
...+spice ----spice测试界面网页
...index.html ----网站主页面网页
requirements ----环境需求
README.md ----用户须知
app.py ----服务器的主程序
```
2021-01-26 12:47:02 +00:00
## 环境配置
2021-01-20 12:20:42 +00:00
2021-01-26 12:47:02 +00:00
### Python环境
需要使用`python>=3.6`同时需要安装如下几个python包可以通过`pip install pkg-name`的方法进行安装,例如 `pip install tornado`
* `tornado`
* `datetime`
* `pycket`
2021-03-31 06:49:39 +00:00
* `redis`
2021-01-26 12:47:02 +00:00
* `pymongo`
* `pymysql`
### 数据库
2021-02-08 08:09:50 +00:00
需要安装如下几个数据库,并进行配置,配置的信息在`./handler/MongoDB.py`和
2021-01-26 12:47:02 +00:00
2021-02-08 08:09:50 +00:00
`./handler/MysqlDB.py`中均有记录
2021-01-26 12:47:02 +00:00
* `redis`
* `mysql`
* `mongodb`
## 项目启动
2021-02-08 08:09:50 +00:00
进入项目路径,执行`python app.py`
2021-01-26 12:47:02 +00:00
## 更新日志
2021-04-01 05:10:17 +00:00
* 2021年4月1日
* bug系统运行一天后mysql异常
* ~~bugschematic中能够进行绘图的区域有限~~
* bug移动整体电路时电路连线无法一起移动
* bugPIN POUT暂时无作用
* to do:主页面取消跳转采用判定是否登录的方法改写login logou
2021-04-01 05:20:55 +00:00
* fix当仿真失败时会提醒用户Fail
2021-03-31 07:27:08 +00:00
* 2021年3月31日前后端更新
* 新增在服务器上成功部署后端代码为适配centos服务器而做了一些修改。
* 新增对schematic的Help弹窗做了修改对login和register界面做了修改。
2021-04-01 05:10:17 +00:00
* bug:处理注册信息时需要对用户名和邮箱是否重复进行判定。
* bug:Datetime非北京时间
2021-03-30 09:52:13 +00:00
* 2021年3月30日前后端更新
* 新增index界面
* ![avatar](./doc/the_index.png)
* 2021年3月24号前端更新
* 新增多种仿真模式下的数据显示主要解决了在ac仿真模式下对数轴的问题和两个绘图框的问题
* 新增解决了simulator窗口和show_result窗口tab功能混淆的问题
* dc仿真展示
* ![avatar](./doc/schematic8.png)
* ac仿真展示
* ![avatar](./doc/schematic9.png)
*
* 2021年3月23号前端更新
* 新增:多种仿真模式下的数据显示
* 2021年3月22号后端更新
* bug1当放置同一种组件时名称存在重复手动更改名称后需要将组件进行移动后名称才会修改。
* bug2当进行组件的复制后将组件的部分元件进行调整将无法提取spice。
* bug3Tab的作用域问题希望Tab的openmode函数中加入作用域。
* 新增DC仿真处理
2021-03-20 07:45:00 +00:00
* 2021年3月20号前端更新
* 新增:仿真结果数据显示,成功将仿真得到的节点电压绘制出来。
* todo绘制仿真结果时增加用户配置项目可以进行选择性绘图。
* transient仿真结果展示
2021-03-20 07:45:00 +00:00
* ![avatar](./doc/schematic7.png)
2021-03-18 12:54:06 +00:00
* 2021年3月18号后端更新
* idea & todo仿真结果数据可视化的基本思路为在后端的python代码中用一个自定义类封装的simulation result data container来容纳数据并新增一个用于处理get/post请求的处理函数当前端需要这些相关数据时通过ajax发送过去同时前端使用bokehjs封装一个通用的结果显示的“示波器”向服务器后端发送请求接收相关数据并展示结果。
* 2021年3月17号后端更新
* 新增根据前端传入的电路数据和仿真参数进行参数转换调用pyspice执行电路仿真
* 待解决:仿真结果传递回前端,进行可视化展示
* 2021年3月16号前端+后端更新
* 新增成功将spice网表和simulation设置参数传入后端
* 待解决1前端代码冗杂缺乏层次
* 待解决2需要在后端根据传入参数进行电路仿真 并将仿真结果传递回前端
* 待解决3将常用的单位转换为pyspice能够识别的单位string to specfic unit
2021-02-09 12:11:11 +00:00
* 2021年2月9号前端更新
* 发现bug: 当schematic中没有组件时spice的parse函数抛出错误
* 待解决如何将spice网表和simulation同时传入服务器
* 新增:仿真的参数设置
* ![avatar](./doc/schematic6.png)
2021-02-08 13:12:27 +00:00
* 2021年2月8号前端更新
* 新增在弹出窗口里嵌入bokehjs代码的功能
* ![avatar](./doc/schematic5.png)
2021-02-08 08:05:18 +00:00
* 2021年2月8号前端更新后端更新
* 优化了mos器件的描述方法
* 增加了电源模型
* 增加全局Vdd同步属性
* 将前端schematic和后端server进行结合成功将spice网表发送到后端服务器并存储到数据库中
2021-02-07 16:26:36 +00:00
* 2021年2月8号前端更新
* 优化了schematic电路图提取spice网表功能
* 新增加了多种电源器件
* 初步实验了将提取出来的spice网表送进spice仿真器中执行仿真的结果
2021-02-08 08:05:18 +00:00
* ![avatar](./doc/schematic4.png)
2021-02-02 12:38:20 +00:00
* 2021年2月2日前端更新
* 增加电路spice网表提取功能
* 但是spice网表的具体格式仍存在一些小问题需要与spice语法规则做进一步的校准
* 另外,元件的名称需要增加自动调整功能,来保证所有元件名称的唯一性
2021-02-08 08:05:18 +00:00
* ![avatar](./doc/schematic3.png)
2021-02-01 12:26:04 +00:00
* 2021年2月1日前端更新
* 发现bug拖拽元件时发现连线无法跟着移动
* 增加了对xml格式文件的电路解析info
* 将电路具体的解析info转换为spice网表电路功能待开发
2021-02-08 08:05:18 +00:00
* ![avatar](./doc/schematic2.png)
2021-01-31 09:33:13 +00:00
* 2021年1月31日前端更新
* 增加了元件属性修改功能,增加了对属性的解析
* 更新了几个元件的icon可以在这个网站上绘制相应的像素图表http://www.xiconeditor.com/
2021-01-31 09:39:52 +00:00
* 增加了按下delete键删除元素的功能
2021-01-31 09:33:13 +00:00
* 发现了一些bug例如当进行FlipH和FlipV时端口无法跟着进行翻转
* 当前的功能界面如下图所示
2021-02-08 13:12:27 +00:00
* ![avatar](./doc/schematic1.png)
2021-01-28 06:41:52 +00:00
* 2021年1月28日前端更新
* 增加了一些功能控件,完成基本雏形
* 将元件的属性暂时全部写在元件的value中之后可以尝试使用userobject进行存储。
* 增加了修改元件属性的windos窗口但是value的parse函数仍在搭建
2021-01-26 14:51:08 +00:00
* 2021年1月26日重大更新增加了前端电路绘制功能demo
* 改变技术方案放弃采用MIT的Jade电路绘制前端改为使用mxGraph设计电路绘制功能
* 当前已经可以实现绘制简单的电路原理图并将拓扑关系提取到xml格式文件中后续可设计程序将xml转换为spice文件
* 当前已经增加了几个简单的N_Mosfet P_Mosfet Vdd Gnd Resistor等元件的图表
* 但是,还有很多细节需要继续填充
2021-01-26 12:47:02 +00:00
* 2021年1月26日修复了一些小bug增加了一些配置信息
* 增加了README的内容
* 再次测试代码修复一些bug例如注册时未往数据库中写入email等
* 把部分js代码单独提取出来到一个文件夹下面
2021-01-22 12:09:14 +00:00
* 2021年1月22日进一步完善服务器基本框架。
2021-01-26 12:47:02 +00:00
2021-01-22 12:09:14 +00:00
* 基本尝试使用了BokehJS库的使用计划用JS替代Python版本的Bokeh功能控件。
* 尝试Plotly的使用计划作为Bokeh的备选。
* 尝试使用Javascript的Jquery库利用ajax向服务器发送post请求传递信息。
* 发现Python版本的Bokeh功能控件部署在服务器上存在的一些问题包括后台终端无后台信息等暂时将该功能控件禁用。
* 新增Mongo数据库的使用计划用来记录用户的行为数据该数据库的部署已经完成该数据库的python封装已完成雏形但尚不完善需要后续根据采集节点的设计进一步完善。
* 后续需要在项目管理方面进行梳理,当前代码库已经存在一定的混乱。
2021-01-22 12:35:07 +00:00
* 将代码库中的`font-awesome`css库从本地删去改为线上CDN加载。
2021-01-20 12:20:42 +00:00
* 2021年1月20日完成了服务器基本框架的搭建。实现的功能有
2021-01-26 12:47:02 +00:00
2021-01-20 12:20:42 +00:00
* 用户登录、认证、退出系统,新用户注册新账户
* 在mysql数据库中存储、更新用户基本信息
* 一个基本的仿真的app功能为spice语言描述的电路传入后台后台调用ngspice或xyce进行仿真暂未对仿真结果进行处理仅返回是否仿真成功