# Au–Ag core–shell cyclic loading

## Goal
Compare Au-core/Ag-shell and Ag-core/Au-shell wires through three tension–compression loops. The paper uses MEAM for Au–Ag core–shell nanowires under cyclic loading. The small periodic wire here is a teaching-scale approximation.

## Potential file
**The input is intentionally stopped.** `library.meam` and `AuAg.meam` contain partial transcriptions of Tables 1 and 2, not valid potential files. The extracted Table 2 leaves Cmin(Ag–Au–Au) blank. Table 1 has merged or ambiguous column labels and the screening-index convention needs verification. Recover the original tables and the authors' parameter file before filling these files. Do not fill a gap with a guess. There is no verified downloadable file that implements these exact paper parameters. Consult the [NIST interatomic potentials repository](https://www.ctcms.nist.gov/potentials/) and [LAMMPS MEAM documentation](https://docs.lammps.org/pair_meam.html); other Au–Ag files are not equivalent without validation.

## Requirements and run
MEAM package. Run commands from this directory. Replace `lmp` with your LAMMPS executable. See [LAMMPS_SETUP.md](../LAMMPS_SETUP.md). The input uses metal units: lengths in Å, time in ps, and pressure in bar. `rate` is in inverse ps; the default 0.01/ps is 10^10/s. The output stress is in GPa. Python requires NumPy and Matplotlib.

All runtime estimates are unmeasured. They depend on the processor, LAMMPS build and potential. Check atom count and wall time in the LAMMPS log. The 15-minute target is not verified.

After completing and checking the two potential files, remove the explicit `quit 1` from the input. Then run:

```sh
lmp -in in.auag.lmp -var coretype 1 -var shelltype 2 -var out loops_aucore.txt
lmp -in in.auag.lmp -var coretype 2 -var shelltype 1 -var out loops_agcore.txt
python analyze.py
```

## What to expect and differences
The plot labels complete loops between successive tensile turning points. Incomplete data are flagged. The initial tensile ramp is not a full cycle. The wire has free lateral surfaces and a periodic z axis. Engineering stress uses the initial cylindrical area of radius 17 Å. Geometry, equilibration and rate differ from the paper. Estimated runtime is unknown; 132,000 MD steps per wire could exceed 15 minutes. TODO: resolve and validate all MEAM parameters, check the cycle path and benchmark.
