# Minerals Viz

> Generate charts (PNG/SVG) for critical minerals data — production, trade, import reliance, and time series

- Skill: `lamm-mit/minerals-viz` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add lamm-mit/minerals-viz`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lamm-mit/minerals-viz/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: lamm-mit (https://skillmd.com/u/lamm-mit)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lamm-mit/minerals-viz

---


# Minerals Visualization

Generate publication-quality charts for critical minerals data using the cmm_data visualizations module. Supports world production bar charts, production time series, import reliance charts, and multi-commodity comparisons.

## Usage

### World production chart:
```bash
python3 {baseDir}/scripts/generate_chart.py --chart-type production --commodity lithi
```

### Time series:
```bash
python3 {baseDir}/scripts/generate_chart.py --chart-type timeseries --commodity cobal
```

### Import reliance:
```bash
python3 {baseDir}/scripts/generate_chart.py --chart-type import-reliance --commodity raree
```

### Custom output:
```bash
python3 {baseDir}/scripts/generate_chart.py --chart-type production --commodity lithi --output lithium_prod.png --format png
```

## Parameters

| Parameter | Description | Default |
|-----------|-------------|---------|
| `--chart-type` | Chart type: production, timeseries, import-reliance | Required |
| `--commodity` | USGS commodity code (e.g., lithi, cobal, raree, graph, nicke) | Required |
| `--output` | Output file path | auto-generated |
| `--format` | Image format: png, svg | png |
| `--top-n` | Number of countries in production chart | 10 |

## Chart Types

| Type | Description | Data Source |
|------|-------------|-------------|
| `production` | Horizontal bar chart of top producers | USGS world production |
| `timeseries` | Line chart of production over time | USGS salient statistics |
| `import-reliance` | NIR bar chart with threshold line | USGS salient statistics |

## USGS Commodity Codes

| Code | Commodity | Code | Commodity |
|------|-----------|------|-----------|
| `lithi` | Lithium | `cobal` | Cobalt |
| `raree` | Rare Earths | `graph` | Graphite |
| `nicke` | Nickel | `manga` | Manganese |
| `galli` | Gallium | `germa` | Germanium |
| `coppe` | Copper | `tungs` | Tungsten |

## Examples

```bash
# Lithium top producers
python3 {baseDir}/scripts/generate_chart.py --chart-type production --commodity lithi --top-n 10

# Cobalt production time series
python3 {baseDir}/scripts/generate_chart.py --chart-type timeseries --commodity cobal --output cobalt_trend.png

# Rare earth import reliance (SVG)
python3 {baseDir}/scripts/generate_chart.py --chart-type import-reliance --commodity raree --format svg
```

## Notes

- Requires matplotlib (install with: pip install matplotlib)
- USGS data files must be present in cmm-data data directory
- Output defaults to current directory with auto-generated filename
- SVG format recommended for publications and reports
- For raw data access, use the `minerals-data` skill