- KDXplore - KDSmart Data Exchange
- What is KDSmart and KDXplore?
- Why Use KDXplore?
- Data Exchange - Google Drive Method
- Data Exchange - KDXchange Method
- Setup - Connecting KDXplore to KDSmart Devices
- Transfer - Moving data (Trials, Traits and Tags) between KDSmart and KDXplore
This is a common help topic for both KDXplore and KDSmart.
There are several methods of moving data into and out of KDSmart which can be found on the Data - Import, Export, Backup page. This topic focuses on using KDXplore with KDSmart, which provides more time saving and productivity benefits for the user. Previously, inbuilt software called KDXchange was used to exchange data between KDXplore and KDSmart. Both applications have recently been updated to include integration with Google Drive which requires much less effort in setup. Whilst an internet connection is required, both devices do not need to be on the same WiFi network. Google Drive is now the recommended method, however there may still be a need to use KDXchange so both methods are outlined here.
The following sections outline the steps required for exchanging data between KDSmart and KDXplore:
- Setup - Connecting KDXplore to KDSmart Devices; and
- Transfer - Moving data (Trials, Traits and Tags) between KDSmart and KDXplore.
Beforehand, a little background information is useful in understanding some of the technicalities before launching into the task.
KDSmart and KDXplore are two flexible applications in the KDDart platform:
KDSmart is used on Android tablets or phones to collect phenotypic data in the field for Trials or Nurseries; and
KDXplore is a multiplatform desktop/laptop application which fulfils several roles including managing data on one or more KDSmart devices.
The following illustration depicts a simple trial data workflow for KDDart, however look to the centre to see KDSmart and KDXplore’s role in the workflow:
Whilst KDSmart can be used on its own using CSV files for data transfer there may be a need to upscale to multiple KDSmart devices and larger trials. Using KDXplore benefits the user by improving data management and handling.
Some of these benefits are:
- Work more efficiently and productively with Trial and Nursery data offline (away from office networks or Internet) using laptop or workstation, not just small screens of tablets or phones;
- Provides visualisation tools to assist with data exploration and review;
- Provides broader toolset coverage of the breeding cycle;
- Enables easier management and data exchange with multiple KDSmart devices;
- Retains data from each individual KDSmart device “download” with TableName/Operator/When details;
- Facilitates uploading data to a KDDart database when possible (i.e. when a connection to the office network/Internet is available);
- Barcode production for printing to use with KDSmart barcode scoring;
- Facilitates improved consistency amongst multiple KDSmart devices with Trait and Tag editing and distribution;
- Viewing Traits used in different Trials; and
- The ability to exchange data whilst on site so that data can be curated as efficiently as possible.
A few setup steps are required, however this has been made as easy as possible. The communication software between KDSmart and KDXplore is referred to as KDXchange.
Google Drive is a quick and easy way of exchanging data between devices and requires little set up time. The example provided will take you from exporting a Scoring Set from KDXplore to Google Drive, importing it into KDSmart, exporting the Scored Data file to Google Drive, and then importing that file into KDXplore for curation.
The process of exchanging data will be described in the following steps:
- Connect to the Internet
- Google Drive Setup
- Transferring Files from KDXplore to Google Drive
- Transferring Files into KDSmart from Google Drive
- Transferring Files from KDSmart to Google Drive
- Transferring Files into KDXplore from Google Drive
Google Drive transfers will only work when devices are connected to the internet but they do not have to be connected at the same time. For example, a user on KDXplore may export a Scoring Set to Google Drive which is uploaded to their personal folder, turn off their computer, and then go out into the field and import that Scoring Set into to KDSmart. For users who do not have mobile data on their KDSmart device or are in an area that does not have signal, it will still be necessary to connect to WiFi.
For further information on setting up WiFi please see the Step 1 - Using WiFi section below.
As well as having an internet connection, you will need to have a Google account which gives you access to Google Drive. A free account will provide 15gb of space which is more than enough for using with KDXplore and KDSmart. To sign up or access Google Drive see Google Drive.
This link will be usable on KDXplore, Android devices should have a Google Drive application that would usually be already installed by default but can also be found in the Google Play Store.
Once a Trial, Trait or Tag has been created, it needs to be transferred to a KDSmart device for use in the field. The following instructions demonstrate how to transfer Trials (or other data) from KDXplore to Google Drive so that they can be used in KDSmart.
|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 and then select the Export button at .|
|3.||The Export window displays (as at ) which provides export options. Select the Browse button 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 is ready to be used in KDSmart.|
|4.||Select either the Export or the Export & Close options within the Export window and the KDX file will be exported to your chosen location. A dialogue opens and asks whether you want to open the containing directory - do this if you want to transfer the file to Google Drive immediately.|
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 is a message which confirms that the upload has been completed.
Files that are uploaded to Google Drive from KDXplore need to be imported into KDSmart. The following steps will demonstrate how to open Google Drive on your device and choose files to be imported into KDSmart.
|1.||Navigate to the Trials screen and select the Import button at .|
|2.||Select an import option - for this tutorial choose the File KDX option at . This opens Google Drive.|
A successful import results in the following screen. The attachment message indicates that there are no attachments to the Trial.
Once data is collected by scoring with KDSmart, the data needs to be transferred to KDXplore for curation. Step 5 will demonstrate how to transfer scored data for KDXplore using Google Drive.
|1.||On the Trials screen in the above image, ensure that the Scored Trial that you want to transfer is selected and then choose the Options button at and then the Share option at .|
Once the file has been saved, confirmation notifications are displayed on the device as seen in the below image. This indicates that the Scored Trials are now stored in Google Drive.
The final step is to load the Scored Trial from Google Drive into KDXplore. This allows the user to curate and analysing the scored data.
|1.||Ensure that Google Drive is opened. If it is not, then there is a Google Drive button in KDXplore which opens it in a browser. This button is located at in the above image.|
|2.||Choose any file such as the one located at . 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).|
Click+drag the downloaded file (such as the one in the below image) to the Trials panel in KDXplore. This displays the Load Trial Data window at . The Download button can also be selected to display the Load Trial Data window.
|4.||Select/highlight the file you want to import, select a Source device, and then enter the Name of the Device User.|
Whilst the Google Drive method is now the recommended method for exchanging data between KDXplore and KDSmart, KDXchange is still provided as a backup method for exchanging data.
Connecting Devices has three steps.
KDXplore and KDSmart devices connect and synchronise data using a WiFi network.
The KDSmart device(s) and the KDXplore laptop/PC must be connected and visible to each other on the same network (i.e. same wifi connection). This is a networking requirement and not a limitation of KDSmart/KDXchange.
Depending on the network configuration, there may be times when your PC/Laptop is connected to a wired network (not on WiFi) yet will be able to connect to KDSmart devices on WiFi.
Many organisational IT policies lock computer settings preventing the set up or activation of your own WiFi Hotspot without needing Administrator user access on the computer.
Before traveling to ‘the field’ we suggest you prepare, test and become familiarised with this means of connecting devices. Seek support in your organisation if needed.
If the message above is displayed try the Connect Anyway button, however this may result in mixed success. Only a couple of tries is needed!
When a WiFi network is unavailable at your location, a portable WiFi hotspot can be created on your Laptop (if it has that capability). The connection can then be shared with your other KDSmart devices using KDXchange (see the above tip).
The following image displays a section of the KDXchange screen highlighted to show the following areas:
- Connection panel is where the options to connect devices are located. This includes the IP Address where the KDXchange server will be created.
- KDXplore panel links KDXplore from the user’s computer. This means that the list of Trials, Traits, and Tags that are on the user’s version of KDXplore are displayed. The user will need to choose between either the Trials, Traits or Tags to be selected.
- KDSmart Devices is a list of all the KDSmart devices that are connected to KDXchange or are available for connection. The image demonstrates that a device named ‘Galaxy S8+’ from the user named ‘Tester’ is currently connected.
- Device is a panel which displays data from the currently connected KDSmart device.
KDXchange server software in KDXplore and KDSmart enables them to communicate and needs to be kept running on the pc/laptop until any synchronisation tasks between the devices has completed. Also, the devices should be kept in close proximity whilst connected. Once tasks have completed the KDXchange server can be stopped.
Step 2 involves preparing KDXplore on the laptop/pc to communicate with KDSmart devices. The following steps must be performed on the laptop/pc:
|2.1 (KDX)||On the Laptop/PC start KDXplore and select the Trial Manager icon.|
|2.2 (KDX)||Select the KDXchange Server icon at top of the Trial Manager window to open KDXchange.|
|2.3 (KDX)||Select the Start button ( or Shift Start to enter address and/or port number) which is located at on the above image.|
|2.4 (KDX)||The Network/IP Address and the Port number need to be confirmed.
The selected Network/IP Address in this example is different to that of another computer. The IP address of the computer running KDXplore (suggested by default), is usually fine but can changed if required.
Select the OK button in the window at to confirm this IP Address.
The Port Number usually should be left at the default setting, however if it is changed, both KDSmart and KDXplore must have the same port number. Once OK has been selected, the window will disappear and the program will start listening for devices which means that it is scanning for available devices on the Wi-Fi network.
Once KDXplore is listening for devices, there will be a message displaying the IP address and port number at in the following image. By selecting the Stop button at , the user can stop KDXplore listening for devices.
Step 3 involves connecting one or more KDSmart devices via WiFi with KDXplore on the laptop/pc. These ‘connection’ steps are common to both Upload to KDXplore or Download from KDXplore and for Trials, Traits or Tags.
|3.1 (KDX)||Ensure that the KDXchange server is listening for any KDSmart device(s) from the previous Part 2 steps (as demonstrated above).|
A dialogue box then opens which asks for information about the device as seen in the following image:
Once user information has been entered, the device connection is complete. KDXplore should look like the following image: