‘How can I submit a Morpheus model?’
All Morpheus models including their complete version history are stored in a Git repository:
gitlab.com/morpheus.lab/model-repo (from this Git repository all model pages you can find on this website are automatically generated).
Model submission via GitLab
Models can be submitted in eight simple steps. The complete model upload procedure is shown in this short video:
Below you’ll find a more detailed, illustrated walkthrough explaining each step.
- Prepare a valid and running XML model file including meaningful title and description, e.g. using your local Morpheus GUI.
- A (free) user account at GitLab.com is needed (which hosts Morpheus' open source repository). You can also sign in using an existing GitHub/Google/Twitter account. This account will also allow you later to track and modify your model. You need to be logged in at GitLab via the ‘Sign in / Register’ button on the top right to proceed to the next step.
- Now fork the repo, i.e. save a copy of the repository under your GitLab user account, by clicking on ‘Fork’ at gitlab.com/morpheus.lab/model-repo and then on ‘Select’ under your name.
If you have previously submitted a model but there is no longer one in the review process, please delete your fork first and create a new one so that your copy of the repo is up to date.
To do this, click on ‘Fork’ as described above. Instead of ‘Select’, ‘Go to project’ appears under your name. Follow this link, then go to ‘Settings’ → ‘General’ in the navigation on the left, scroll all the way down to ‘Advanced’, click on ‘Expand’ and then on ‘Delete project’. Follow the instructions to finally delete your fork.
Now go back to the Morpheus Model Repository and fork as described above.
- Create a new branch by selecting ‘+’ → ‘New branch’, give the branch a name such as ‘add-model’, keep the option ‘Create from’ set to
masterand finish with ‘Create branch’.
- Now browse to the model category and a topic area to which you want to contribute (you can also suggest a new one if you think that a suitable topic is still missing) and create a new directory for your model by clicking ‘+’ → ‘New directory’.
- Click the ‘+’ button again and then ‘New file’ to paste your model from the clipboard or ‘Upload file’ to choose a XML file on your computer. This will open a simple form. Fill in/upload the model and click ‘Commit changes’ or ‘Upload file’. You may but do not need to add text in the comments field (‘commit message’).
Optional: You may add an
index.mdfile for an extended explanation of your model, similar to the built-in models.
When you are finished adding files and folders, click on ‘Create merge request’ in the top right corner. If you like, change the title and description of your submission, check the box ‘Contribution’ (please keep all ‘Merge options’ checked) and submit your model files by clicking on ‘Submit merge request’.
Explanation for the ‘Merge options’:
- ‘Delete source branch when merge request is accepted’: This option only means that after the successful publication of your model on the website, the system automatically cleans up by deleting your old branch. This old branch, however, represents only a copy of your submission at this point, since your model is now also located in the
masterbranch and hence published on the Morpheus website. So no information is lost here on deletion.
- ‘Squash commits when merge request is accepted’: This means that all small adjustments made by you and the curators during the review process are combined into a single change in the version history when your model is accepted (merged). Your initial commit (the first edit made when you created your new model), including your name, will always remain visible to all in the repository’s history.
- Now the review process starts. In the meantime you can make further changes to your model and, if created, to the
index.mddescription page at any time.
Don’t forget to work within your newly created branch for the new model so that your changes are mirrored in the open merge request.