Uploading and downloading schematisations

Uploading a schematisation

A schematisation revision can be uploaded with the Rana panel:

  1. Activate the ‘Rana panel’ by clicking on the pictogram (modelsSimulations) in the toolbar.

  2. Browse in your Rana projects to the schematisation that you have updated on your laptop

There are two ways of uploading a new revision:

  • Right mouse click on the schematisation, and click ‘Save new revision’

  • Double click the schematisation and click the button ‘Save new revision’

  1. You get an overview of the schematisation revisions history. click ‘Next’

  2. Click on ‘Check Schematisation’. If error messages appear in red, your revision will not be valid so it is best to fix them before uploading your schematisation. If this is not the case then click on ‘Next’.

  3. Select the files you want to add to your upload by clicking on ‘Upload’. If you leave it on ‘Ignore’ the edit will not be uploaded.

  4. Describe the changes you made in a commit message.

  5. By default ‘Make a Rana model’ and ‘Inherit simulation templates from previous revision’ are checked. Uncheck them if needed. E.g. in case dwa has changed in your new revision.

  6. Click on ‘Start Upload’.

Your revision will now be available for everyone in your organisation.

Downloading a schematisation

A schematisation revision can be downloaded with the Rana panel:

  1. Activate the ‘Rana panel’ by clicking on the pictogram (modelsSimulations) in the toolbar.

  2. Browse to your schematisation

There are two ways of downloading a schematisation

  • Right mouse click on the schematisation, and click ‘Open’

  • Double click the schematisation and click the button ‘Open’

Two things will happen:

  1. The files will be downloaded to simulation working directory in your settings.

  2. The schematisation will be opened in the schematisation editor.

Add schematisations to your project

There are three methods to add schematisations to your project:

From Scratch

From scratch will create a new empty schematisation in your project. A wizard will guide you through the steps to get a first setup for 0D/1D/2D model depending on your preference. Important: make sure your choose the correct coordinate system

Upload Existing

This method will upload a schematisation from your local machine to the model databank. It will effectively create a clean copy of the local schematisation. The local revision history (if even available) is not preserved, the new schematisation starts with revision 1.

Import from HCC

This method will import a schematisation from the HCC model databank into your project. It will effectively create a clean copy of the choosen revision of the schematisation in a new schematisation. The revision history from the model databank is not attached but still available in the model databank under the original schematisation.


In case you have already a schematisation available in the model databank you can import that schematisation using the ‘import schematisation’ button in the Rana panel. When you import a schematisation it makes an existing schematisation available in your project. You can use it to run simulations, add new revisions to it. When you’re done working with the schematisation you can click ‘remove from project’. This will not delete your schematisation. It is still available in the model databank including the new revisions added in the project.

Overwriting your latest revision with an older one

In some cases you like to take an older revision and promote that to be the newest revision. The steps for this are as follows:

  1. Double‑click a schematisation in Rana.

  2. Click View all revisions.

  3. Right‑click the name of the revision you want to open.

  4. Click Open.

  5. It will download that revision and load it into Work in Progress.

  6. Make any necessary adjustments to the schematisation.

  7. In the detail screen of the schematisation, there is a button Save new revision.

  8. When you click that, the currently open Work in Progress is uploaded to Rana.

  9. It is advisable to disable Generate model, but especially Inherit simulation templates, during that step.

This movie shows the steps to follow: