Skip to content

Commit d827e7b

Browse files
committed
Integrated MACE foundation models into MatterTune
1 parent ceddb9b commit d827e7b

3 files changed

Lines changed: 45 additions & 0 deletions

File tree

docs/backbones/mace.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
# MACE Backbone
2+
3+
MACE is a series of fast and accurate machine learning interatomic potentials with higher order equivariant message passing developed by Ilyes Batatia, Gregor Simm, David Kovacs, and the group of Gabor Csanyi in University of Cambridge. The MACE series released its first foundation model, [MACE-MP-0](https://arxiv.org/abs/2401.00096), in 2023, making it one of the earliest foundation models in the materials domain. To date, MACE has spawned several versions of its foundation models (see [MACE versions](https://github.com/ACEsuit/mace-foundations) for details) and has earned top marks on numerous leaderboards.
4+
5+
## Installation
6+
7+
MACE can be directly installed with pip:
8+
9+
```bash
10+
pip install --upgrade pip
11+
pip install mace-torch
12+
```
13+
14+
or it can be installed from source code:
15+
16+
```bash
17+
git clone https://github.com/ACEsuit/mace.git
18+
pip install ./mace
19+
```
20+
21+
## Key Features
22+
23+
MACE adopts an equivariant neural-network paradigm and delivers energy-conserving predictions of forces and stresses. For details on the specific features of each MACE version, please consult the introduction here: [MACE versions](https://github.com/ACEsuit/mace-foundations)
24+
25+
## License
26+
27+
The MatterSim backbone is available under MIT License

docs/installation.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,23 @@ uv pip install -e .
5151
python setup.py build_ext --inplace
5252
```
5353

54+
### MACE
55+
56+
MACE can be directly installed with pip:
57+
58+
```bash
59+
pip install --upgrade pip
60+
pip install mace-torch
61+
```
62+
63+
or it can be installed from source code:
64+
65+
```bash
66+
git clone https://github.com/ACEsuit/mace.git
67+
pip install ./mace
68+
```
69+
70+
5471
### JMP
5572

5673
Please follow the installation instructions in the [jmp-backbone repository](https://github.com/nimashoghi/jmp-backbone/blob/lingyu-grad/README.md).

docs/introduction.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ Seamlessly work with multiple state-of-the-art pre-trained models including:
1515
- M3GNet
1616
- ORB
1717
- MatterSim
18+
- MACE
1819

1920
### Flexible Property Predictions
2021
Support for various molecular and materials properties:

0 commit comments

Comments
 (0)