Tutorial 2 - KDXplore

The Trial Manager Plug-in within KDXplore is a versatile and useful tool for providing users the ability to manage trials by editing traits and tags and enabling visualisation options for data. It also provides a platform for users to load and curate their collected data.
This tutorial provides instruction on how to begin using KDXplore’s Trial Manager. Upon completion you should be able to:

  1. Open and navigate Trials using Trial Manager;
  2. Load trials into KDXplore;
  3. Add traits and tags to a trial;
  4. Create trait instances in a trial;
  5. Make a scoring Set for efficient scoring;
  6. Edit basic trial Information;
  7. Connect KDXplore and KDSmart; and
  8. Transfer trials to KDSmart.

These activities form a part of managing and configuring trials. This is an important step toward being able to load trials onto KDSmart devices for data collection in the field.



Note

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

Step 1 - Loading Trials

The first step to start working with Trial Manager is to load a trial using one of the several available methods. Loading trials using Google Drive, from CSV files and from a KDDart database will be covered.

If the connection to the KDDart database is successful, then a variety of trials are available for practice. See Training Sample Data for sample files and database login information.

Further example CSV files are available at the KDSmart/KDXplore Example Resources page. Please visit this page and download the ‘Column and Row Trial’(KDSXsample1_Normal_Trial_X_Y.csv) to use for the following tutorials if you do not already have a trial to use.


Loading Trials from a CSV File

KDXplore can import CSV and Excel XLS or XLSX files easily using drag+drop. For information on file import formats please see the CSV Import File Formats help page.

This annotated illustration accompanies the following instructions to import a trial from a CSV file:


Importing Trials from a File
Importing Trials from a File (select to zoom)


Trials can be imported from various sources and in different formats. One of the easiest ways is to import a CSV file which is outlined below in the steps and video below:

Importing a CSV file
Step Action
1. Select the Add Trials Button at "1" and select the Load From CSV option. This will display the Import Trials Window at "2".
2. Either drag+drop a CSV file into the window or select the Browse Button located at "3".
3. Select the Add Device Button at "4" to link any connected devices to import data (this is optional).
4. Change the Trial Name and Operator if necessary. The traits that are contained in this file will also be listed in the window. Selecting a trait by right-clicking it will allow the user to choose import options for that trait i.e. Don’t Import.
5. Select the Import Button at "5" to save the preferences and import the trial.


Once a trial has been imported it will appear in the list in the Trial Details Panel. Trials can also be imported from KDDart by selecting Load From Database and from connected KDSmart devices through the Load From Tablet Data option when selecting the Add Trials Button.



Note

Whilst this covered the import of a CSV file, the same process applies for a XLS or XLSX file except the user must choose the Load From XLS option after choosing to add trial.


Loading Trials from KDDart Database

To import trials from the KDDart database, you must first log in to KDDart. See login instructions below, followed by database trial import instructions.

Connecting to KDDart
Connecting to KDDart


Connecting to KDDart
Step Action
1. Select File at the "1", then choose the connect option.
2. The KDDart Login Window will then appear as at "2". Enter your username and password and then select the Login button to log into the KDDart database.

Logging into KDDart allows the user to easily import trials with the relevant traits and tags attached. The following instructions demonstrate how to import a trial from the database:


Importing Trials from KDDart Database 1/2
Importing Trials from KDDart Database 1/2(select to zoom)


Importing a Trial from the Database
Step Action
1. Select the kdx_download Import Trial Button at "1" and choose the Load from Database option to open the Database Import Window as seen in the image above.
2. Choose an attribute to search for (such as the one at "2"). This example is a location attribute that will only display the trials that take place at Roseworthy.
3. Select the Find Trials Button to search for the trials. If no attributes were selected, then all trials in the database are presented.
4. The search results will be displayed (such as in the following image). Choose a trial (or multiple trials) such as the one in "1" and then select the Download Trials Button at "2" to complete the import.


Importing Trials from KDDart Database 2/2
Importing Trials from KDDart Database 2/2 (select to zoom)



Loading Trials from Google Drive

The integration with KDSmart and Google drive means that it’s likely that any scored trials (trials with scored data) will be located on Google Drive. This means that the trial will need to be downloaded to the computer that KDXplore is installed on. This method is the same as the Loading Trials from a CSV File method except that you will need to download the file (which will likely be a KDX file) from Google Drive. The image and instructions below will outline how to download a trial from Google Drive and load it into KDXplore.


Downloading a Trial from Google Drive
Downloading a Trial from Google Drive(select to zoom)


Loading a Trial from Google Drive
Step Action
1. Ensure that Google Drive is opened. If it’s not, then there is a Google Drive button in KDXplore which will open it in a browser. This button is located at "1" in the above image.
2. Choose any file such as the one located at "2". Right-click this file and then choose the Download option. This downloads the file to the default location for your browser (e.g. The Downloads folder).
3.

Click+drag the downloaded file (such as the one "1" in the below image) to the Trials Panel in KDXplore. This displays the Load Trial Data Window at "3". The kdx_download Import Trial Button can also be selected to display the Load Trial Data Window.

