DOCUMENTATION
Complete guide to using PISTON for professional engine simulation
Installation
Download PISTON for your platform from the download page. Follow the platform-specific installation instructions for Windows, macOS, or Linux.
System Requirements:
- • Dual-core CPU 2.0 GHz+ (quad-core 3.0 GHz+ recommended)
- • 4 GB RAM minimum (8 GB+ recommended)
- • 200 MB disk space (500 MB+ for simulation data)
- • OpenGL 3.3+ compatible graphics
Quick Start: 5-Minute Tutorial
1Launch PISTON
Open the application from your system's launcher. The CLI interface will appear (GUI coming in Phase 2).
2Load Sample Engine
$ piston load --engine ls3_stockLoads the GM LS3 6.2L V8 with factory specifications.
3Run Simulation
$ piston simulate --rpm-range 1000:7000 --step 250Simulates across RPM range from 1000 to 7000 RPM in 250 RPM increments.
4View & Export Results
$ piston results --show
$ piston export --format csv --output results.csvDisplay results in terminal and export to CSV for analysis in Excel, MATLAB, etc.
Next Steps
- • Explore the User Manual section below for detailed commands
- • Learn about the Parts Database to customize your build
- • Check Case Studies for real-world examples
- • Join the Discord community for tips and support
ADDITIONAL RESOURCES
Case Studies
Real-world engine builds with before/after comparisons
Help Center
Detailed guides and troubleshooting resources
Changelog
Version history and feature updates