Crystal visualization and gemmological reference tools aligned with the FGA (Gem-A) curriculum.
| Package | Description | Docs | PyPI |
|---|---|---|---|
| cdl-parser | Crystal Description Language parser |  |
 |
| crystal-geometry | 3D geometry engine for crystals & twins | |
 |
| mineral-database | SQLite database with 94+ mineral presets | |
 |
| crystal-renderer | SVG/STL/glTF visualization export | |
 |
| cdl-lsp | Language Server for IDE support | |
 |
| gemmology-knowledge | FGA curriculum documentation | |
- |
- Main Website - Documentation hub
- CDL Playground - Interactive crystal editor
- Crystal Gallery - Browse mineral presets
- Learn - FGA curriculum-aligned content
- Quiz & Exams - Test your gemmology knowledge
- Calculator Tools - SG, RI, birefringence calculators
Crystal Description Language (CDL) is a notation for describing crystal morphology:
cubic[m3m]:{111}@1.0 + {100}@1.3 # Truncated octahedron
trigonal[-3m]:{10-10}@1.0 + {10-11}@0.8 # Quartz prism with pyramids
# Full suite
pip install gemmology-plugin
# Individual packages
pip install gemmology-cdl-parser gemmology-crystal-geometry gemmology-mineral-database gemmology-crystal-rendererWe welcome contributions! See CONTRIBUTING.md for guidelines.
All packages are released under the MIT License.