https://github.com/TeamAtomECS/AtomECS

Cold atom simulation code
https://github.com/TeamAtomECS/AtomECS

amop atoms ecs laser-cooling physics

Last synced: about 1 month ago
JSON representation

Cold atom simulation code

• Host: GitHub
• URL: https://github.com/TeamAtomECS/AtomECS
• Owner: TeamAtomECS
• License: gpl-3.0
• Created: 2020-10-20T14:00:39.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2023-04-20T11:31:02.000Z (about 1 year ago)
• Last Synced: 2024-04-10T05:23:17.067Z (3 months ago)
• Topics: amop, atoms, ecs, laser-cooling, physics
• Language: Rust
• Homepage:
• Size: 5.44 MB
• Stars: 45
• Watchers: 6
• Forks: 9
• Open Issues: 20
• Metadata Files:
  • Readme: README.md
  • License: license.txt

Lists

• awesome-iontraps - AtomECS - Laser cooling simulations - Oxford group ([arxiv paper](https://arxiv.org/abs/2105.06447)) (Software / Theory)

README

        
# AtomECS

> Simulate cold atoms with rust.

Paper out now on [arxiv](https://arxiv.org/abs/2105.06447)

**NOTE: Work is ongoing to change the backend from specs to bevy** - see the `bevy` branch and [this issue](https://github.com/TeamAtomECS/AtomECS/issues/3) for details! You can also run a number of demos from the bevy branch in your browser [here](https://teamatomecs.github.io/AtomECSDemos/).

[![crate_version](https://img.shields.io/crates/v/atomecs.svg?style=flat)](https://crates.io/crates/atomecs)

[![crate_version](https://img.shields.io/badge/docs-latest-blue.svg?style=flat)](https://docs.rs/atomecs)

[![build](https://github.com/TeamAtomECS/AtomECS/actions/workflows/build.yml/badge.svg)](https://github.com/TeamAtomECS/AtomECS/actions/workflows/build.yml) [![unit_tests](https://github.com/TeamAtomECS/AtomECS/actions/workflows/unit-tests.yml/badge.svg)](https://github.com/TeamAtomECS/AtomECS/actions/workflows/unit-tests.yml)

`atomecs` is a rust crate for simulating ultracold atom experiments. It supports numerous features:

* Laser-cooling of atoms by optical scattering forces.

* Doppler forces on atoms that scatter light, including the random fluctuations that give rise to the Doppler temperature limit.

* Magnetic fields, implemented on a grid or through simple analytical models.

* Hot atoms generated by an oven.

* Hot atoms generated on the surface of a simulation volume (eg, to simulate thermal vapor in a chamber).

* Cooling light beams, defined by their detuning and gaussian intensity profiles.

* Volumes that define bounds for the simulation.

* File output in binary or text format.

* Thorough unit testing to ensure simulation results are correct.

* Good parallel performance on modern multi-core CPUs.

* Simulations can be wrapped using python/matlab, as shown in the [source_optimisation_example](https://github.com/TeamAtomECS/source_optimisation_example) or the [matlab examples](https://github.com/TeamAtomECS/matlab_examples).

* Optical dipole force traps.

* Confinement of atoms by magnetic fields, e.g. quadrupole and TOP traps.

# Getting Started

Instructions for installing rust can be found on the [rust website](https://www.rust-lang.org/tools/install), which includes the rust toolchain and `cargo` command line tool.

After cloning this repository using git, you can run examples using the `cargo` command line tool, e.g. `cargo run --release --example 1d_mot`.

The [matlab examples](https://github.com/TeamAtomECS/matlab_examples) show how to load and plot simulation results.

You can build the program documentation using `cargo doc`.

## Data-oriented design

`atomecs` follows the data-oriented Entity-Component-System (ECS) pattern, which is implemented using [specs](https://github.com/slide-rs/specs).

ECS is well suited to high-performance simulations, and is sufficiently flexible to accomodate changing design goals.

_If you are unfamiliar with data-oriented design - for instance, if you come from an object-oriented background - it is strongly recommended that you read up before diving into the code._ Some useful ECS resources are:

* Mike Acton's [GDC talk](https://www.youtube.com/watch?v=p65Yt20pw0g), which discusses the advantages of ECS + DOD (in the context of the Unity game engine).

* The [specs book](https://specs.amethyst.rs/docs/tutorials/) which describes the ECS used in `atomecs`.

* Although written for Unity/C#, the concepts in the [Unity Entities Package Documentation](https://docs.unity3d.com/Packages/[email protected]/manual/ecs_core.html) are very useful to understand.

## Current Limitations

* atom-atom interactions are not implemented. Most of our current work deals with atom sources, which have low steady-state number densities, so we haven't implemented this. Results for steady-state 3D MOTs should be interpreted carefully.

# Getting Involved

Our goal is to make AtomECS user-friendly, with friendly developers! Please feel free to use the issue tracker to ask questions, or join the conversations happening within the issues.

If you would like to submit a contribution:

* Take a look at the issues page to see if there is something suitable for a new user.

* Freely develop and change your own fork.

* When a feature is finished, raise a pull request to merge your changes back into the AtomECS repository. The team will openly review your code and suggest changes/improvements.

## The Team

The current developers of `atomecs` are:

* Dr. [Elliot Bentine](https://github.com/ElliotB256), Oxford

* Dr. [Tiffany Harte](https://github.com/tiffanyharte), Cambridge

* [Xuhui Chen](https://github.com/Pi-sun), Oxford

* [Maurice Zeuner](https://github.com/MauriceZeuner), Cambridge

The long term goal for `atomecs` is to have a complete simulation suite for cold atom experiments.

If you'd like to get involved in development, please do!