Quickstart guides

Here we are creating some quickstart guides for some common tasks. If you have a task that you think would benefit from such a guide, please let us know.

Uploading a model to the repository

While it is desirable to use some kind of version control system to manage the development of any work performed on a computer, it is often the case that a user has a model, in CellML for example, that they simply wish to upload to the model repository. It is hoped that soon tools such as OpenCOR will natively support such a task, but for now users are currently required to learn a bit of Git in order to upload such models themselves. An alternative is to simply contact us with your model and we will upload it for you, but this will loose any direct association or connection with the original author of the model. We therefore highly recommend that the following process is followed at this time.

  1. create a workspace

    More detail is available at Creating a new workspace. Note the teaching instance that is available for testing things out if required.

  2. use a git client to clone the workspace to your local machine

    To ensure an accurate record of your contributions is maintained, please see Git username configuration. A detailed description of cloning a workspace is available here: Cloning your forked workspace.

  3. add your model and any other data to the workspace (such as a brief documentation page in HTML or reStructuredText and any images used in the documentation)

    See Committing changes for details on adding the files to the cloned workspace on your local machine.

  4. push the changes back to the repository

    Details available here: Pushing changes to the repository.

  5. [optional] share the workspace with any collaborators

    Your workspace will currently be private and only visible to yourself when you are logged in to the repository. If you would like to share the workspace with your collaborators while still keeping the work private, you are able to do so: Working with collaborators.

  6. [optional] create an exposure

    If you have some documenation for your workspace or would like to easily link to a specific revision of your workspace, you are able to create an exposure for the workspace. Like the workspace, this will initially be private to yourself and the users you choose to share it with. For CellML models, see extra information here: Creating CellML exposures.

  7. submit the workspace for “publication” - this will make the workspace publicly available

    In order to make your workspace publicly available, you need to submit it for publication. The publication process simply allows the repository administrators to quickly check the workspace for material that should not be distributed in the repository (once a workspace is published, it will be available forever). The process is the same as that described here: Making your work publicly accessible.

  8. [optional] submit the exposure for publication (again, this makes it public)

    Once the workspace is published, you are able to submit any exposure(s) you might want public for publication.