taster is a Python package for computing partition coefficients of Martini 3 small molecules using free energy calculations.
Given a molecule's CG structure and ITP file, taster automates the full workflow:
- Solvation box preparation across multiple solvents
- Parallel FEP/TI simulations via GROMACS
- Free energy estimation using TI or MBAR
- LogP calculation relative to a reference solvent (typically water)
- Convergence and overlap diagnostics (forward/backward convergence, MBAR overlap matrix, TI dhdl plots) for each leg
- Python >= 3.11
- GROMACS (2024.3 or greater needed if topologies use angles with restricted bending potentials)
numpy >= 1.20pandas >= 1.0matplotlib >= 3.5MDAnalysis >= 2.0alchemlyb >= 2.0tqdm >= 4.60jax >= 0.7.2
Development dependencies are managed in uv dependency groups. The test group
includes pytest and alchemtest; lint, typecheck, and docs provide the
corresponding development tools.
Install uv first.
Install taster with the dependencies needed to run and test it:
git clone https://github.com/Martini-Force-Field-Initiative/taster.git
cd taster
uv sync --group testThis creates a project environment in .venv using the versions pinned in
uv.lock. GROMACS must also be installed separately.
Install taster with all linting, type-checking, testing, and documentation tools:
uv sync --all-groupsimport taster
# Run the full workflow
df = taster.run_partition_workflow(
itp="MOL.itp",
structure="MOL.gro",
solvents=["water", "octanol-water_74-26", "hexadecane", "chloroform"],
reference="water",
reps=3,
ncores=36,
)
print(df)Or run each step individually:
import taster
# Step 1 — prepare simulation boxes
resname = taster.prepare_partition_setup(
itp="MOL.itp",
structure="MOL.gro",
solvents=["water", "octanol-water_74-26", "hexadecane"],
reps=3,
)
# Step 2 — run TI simulations
taster.run_partitions(
resname, solvents=["water", "octanol-water_74-26", "hexadecane"], reps=3, ncores=36
)
# Step 3 — analyse
df = taster.process_partition(
resname, solvents=["octanol-water_74-26", "hexadecane"], water="water", reps=3
)taster --itp MOL.itp --structure MOL.gro \
--solvents water octanol-water_74-26 hexadecane chloroform \
--reps 3 --ncores 36 --estimator MBARSee all options:
taster --helpimport taster
print(taster.available_solvents())Results are saved to ./Partitions/<resname>/:
results.txt— human-readable report of LogP and ΔG values per replicate and averagepartition_avg.npy— numpy array of averaged results(dG, dG_err, logP, logP_err)per solvent
process_partition and run_partition_workflow also return a pandas.DataFrame:
rep solvent dG dG_err logP logP_err
1 octanol-water_74-26 -12.3 0.4 2.15 0.07
1 hexadecane -15.1 0.5 2.64 0.09
...
avg octanol-water_74-26 -12.3 0.2 2.16 0.04
avg hexadecane -15.1 0.3 2.64 0.05
By default (diagnostics=True), process_partition also saves convergence/overlap
figures for every replicate and solvent leg (including the reference solvent) under
./Partitions/<resname>/diagnostics/<rep>/<solvent>/:
mbar_convergence.png/ti_convergence.png— forward/backward convergence of the free energy estimatembar_overlap_matrix.png— MBAR overlap matrix between neighbouring lambda states (MBAR only)ti_dhdl.png— dHdl curve across lambda states (TI only)convergence.log— convergence analysis log, kept out of the terminal
Pass diagnostics=False to skip this and only compute LogP values.
To run the full test suite from the main folder run:
uv run pytest -v tests/This runs all tests in tests/; alchemtest is installed through the uv test
dependency group.
By default ncores is set to os.cpu_count(), which returns the total number of logical CPUs on the machine. On shared HPC nodes this will be the node's full core count.
Always pass ncores explicitly to match the resources available to your job.
- Luís Borges Araújo — luis.borges@ens-lyon.fr
- Pablo Cardona Perez — pablo.cardona_perez@ens-lyon.fr
LGPLv2.1 License. See LICENSE for details.