Skip to main content

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)

Table of built distributions (wheels) for orca-sph 26.8.1
File Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page