Creating a New Branch

You can select any commit on a branch to create a new branch from that source commit. This starts a new sequence of commits that runs in parallel with the first sequence. When the branch is created, the collections of versions and assigned tags will be identical in the source commit and on the new branch. But as soon as you start saving new versions and reassigning tags, the branches will diverge. See Figure 4-1, which is a continuation of Figure 2-2, for a schematic representation.


	The Branch as a Sequence of Commits

•

Prefer saving a draft over creating a new branch if all you want to do is experiment with a model, without necessarily affecting its version history. See Saving Drafts of Models.

•

Prefer using (

) if you want to create a copy of a model. Changes to the copy can later be merged to the original model via the window. See Saving Models to Databases and Comparing a Version With the Opened Model in the COMSOL Desktop.

A good mental picture is to think of a tree in which the initial branch is the trunk of the tree, with an initial commit saved at the base of the trunk (at the ground), and successive commits stacked on top of each other. Other branches created off the main branch correspond to tree branches shooting out from the trunk. A repository can be thought of as the tree itself.

Figure 4-1: A schematic representation of a repository containing two branches. A second branch has been created off the main branch’s second commit. In the third commit on the main branch, the model A was deleted. On the new branch’s second commit, a new version of model A was instead saved. Browsing the latest versions on the main branch will return model versions B3 and C1. Browsing on the new branch will return A3 and B1.

To create a branch from a particular source commit, do one of the following:

•

Select a branch node (

) in the The Databases Tree and click the button (

) in the section of the toolbar. The source commit is the latest commit on the branch.

•

Select a snapshot node (

) in the The Databases Tree and click the button (

) in the section of the toolbar. The source commit is the commit that the snapshot references.

•

Select a commit table row in the The Commits Window and click the button (

) in the window’s toolbar.

In all cases, The Create Branch Dialog Box is opened.


	Creating a new branch is a fairly cheap operation in a Model Manager database in terms of actual data storage. No data is copied except for the small amount of metadata necessary for determining which items are initially present on the branch. There is, however, a cost in terms of disk space usage if a search index is created for the branch — see also Searching in Branches.

Partial Branches

You can create a partial branch that contains a subset of all items that were present in the source commit. Select models and files in The Databases Tree or The Model Manager Window to include those items in the new branch. Select tags to include all items that are tagged by the selected tag. All tag assignments present in the source commit will be mirrored on the new branch as well.

The Create Branch Dialog Box

You create the new branch from the dialog box. The field shows the database in which the branch is created, and the field shows the repository that the source commit and new branch both belong to.

Write the name of the new branch in the field.

Write an optional comment for the initial commit that will be made for the new branch in the field.

Select in the list for complete search and filter support on the new branch; otherwise, select — see also Searching in Branches.

In the list:

Select to include all items from the source commit.

Select to only include the items whose versions were selected when the dialog box was opened. The selected item versions are displayed in a table under the field. Select a table row and click the button (

) to exclude the item from the new branch.

Select to create a branch that does not include any initial items at all.

You can set up permissions for the new branch in the field. This field is only shown if connected to a server database via a Model Manager server. See Granting Permissions.

Click to create the new branch in the database.

The created branch appears as a new child node to the node in The Databases Tree.


	An empty branch is, for example, useful if you only intend to create new models on the branch. You can later merge these models to the source branch.


	An initial commit is always made on a new branch. If you open The Commit Details Dialog Box for this commit you will see that the Changes table is, however, empty — no new versions or tag assignments are saved in the database in that initial commit.