Documentation

Everything you need to create crystal visualizations with gemmology.dev packages.

Getting Started

Installation

Install gemmology packages via pip

Quick Start

Generate your first crystal visualization

CDL Language

CDL Specification

Complete Crystal Description Language reference

CDL Examples

Common patterns and recipes

API Reference

cdl-parser

Parse and validate CDL expressions

crystal-geometry

3D geometry generation

mineral-database

Query mineral presets

crystal-renderer

Render crystals to SVG, STL, glTF

CLI Reference

Command Line

Generate crystals from the terminal

CLI Options

Complete list of command-line flags

Quick Reference

Installation

pip install cdl-parser crystal-geometry mineral-database crystal-renderer

Quick Start

from cdl_parser import parse_cdl
from crystal_geometry import cdl_to_geometry
from crystal_renderer import generate_svg

desc = parse_cdl("cubic[m3m]:111")
geom = cdl_to_geometry(desc)
svg = generate_svg(geom)