Quick Start
Install Elodin and start simulating.
Install
Download the Elodin Client:
File | Platform | Checksum |
---|---|---|
elodin-aarch64-apple-darwin.tar.gz | Apple Silicon macOS | sha256 |
elodin-x86_64-unknown-linux-gnu.tar.gz | x64 Linux | sha256 |
elodin-x86_64-pc-windows-msvc.zip | x64 Windows | sha256 |
Install the Elodin Python SDK using pip
:
The SDK is only supported on macOS and Linux distributions with glibc 2.35+ (Ubuntu 22.04+, Debian 12+, Fedora 35+, NixOS 21.11+). Windows users can still use Elodin by installing and running the simulation server in Windows Subsystem for Linux. Install the Elodin Python SDK in WSL, after installing WSL.
Start Simulating
Windows (WSL)
To use Elodin on Windows, the simulation server must run in Windows Subsystem for Linux (WSL). The Elodin Client itself can run natively on Windows.
In a Windows terminal launch the Elodin app.
.\elodin.exe
In a WSL terminal download and install elodin
binary into your path then run:
- Create a new simulation using the three-body orbit template.
- Run the simulation server.
Linux / macOS
- Create a new simulation using the three-body orbit template.
- Launch the simulation using the
elodin
CLI.
Perform Analysis
To analyze simulation data, use the Exec
API to run the simulation for some number of ticks and collect the historical component data as a [Polars DataFrame].
The DataFrame can then be used to generate plots or perform other methods of data analysis.
Run the bouncing ball example code to see this in action:
The ball/plot.py
example depends on matplotlib
. Install it using pip
:
Then create & run the ball template:
For more information on data frames check out Polars DataFrame
Next Steps
Try out the following tutorials to learn how to build simulations using Elodin:
Three-Body Orbit Tutorial
Learn how to model a basic stable three-body problem