Skip to content

Commit 5a101e2

Browse files
Add example config files (#558)
* Add example config files * Update config examples link
1 parent e5df43d commit 5a101e2

37 files changed

+877
-2
lines changed

README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -289,7 +289,8 @@ This will run a singlepoint energy calculation on `KCl.cif` using the [MACE-MP](
289289
> [!NOTE]
290290
> `properties` must be passed as a Yaml list, as above, not as a string.
291291
292-
Example configurations for all commands can be found in [janus-tutorials](https://github.com/stfc/janus-tutorials/tree/main/configs)
292+
Minimal and full example configuration files for all calculations can be found
293+
[here](https://stfc.github.io/janus-core/examples/index.html).
293294

294295

295296
## Development
Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
===========
2+
Descriptors
3+
===========
4+
5+
A minimal example configuration file for ``janus descriptors`` is:
6+
7+
.. literalinclude:: minimal/descriptors.yml
8+
9+
An example configuration file with all parameters set for ``janus descriptors`` is:
10+
11+
.. literalinclude:: full/descriptors.yml

docs/source/examples/eos.rst

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
=================
2+
Equation of State
3+
=================
4+
5+
A minimal example configuration file for ``janus eos`` is:
6+
7+
.. literalinclude:: minimal/eos.yml
8+
9+
An example configuration file with all parameters set for ``janus eos`` is:
10+
11+
.. literalinclude:: full/eos.yml
Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
arch: mace_mp
2+
device: cpu
3+
model: "tests/models/mace_mp_small.model"
4+
calc_kwargs:
5+
dispersion: True
6+
7+
struct: "tests/data/NaCl.cif"
8+
invariants_only: True
9+
calc_per_element: False
10+
calc_per_atom: True
11+
out: NaCl-descriptors.extxyz
12+
13+
file_prefix: NaCl
14+
read_kwargs:
15+
index: ":"
16+
write_kwargs:
17+
invalidate_calc: False
18+
19+
log: descriptors-log.yml
20+
summary: descriptors-summary.yml
21+
tracker: False
22+
progress_bar: True

docs/source/examples/full/eos.yml

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
arch: mace_mp
2+
device: cpu
3+
model: "tests/models/mace_mp_small.model"
4+
calc_kwargs:
5+
dispersion: True
6+
7+
struct: "tests/data/NaCl.cif"
8+
min_volume: 0.9
9+
max_volume: 1.1
10+
n_volumes: 10
11+
eos_type: birchmurnaghan
12+
minimize: True
13+
minimize_all: True
14+
fmax: 0.01
15+
minimize_kwargs:
16+
filter_kwargs:
17+
constant_volume: True
18+
write_structures: True
19+
plot_to_file: True
20+
21+
file_prefix: NaCl
22+
read_kwargs:
23+
index: "0"
24+
write_kwargs:
25+
invalidate_calc: True
26+
27+
log: eos-log.yml
28+
summary: eos-summary.yml
29+
tracker: False
Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
arch: mace_mp
2+
device: cpu
3+
model: "tests/models/mace_mp_small.model"
4+
calc_kwargs:
5+
dispersion: True
6+
7+
struct: "tests/data/NaCl.cif"
8+
optimizer: FIRE
9+
fmax: 0.0005
10+
steps: 100
11+
opt_cell_lengths: False
12+
opt_cell_fully: True
13+
filter_class: UnitCellFilter
14+
pressure: 0.0001
15+
symmetrize: True
16+
symmetry_tolerance: 0.001
17+
out: NaCl-opt.extxyz
18+
write_traj: True
19+
minimize_kwargs:
20+
filter_kwargs:
21+
constant_volume: True
22+
traj_kwargs:
23+
invalidate_calc: True
24+
opt_kwargs:
25+
maxstep: 0.1
26+
27+
file_prefix: NaCl
28+
read_kwargs:
29+
index: "0"
30+
write_kwargs:
31+
invalidate_calc: True
32+
33+
log: geomopt-log.yml
34+
summary: geomopt-summary.yml
35+
tracker: False

docs/source/examples/full/neb.yml

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
arch: mace_mp
2+
device: cpu
3+
model: "tests/models/mace_mp_small.model"
4+
calc_kwargs:
5+
dispersion: True
6+
7+
init-struct: "tests/data/LiFePO4_start.cif"
8+
final-struct: "tests/data/LiFePO4_end.cif"
9+
neb-structs: null
10+
neb-class: NEB
11+
n-images: 10
12+
write-band: True
13+
neb-kwargs:
14+
dynamic_relaxation: False
15+
interpolator: pymatgen
16+
interpolator-kwargs:
17+
autosort_tol: 0.0
18+
optimizer: FIRE
19+
fmax: 1
20+
steps: 1000
21+
optimizer-kwargs:
22+
a: 0.01
23+
plot-band: True
24+
minimize: True
25+
minimize_kwargs:
26+
opt_kwargs:
27+
maxstep: 0.1
28+
29+
file_prefix: NaCl
30+
read_kwargs:
31+
index: "0"
32+
write_kwargs:
33+
invalidate_calc: True
34+
35+
log: neb-log.yml
36+
summary: neb-summary.yml
37+
tracker: False

docs/source/examples/full/nph.yml

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
arch: mace_mp
2+
device: cpu
3+
model: "tests/models/mace_mp_small.model"
4+
calc_kwargs:
5+
dispersion: True
6+
7+
ensemble: nph
8+
struct: "tests/data/NaCl.cif"
9+
steps: 100
10+
timestep: 0.1
11+
temp: 100
12+
equil_steps: 100
13+
minimize: True
14+
minimize_every: 50
15+
minimize_kwargs:
16+
filter_class: null
17+
rescale_velocities: True
18+
remove_rot: True
19+
rescale_every: 50
20+
21+
post_process_kwargs:
22+
rdf_compute: True
23+
correlation_kwargs:
24+
vaf:
25+
a: Velocity
26+
points: 250
27+
saf:
28+
a: Stress
29+
a_kwargs: {'components': ['xy', 'yz', 'zx']}
30+
points: 250
31+
plumed_input: null
32+
plumed_log: null
33+
34+
barostat_time: 75
35+
bulk_modulus: 1
36+
pressure: 1
37+
ensemble_kwargs:
38+
mask: [0, 1, 0]
39+
40+
restart: False
41+
restart_auto: True
42+
restart_stem: nph-restart
43+
restart_every: 1000
44+
rotate_restart: True
45+
restarts_to_keep: 2
46+
47+
final_file: nph-final.extxyz
48+
stats_file: nph-stats.dat
49+
stats_every: 100
50+
traj_file: nph-traj.extxyz
51+
traj_append: False
52+
traj_start: 10
53+
traj_every: 100
54+
55+
file_prefix: NaCl
56+
read_kwargs:
57+
index: "0"
58+
write_kwargs:
59+
invalidate_calc: True
60+
61+
log: nph-log.yml
62+
summary: nph-summary.yml
63+
tracker: False
64+
progress_bar: True
65+
update_progress_every: 10
Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
arch: mace_mp
2+
device: cpu
3+
model: "tests/models/mace_mp_small.model"
4+
calc_kwargs:
5+
dispersion: True
6+
7+
ensemble: npt-mtk
8+
struct: "tests/data/NaCl.cif"
9+
steps: 100
10+
timestep: 0.1
11+
temp: 100
12+
equil_steps: 100
13+
minimize: True
14+
minimize_every: 50
15+
minimize_kwargs:
16+
opt_kwargs:
17+
maxstep: 0.1
18+
rescale_velocities: True
19+
remove_rot: True
20+
rescale_every: 50
21+
22+
post_process_kwargs:
23+
rdf_compute: True
24+
correlation_kwargs:
25+
vaf:
26+
a: Velocity
27+
points: 250
28+
saf:
29+
a: Stress
30+
a_kwargs: {'components': ['xy', 'yz', 'zx']}
31+
points: 250
32+
plumed_input: null
33+
plumed_log: null
34+
35+
pressure: 1
36+
thermostat_time: 100
37+
barostat_time: 1000
38+
thermostat_chain: 3
39+
barostat_chain: 3
40+
thermostat_substeps: 1
41+
barostat_substeps: 1
42+
43+
temp_start: 0
44+
temp_end: 100
45+
temp_step: 10
46+
temp_time: 1
47+
48+
restart: False
49+
restart_auto: True
50+
restart_stem: npt-mtk-restart
51+
restart_every: 1000
52+
rotate_restart: True
53+
restarts_to_keep: 2
54+
55+
final_file: npt-mtk-final.extxyz
56+
stats_file: npt-mtk-stats.dat
57+
stats_every: 100
58+
traj_file: npt-mtk-traj.extxyz
59+
traj_append: False
60+
traj_start: 10
61+
traj_every: 100
62+
63+
file_prefix: NaCl
64+
read_kwargs:
65+
index: "0"
66+
write_kwargs:
67+
invalidate_calc: True
68+
69+
log: npt-mtk-log.yml
70+
summary: npt-mtk-summary.yml
71+
tracker: False
72+
progress_bar: True
73+
update_progress_every: 10

docs/source/examples/full/npt.yml

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
arch: mace_mp
2+
device: cpu
3+
model: "tests/models/mace_mp_small.model"
4+
calc_kwargs:
5+
dispersion: True
6+
7+
ensemble: npt
8+
struct: "tests/data/NaCl.cif"
9+
steps: 100
10+
timestep: 0.1
11+
temp: 100
12+
equil_steps: 100
13+
minimize: True
14+
minimize_every: 50
15+
minimize_kwargs:
16+
filter_class: null
17+
rescale_velocities: True
18+
remove_rot: True
19+
rescale_every: 50
20+
21+
post_process_kwargs:
22+
rdf_compute: True
23+
correlation_kwargs:
24+
vaf:
25+
a: Velocity
26+
points: 250
27+
saf:
28+
a: Stress
29+
a_kwargs: {'components': ['xy', 'yz', 'zx']}
30+
points: 250
31+
plumed_input: null
32+
plumed_log: null
33+
34+
thermostat_time: 50
35+
barostat_time: 75
36+
bulk_modulus: 1
37+
pressure: 1
38+
ensemble_kwargs:
39+
mask: [0, 1, 0]
40+
41+
temp_start: 0
42+
temp_end: 100
43+
temp_step: 10
44+
temp_time: 1
45+
46+
restart: False
47+
restart_auto: True
48+
restart_stem: npt-restart
49+
restart_every: 1000
50+
rotate_restart: True
51+
restarts_to_keep: 2
52+
53+
final_file: npt-final.extxyz
54+
stats_file: npt-stats.dat
55+
stats_every: 100
56+
traj_file: npt-traj.extxyz
57+
traj_append: False
58+
traj_start: 10
59+
traj_every: 100
60+
61+
file_prefix: NaCl
62+
read_kwargs:
63+
index: "0"
64+
write_kwargs:
65+
invalidate_calc: True
66+
67+
log: npt-log.yml
68+
summary: npt-summary.yml
69+
tracker: False
70+
progress_bar: True
71+
update_progress_every: 10

0 commit comments

Comments
 (0)