Jupyter SCAD: SCAD in Jupyter

Jupyter SCAD为在Jupyter笔记本中描述的3D对象提供SolidPython2的渲染和交互式可视化。此外，它还提供STL的交互式可视化。

此程序专注于在Jupyter笔记本中交互式地使用Python（即SolidPython2）生成stl文件的使用案例。

状态：成熟

此项目已达到其目标，一个基本的SolidPython2 Jupyter笔记本查看器。任何进一步的改进最好通过仅使用OpenSCAD GUI（参见下面的替代方案）来实现。

目前，此项目计划进行的唯一工作是错误修复。如果您有兴趣继续添加功能，请提出一个表达您兴趣的问题，我们可以讨论传递接力棒。

文档

文档托管在 https://jreiberkyle.github.io/jupyterscad/。

快速入门

Jupyter SCAD可以使用pip安装

pip install jupyterscad

可以使用SolidPython2定义OpenSCAD对象，在Jupyter笔记本中查看，并使用以下方法保存到stl文件：

from jupyterscad import view
from solid2 import cube

view(cube([1.5,2,1],center=True), outfile='cube.stl')

替代方案

作为Jupyter SCAD的替代方案，可以使用Jupyter笔记本作为外部编辑器，使用SolidPython2更新SCAD文件，并使用OpenSCAD来可视化和渲染SCAD文件。这种方法的优点是可以可视化预览。缺点是两个程序的工作流程可能会让人感到分散。有关使用外部编辑器为OpenSCAD的更多信息，请参阅此处。

或者，可以使用ViewSCAD，这是本项目灵感的来源。然而，ViewSCAD最后一次更新是在2019年（截至2023年9月21日）。它仅支持SolidPython，不支持SolidPython2。

从ViewSCAD过渡

本包受ViewSCAD的启发，因此保持了非常相似的用户界面。

要从ViewSCAD过渡，替换

import viewscad

r = viewscad.Renderer()
r.render(obj)

为

from jupyterscad import view

view(obj)

可视化后端

本包使用pythreejs进行可视化。

考虑过的替代方案，按从最接近到最远的顺序排列

• pyvolume：提供网格可视化和交互，但截至2023年9月24日的最新版本是alpha，文档很少。
• matplotlib mplot3d：提供网格可视化和交互，但速度较慢。
• pyvista：提供stl加载和可视化，但在Docker镜像中可视化不起作用。

致谢

感谢nickc92创建了ViewSCAD，这是本项目的灵感来源。