Tutorial 3 - KDSmart

KDSmart is an Android application that can be installed on mobile devices for the collection of Trial or Nursery data.

The following image illustrates the Trial Data Workflow. Trials can be loaded into KDSmart from KDXplore, Trait data is collected using KDSmart, then the data is loaded back into KDXplore for curation, then transfer to a KDDart database for long term access and storage. For this tutorial Phase 2 is about to begin.


Example of the Trial Data Workflow (select to zoom)


Please ensure the previous tutorial has been completed Tutorial 2 - KDXplore and have a Trial loaded (or ready to import) into KDSmart to use in this tutorial.

By the end of this tutorial, you should be able to:

  1. Import a Scoring Set to KDSmart;
  2. Navigate the KDSmart application and open a Trial;
  3. Understand Traits and Tags in KDSMart;
  4. Use different views for Scoring data; and
  5. Transfer scored data to KDXplore.



Note

Select any heading to expand/display expand or contract contract the section.

Home Screen

Once the KDSmart application is opened, you will see the Home Screen as in the below image. As well as menu options, the Home Screen displays important information such as the KDSmart version number, Trial details, and the device name.


Home Screen (select to zoom)


This tutorial requires you to be able to navigate to the Trials Screen which can be done by selecting the:

  • "1" trials_btn Trials Button; or
  • "2" Menu Button, then choosing the Trials option.

Note

Please see the KDSmart Home Screen page for a comprehensive outline of the KDSmart Home Screen or continue with this tutorial to learn more.



Step 1 - Importing a Scoring Set

Whilst you can use the Trials in the Demo Database, if you want to use your own Trials then you will need to import a Scoring Set (a Trial with a specific set of Traits to be scored). When a Scoring Set is imported to KDSmart, the Trial it is created from will be listed in the Trials Screen. The previous tutorial demonstrated how to export a Scoring Set to Google Drive. This tutorial will outline how to retrieve that Set from Google Drive. See below for further instruction.


Importing a Trial 1/3


Importing a Trial
Step Action
1. Navigate to the Trials screen and select the Import Button at "1".
2. Select an import option - for this tutorial choose the File KDX option at "2". This will open Google Drive.
3.

Select the KDX file to be imported such as the one at "2" in the below image. Then select the Open option at "2" and the import will begin.

Importing a Scoring Set 2/3

4.

Successful imports result in the following screen. The attachment message indicates that there are no attachments to the Trial.

Scoring Set 3/3



Step 2 - Selecting and Starting a Trial

To view the names and details of Trials in KDSmart, you can navigate back to the Home Screen which is outlined in the following image. Swipe left and right to browse Trials. The Home Screen is displayed when the KDSmart Application is opened. This can be seen in the following image:


Home Screen


  • "1" Current Trial is the Trial that is currently selected and related information. If the play_btn Start Scoring Button is selected, it will start the scoring of the selected Trial.
  • "2" The trials_btn Trials Button will display a list of all Trials that have been imported onto the KDSmart device as displayed in the next image:


List of Trials


Starting Scoring 1/2
Step Action
1. Choose a Trial such as the one displayed at "1" to save this as the current Trial and navigate to the Trial Details Screen.
2. Select the play_btn Start Scoring Button to navigate to the Configuration Screen as seen in the following image:


Configuration


Starting Scoring 2/2
Step Action
3. The Configuration Screen allows the user to choose collection options related to the collection of the data when scoring Trials. There are multiple tabs which can be navigated to by dragging the screen to the left or right. The first tab which is presented is the Options Tab which allows the user to define the collection order* (at "1") and other collection options. There is also the option to add Tag Bundles.
4. Select the Start Scoring Button at "2" to begin data collection.

Note

The collection order refers to the order that the user will collect data in the field which includes the starting position and the traversal pattern. More information about options can be found in the Collection Parameters and Trait/Instance Selection sections.



Step 3 - Understanding the Scoring Panel

After a Trial is chosen and started, the next step is to start scoring data. The following image and table demonstrate the parts of the scoring panel that are used to score data.


Outline of Scoring Panel


