From 18da7d1d21591a4af6584cd533f9f7a787132e2c Mon Sep 17 00:00:00 2001 From: finlayclark Date: Mon, 17 Jun 2024 14:09:21 +0100 Subject: [PATCH] Improve installation instructions and provide env yaml file --- README.md | 19 +++++++------------ environment.yaml | 20 ++++++++++++++++++++ 2 files changed, 27 insertions(+), 12 deletions(-) create mode 100644 environment.yaml diff --git a/README.md b/README.md index a7104bb..2d7a22c 100644 --- a/README.md +++ b/README.md @@ -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) diff --git a/environment.yaml b/environment.yaml new file mode 100644 index 0000000..e551c15 --- /dev/null +++ b/environment.yaml @@ -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