| name | minerals-viz |
| description | Generate charts (PNG/SVG) for critical minerals data — production, trade, import reliance, and time series |
| metadata | {"openclaw":{"emoji":"📈","requires":{"bins":"[Truncated]"}}} |
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:
python3 {baseDir}/scripts/generate_chart.py --chart-type production --commodity lithi
Time series:
python3 {baseDir}/scripts/generate_chart.py --chart-type timeseries --commodity cobal
Import reliance:
python3 {baseDir}/scripts/generate_chart.py --chart-type import-reliance --commodity raree
Custom output:
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
python3 {baseDir}/scripts/generate_chart.py --chart-type production --commodity lithi --top-n 10
python3 {baseDir}/scripts/generate_chart.py --chart-type timeseries --commodity cobal --output cobalt_trend.png
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