Using the Scoring Panel
Button Action
"1" Select Plot Selecting this button will allow the user to choose the exact plot that they need to score. This is useful if the user would like to score a plot out of order from the collection order.
"2" Move Forward/ Back move_forward_btn/ move_back_btn These buttons display the next or previous plot that is to be displayed. The move_forward_btn Move Forward Button displays the next plot and the move_back_btn Move Backward Button displays the previous button.
"3" Field View field_btn This button displays the view of the entire Field from the Experiment including the collection order and any Tags that are applied to a plot. Within this window, selecting a plot and then choosing the Jump To option will take the user to the chosen Plot so that it can be scored. This method of choosing Plots is useful if the user does not know the actual PlotID but is familiar with the physical layout of the Field.
"4" Auto Advancing autoadvance_btn The selection of this will start the Autoscoring function. It will present the option to auto advance either All Traits or Un-scored Traits. More on autoscoring is explained further on.
"5" Trait Instance Each row such as the one outlined here is a Trait instance. Selecting a Trait will provide the user the ability to score it. Traits can be for the entire Plot or for specific Sub-Plots.
"6" Add Media add_media_btn Photos and audio files can be added to Plots with this button. Adding media can be used as notes e.g. a photo of damage to a plant.
"7" Select Tag/s add_tag_btn Tags can be added and removed from each Plot.

Note

The full KDSmart Help Guides can be referred to in order to learn about scoring KDSmart - How to Score Trials and Nurseries .


Step 4 - Scoring Data

The main purpose of KDSmart is to score data. This refers to the collection of phenotypic data in the field and involves the user walking through the experiment Plots and entering data to KDSmart after observing specimens. This step will outline how to enter Trait and Tag data into KDSmart.


Traits


In the Scoring Panel, all Traits in the selected plot will either display a ‘-‘ to indicate that there is currently no recorded value (i.e. the Trait instance at "1" in the following image), or it will contain a value (i.e. the Trait instance at "2" in the following image).


Scoring Panel


The following steps will outline how to score Traits:

Scoring a Trait
Step Action Image
1. Select a Trait Instance to begin scoring. This instance contains radio-buttons to choose values which in this case are days. To select a value such as +1, select the corresponding radio-button (such as at "1"). Different Trait instances require different values E.g. a decimal value. The ? Button at "2" sets the value as Missing meaning that the value is missing from the Trait Instance The NA Button sets the value to NA (not applicable) which means that the Trait is not relevant to that plot. KDStutorial7
2. Swipe the screen right to view Plot information. KDStutorial8
3. If a Trait Instance that has already been scored is selected, the dialogue box appears on the right. It provides the option to edit the score of the selected Trait with the edit_btn Edit Button, or to move to the next un-scored Trait. KDStutorial9

Once a Plot is scored, the user can proceed to another Plot to score. Navigation between Plots can be done in a variety of ways. The following image outlines the three different methods (not including Auto-Advance):


Navigation Methods


Navigating to Another Plot
Navigation Method Action Image
1. To move to the next Plot (‘next’ is determined by the collection order), select either the move_forward_btn Move Forward Button and the move_back_btn Move Backward Button at "1". KDStutorial10
2. Plot Selection can be used to pick a specific Plot. Select the current Plot (i.e. "2") to display the selection screen to the right. Depending on the Plot Layout, the user will be able to pick x,y coordinates or a Plot ID. KDStutorial11
3. Another option is to choose the Field-View option at "3" which provides a top down view of the field. Choosing this option will display the screen on the right. The arrows indicate the collection order and the user can navigate to any Plot by selecting the Plot and choosing the Jump To option. KDStutorial12

Note

The Auto-Advance feature will allow the user to move to the next Trait Instance and Plot quickly but will be covered in the next step.



Tags

Tags provide a quick method of applying predefined classification or annotation to cells (Plots or Sub-Plots). Main benefit of Tags are 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 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.

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
  • Are exportable to CSV file.

When Tags have been assigned to a Plot or Sub-Plot they will appear as shown in the following image, which shows part of the Scoring Screen with two Tags assigned at "1" which is above the Trait column. Tags are assigned or reassigned using the Tag button at "2".


Example of Two Applied Tags on the Scoring Screen


Steps to Assign Tags
Step Action
1. Locate a Plot to Tag in the Scoring Screen.
2. Select the Tag add_tag_btn Add Tag Button.
3. Select one or more Tags to assign them to a cell.
4. Select Apply to save changes and return to the scoring screen. This displays the Tag short name above the Traits for the selected cell.


Step 5 - Auto-Advance Scoring

The quickest way to score Traits is to use the Auto-Advance feature. Auto-Advance also allows the user to concentrate on only those Traits for which a measurement has not been provided.