Loading Trial Data
Loading Trial Data (select to zoom)

4. As with the Loading Trials from a CSV File method, select/highlight the file you want to import, select a Source device, and enter the Name of the Device User.
5.

Select the Import Button at "4" to complete the import.

Import Trial Data
Import Trial Data (select to zoom)



Step 2 - Adding Traits

It’s likely that any trial that is added will already have the required traits necessary for the experiment. However, traits can also be added to a trial within the Trial Manager Plug-in by creating a new trait, editing an existing trait, or importing a trait. This tutorial will contain a quick demonstration on adding a new trait.

Users can add new traits which can then be added to trials. These new traits provide users the flexibility to add traits after a trial has been created, e.g. adapting a previously used trial for a new experiment.

The following image and instructions demonstrate how to add new traits:


Adding a New Trait
Adding a New Trait (select to zoom)


New traits can be added by:

Adding a New Trait
Step Action
1. Navigate to the Traits Panel by selecting the Traits Button at "1".
2. Select the Add Traits Button at "2" to create a new trait. This will display the Edit Trait Properties Window at "3".
3. Within the Edit Trait Properties Window are the key trait fields. Enter the details of the trait. More information on traits can be found below.
4. Select the Save Button to save the new trait which will then be displayed in the Traits Window.

To add a new trait, all the following details must be entered:

Trait Details
Attribute Description
Trait Name The name for the new trait. Must be unique and short because it’s displayed in the Scoring Screen and there may be limited screen space on smaller devices.
Alias An alternative name for the trait. This can be something shorter than the trait name and is optional.
Level This will define the trait as one that is relevant on the plot or sub-plot level.
Description This is an optional longer explanation of the trait to assist in data entry.
Unit The unit of measurement in which the trait can be scored by e.g. centimetres so that a plant leaf can be measured
Data Type
This constrains the values permitted for scoring against the trait. One of the following must be chosen:
  • CATEGORICAL,
  • DATE,
  • ELAPSED_DAYS,
  • INTEGER,
  • DECIMAL; or
  • TEXT;
Validation Rule The Validation rule optionally restricts the values being entered. The nature of the rule is dependent upon the selection of a data type and can include a minimum and maximum value.
Add Traits to Bundle Checkboxes that allow the user to add the new trait to existing trait bundles.

Note

You can also try importing traits by downloading a traits file from the KDSmart/KDXplore Example Resources page and importing them with the same method that is used for importing trials. For more information on adding traits to a trial, please see the Adding Traits section of the full help guides.


Step 3 - Adding Tags

In KDXplore Trial Manager, tags are short, coded descriptions that are used to represent information about a plot in a trial. Tags available for use in scoring in trials can be seen, along with definitions in the Tags Tabs of KDXplore Trial Manager.

Similarly to traits, tags can be included in a trial but the user may also create custom tags for a trial. Follow the instructions below to create a new tag:


Adding a Tag
Adding a Tag (select to zoom)


Adding Tags
Step Action
1. Select the Add Tag/Tag Bundles Button at the top of the panel at "1" and then choose the Add Tag option.
2. This opens the Add Tags Window (shown with "2") which allows the user to create a new tag by entering a new tag label and a description. Tags must have a unique name in KDXplore, similarly to traits. This example demonstrates the creation of a tag known as HD which is described as Human Damage.
3. Choose a Tag Bundle with the checkbox at "3". If there are no user-created bundles, then there will only be the All Tags bundle to choose (Note: Creating tag bundles will be examined later).
4. Once the tag name and details have been entered, select the Save Button at "4".

The new tag is added into the Tags Panel after being saved.


Step 4 - Attaching Traits to a Trial to make Trait Instances

When a trait is scored for a specific plot/sub-plot it will contain the value entered. Some traits however, may need to be scored several times, such as recording plant height at several time intervals, or the changing soil PH.

The least desirable workaround would be to have multiple traits with slightly different names (i.e. Plant_height_wk1, Plant_height_wk2, etc.). This creates more work for trait creation, management, analysis and data curation.

A much simpler and more effective solution is to create Trait Instances. This can be done in the Trial Manager which will allow the trait to be used, or scored, multiple times within the same trial.

Using the Plant_height example, if three instances are specified for the trait, then three measurements can be recorded for each plot/sub-plot and is available for comparison e.g. Plant_height#1, Plant_height#2, etc.

The following image and steps will outline how to create multiple instances of Plant_height:


Adding Trait Instances
Adding Trait Instances(select to zoom)


Creating Trait Instances
Step Action
1. Select a trial and Navigate to the Uses Traits Panel within Trial Manager at "1". It will list all the traits that a trial is using. Select the plus_button Add Trait Instance Button at "2" to open the Add Trait Instances Window at "3".
2. Select a trait such as Plant_height at "4".
3. Choose the number of trait instances desired (such as 3 in this example) at "5".
4. Select the Conform Button at "6" to add the trait instances to the trial.
5. Changing the scoring order by selecting the Trait Order Button trait_order at "7" can also be useful as it helps the user choose the most efficient scoring order to score data. Try changing the scoring order to something more convenient.


