Skip to main content
Early Access - The Dcycle CLI is currently available for enterprise customers. Contact us to learn more about access.

​
Overview

Link Life Cycle Assessment (LCA) materials to ecoinvent activity names for accurate environmental impact calculations. Materials can be linked in bulk from an Excel file or individually with explicit match pairs.

​
Available Commands

CommandDescription
dcy lca linkLink materials to ecoinvent activities (from file or explicit matches)
dcy lca edit <id>Edit the ecoinvent match for a single material
Upload an Excel file (.xlsx) with material-to-activity mappings: 
dcy lca link --file-path materials.xlsx
Output: 
LCA materials link file uploaded successfully
File ID: abc123-...

​
Flags

FlagShortDefaultDescription
--file-path-f—Path to the Excel file (.xlsx)
--dry-run—falsePreview without uploading
--org——Organization ID override

​
Examples

# Preview without uploading
dcy lca link --file-path materials.xlsx --dry-run

# Upload with JSON output
dcy lca link --file-path materials.xlsx --format json
Dry-run output: 
Dry run: would upload materials.xlsx (24.5 KB)
For materials that can’t be auto-matched, specify the ecoinvent activity directly. This is an alternative to --file-path — they cannot be used together: 
dcy lca link \
  --match "<material-id>=Electricity, low voltage {ES}| market for | Cut-off, U"
Multiple --match flags can be provided for different materials: 
dcy lca link \
  --match "<id-1>=Activity name one" \
  --match "<id-2>=Activity name two"

​
Flags

FlagShortDefaultDescription
--match-m—Match pair UUID=activity_name (repeatable)
--dry-run—falsePreview without uploading
--org——Organization ID override
--file-path and --match are mutually exclusive. Use one or the other, not both.

​
Edit Material

Update the ecoinvent activity linked to a specific material: 
dcy lca edit <material-id> \
  --activity "Electricity, low voltage {ES}| market for | Cut-off, U" \
  --country ES
Output: 
Material: Electricity Grid Mix
ID: 550e8400-...
Country: ES
Current Match: None
New Match: Electricity, low voltage {ES}| market for | Cut-off, U
LCA materials link file uploaded successfully
File ID: abc123-...

​
Flags

FlagShortRequiredDescription
--activity-aYesNew ecoinvent activity name
--country-cNoISO country code override
--location-lNoEcoinvent product location (GLO, RER, RoW, etc.) — sets region for impact resolution
--dry-run—NoPreview without updating
--org—NoOrganization ID override

​
Examples

# Preview without uploading
dcy lca edit <material-id> --activity "Activity name" --dry-run

# Set country and location
dcy lca edit <material-id> \
  --activity "Electricity, low voltage {ES}| market for | Cut-off, U" \
  --country ES \
  --location RER

# JSON output
dcy lca edit <material-id> --activity "Activity name" --format json

​
Typical Workflows

# 1. Preview the upload
dcy lca link --file-path materials.xlsx --dry-run

# 2. Upload
dcy lca link --file-path materials.xlsx

​
Fix Individual Matches

# 1. Check the current match
dcy lca edit <material-id> --activity "new activity" --dry-run

# 2. Apply the fix
dcy lca edit <material-id> --activity "new activity" --country ES

dcy lca link \
  --match "550e8400-...=Electricity, low voltage {ES}| market for | Cut-off, U" \
  --match "661f9511-...=Natural gas, high pressure {RER}| market group for | Cut-off, U"

​
Next Steps

Custom Emission Factors

Upload organization-specific emission factors

Sold Products

Manage sold product records

Facilities

Manage physical locations

Projects

Create and manage sustainability projects