Version 3.2 Changes¶
Along with many usability and bug fixes, the newest version of KDSmart (v3.2) has implemented several new features that provide more options for users to score trials. These are the new or updated features that are outlined in this page:
- Categorical other traits;
- Block selection;
- Field Scoring Mode;
- Bulk scoring;
- Creating trials; and
- Adding sub-plots.
This page will be updated as the new KDSmart version is tested. Any feedback or questions are more than welcome, and can be sent to email@example.com
Categorical Other Traits¶
The latest version of KDSmart (v3.2) has introduced the a new trait type called the categorical other (cat_other) trait. This is like a regular categorical trait (is scored with categories such as colours) except that it has an extra category called ‘Other’ which is an editable text field. This means that a cat_other trait is essentially a categorical and text trait combined.
There has been changes to some aspects of KDSmart to accommodate this new trait and this tutorial will demonstrate some of the changes plus some helpful hints for using cat_other traits. This will include activities such as:
- Creating a cat_other trait;
- Adding that trait to a trial; and
- Scoring a cat_other trait.
Creating a Categorical Other Trait¶
As traits can be created within KDSmart, an extra option has been added so that categorical traits can be created with an other field. The video and accompanying instructions below demonstrate how to create a cat_other trait.
|1.||Navigate to the Traits Screen as seen in the above image.|
|2.||Select the Add Trait Button which will display the Add Trait Screen.|
|3.||Choose a name for the trait by entering it in the text field and selecting the Use Button. If the trait name is already taken then the Use Button will be disabled.|
Then the data type must be set to Categorical.
|5.||Enter the your categories in the Choices Field. Select the Add Button after entering each choice to add it to the list of categories. Each one should appear below and you can select the Trash Icon if you need to delete any.|
|6.||Select the Enable Other Checkbox and then name the other category.|
Adding Categorical Other Traits to a Trial¶
Categorical Other traits are added to existing trials the same way that any other traits are. If you already have a trial loaded into KDSmart, then please see the video below if you would like a refresher on how to add traits to a trial.
|1.||Select the Trial Details Button to view details of a trial.|
|2.||Select the Edit Traits Button. This will display the Trait/Instance Screen.|
|3.||Select the Add Traits Button then choose a trait/s to add to the trial.|
|1.||Start scoring a trial so that the Configuration Screen will open.|
|2.||Swipe to the Trait/Instance Screen.|
|3.||Select the Add Traits Button then choose a trait/s to add to the trial.|
Scoring Categorical Other Traits¶
Scoring a cat_other Trait is much like scoring any other type of trait. The video below will provide a short refresher and will include tips for creating an other category.
|1.||To start scoring, find a trial and select the Scoring Button.|
|2.||Configure your trial how you wish and then select the Start Scoring Button.|
|3.||On the plot you want to score, select the empty trait value (‘-‘) to navigate to the Trait Scoring Screen.|
|4.||On a categorical other trait, choose a category to score the plot/sub-plot.|
|5.||The score the other category, select the radio button and then the Edit Icon which will display a text field to enter what you would like to name the other value.|
Selecting a Block for Scoring¶
Block selection can be done on any trial that is a block trial and it is available in the Scoring Configuration Screen. See the video and instructions below for how to select one or more blocks to score.
|1.||To choose specific blocks to score, start by choosing a trial and opening the Scoring Configuration Screen.|
|2.||Swipe across to the Select Blocks Tab.|
|3.||Check the checkbox for each block that you want to score. You can choose one or more but you will not be allowed to choose no block. Select the Start Scoring Button to begin scoring the blocks.|
|4.||The Scoring Screen will appear as normal. You can see what blocks are selected by opening Field View.|
|5.||If you want to select a different block or set of blocks then exit back to the Scoring Configuration Screen to start again.|
Field Scoring Mode¶
Previously there have been two methods of scoring, Path Scoring Mode, and Sheet Scoring Mode. There have also been multiple methods of plot navigation with trials such as the Field View. The Field Scoring Mode is a new scoring method that uses Field View as the default for the Scoring Screen, and selection of a plot opens Sheet Scoring View. The new bulk scoring feature is also exclusively available in Field Scoring Mode which is outlined in the next section. See below for more information on how to use scoring mode:
|1.||Find a trial that’s to be scored and select the Scoring Button. This will open the Scoring Configuration Screen.|
|2.||Under the Scoring Mode Section are three radio buttons that enable selection of a scoring mode. Select the Field View Icon on the right.|
|3.||Select the Start Scoring Button after all configuration options have been chosen to begin trial scoring in Field Scoring Mode.|
|4.||Long Press on a plot to highlight it. This will enter you into Selection Mode where a short press on any other plot will also highlight it. Select all plots that you want to score.|
|5.||Select the Scoring Button to open up the Spreadsheet Scoring View. Only the plots you have selected will be present.|
|6.||Select any plot or sub-plot trait value to open the Trait Scoring Screen then choose a value for it.|
|7.||Select the Deselect Button to deselect the currently highlighted plots.|
The new bulk scoring feature allows users to apply a single value to many plots or sub-plots. This can dramatically increase efficiency of scoring in some situations but is only available in Field Scoring Mode. See the instructions below for how to bulk score plots and sub-plots.
|1.||Open a trial in Field Scoring Mode and select the plots that you need to apply the same trait value for. A long-press will enter you into select mode then you can add any plot to your selection.|
|2.||Select the Plot Bulk Scoring Button to open the Bulk Scoring Screen. All plot traits will be listed and the number of trait that are already scored will be listen in the # Already Scored Column.|
|3.||Select a trait to open a Trait Measurement Screen. Select a value and you will be automatically returned to the Bulk Scoring Screen.|
|4.||If there are plots that are already scored, you will need to select the Overwrite Trait Values Checkbox to overwrite the previous values.|
|5.||The Undo Button for that trait will now be available in case you selected the wrong value.|
Sub-plot bulk scoring is the exact same process as bulk scoring plots. However, the Sub-plot Bulk Scoring Button will only be available if there is only one plot selected.
Whilst previous versions of KDSmart had a trial creation feature, it has been completely overhauled for KDSmart 3.2 to provide flexibility when creating trials. This includes setting the trial type, size, adding sub-plots, etc. See the following instructions for how to create a new trial:
|1.||Navigate the the Trials Screen and select the Menu Button to display the menu options.|
|2.||Select the Create Trial Button from the menu options. This will open the Create Trials Screen|
|3.||Enter trial details for the new trial (see the following table).|
|4.||Select the Confirm Button to confirm the creation of the trial. It will now be available in the Trials Screen.|
The following table provides more information on each of the fields that can be completed. Please note that the trial details that are available will be different depending on the trial type that is chosen. See the following table for more information:
|Trial Name||The name for the trial.|
|Trial Type||Choose either a Plot ID (plots are organised by plot number) or an X/Y trial (plots are organised by columns and rows) from the dropdown menu.|
|Number of Plots (Plot ID)||The total number of plots in the trial|
|First Plot ID (Plot ID)||The number of the first plot in the trial.|
|Run Direction (Plot ID)||Sets the direction that plots are laid out.|
|Custom Run Length||Determines the number of plots that will be set per row.|
|Number of Columns (X/Y)||Number of columns in an X/Y trial.|
|Number of Rows (X/Y)||Number of rows in an X/Y trial.|
|Number of Sub-Plots per Plot||Determines the number of sub-plot for each plot in the trial.|
|Trait Instance Style||Choose between the Trait:123 or Trait_123 trait instance styles, or choose no trait instance style.|
In previous versions of KDSmart, sub-plots could only be added to one plot at a time whilst the trial was being scored. KDSmart version 3.2 has included two new ways to add sub-plots to a plot; in trial creation (outlined in the Creating Trials section), and with the Add Sub-Plot Screen. This section outlines how to add sub-plots to plots in an existing trial with the Add Sub-Plots Screen.
|1.||Navigate to the desired trial in the Trials Screen and long press the trial so that it is selected.|
|2.||Open the menu with the Menu Button then select the Add Sub-Plots Button to open the Add Sub-Plots Screen.|
|3.||Use the picker to select a number of sub-plots (between one and ten) for each plot. Please note that the number chosen determines the total number of sub-plots for each plot, not the number of sub-plots to be created. An example would be if plots in a trial contain one plot and then two sub-plots were chosen with the picker, one new sub-plot would be created.|
|4.||Select the Confirm Button to confirm the creation of the sub-plot creation.|
|5.||The Sub-Plot Report Screen will be displayed which provides information on newly added sub-plots.|