oxiphysics 0.1.0

Unified physics engine - Bullet/OpenFOAM/LAMMPS/CalculiX replacement
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

# OxiPhysics

**Status: Alpha** — functional umbrella re-export crate.

A unified, pure-Rust physics engine covering rigid body dynamics, fluid simulation, finite
element analysis, molecular dynamics, soft body simulation, and more.

OxiPhysics is designed as a Rust-native replacement for libraries such as Bullet Physics,
OpenFOAM, LAMMPS, and CalculiX — providing a single coherent API across multiple physics
domains through one top-level dependency.

Version: **0.1.0** | Updated: **2026-04-06**

---

## What `oxiphysics` provides

The `oxiphysics` crate is an **umbrella re-export crate**: it re-exports every sub-crate under
a named module, so users can access all of OxiPhysics through a single `Cargo.toml` entry.

### Re-exported modules

| Module | Sub-crate |
|---|---|
| `oxiphysics::core` | `oxiphysics-core` — math primitives, PDE/ODE solvers, statistics |
| `oxiphysics::geometry` | `oxiphysics-geometry` — B-splines, mesh geometry, computational geometry |
| `oxiphysics::collision` | `oxiphysics-collision` — broad-phase (SAP) + narrow-phase (EPA/GJK) |
| `oxiphysics::rigid` | `oxiphysics-rigid` — rigid body dynamics, kinematics, mechanisms |
| `oxiphysics::constraints` | `oxiphysics-constraints` — constraint solving, robot control |
| `oxiphysics::vehicle` | `oxiphysics-vehicle` — vehicle dynamics simulation |
| `oxiphysics::sph` | `oxiphysics-sph` — Smoothed Particle Hydrodynamics |
| `oxiphysics::lbm` | `oxiphysics-lbm` — Lattice Boltzmann Method |
| `oxiphysics::fem` | `oxiphysics-fem` — Finite Element Method structural analysis |
| `oxiphysics::md` | `oxiphysics-md` — Molecular dynamics simulation |
| `oxiphysics::softbody` | `oxiphysics-softbody` — soft body dynamics, crack propagation, bio-mechanics |
| `oxiphysics::materials` | `oxiphysics-materials` — material models, smart materials |
| `oxiphysics::gpu` | `oxiphysics-gpu` — GPU acceleration support |
| `oxiphysics::viz` | `oxiphysics-viz` — visualization and rendering |
| `oxiphysics::io` | `oxiphysics-io` — VTK, OpenFOAM, HDF5, medical imaging I/O |
| `oxiphysics::pipeline` | Pipeline utilities for multi-domain simulations |

---

## Installation

```toml
[dependencies]
oxiphysics = "0.1.0"
```

For a lighter dependency footprint, use individual sub-crates:

```toml
[dependencies]
oxiphysics-core = "0.1.0"
oxiphysics-rigid = "0.1.0"
oxiphysics-collision = "0.1.0"
```

---

## Quick Start

```rust
use oxiphysics::core::transform::Transform;
use oxiphysics::core::math::Vec3;

fn main() {
    let mut transform = Transform::default();
    let point = Vec3::new(1.0, 2.0, 3.0);
    let moved = transform.transform_point(point);
    println!("Transformed: {:?}", moved);
}
```

### Rigid body simulation

```rust
use oxiphysics::rigid::RigidBody;
use oxiphysics::core::math::Vec3;

let body = RigidBody::new(1.0, Vec3::new(0.0, 10.0, 0.0));
```

### SPH fluid simulation

```rust
use oxiphysics::sph::SphSimulation;

let mut sim = SphSimulation::default();
sim.step(0.01);
```

### Finite element analysis

```rust
use oxiphysics::fem::FemSolver;

let solver = FemSolver::new();
```

---

## Sub-crate feature flags

Each sub-crate can be toggled via Cargo features when using the umbrella crate. See the
individual sub-crate READMEs for details.

---

## Documentation

Full API documentation: [docs.rs/oxiphysics](https://docs.rs/oxiphysics)

Source and issue tracker: [github.com/cool-japan/oxiphysics](https://github.com/cool-japan/oxiphysics)

---

## License

Apache-2.0 — Copyright 2026 COOLJAPAN OU (Team Kitasan)