Before you begin: One-time calibration
Before a new sensor can be used, it must be calibrated using the "Structor Sensor Calibrator" available on the iOS App store from the following link:
Once installed launch the calibrator app and follow the on-screen instructions and tutorial to align the iPad camera with the sensor; calibration data will be saved to the sensor for future use.
Note: If your scan results are having alignment problems you may want to retry the calibration.
Step 1: Record Harvest Information
- From the iOS application, navigate to the Harvest Events
- Tap the ( + ) button to add a new event
- Enter event details and save
- Record a Harvest Input, enter details and save.
Step 2: Choose the Harvest Input to scan
Navigate to the "Inputs" list of the Harvest Event created in Step 1, and choose the down-arrow widget beside the input you would like to scan and tap "Take HQV Scan":
Step 3: Perform the scan
After choosing 'Take HQV Scan' from the desired input the scanning interface will load:
Aim the iPad so your looking at just the contents of the bin and then tap the 'Scan' button. A green mesh will appear over the apples as you slowly move the ipad over the bin until all of the apples are covered by the mesh.
If you make a mistake you can hit the 'Reset' button (circular arrow above the 'Stop' button) on the right-hand side to try again:
See the following video for a visual representation of the scanning process:
When you have completed the scan, tap the 'Stop' button on the right-hand side. The application will then take a moment to prepare the scan for review:
The final screen allows you to quickly review the results from a top-down perspective. Everything should be clearly visible without any large gaps or distortion.
When you're satisfied with the results choose the 'Save' button in the top right and the scan will be immediately uploaded the the Croptracker servers for processing.
Step 5: Review scan results online
After a scan has been uploaded the Croptracker servers will then process it online. When finished you can review the results of the scans by going to the 'Harvest' menu and choosing 'Harvest Quality Vision Scans'.
Dependent on the size of the scan and currently available processing resources in the cloud the results can take several minutes to complete.
Here are some of the known issues encountered during early trials:
|First-time scan may crash the application while asking for permissions.||This appears to be an issue with the hardware driver for the scanner. After accepting permissions you can re-load the application and subsequent use should not crash.|
The scanner may not be detected even though it's plugged in.
If you see a screen saying "Please Connect Sensor" simply un-plug and re-plug the sensor cable. If this does not resolve the issue the scanner battery may be exhausted and need to be recharged before use.
|The scanner view may appear to 'freeze' while scanning.|
Cause of issue is unknown but can usually be resolved using one of the following methods:
|Mesh refuses to cover areas in sunlight|
Sunlight can overload the sensor input (since it utilizes infra-red lasers) and prevents it from capturing in that area.
Either capture in a shaded area or use some form of cover (or even your own shadow) to block sunlight in the areas being scanned.
|Mesh "doubles up" and drifts while scanning.||Scan is being performed too quickly or too close. Slow down the scan and make sure the mesh is populating evenly as you move the camera. Fast motions may cause the scanner to lose it's "tracking" position and make it impossible to complete the scan.|
|Scanning view is darkened and mesh is covering only pieces of the view.||You may be too close to perform a scan, maintain a minimum distance of 45-50cm while scanning. If you are unable to reach this distance a step-stool or other suitable elevation platform may be necessary.|
|Opening HQV displays a calibration message and then fails to load or crashes.||Please download the Structure Sensor Calibrator tool and follow the instructions as described in the "Before You Begin" section above.|