LCA Materials - Dcycle Platform Docs

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

Command	Description
`dcy lca link`	Link materials to ecoinvent activities (from file or explicit matches)
`dcy lca edit <id>`	Edit the ecoinvent match for a single material
`dcy lca delete-material <id>`	Delete an LCA material by ID

Link from File

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

Flag	Short	Default	Description
`--file-path`	`-f`	—	Path to the Excel file (.xlsx)
`--dry-run`	—	`false`	Preview 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)

Link with Explicit Matches

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

Flag	Short	Default	Description
`--match`	`-m`	—	Match pair `UUID=activity_name` (repeatable)
`--dry-run`	—	`false`	Preview 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

Flag	Short	Required	Description
`--activity`	`-a`	Yes	New ecoinvent activity name
`--country`	`-c`	No	ISO country code override
`--location`	`-l`	No	Ecoinvent product location (GLO, RER, RoW, etc.) — sets region for impact resolution
`--dry-run`	—	No	Preview without updating
`--org`	—	No	Organization 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

Delete Material

Delete an LCA material by ID:

dcy lca delete-material <material-id>

Output:

material deleted successfully: Material Name

Flags

Flag	Short	Default	Description
`--yes`	`-y`	`false`	Skip confirmation prompt
`--org`	—	—	Organization ID override

Examples

# With confirmation prompt
dcy lca delete-material <material-id>

# Skip confirmation
dcy lca delete-material <material-id> --yes

# JSON output
dcy lca delete-material <material-id> --yes --format json

Typical Workflows

Bulk Link Materials

# 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

Link Multiple Materials Without a File

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

​Overview

​Available Commands

​Link from File

​Flags

​Examples

​Link with Explicit Matches

​Flags

​Edit Material

​Flags

​Examples

​Delete Material

​Flags

​Examples

​Typical Workflows

​Bulk Link Materials

​Fix Individual Matches

​Link Multiple Materials Without a File

​Next Steps

Custom Emission Factors

Sold Products

Facilities

Projects

Overview

Available Commands

Link from File

Flags

Examples

Link with Explicit Matches

Flags

Edit Material

Flags

Examples

Delete Material

Flags

Examples

Typical Workflows

Bulk Link Materials

Fix Individual Matches

Link Multiple Materials Without a File

Next Steps