The appropriate badge will appear at the end of each step to make it easier to check your progress. Therefore, it is advisable to click on the badge and look for the results of the latest commit, instead of waiting until the badge status is updated. However, keep in mind that, even when your submission has passed the step's tests, it takes some minutes for the corresponding badge status to update to passing. It will stay this way until all three steps of the tutorial are successfully completed, at which point it will change to a green, passing state. Here is an example of one of the badges:Īt this point, the badge is in a gray, no status, state. To check your progress, right-click on the badge shown at the end of each step, open the link in a new tab, and then click on the name of your latest commit. You can make as many attempts as needed to successfully complete them. By making the changes indicated in the instructions below, you will be able to sequentially pass each of the three steps. For now, the steps are marked as incomplete. Every time you commit (or push, if working from your local machine) your changes, the repository will automatically check your progress on each of the three steps. We recommend using GitHub's browser interface and opening this repository in a second tab this way you will be able to revisit the instructions while you create or edit files. Keep in mind that the repository will only allow you to create a Dockerfile and modify the existing build_image.sh and run_experiment.sh files (yes, just three steps to containerize a model!). You will be able to complete these steps using GitHub's browser interface, but you can also choose to clone this repository to your local machine and push your changes from there. We break down the process of building and running a Docker container into three steps. However, we suggest that you refrain from modifying them until instructed in the steps below. Feel free to explore the contents of this repository before coming back to this page. We have modified it to create a mock BehaviorSpace experiment (named "experiment1") and included it in the src folder of this repository. In this tutorial you will containerize the "Wolf Sheep Predation" model from NetLogo's model library. Feel free to implement this organization within your own project. We have structured this repository following the suggested project organization by Software Carpentry. Please note that we assume that you have completed the Basics of Git and GitHub tutorial beforehand or that you are already familiar with how to use GitHub. With this knowledge and following the instructions given in docs/Next Steps, you should be able to containerize your own model on your local machine. Once completed, we expect you to have a basic understanding of what you need to do to containerize and run your NetLogo model using Docker. The objective of this tutorial is to provide you with a hands-on experience of the steps involved, without the need to download or run anything locally on your machine. To learn more about the importance of containerizing models and the basic principles behind this tool, we invite you to read our article. Welcome! This tutorial will walk you through the process of containerizing a NetLogo model.
0 Comments
Leave a Reply. |