When the user provides a value for a Trait, KDSmart moves the focus to the next un-scored Trait, skipping over those Traits (and sometimes entire Plots) which have already been scored. This is useful when starting scoring as it quicker and when scoring has been finished if the user needs to find any un-scored Plots or Traits. The following image and steps demonstrate how to use Auto-advance:


Auto-Scoring a Trait


Using Auto-Advance
Step Action
1. Select the autoadvance_btn in the menu bar to turn on Auto-advance scoring.
2. Choose either the All Traits option to score all Traits within the dialogue box, or the Un-scored Traits option.
3. Begin scoring by selecting the blank area next to an un-scored Trait. This displays a new screen with the data entry “form” for the Trait on one side and the Plot Information on the other side (this is demonstrated in the image above).
4.
The Plot identification buttons and the move_forward_btn/move_back_btn Move Forward/Backward Buttons are no longer available but there are backward_btn/forward_btn Skip Backward/Forward Buttons along the bottom that may be used if you don’t want to enter a measurement for the Trait being displayed. If a plot is skipped, then KDSmart will let the user know this by:
  • Vibrating the device.
  • Posting a system notification.
  • Displaying a popup message for the user to confirm that they have reached the correct Plot to continue scoring.


As in the normal scoring screen, the presentation of the Auto-Advance scoring screen changes depending on whether the user is:

  • Using a Tablet or Phone-sized device.
  • Using Portrait or Landscape mode.
  • In right-handed or left-handed input mode.



Step 6 - Transferring a Scored Trial to KDXplore

Once data is collected by scoring with KDSmart, the data will need to be transferred to KDXplore for curation. The following quick-guide demonstrates how to transfer scored data for KDXplore using Google Drive.

To prepare for transfer, the user needs to have a KDSmart device, a Google Account (for Google Drive), and access to the internet. You also need a device with KDXplore installed to open the file.


Transferring a Trial 1/5


Transferring a Trial
Step Action
1. On the Trials Screen in the above image, ensure that the Scored Trial that you want to transfer is selected. Then choose the Options Button at "1" and then the Share option at "2".
2.

The Choose Export Option Window will be displayed as seen in the image below. Select the Full Data for KDXplore option at "1".

Transferring a Trial 2/5

3.

You will be presented with options for sharing the KDX file. Select the Save to Drive option at "1" in the below image.

Transferring a Trial 3/5

4.

Choosing the Save to Drive option displays options for saving the file as seen in the below image. Select the Save option at "1" when you are ready to save the file to Google Drive.

Transferring a Trial 4/5

5.

Once the file has been saved, confirmation notifications are displayed on the device as seen in the below image. This will indicate that the Scored Trials are now stored in Google Drive.

Transferring a Trial 5/5

Once these steps have been completed, you need to load the Scored Trial into KDXplore. Please see the Loading Trials from Google Drive section for how to do this.

Note

KDXplore and KDSmart integration with Google Drive was included with KDSmart version 3.0.22. Before this, KDXchange was used to connect devices over Wi-Fi and transfer data. Google Drive is the recommended method of data transfer however if you need to use KDXchange, instructions can be found at the KDXchange page.


Quiz

Question 1 Once data is scored it cannot be changed. Is this statement true or false?

  1. True
  2. False

Question 2 What of the following is not a method for moving to another plot?

  1. Field View
  2. Auto Advance
  3. Select Plot
  4. Select Tag/s
  5. Move Forward/Back

Question 3 What KDDart platform is used to score Trials?

  1. KDManage
  2. Trial Manager
  3. KDXplore
  4. Curation
  5. KDSmart

Question 4 What can be transferred to KDSmart to help with scoring? (Hint: There is more than one)

  1. Traits
  2. Trials
  3. Plants
  4. Tags
  5. Fields


Summary

By now you should be able to:

  1. Navigate around the KDSmart application and open Trials;
  2. Be familiar with the operation of Traits and Tags;
  3. Use different views for Scoring data; and
  4. Transfer scored data to KDXplore using KDXchange.

To become more comfortable scoring Trial data using KDSmart, or perhaps trying a different device, please try the different methods of scoring to practice and see what works best for each situation encountered.

For more information about using KDSmart, consult the full KDSmart help guide at KDSmart Help Guides.

When ready, please follow the link to continue to the next tutorial: Tutorial 4 - KDXplore Curation.