昊明有态度|这个开源库用一行代码帮你搞定，Python代码转Latex公式
机器之心报道
【昊明有态度|这个开源库用一行代码帮你搞定，Python代码转Latex公式】编辑：小舟
你的代码中有数学公式吗？
数学是数据科学和机器学习的重要基础 ， 数学运算的结果对于机器学习项目而言是至关重要的 。 在编写代码时 ， 我们常常需要定义数学公式的计算形式 。 像S=r^2这样简单的数学公式 ， 大概不会出现拼写错误 。 但如果是下面这样的公式呢？
文章图片
图源：知乎用户@马啃菠箩
还记得数学老师密密麻麻的板书吗？人们习惯于手写公式的运算过程 。 而如果计算机编程语言能够显示出类似于手写公式的计算过程 ， 检查公式运算是否准确就可以轻松多了吧 。
近日 ， GitHub上一个名叫handcalcs的开源库就解决了这个问题 。
项目地址：https://github.com/connorferster/handcalcs
handcalcs库：将Python计算代码转换为Latex公式
handcalcs库可将Python计算代码自动渲染为Latex公式 ， 呈现方式类似于手写的公式计算：先编写符号公式 ， 再代入具体数字 ， 最后得出结果 。
文章图片
正如上面的演示样例所示 ， 计算机能够识别的公式形式是：
文章图片
而人们更习惯的是如下形式的数学公式：
文章图片
handcalcs的功能就是 ， 将数学公式和运算过程以人们更容易理解的形式展示出来 。
数学计算的结果往往会影响后续代码的运行过程 ， 而复杂的数学公式更容不得一点错漏 ， 因此对于包含较多复杂数学公式的Python代码 ， 用handcalcs进行自查或许是有必要的 。
如何使用handcalcs？
那么 ， 这个开源库要如何应用呢？
基本用法1：Jupyter单元格魔法函数
handcalcs的设计初衷是在JupyterNotebook或JupyterLab中作为单元格魔法函数来使用 。
首先 ， 引入handcalcs模块并运行单元格：
importhandcalcs.render
接下来 ， 在想要使用handcalcs的单元格上面添加一行魔法函数%%render：
%%render
例如：
%%rendera=2b=3c=2*a+b/3
如果系统安装了Latex环境 ， 你还可以将notebook导出成pdf格式文件 。
基本用法2：函数装饰器@handcalc()
除了在Jupytercell中使用外 ， 在Python的函数中也可以使用handcalcs 。
首先导入@handcalc()装饰器：
fromhandcalcs.decoratorimporthandcalc
然后编写函数 。 注意：函数必须returnlocals()：
@handcalc()defmy_calc(x,y,z):a=2*x/yb=3*ac=(a+b)/zreturnlocals()
@handcalc(left:str='''',right:str='''',jupyter_display:bool=False)
返回一个由(latex_code:str,locals:dict)组成的元组 ， 其中locals是函数命名空间范围内所有变量的字典 。
其他功能
有些公式的参数量较多 ， 如果按照常规的格式显示在一列 ， 会浪费大量空间 。 而使用handcalcs ， 只需添加注释标签#Parameters就能让参数以三列的形式显示出来：
文章图片
而有些公式的计算过程非常繁琐 ， 也会占用大量显示空间 ， 只需使用标签#Short就能让运算过程的显示行数减少：
反之 ， 如果你比较喜欢推导等式对齐的方式 ， 可以使用#Long标签显示 。
有时你并不需要代入数值计算 ， 只需要以符号的形式显示数学计算公式 。 那么 ， 你需要使用#Symbolic标签：
推荐阅读
- 上观新闻|哪三大行业是上海创新创业高地？在宝山举行的这个大赛迎来收官之战
- 数码鲜蜂|三星大秀肌肉！这个透明手机如何？
- 国际空间站|国际空间站漏气了，每天向外撒“黄金”，但NASA找不到这个洞
- 电池|手机整夜充电会伤电池？打开这个模式就好了
- 忘川彼岸|小米，再见了
- 华为|以前“死活都不卖”，如今低价求中国购买，荷兰态度说变就变
- 贾跃亭|贾跃亭曾竭尽全力企图改变这个世界！消息人士：他仍在追求这目标
- 芯片|只因中国这个决定？一夜蒸发6800亿，美国芯片企业损失惨重！
- 海为川|持谦虚谨慎工作态度为最佳，组装电脑失败告诉我
- 微信|被好友拉黑不知道？微信右上角这个功能很实用，能直接显示黑名单