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

Lab Eligibility

Overview

Tracr has been working on integrations with trusted grading labs which will allow you to submit a diamond to a grading lab with a Tracr ID to link your grading report to the Tracr digital record. There is also the option with some labs (GIA, IoD) to add your Tracr provenance to the grading report.

A diamond needs to have a few requirements met to be eligible for grading through one of our integrations. These include: being a polished diamond and having a supported scan report that Tracr can process.

The Portal and Tracr API includes the LAB ELIGIBLE status and the breakdown of the eligibility requirements.

How do I work out if my diamond is eligible for grading?

Inventory

Tracr has provided a column with a LAB ELIGIBLE status in the inventory. You are also able to filter on the status and export the result.

Column

There is a column within the inventory, labelled LAB ELIGIBLE.

Within the column, each polished diamond will have a parent status icon. The parent status icons have been designed to quickly identify diamonds that are either Eligible, or require user input.

The options are:

  1. Eligible

  2. Missing report

  3. Missing data

  4. Invalid report

  5. Not processable

How will I know what I need to add to the diamond to make it eligible?

If a diamond has a badge with a green checkmark and the word Eligible your diamond is eligible for grading.

If a diamond has a Error icon or a Warning icon, you will be required to add a scan report that is processable. The badges are hoverable and will give you a popover with more information into what you need to do to fix the diamond record for grading.

Below shows an example of the popover for each status.

Filtering

You will be able to filter your inventory by the LAB ELIGIBLE status.

How will the Lab eligible column show on the Export Report?

There will be a column Lab Eligible, with status options:

  1. Eligible

  2. Missing report

  3. Missing data

  4. Invalid report

  5. Not processable

Diamond Details

The LAB ELIGIBLE status is available on the diamond details.

Lab Eligible Requirements

Polished Diamond

A diamond needs to be polished in your Tracr inventory to be eligible for grading.

How to upload a polished diamond?

Please follow the guidelines detailed here to correctly upload a polished diamond.

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

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. 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".

Processing Scan Report

A diamond needs a supported scan report that Tracr can process for the shape submitted to be eligible for grading.

What the process checks: Shape: It verifies that the declared shape is a supported shape. Scan Report: It confirms that the uploaded scan report is valid for the shape submitted.

We need specific fields from the scan report to compare to the measurements the grading lab submits. If a diamond's scan report is processable, it does not ensure a diamond will be successfully graded.

FAQs

How can I tell if my diamond is eligible for grading?

You will be able to know if your diamond is eligible for grading if it has a checkmark.

Last updated