Substitution Map
Map substitute materials for a critical mineral commodity with trade-off analysis (performance, cost, availability) and supply risk assessment. Uses a curated knowledge base of substitution relationships enriched with live data from BGS production statistics and corpus search.
Usage
Find substitutes for a commodity:
python3 {baseDir}/scripts/substitution_lookup.py --commodity lithium
Filter by application:
python3 {baseDir}/scripts/substitution_lookup.py --commodity cobalt --application batteries
JSON output:
python3 {baseDir}/scripts/substitution_lookup.py --commodity rare_earth --format json
Parameters
| Parameter |
Description |
Default |
--commodity |
Commodity to find substitutes for |
Required |
--application |
Specific application: batteries, magnets, catalysts, alloys, electronics |
all |
--format |
Output format: summary, detailed, json |
summary |
Available Commodities
| Commodity |
Key Applications |
lithium |
Batteries, ceramics, lubricants |
cobalt |
Batteries, superalloys, catalysts |
rare_earth |
Magnets, catalysts, phosphors |
nickel |
Batteries, stainless steel, alloys |
graphite |
Batteries, refractories, lubricants |
manganese |
Steel, batteries, chemicals |
gallium |
Semiconductors, LEDs, solar cells |
germanium |
Fiber optics, IR optics, solar cells |
copper |
Wiring, electronics, motors |
Examples
# All lithium substitutes
python3 {baseDir}/scripts/substitution_lookup.py --commodity lithium
# Cobalt substitutes in batteries
python3 {baseDir}/scripts/substitution_lookup.py --commodity cobalt --application batteries
# Rare earth substitutes in magnets (JSON)
python3 {baseDir}/scripts/substitution_lookup.py --commodity rare_earth --application magnets --format json
Notes
- Substitution data from curated knowledge base (USGS, industry literature)
- Trade-off ratings: performance (1-5), cost (relative), availability (1-5)
- Supply risk enrichment from BGS when available
- For production data, use
bgs-production; for risk metrics, use supply-chain-analysis
1---2name: substitution-map3description: Map substitute materials for critical minerals with trade-off analysis and supply risk assessment4---56# Substitution Map78Map substitute materials for a critical mineral commodity with trade-off analysis (performance, cost, availability) and supply risk assessment. Uses a curated knowledge base of substitution relationships enriched with live data from BGS production statistics and corpus search.910## Usage1112### Find substitutes for a commodity:13```bash14python3 {baseDir}/scripts/substitution_lookup.py --commodity lithium15```1617### Filter by application:18```bash19python3 {baseDir}/scripts/substitution_lookup.py --commodity cobalt --application batteries20```2122### JSON output:23```bash24python3 {baseDir}/scripts/substitution_lookup.py --commodity rare_earth --format json25```2627## Parameters2829| Parameter | Description | Default |30|-----------|-------------|---------|31| `--commodity` | Commodity to find substitutes for | Required |32| `--application` | Specific application: batteries, magnets, catalysts, alloys, electronics | all |33| `--format` | Output format: summary, detailed, json | summary |3435## Available Commodities3637| Commodity | Key Applications |38|-----------|-----------------|39| `lithium` | Batteries, ceramics, lubricants |40| `cobalt` | Batteries, superalloys, catalysts |41| `rare_earth` | Magnets, catalysts, phosphors |42| `nickel` | Batteries, stainless steel, alloys |43| `graphite` | Batteries, refractories, lubricants |44| `manganese` | Steel, batteries, chemicals |45| `gallium` | Semiconductors, LEDs, solar cells |46| `germanium` | Fiber optics, IR optics, solar cells |47| `copper` | Wiring, electronics, motors |4849## Examples5051```bash52# All lithium substitutes53python3 {baseDir}/scripts/substitution_lookup.py --commodity lithium5455# Cobalt substitutes in batteries56python3 {baseDir}/scripts/substitution_lookup.py --commodity cobalt --application batteries5758# Rare earth substitutes in magnets (JSON)59python3 {baseDir}/scripts/substitution_lookup.py --commodity rare_earth --application magnets --format json60```6162## Notes6364- Substitution data from curated knowledge base (USGS, industry literature)65- Trade-off ratings: performance (1-5), cost (relative), availability (1-5)66- Supply risk enrichment from BGS when available67- For production data, use `bgs-production`; for risk metrics, use `supply-chain-analysis`
lamm-mit