1# Solutions to the plate challenges
3This repository holds solutions to the challenges defined in [challenges/plate](https://vault1.magland.org/challenges/plate). It is one of possibly several solution repositories registered with that challenge repository, which clones each of them, compares every solution against a common reference, and publishes the comparison at [challenges/plate/site](https://vault1.magland.org/challenges/plate/site/). This repository's own site, at [challenges/plate-solutions/site](https://vault1.magland.org/challenges/plate-solutions/site/), lists its submissions with audio players and animates the exported displacement fields as a 3D surface.
5## Layout
7```
8solutions/<challenge-id>/<submission-id>.json one submission: metadata and one or more solutions
9solutions/<challenge-id>/<submission-id>/*.wav the scored output files, referenced from the JSON
10solutions/<challenge-id>/<submission-id>/*.h5 optional displacement fields for visualization (git LFS)
11solvers/ source code of the submissions
12web/ this repository's site (built by web/build.py)
13```
15Field exports are about 45 MB each and are stored with git LFS (`.gitattributes` routes `*.h5` there). Cloning without git-lfs leaves pointer files in their place; the validator tolerates that and the site marks such fields as unavailable.
17## The example submission
19`kirchhoff-bfs` solves the Kirchhoff-Love thin-plate reduction of the challenge model with Bogner-Fox-Schmit C1 finite elements on uniform meshes of 4 to 48 elements per side, a closed-form modal time response, and an exact evaluation of the retarded Rayleigh integral. It is a thin-plate approximation, so its converged limit differs from the three-dimensional model that defines the challenge; the chain is ordered by mesh refinement.
21```
22python solvers/kirchhoff-bfs/kl_bfs_plate.py <plate-repo>/challenges/plate-strike-v1/challenge.json solutions/plate-strike-v1/kirchhoff-bfs --fields 48 4 8 12 16 24 32 48
23```
25## Adding a submission
27Follow the same steps as in [challenges/string-solutions](https://vault1.magland.org/challenges/string-solutions#adding-a-submission-to-this-repository): produce the output exactly as the [specification](https://vault1.magland.org/challenges/plate/blob/main/challenges/plate-strike-v1/README.md) says, write `solutions/<challenge-id>/<submission-id>.json` following the [schema](https://vault1.magland.org/challenges/challenge-tools/blob/main/schema.json), record known accuracy orderings in `more_accurate_than`, and open a pull request.
29## Validating locally
31```
32pip install git+https://vault1.magland.org/challenges/challenge-tools
33challenge-tools validate --challenges <path-to-plate-repo>/challenges --solutions solutions
34python web/build.py --out site
35```