{
  "name": "FacetLab rough diamond polishing data",
  "version": "2.0.0",
  "source": "4cs.co.za",
  "license": "CC BY 4.0",
  "scope": "Educational game data for explaining diamond cut, colour, clarity and carat. Not grading, valuation or appraisal data.",
  "roughParcels": [
    {
      "id": "KIM-27",
      "name": "Kimberley octahedron",
      "roughMassCarat": 2.84,
      "grainAngleDegrees": 14,
      "baseColour": "H",
      "baseClarityScore": 84,
      "teachingNote": "Octahedral rough often gives a strong round brilliant when the table follows the grain."
    },
    {
      "id": "NAM-11",
      "name": "Namaqualand dodecahedron",
      "roughMassCarat": 3.16,
      "grainAngleDegrees": -22,
      "baseColour": "J",
      "baseClarityScore": 76,
      "teachingNote": "Warmer rough can still look beautiful. Planning decides whether it becomes bright or just heavy."
    },
    {
      "id": "CUL-04",
      "name": "Cullinan offcut",
      "roughMassCarat": 1.92,
      "grainAngleDegrees": 6,
      "baseColour": "F",
      "baseClarityScore": 90,
      "teachingNote": "Clean rough tempts cutters to chase weight, but a shallow plan leaks light through the pavilion."
    },
    {
      "id": "ORA-09",
      "name": "Orange River shard",
      "roughMassCarat": 4.05,
      "grainAngleDegrees": 31,
      "baseColour": "K",
      "baseClarityScore": 70,
      "teachingNote": "Large warm rough makes the yield temptation obvious. The heavy stone is not always the best finished stone."
    }
  ],
  "scoring": {
    "idealTablePercent": 58,
    "idealDepthPercent": 61.8,
    "idealCrownAngleDegrees": 34.5,
    "orientationPenaltyPerDegree": 1.45,
    "tablePenaltyPerPercent": 3.6,
    "depthPenaltyPerPercent": 4.2,
    "crownPenaltyPerDegree": 4.6,
    "cutScoreMix": {
      "brilliance": 0.62,
      "symmetry": 0.38
    },
    "brillianceMix": {
      "planning": 0.38,
      "polish": 0.34,
      "cleave": 0.18,
      "symmetry": 0.1
    },
    "yieldRangePercent": {
      "minimum": 31,
      "maximum": 50
    }
  },
  "analysisModes": [
    {
      "id": "optics",
      "name": "Optics",
      "purpose": "Shows returned and leaking light rays so learners can see why planning and polish affect sparkle."
    },
    {
      "id": "clarity",
      "name": "Clarity",
      "purpose": "Maps feathers, clouds, crystals and pinpoints against the planned table position."
    },
    {
      "id": "stress",
      "name": "Stress",
      "purpose": "Visualises pressure, heat and scratch risk while polishing."
    },
    {
      "id": "make",
      "name": "Make DNA",
      "purpose": "Overlays the table, depth, crown and symmetry geometry behind the finished make."
    }
  ],
  "portableRunFormat": {
    "replayQueryParam": "run",
    "encoding": "base64url JSON",
    "export": "FacetLab can export a finished run as JSON containing grade, metrics, replay URL, attribution and the compact run payload."
  },
  "learningNotes": {
    "cut": "Cut is the main visible driver of sparkle because table, depth, symmetry and polish control how light returns from the stone.",
    "colour": "Colour belongs to the rough, but the finished make and setting can make warmth more or less visible.",
    "clarity": "Clarity is not only a paper grade. Heat, scratches and opened feathers can make inclusions matter more.",
    "carat": "Carat is the finished weight, not the rough weight. A heavier finished stone can still be a worse diamond if the make leaks light."
  }
}