I think what you need is an a bit more comprehensive description of tags in DigitalMicrograph:

Be aware that

There exist simplified wrapper commands for simple scripts

such as

image img := RealImage( "", 4, 10 )
SetNumberNote( img, "TagPath:With:SubTag:TagName", 12.2 )
DeleteNote( img, "TagPath:With:SubTag:TagName")

However, the underlaying object is the TagGroup object with a lot of specific commands. You can always also achieve the simple things with the complete object, of course.

Next, it is important to know that

There is a difference between TagGroup and TagList.

Both are TagGroup objects on the surface, but some commands will only work on either of them. TagLists have indexed entries and TagGroups have labelled entries.

The difference of the two becomes important when you start to insert into the group / list or want to remove from them, and it also becomes important when you traverse the structure.

Also note that TagGroup entries are alphanumerically sorted while TagList entries are sorted by the index.

Some examples:

• commands of form TagGroupInsertTagAs... TagGroupGetIndexedTagAs... work only on TagLists

• commads of form TagGroupSetTagAs... TagGroupGetTagAs... work only on TagGroups

• To delete a tag from a TagList you need to use TagGroupDeleteTagWithIndex

• To delete a tag from a TagGroup you need to use TagGroupDeleteTagWithLabel

Sometimes you can work around this issue by using the index in a TagList as a label by putting it in between [ and ] as a tag-path. But there are also some circumstances when you need the difference of 'TagGroup' and 'TagList'

There are different options to delete tags

• TagGroupDeleteAllTags() deletes 'all' sub-tags of a TagGroup or TagList - but not the group/list entry itself.

• TagGroupDeleteTagWithLabel() deletes a specif tag within a TagGroup specified by the label.

• TagGroupDeleteTagWithIndex() deletes a specif tag within a TagList specified by the index. Note, that this changes the indices of the other entries!

Example

The code below creates the tagGroup from the image above:

tagGroup rootTg = NewTagGroup()
tagGroup tg = NewTagGroup()
tagGroup tl = NewTagList()

tg.TagGroupSetTagAsString( "value", "I am a string tag")
tg.TagGroupSetTagAsString( "2", "My tag at #2")
tg.TagGroupSetTagAsString( "Name", "Hello")
tg.TagGroupSetTagAsString( "1", "My tag at #1")

tl.TagGroupInsertTagAsString( 0, "String tag #1" )
tl.TagGroupInsertTagAsString( 1, "String tag #2" )
tl.TagGroupInsertTagAsString( 2, "String tag #3" )
tl.TagGroupInsertTagAsString( 1, "String tag #4" )

rootTg.TagGroupSetTagAsTagGroup( "TagGroup", tg )
rootTg.TagGroupSetTagAsTagGroup( "TagList", tl )

rootTg.TagGroupOpenBrowserWindow( "TagGroup example", 0 )

To delete the "Name: Hello" tag (which is the 3rd tag in the sorted group), we would use either of the three:

rootTg.TagGroupDeleteTagWithLabel( "TagGroup:Name" )
tg.TagGroupDeleteTagWithLabel( "Name" )
tg.TagGroupDeleteTagWithIndex( 2 )

To delete the 3rd entry in the TagList, we would use either of the three:

rootTg.TagGroupDeleteTagWithLabel( "TagList:[2]" )
tl.TagGroupDeleteTagWithLabel( "[2]" )
tl.TagGroupDeleteTagWithIndex( 2 )

To delete the whole TagList, we would use

rootTg.TagGroupDeleteTagWithLabel( "TagList" )