Difference between revisions of "UKCA Chemistry and Aerosol UMvn13.0 Tutorial 3"

From UKCA
Line 56: Line 56:
 
| '''<span style="color:blue"><tt>your_branch_name</tt></span>''' || This is a descriptive name for your branch, e.g. <tt>ukca_tutorials</tt>. You '''should not''' also include a revision/version number here.
 
| '''<span style="color:blue"><tt>your_branch_name</tt></span>''' || This is a descriptive name for your branch, e.g. <tt>ukca_tutorials</tt>. You '''should not''' also include a revision/version number here.
 
|-
 
|-
| '''<span style="color:purple"><tt>[TRUNK REVISION]</tt></span>''', <br/>i.e. <span style="color:purple"><tt>um13.0</tt></span> || This is the trunk revision we are branching from. For these tutorials it is '''<tt>um13.0</tt>'''.
+
| '''<span style="color:purple"><tt>[REVISION]</tt></span>''' <br/>i.e. <span style="color:purple"><tt>um13.0</tt></span> || This is the trunk revision we are branching from. For these tutorials it is '''<tt>um13.0</tt>'''.
 
|}
 
|}
   

Revision as of 13:48, 15 September 2022

UKCA Chemistry and Aerosol Tutorials at UMvn13.0

Difficulty MEDIUM
Time to Complete 1-2 hours
Video instructions

Remember to run mosrs-cache-password in your Rose suite and UM branch terminals.

What you will do in this tutorial

In this tutorial you will learn how to make a branch to allow you to include UKCA code changes within the Box Model. You will then include 2 new chemical tracers, ALICE and BOB.

To be able to make UKCA code changes you will need to make a work with the UKCA code repository on the Met Office Science Repository Service (MOSRS), located here

Working with the UKCA repository

Making a ticket

To work with the UKCA code you will need to first make a new "ticket" on the UKCA trac pages on MOSRS, located here:

You should ensure that:

  • The Milestone is set to Not for builds. If you were developing a code change for the trunk then this would be set to the code version you wanted the change to be available from.
  • Once the ticket is created you click Modify Ticket and then select Start work and then Submit changes. This will make the ticket active and owned by you.

An example ticket can be seen at


The ticket is useful to be able to keep a log of your progress with the ticket as well as being able to hold trac wiki pages that can be used to present results and documentation.

In these tutorials we will have tickets and branches for both the UKCA and UM, so you will need to keep track of both.

Make a branch

Once you have a ticket you are able to make a branch on the UKCA repository. You should do this in your terminal

fcm branch-create --type dev -k ticket_number your_branch_name fcm:ukca.x_tr@um13.0
Setting Description
ticket_number This is the number of the ticket that you have just created
your_branch_name This is a descriptive name for your branch, e.g. ukca_tutorials. You should not also include a revision/version number here.
[REVISION]
i.e. um13.0
This is the trunk revision we are branching from. For these tutorials it is um13.0.

Checklist

Tutorial 4

UKCA Chemistry and Aerosol Tutorials at UMvn13.0


Written by Luke Abraham 2022