OrcaSPH - SPH Fluid Simulator with OrcaLink Integration
OrcaSPH 是一个 Python 包,提供 SPHSimulator 可执行程序和相关的库文件,支持通过 pip install orca-sph 安装,使用 orcasph 命令运行。
OrcaSPH 基于 SPlisHSPlasH 流体仿真引擎,集成了 Orca 系统的两个核心功能模块:
- OrcaLink:支持 SPH 仿真器与 OrcaLink 服务器的 gRPC 通信,实现流体对刚体的作用力传输和刚体位置/速度接收
- ParticleRender:支持粒子数据通过 gRPC 实时传输到渲染服务
Orca 集成允许在分布式系统中运行 SPlisHSPlasH 模拟器,并与其他计算节点进行实时数据交换。
系统要求
- Python:3.10+ (不再支持 3.8 和 3.9)
- 操作系统:Linux (x86_64)
- 系统库:已安装必要的系统库(libGL, libX11 等)
安装
从 PyPI 安装(推荐)
pip install orca-sph
安装后可以使用:
- 命令行工具:
orcasph --help - Python 模块:
import orcasph_client
基本用法
启动仿真
orcasph --scene path/to/scene.json
常用选项
使用 orcasph --help 查看完整的命令行选项,包括:
--scene FILE:场景文件路径(必需)--cpu RANGE:指定 CPU 核心范围--threads N:指定 OpenMP 线程数--config FILE:gRPC 配置文件路径--gui:启用 GUI 模式运行
许可证
本包采用双许可证:
- SPlisHSPlasH 核心代码:MIT License (Copyright © 2016 Jan Bender)
- Orca 扩展:Proprietary License (Copyright © 2026 Songying Technology Inc.)
详细信息请参考 LICENSE 文件。
Metadata
Release files for orca-sph 26.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Actions Reset | |||
|---|---|---|---|---|
| orca_sph-26.8.1-cp313-cp313-manylinux_2_35_x86_64.whl | CPython 3.13 | CPython 3.13 | Linux glibc 2.35+ x86-64 | Details for orca_sph-26.8.1-cp313-cp313-manylinux_2_35_x86_64.whl |
| orca_sph-26.8.1-cp312-cp312-manylinux_2_35_x86_64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.35+ x86-64 | Details for orca_sph-26.8.1-cp312-cp312-manylinux_2_35_x86_64.whl |
| orca_sph-26.8.1-cp311-cp311-manylinux_2_35_x86_64.whl | CPython 3.11 | CPython 3.11 | Linux glibc 2.35+ x86-64 | Details for orca_sph-26.8.1-cp311-cp311-manylinux_2_35_x86_64.whl |
| orca_sph-26.8.1-cp310-cp310-manylinux_2_35_x86_64.whl | CPython 3.10 | CPython 3.10 | Linux glibc 2.35+ x86-64 | Details for orca_sph-26.8.1-cp310-cp310-manylinux_2_35_x86_64.whl |
Total release size: 215.7 MB
Release files / orca_sph-26.8.1-cp313-cp313-manylinux_2_35_x86_64.whl
| Download URL | orca_sph-26.8.1-cp313-cp313-manylinux_2_35_x86_64.whl |
|---|---|
| Size | 53.9 MB |
| Tags | CPython 3.13 Linux glibc 2.35+ x86-64 |
|
SHA-256 checksum How to use checksums |
3a51ef2c73f421c822cafc959d0fd7f205db645ceb52978a5bf86a8d0239cd92
|
|
BLAKE2b-256 checksum How to use checksums |
333e7283e527bd13eecf7b3faa7b1b7ebf4a9c18934f4dc191ac532250dd5859
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.13
|
Release files / orca_sph-26.8.1-cp312-cp312-manylinux_2_35_x86_64.whl
| Download URL | orca_sph-26.8.1-cp312-cp312-manylinux_2_35_x86_64.whl |
|---|---|
| Size | 53.9 MB |
| Tags | CPython 3.12 Linux glibc 2.35+ x86-64 |
|
SHA-256 checksum How to use checksums |
cc0da09b2056ea77fece3eaa267fa1caa3c2cda78248198631ff96b4ba03c0cb
|
|
BLAKE2b-256 checksum How to use checksums |
24052a1b1b12f24dc22a2249d362c12984488dda0f4b0a61eade01b98e9f0268
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.13
|
Release files / orca_sph-26.8.1-cp311-cp311-manylinux_2_35_x86_64.whl
| Download URL | orca_sph-26.8.1-cp311-cp311-manylinux_2_35_x86_64.whl |
|---|---|
| Size | 53.9 MB |
| Tags | CPython 3.11 Linux glibc 2.35+ x86-64 |
|
SHA-256 checksum How to use checksums |
cd0eef08195e2aa5a5024ba2acc3defecb75c3097fa7d930becdd390a34df3c6
|
|
BLAKE2b-256 checksum How to use checksums |
2d6acf7f4cc01e04d2a4b0399d17b5b64e1f7a4a85e7f1a352ab853f17449a5b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.13
|
Release files / orca_sph-26.8.1-cp310-cp310-manylinux_2_35_x86_64.whl
| Download URL | orca_sph-26.8.1-cp310-cp310-manylinux_2_35_x86_64.whl |
|---|---|
| Size | 53.9 MB |
| Tags | CPython 3.10 Linux glibc 2.35+ x86-64 |
|
SHA-256 checksum How to use checksums |
01fd8e624f70a629c26361f1df00f8f9e4e9d24da0156d6badded62115bee12a
|
|
BLAKE2b-256 checksum How to use checksums |
f00f84a82e722ffb498c3340c2b1d67c9d46f7e92a231ec6630957966f8665d9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.13
|
Security for orca-sph 26.8.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.