Skip to content

Commit

Permalink
Improve installation instructions and provide env yaml file
Browse files Browse the repository at this point in the history
  • Loading branch information
fjclark committed Jun 17, 2024
1 parent 6ef4d22 commit 18da7d1
Show file tree
Hide file tree
Showing 2 changed files with 27 additions and 12 deletions.
19 changes: 7 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,24 +15,19 @@ a3fe

a3fe depends on SLURM for scheduling jobs, and on GROMACS for running initial equilibration simulations. Please ensure that your have sourced your GMXRC or loaded your GROMACS module before proceeding with the installation.

We first need to install the [BioSimSpace](https://biosimspace.openbiosim.org/) dependencies using mamba (or conda). SOMD, which is used to run the simulations, is contained within Sire, which will be installed as a dependency of BioSimSpace.
Now, download and install a3fe:
```bash
mamba create -n a3fe -c conda-forge -c openbiosim/label/dev biosimspace
mamba activate a3fe
git clone https://github.com/michellab/a3fe.git
cd a3fe
mamba mamba env create -f environment.yml
python -m pip install --no-deps .
```
Now download a3fe, install, and test:
```bash
git clone https://github.com/fjclark/a3fe.git
cd a3fe
pip install .
pytest a3fe
```


### Quick Start

- Activate your a3fe conda environment
- Create a base directory for the calculation and create an directory called `input` within this
- Move your input files into the the input directory. For example, if you have parameterised AMBER-format input files, name these bound_param.rst7, bound_param.prm7, free_param.rst7, and free_param.prm7. For more details see the documentation.
- Move your input files into the the input directory. For example, if you have parameterised AMBER-format input files, name these bound_param.rst7, bound_param.prm7, free_param.rst7, and free_param.prm7. For more details see the documentation. Alternatively, copy the example input files from a3fe/a3fe/data/example_run_dir to your input directory.
- Copy run somd.sh and template_config.sh from a3fe/a3fe/data/example_run_dir to your `input` directory, making sure to the SLURM options in run_somd.sh so that the jobs will run on your cluster
- In the calculation base directory, run the following python code, either through ipython or as a python script (you will likely want to run the script with `nohup`or use ipython through tmux to ensure that the calculation is not killed when you lose connection)

Expand Down
20 changes: 20 additions & 0 deletions environment.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
name: a3fe
channels:

- conda-forge
- "openbiosim/label/dev"

dependencies:
# Base depends
- arviz
- pandas
- python>=3.9
- pip
- numpy
- matplotlib
- scipy
- ipython
- pymbar<4
- ambertools
- biosimspace>2023.4
- pydantic

0 comments on commit 18da7d1

Please sign in to comment.