From bbfdecb5a40ae9c1412a91d1158b9d04cd72bdaa Mon Sep 17 00:00:00 2001 From: RainierBarrett Date: Tue, 6 Feb 2024 15:08:24 -0700 Subject: [PATCH] Add instructions for using pre-compiled ovito docker container --- wiki/pages/How_to_visualize.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/wiki/pages/How_to_visualize.md b/wiki/pages/How_to_visualize.md index fdcc156..deaa30d 100644 --- a/wiki/pages/How_to_visualize.md +++ b/wiki/pages/How_to_visualize.md @@ -20,3 +20,15 @@ Installation instructions can be found [here](Installing_the_Frequently-Used_Pro 1. [Ovito](https://www.ovito.org/macos-downloads/) is a propreitary software package with a free basic version availaible for download. Getting off the ground may be faster with Ovito, but if we outgrow the basic version's functionality, someone will have to pay for an upgrade! A notable advantage of Ovito is the ability to view the output from a simulation remotely. + * We have a frozen image of a compiled version of OVITO from before the paywall was added, hosted on dockerhub. For now it only runs on Linux machines, but you can do things like view two trajectories at once with this image. To run it: + ``` + docker pull cmelab/ovito:latest + docker run --rm -it -v /tmp/.X11-unix:/tmp/.X11-unix -v : -e DISPLAY=$DISPLAY -e QT_X11_NO_MITSHM=1 cmelab/ovito + ``` + * These docker flags instruct docker, in order: + * `--rm`: not to keep the docker container when the instance ends + * `-it`: to run interactively in pseudo-tty mode (needed for interactive shell) + * `-v /tmp/.X11-unix:/tmp/.X11-unix`: where your computer's X11 socket lives (where to send video stream) + * `-v :` (optionally) what files to make visible inside the container, e.g. an MD trajectory + * `-e DISPLAY=$DISPLAY` what display environment variable to use + * `-e QT_X11_NO_MITSHM=1` to disable shared memory for video buffer (necessary to stream from container) \ No newline at end of file