For the complete documentation index, see llms.txt. This page is also available as Markdown.

Lab Eligibility: Main Issues and How to Fix

Missing Scan Report

If you are missing a scan report and want to grade your diamond through a Tracr intergration, you will need to upload a polished diamond and a supported scan report that Tracr can process.

Please follow the guidelines below to help upload a scan report.

Invalid Scan Report

If your scan report is invalid, you have uploaded a scan report that is not .xml, .htm, or .html. Manually renaming a file's extension will not make it valid.

Please follow the guidelines below to help upload a valid scan report.

Scan Report Guide

Supported Scan Report

A diamond needs a supported scan report to be eligible for grading. Tracr currently supports Sarine XML scan reports and Helium HTM and HTML scan reports.

We support Helium Carbon versions that generate a .Ox2z file extension, beginning with Carbon version 1.0. For the latest version, please visit the official Helium Website.

Example scan reports:

Prepare a polished diamond dataset

Follow these steps to prepare polished diamond data for upload to Tracr.

Sarine Instructor

If you are using Sarine Instructor to provide a scan for polished diamonds, you need to generate an XML report and an STL export. Use the template provided by Tracr to export the report for each diamond.

In the CSV file, Tracr needs the STL file in the column scan, and the XML report in the column scan_report.

Sarine Instructor: Extracting data for polished diamonds

Extracting the required traceability data for polished diamonds using Sarine Instructor software is compatible with the following hardware:

  • DiaMension

  • DiaMension HD

  • DiaMark HD

  • DiaMark™ HD

Once a polished diamond is scanned and the file loaded onto the Instructor software, you can extract the following data points:

  • Diamond Measurements (using a provided template)

  • Diamond 3D Model

The following instructions describe how to extract the required data.

1

Install the Tracr templates for polished diamonds

  • Place the Tracr template file, e.g. ‘TracrPolishedTemplate.txt’, within the Sarine Instructor Export folder: Sarine Technologies/Instructor/Export/

2

Export diamond measurements

  1. Open the stone .srn file in Sarine Instructor.

  2. Point to the Export icon, and select the corresponding Tracr template, for example, ‘TracrPolishedTemplate.txt’.

  3. In the Save As dialog box, save the measurements as ‘YourStoneName.xml’.

3

Export the mesh

  1. Open the stone .srn file.

  2. Point to the Save icon, and select Save as.

  3. In the Save As dialog box, select ‘*.stl’ as the file type and save the mesh with the stone's name.

Helium software

If you are using Helium software to provide a scan for polished diamonds, you need to generate an HTM/HTML report and an STL export. Use the template provided by Tracr to export the report for each diamond. There are two types of Helium template:

  • Specific shape, only for a handful of shapes with additional information.

  • Generic, less information but you can use this template for all shapes.

Shape
Recommended template

Princess

HTML_REPORT_FOR_PRINCESS

Radiant

HTML_REPORT_FOR_RADIANT

Heart

HTML_REPORT_FOR_Any_Cut

Pear

HTML_REPORT_FOR_Any_Cut

Oval

HTML_REPORT_FOR_OVAL_MARQUISE

Marquise

HTML_REPORT_FOR_OVAL_MARQUISE

Cushion

HTML_REPORT_FOR_CUSHION

Emerald

HTML_REPORT_FOR_STEP_CUT

In the CSV file, Tracr needs the STL file in the column scan, and the HTM/HTML report in the column scan_report.

For more information about exporting using a Helium Polish Scanner, please refer to the Helium Polish Scanner - Settings for Export (PDF).

Download Helium templates

Please note:

  • Before uploading polished diamond data, please make sure that you register the parent diamond on Tracr.

  • To verify the polished diamond, a 3D scan and the report of the scan of the diamond are crucial.

  • Providing the images and videos is optional, however, this will greatly improve the Diamond Experience.

  • Add the grading document to complete the polished digital asset.

To populate a polished diamond CSV file:

1

Download the polished CSV file template

(Integration Tool > Integration toolkit > CSV Templates).

2

Populate the CSV file

One row per diamond.

3

Use the Data Dictionary

It is recommended that you download and use the Data Dictionary (Integration Tool > Integration toolkit > Data dictionary) to help you to populate the CSV file. Filter the Data Dictionary by "Stone State = Polished". Ensure that you populate fields with the column "Required = true".