# Physics in Parallel documentation
These guides describe **PiP 4.1.1-alpha**, a documentation patch with the same
runtime, public API, and data formats as 4.1.0-alpha. Older-generation users should
read [release migration](RELEASES.md).
**All AI agents must read [docs/AGENTS.md](AGENTS.md) before working with PiP.**
## Numbered learning path
1. [Overview](guide/1-overview.md)
2. [Installation](guide/2-installation.md)
3. [Your first simulation](guide/3-first-simulation.md)
4. [Tensors, matrices, and vectors](guide/4-tensors-matrices-and-vectors.md)
5. [Randomness and sampling](guide/5-randomness-and-sampling.md)
6. [Spaces, lattices, and pairs](guide/6-spaces-lattices-and-pairs.md)
7. [Particle state](guide/7-particle-state.md)
8. [Forces, integration, and thermostats](guide/8-forces-integration-and-thermostats.md)
9. [Serialization and NumPy](guide/9-serialization-and-numpy.md)
10. [Parallelism and performance](guide/10-parallelism-and-performance.md)
11. [Advanced extensions](guide/11-advanced-extensions.md)
12. [AI-assisted integration](guide/12-ai-assisted-integration.md)
Each chapter ends with a link to the next. Chapters 1–3 get a simulation running;
4–6 explain numerical and spatial foundations; 7–9 cover particles and data;
10–12 cover performance, extensions, and AI-assisted integration.
## Existing projects
Follow the [project migration procedure](AGENTS.md#migrate-an-existing-project-to-pip)
for adopting PiP while preserving existing science. This is distinct from
[upgrading an older PiP release](RELEASES.md).
## Reference and examples
- [API index](reference/api-index.md) and [rustdoc](https://docs.rs/physics_in_parallel/4.1.1-alpha).
- [Complete examples](EXAMPLES.md).
- [Performance contracts](PERFORMANCE.md) and [advanced API](ADVANCED.md).
- [NumPy helper](NUMPY.md).
- [Troubleshooting](troubleshooting.md).
## Validation and releases
- [Independent numerical correctness](CORRECTNESS.md).
- [SIMD comparisons](SIMD.md).
- [Benchmark commands, measurements, and limits](BENCHMARKS.md).
- [Release notes and maintainer checks](RELEASES.md).
Repository verification commands run from the repository root. Application
tutorial commands run from the application directory named by the chapter.