Tags¶
KDSmart scoring includes the use of tags to provide short text descriptions for plots and subplots. This section provides more information on tags, including how to create and manage them in Trial Manager.
What is a Tag?¶
Tags are short, text descriptions used to represent information about a plot or subplot (a cell) in a trial, e.g. ‘BD’, which can mean ‘bird damage’. They provide a quick method of applying predefined classifications or annotations to plots or subplots. They essentially work like reusable notes.
Tags have the following characteristics:
User-definable;
Consist of a short name and optional long description;
New tags can be created in the field;
Can be imported from a CSV file; and
Exportable to a CSV file.
The main benefits of tags are that they:
Are simple to use - selectable from a list makes them quick and easy to assign;
User or project definable;
Provide consistent annotation, avoiding problems with spelling or language; and
Deployable across multiple users, devices and locations.
This means that the:
Users spend less time writing and repeating notes in the field; and
Data curators have more consistent, uniform recordings from multiple locations by different field workers.
See the tag examples in the following table:
Tag (Short Name) |
Long Description |
---|---|
BD |
Bird Damage |
LDG+ |
General Lodging in plots-mild |
LDG++ |
General Lodging in plots-moderate |
WET |
Waterlogging |
Tag Management¶
Tags in Trial Manager are managed from the Tags tab (seen in the image below), which is outlined on the Trial Manager Overview page. The following actions can be performed in the Tags tab.
Add a new tag;
Edit a tag description;
Delete a tag;
Import tags from a CSV file; and
Export selected tags to a CSV file.
Creating Tags¶
Tags can either be created in Trial Manager or imported. Follow the instructions below to create a new tag.
Step |
Action |
---|---|
1. |
From the Tags tab, select the Add button and then the Add Tag option to open the Create a New Tag window. |
2. |
Enter a tag label such as ID in the above image. |
3. |
Enter a description that explains what the tag label is such as Insect damage. |
4. |
Use the checkboxes to add the new tag to any existing tag bundles. All new tags are automatically added to the All Tags bundle. |
5. |
Select the Save Tag button to save the new tag. |
Note
You can also create tags in KDSmart, so it is unnecessary to organise tags before exporting trials to be scored. You cannot edit tags in Trial Manager after creation, but you can easily create new tags instead.
Deleting Tags¶
Tags that are not needed can be deleted. You can also delete one or more tags at once. See the instructions below for more information:
Step |
Action |
---|---|
1. |
From the Tags panel, select one or more tags to be deleted and select the Delete button (as in the above image). |
2. |
Select the Delete Tags option. |
3. |
There will be a confirmation dialogue that will ask for confirmation to delete the selected tag/s. Either select the Yes button to confirm the deletion or the No button to cancel the deletion of the tags. |
Tag Bundle Management¶
Tags can be grouped into bundles to help with the management. Tag bundles can be created in Trial Manager and imported/exported from other devices as well. There will always be an automatically created bundle called All Tags. The image of the Tags panel below contains tag bundles such as Damage and General Lodging.
See the sections below for tag bundle management.
Creating Tag Bundles¶
The steps below are an example of how to create a new tag bundle:
Step |
Action |
---|---|
1. |
Select the Add button from the Tags panel and choose the Add Tag Bundle option to open the Add/Edit Tag Bundle window as pictured above. |
2. |
To add a tag to the new bundle, either double-click a tag or select it with a single-click, then select the Add To Bundle button. Click+drag, shift+click, or ctrl+click to select multiple tags. |
3. |
|
4. |
Ensure you have added all necessary tags, and then select the Save button. |
Editing Tag Bundles¶
You can also edit tag bundles to change the bundle name and add or remove tags from the bundle.
Step |
Action |
---|---|
1. |
From the Tags panel, select a tag bundle to be edited and then select the Edit button. This will open the Add/Edit Tag Bundle window. |
2. |
To remove tags from a bundle, select one or more tags from the bundle (listed in the Tags In Bundle panel) to be deleted and select the Remove button to confirm the edit. |
3. |
You can also add more tags to the bundle. To add tags, select one or more tags from the Tags From Bundle panel and then the Add To Bundle button to confirm the edit. |
Deleting Tag Bundles¶
Tag bundles that are not needed are deletable from Trial Manager in a similar way to deleting individual tags.
¶ Step
Action
1.
From the Tags panel, select a tag bundle to be deleted and select the Delete button (as in the above image).
2.
Select the Delete Tag Bundles option.
3.
There will be a confirmation dialogue that will ask for confirmation to delete the selected tag/s Either select the Yes button to confirm the deletion or the No button to cancel the deletion of the tags.