Validated Codes

  1. Create a factory
  2. Simulate and analyze an atomistic protein
  3. Standalone automacs simulation
  4. Autoplot feature
  5. Simulation notebook
  6. Simulation-analysis pipeline
  7. Coarse-grained bilayer demonstration

How to read the validation list

Each item on the validation list corresponds to a tested use-case or implemented feature in our codes. Many of the unit tests are logged on the tests reports page, which provides a full record of all commit hashes for the time of the completed test. The following list is meant to serve as a guide for running the tests, particularly since some require the use of the interface, and hence cannot be automatically tested at the command line.

Create a factory

tested 2018.04.16

Instructions: Users can create a factory by cloning http://github.com/biophyscode/factory. The make help command provides instructions at the terminal. The quickstart guide to installing the factory provides more complete instructions.

Unit test: The unit test for the factory is completed from a separate, testing factory explained in the Docker quickstart guide which gets the units tests from a separate repository. Run the unit test factory setup from testset.py via make test factory setup to complete the test and generate the factory for other tests. If you have not yet prepared any Docker images, then this unit test will build them for you, so it might take a few minutes. Note that this method is a common starting point for many other tests.

Simulate and analyze an atomistic protein

tested 2018.04.16

Instructions: This test covers the quick start guide for analyzing preexisting simulation data. Expert users can follow the docker quickstart guide using the factory testset to test it. New users are encouraged to try the quickstart guide to run the code themselves. In this example, you start with a previous simulation of an atomistic protein in GROMACS generated by a standalone automacs simulation and then compute the protein RMSD, make a simple plot, and generate a video using VMD.

Unit test: Create a testing factory with units tests from the factory-testset. Run unit test make test demo protein generate to generate data. Run unit test make test demo protein to run this test, which includes everything covered in the quickstart guide. Note that the testset will create a new omnicalc project with calculation codes from the omni-basic repository. The data-generation portion of the test effectively covers the standalone automacs test.

Standalone automacs simulation

tested 2018.04.16

Instructions: Generate an atomistic protein simulation using a standalone copy of automacs according to the quickstart guide. The atomistic protein simulation can be completed without a factory.

Autoplot feature

Note: Several unit tests, particularly the simulation-analysis pipeline and the coarse-grained bilayer tests, include this feature.

Instructions: Some omnicalc plot scripts use a method called “autoplot” which makes it possible to write somewhat more modular plotting codes. This feature is described in a separate guide.

Simulation notebook

pending test

Instructions: In addition to running simulations in the factory interface or a standalone automacs instance, users can also use a notebook to run a simulation. This feature is described in a separate guide.

Simulation-analysis pipeline

tested 2018.04.16

Instructions: The simulation-analysis pipeline walkthrough shows users how to set up the factory and use the web interface to run and analyze a simulation.

Unit test: Create a testing factory with units tests from the factory-testset. Run the make test factory setup unit test to create a factory. The testing factory should have a file at factory-testset/tests/testset.py where you can set the open ports and hostname for serving the factory over the internet. These settings can be found in the demo serve section. Once you have set these values, run the unit test make test demo serve in the usual way. Then you may complete the simulation-analysis pipeline walkthrough using the graphical interface. Note that this test includes the atomistic protein walkthrough (we have a separate test for the coarse-grained bilayer) and the video rendering instructions.

Coarse-grained bilayer demonstration

tested 2018.04.16

Instructions: An addition to the simulation-analysis pipeline walkthrough includes a tutorial for creating coarse-grained bilayers. The analysis of the bilayers includes an extra library for generating abstract mesh structures of the bilayer as well as use of the autoplot method.

Unit test: Run the unit test named make test demo serve as per the pipeline test above and follow the coarse-grained bilayer walkthrough. This test should get all of the necessary calculation codes from the omni-basic repository. You may also test the autoplot demonstration from the command line.