Skip to content

GoodenoughPhysicsLab/physicsLab

Repository files navigation

physicsLab

输入图片说明

License build

介绍

当我们在物理实验室AR纯手动做实验的时候,往往会遇到一些琐碎、麻烦但又不得不做的事情,比如:重复的搭建某些电路,调整元件的位置,电路内部结构的重复。这些问题都可以通过使用physicsLab生成这些电路结构来轻易解决!于是我写了physicsLab,让你能用Python在物实做实验。

部分方便且惊艳的功能展示

  • 同时支持通过存档的文件名与存档名访问存档
  • 不受实验室大小地随意摆放原件 (比如在实验室外悬空的元件)
  • 将midi转换为物实对应的电路
  • 修改物实的实验封面
  • 获取用户的所有头像或实验用过的所有封面 更多好用的功能等你来发现

功能支持

  • 良好的平台兼容性,只要该平台能够运行Python与文件读写,比如Windows, Linux, MacOS, Android
  • 支持物实所有实验类型:电学,天体物理,电与磁
  • 支持物实全部元件
  • 大多数物实网络api封装的支持 (直接与物实服务器进行交互)

stable?

鉴于目前用户较少, 深度使用该库的用户几乎没有, 因此不考虑稳定兼容。 并且哪怕用户多了, 也会优先考虑标注弃用, 并推荐转移到新api的模式, 而不是无意义的兼容。

安装教程

  1. 请确保你的电脑有Python(>=3.8)与物理实验室AR(简称物实)(也可以联系物理实验室的开发者Jone-Chen

  2. 在cmd或shell输入以下载physicsLab:

pip install physicsLab

在某些非正常情况,你可能无法顺利使用pip,此时你可以换为该命令来解决该问题:

python -m pip install physicsLab

Note: 在Windows下你可以输入py来使用pythonLinux, MacOS下可能需要输入python3来使用python

  1. 有一个并非必需的功能:播放midi。你可以输入下面命令的任意一条:
pip install plmidi
pip install pygame

点击跳转至plmidi

之所以没有做安装physicsLab的时候自动安装这两个库,是因为Androidqpython在下载含c的库的时候存在问题

  1. 物实存档使用了中文字符,默认编码为utf-8。但在一些非正常情况,存档的编码可能被改变。虽然physicsLab有一定的处理存档编码问题的能力,但如果还是出现了问题,请输入该命令:
pip install chardet

此时physicsLab会自动调用chardet来处理更加棘手的文件编码问题。

  1. 如果下载成功,请输入下面的代码以验证physicsLab已经可以使用了
from physicsLab import *

with experiment("example"):
    Logic_Input(0, 0, 0.1)

然后打开物实,点击从本地读取,点击一个名为example的实验。如果出现了一个悬空的逻辑输入,则说明一切都成功了。

Note: 每次运行physicsLab后都需要重新加载物实的本地存档,即点击从本地读取,再次点击对应存档,使物实重新加载该存档

新手解惑: 为什么我明明安装了physicsLab, python却告诉我无法找到?

pip安装的包会被放在site-package文件夹下
这大概率是因为pip安装的包所对应的site-package与你使用的python对应的site-package不一样导致的
解决方案:找到ide调用的python对应的site-package,然后把physicsLabphysicsLab.egg-info复制过去
同时我推荐去学一下python的虚拟环境venv,有效解决此问题

如果此方法失效了,虽然这一定不是这个方法的问题,但你还可以在python的开头写上这两行代码来解决这个问题:

import sys
sys.path.append("/your/path/of/physicsLab") # 将字符串替换为你想添加的路径

这个方法很丑陋但很简单好用,可以帮你快速解决问题,毕竟能跑起来就很不错了
其原理是python会在sys.path这个列表里面的路径去寻找python package,若未找到则会报错。因此该方法的原理就是把python找不到的路径加进去,python就找到了
注:每次运行的时候加入的path都是临时的,因此该方法必须让python在每次运行的时候都执行一遍

使用说明

Note: 如果physicsLab抛出TypeError,请检查你自己的输入参数是否有问题,
如果抛出AssertionError,请报告bug

目前physicsLabwindows上的支持最好,在Android上仅支持手动导入/导出存档(默认在physicsLabSav文件夹中)。
其他操作系统上的行为与在Android上应该一致。

qpython v3.2.5中大大削减了python在文件路径操作方面的权限,这意味着在qpython上使用physicsLab生成的存档将很难被物实导入,因为物实没权限访问不了。 但此问题在qpython v3.2.3中不存在,推荐下载该版本。 不过由于安卓权限的问题,用起来肯定没有电脑上方便。

下面给出一个简单的例子(该例子仅用于讲解,你大概率无法运行):

from physicsLab import *

  # 打开存档
  # 也支持输入存档的文件名(也就是xxx.sav)
e = Experiment("example")
  # 如果你希望程序不覆盖掉存档中已有的实验状态,需要这样写
read_plsav(e)
  # 创建一个逻辑输入,坐标为(0, 0, 0.1)
Logic_Input(0, 0, 0.1)
  # 你也可以不写坐标,默认是(0,0,0)
o = Or_Gate()
  # 元件含有引脚属性,是对物实原始的引脚表示方法的封装
  # 比如或门(Or_Gate),含有 i_up, i_low, o三个引脚属性
  # 通过引脚属性,就可以更方便的连接导线了

  # crt_wire()函数用来连接导线,有三个参数:SourcePin, TargetPin, color
  # SourcePin与TargetPin必须传入元件的引脚
  # color可以不写,默认为蓝色
crt_wire(o.i_up, o.i_low)
  # 将程序中生成的原件,导线等等写入存档
e.write()
  # 然后用物实打开存档见证奇迹

physicsLab还支持等价但更优雅的方式 (这也是我最推荐的方式):

from physicsLab import *

with experiment("example", read=True):
    Logic_Input(0, 0, 0.1)
    o = Or_Gate()
    o.i_up - o.i_low # 连接导线

上面两段代码产生的结果是一样的

更详细的内容请在文档中查看

由于physicsLab使用中文注释而且物实的存档也使用了中文
因此我建议你手动在Python代码的第一行添加如下注释:

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

不过由于编码导致问题的情况似乎很少

优点

  • physicsLab拥有优秀的与物实存档交互的能力,你甚至可以使用程序完成部分工作之后你再继续完成或者让程序在你已完成的实验的基础上继续完成。 如此灵活的功能使得physicsLab即使是在python shell上也能出色的完成工作!
  • physicsLab为纯python库,其c拓展部分(与midi相关的)被放到了plmidi中,但plmidi不是必须需要的。纯Python库通常意味着更容易使用,更少的问题。
  • 封装了物实里的大量原件,即使是未解锁的原件也可以轻易用脚本生成,甚至一些常用的电路也被封装好了!
  • 物理实验室存档的位置有点隐蔽,但用该脚本生成实验时,你无须亲自寻找这个文件在哪里。
  • 外部依赖少
  • 相比于手动做实验,代码复用率更高,许多逻辑电路已经被封装,只需简单的一行调用即可生成。
  • 程序有利于大型实验的创作
  • 改存档做出来的实验往往有十分惊艳的效果!

其他

contribute

physicsLab没有强行要求代码风格,但需要注意与上下文保持一致

你可以从更新文档、bugfix、写测试代码开始入手