Please replace the following with information about your own repository.
Welcome! This is a template git repository for creating REPRODUCIBLE Underworld code based projects.
REPRODUCIBLE because this project:
- Is stored in a git repository.
- Uses a Dockerfile to recreate the exact project environment.
The two features above enable the project to take advantage of software engineering and open source principles, such as: version control, reproducible environments, collaboration (Pull Requests, Binderhub), continuous integration.
(See https://the-turing-way.netlify.com/, for a general introduction to these principle. N.B. it is data-science focussed)
You can use this repository as a GitHub template to start a new repository of your own that matches the requirements of the underworld-community. To get started, hit the "Use this template" button above. See this quick start guide for more information.
Please give a quick overview of purpose of the model files/directories included in this repo. Note that while light data files are fine, heavy data should not be included in your repository.
File | Purpose |
---|---|
RayTay.ipynb |
A simple Rayleigh Taylor notebook. |
VrmsCaseA.txt |
Expected results data file. |
raytay.png |
Image file. |
raytay_init.png |
Initial image file. |
Please specify how your repository is tested for correctness.
Tests are not required for laboratory
tagged repositories, although still encouraged.
All other repositories must include a test.
The attained peak VRMs time is tested against an expected value. If it is outside a given tolerance, an exception is raised.
Please specify if your model will operate in parallel, and any caveats.
Yes, test result should be obtained in both serial and parallel operation.
- (Required) Have you replaced the above sections with your own content?
- (Required) Have you updated the Dockerfile to point to your required UW/UWG version?
- (Required) Have you included a working Binder badge/link so people can easily run your model?
You probably only need to replace
template-project
with your repo name. - (Optional) Have you included an appropriate image for your model?