Step 5 - Making a Scoring Set

One of the best strategies for scoring data efficiently and quickly is to create a scoring set. A scoring set allows the users to pick specific traits that can be scored at one time for a trial. An example of this would be if there is a trial which requires the measurement of plant height at 3 different intervals in the experiment.

The trial might contain a variety of traits but the user can create a separate scoring set so that the plant height can be measured separately.

The following image and example will demonstrate how to do this:


Making a New Scoring Set
Making a New Scoring Set (select to zoom)


Making a New Scoring Set
Step Action
1. Start by selecting a trial to create a scoring set for. This example uses the ‘maize-with-data’ data from the previous step with multiple instances of the trait Plant_height.
2. Select the plus_button icon at "1" to open the Add Scoring Set Window at "2".
3. Choose traits to add to the scoring set such as the Plant_height instances shown in the area at "3".
4. Choose a name for the scoring set at "4". This one is named Plant Height.
5. Select the Create Button at "5" to ensure that the scoring set is created. The scoring set will now appear in the Measurements Panel.

Tip

Export the scoring set to KDSmart to use it.
Step 7 will demonstrate how to set up a connection between KDXplore and KDSmart.



Step 6 - Selecting a Planting Date

Basic trial information such as the planting date can easily be changed in Trial Manager. The following instructions detail how to change the planting data of a trial:


Changing Planting Date
Changing Planting Date (select to zoom)


How to Change the Planting Date of a Trial
Step Action
1. On the main Trial Manager Window, select a trial such as the ‘maize-with-data’ example at "1".
2. Basic information about the trial is listed in the Trial Details Panel at "2".
3. Select and open the planting date at "3" by double-clicking which will open the Date Selection Window which is outlined in "4".
4. Select a date, and then the Save option.

Tip

Many other trial details can also be changed with this method. Try it on other details such as name for plot and trial layout* to see what happens.


Step 7 - Transferring a Scoring Set to KDSmart

Once a scoring set for a trial has been created, it needs to be transferred to a KDSmart device for use in the field. The following steps demonstrate how to transfer scoring sets (or other data) from KDXplore to Google Drive so that they can be used in KDSmart.

To prepare for transfer, you will need to have a device with KDXplore installed, a Google account (for Google Drive) and access to the internet.


Exporting a Scoring Set
Exporting a Scoring Set(select to zoom)


Transferring a Scoring Set from KDXplore to Google Drive
Step Action
1. Ensure that Google Drive is opened in an internet browser and have KDXplore open to prepare for the transfer.
2. Choose a scoring set such as the one at "1" and then select the export_button button at "2".
3. The Export Window will display (as at "3") which provides export options. Selecting the Browse button allows you to choose a location on the computer to save the scoring Set to. Ensure that the radio button for KDX file is selected so that it’s ready to be used in KDSmart.
4. Select either the Export or the Export & Close options within the Export Window to export the KDX file to your chosen location. A dialogue will open and ask whether you want to open the containing directory - do this if you want to transfer the file to Google Drive immediately.
5.

Click+Drag the file into the web browser with Google Drive opened and drop it to complete the upload. The file should now appear in Google Drive and there will be a message which confirms that the upload has been completed.

Uploading Files to Google Drive
Uploading Files to Google Drive (select to zoom)

Trials that have been exported to Google Drive will now be available to be imported into KDSmart. Go to the next tutorial for more information on how to complete an import.



Note

An exported scoring Set will appear as a trial in KDSmart so no need to worry if you don’t see the scoring Set listed.

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 Is it true that only one scoring set can be created per trial?

  1. True
  2. False

Question 2 What plug-in do you use in KDXplore to select a Planting Date?

  1. Nursery Design
  2. Trial Design
  3. Trial Manager
  4. Inventory
  5. GenXplore

Question 3 What does a trait instance allow the user to do?

  1. Score the same trait multiple times in the same trial.
  2. Add tags to a trait.
  3. Re-use a trait in multiple trials.
  4. Transfer a trait to a KDSmart device.
  5. Load a trait from the database.

Question 4 What methods can be used to import a trial? (Hint: There is more than one)

  1. Load from CSV
  2. Load from tablet data
  3. Load from XLS
  4. Load from database
  5. Load from TXT


Summary

By completing the tutorial, you should now be familiar with the preparation tasks for setting up a trial for KDSmart using KDXplore and should also be able to:

  1. Open and navigate to trials in the Trial Manager;
  2. Load trials;
  3. Add traits and tags to a trial;
  4. Create trait instances in a trial;
  5. Make a scoring set;
  6. Edit basic trial Information;
  7. Connect to KDSmart; and
  8. Transfer scoring sets (trials) to KDSmart using KDXchange.

These exercises can be repeated using different example files that are located on the KDSmart/KDXplore Example Resources page.

Once comfortable with the activities of this tutorial, move to the next one by follow this link Tutorial 3 - KDSmart, using the next button or the main menu at left.