Skip to content

Latest commit

 

History

History
49 lines (31 loc) · 3.65 KB

README.md

File metadata and controls

49 lines (31 loc) · 3.65 KB

Atomify - a real time LAMMPS visualizer

Build Status Join the chat at https://gitter.im/ovilab

The typical workflow when developing scripts for LAMMPS includes working with several programs. A text editor is needed to modify the scripts, the terminal to run LAMMPS, and programs like VMD or Ovito reading trajectories from a file dumped to the disk to visualize the system over time. If physical quantities are computed with LAMMPS, the data is often plotted with MATLAB or Python. This is a tedious process, especially for teaching purposes and for people who are new to LAMMPS. We here introduce Atomify, a high performance live visualizer for LAMMPS simulations with stunning graphics able to simulate and render more than 250000 atoms with good frame rate. Atomify supports OpenMP parallelization, GPU acceleration, live plotting of LAMMPS variables and computes and an easy to use code editor in one single program. The latter utilizes the powerful machinery already built into LAMMPS to allow easy access to advanced physical quantities. Atomify is open source software written in C++ built on top of Qt.

Atomify lets you run LAMMPS and visualize the state live

How to install

MacOS

Alternative 1a) Download the dmg (preferred).

Alternative 1b) If 1a crashes, download the simple dmg (without OpenMP acceleration).

Alternative 2) Install with Homebrew: brew install https://raw.githubusercontent.com/ovilab/atomify/dev/macos/atomify.rb. The installation takes ~10 minutes.

Alternative 3) Download from Mac App Store (this option has limitations on the file system).

Linux

Alternative 1) Download

Alternative 2) sudo snap install atomify

Windows

Coming soon.

How to build

Step 1) You will need Qt 5.10. The easiest way to achieve this is to download Qt Creator from https://www.qt.io/download-open-source/ and install it from there. When you run the installer, you can just press skip when it asks you for the account. If you are using Mac, you can also uncheck the ~10GB iOS package unless you want that.

If you are on Ubuntu, you will also need OpenGL libraries. You can achieve this by running sudo apt install libgl1-mesa-dev.

Step 2) Clone the Atomify repository git clone --recursive https://github.com/ovilab/atomify.git

Step 3) Open the atomify directory and run python configure.py which will configure and compile LAMMPS.

Step 4) Open atomify.pro in Qt Creator and build/run (remember to choose Release mode for maximum performance).

How to add/remove LAMMPS packages

If you compiled Atomify yourself, you can easily modify the LAMMPS installation (packages and your own code). LAMMPS is located in libs/lammps. You need to recompile LAMMPS with (being in the libs/lammps/src folder) make atomify mode=lib. Then you need to recompile Atomify, but Qt won't detect your changes unless you modify i.e. main.cpp (just add a line and save to modify date).