Documentation Index
Fetch the complete documentation index at: https://docs.mangrovesystems.com/llms.txt
Use this file to discover all available pages before exploring further.
What you’ll build in this exercise:
- Configure per-delivery batch partitioning to generate separate batches per delivery
- Add Energy Consumption and Transportation event types for LCA data
- Calculate process emissions and allocate them to individual batches
- Verify net carbon output (gross - emissions) across multiple batches
Part 1: Design (30 min)
1. Choose a partition strategy
For Mangrove Biochar, decide:- Should batches be per-delivery or time-based (e.g., monthly)?
- What does the Isometric methodology require?
- What makes operational sense for 3-4 deliveries per week?
2. Identify emission sources
Map the emission sources for Mangrove Biochar:| Source | Category | Data Source | Cadence |
|---|---|---|---|
| Electricity for pyrolysis | Process | Monthly utility bill | Monthly |
| Propane for heating | Process | Monthly supplier invoice | Monthly |
| Transport to application site | Process | Per-delivery trip log | Per-delivery |
3. Plan emissions allocation
| Emission | Method | Rationale |
|---|---|---|
| Electricity | Proportional by mass | Energy scales with throughput |
| Propane | Proportional by mass | Heating scales with throughput |
| Transport | Direct to delivery batch | Each delivery has its own route |
Part 2: Build in Mangrove (1.5 hrs)
Step 1: Configure batch partitioning
- Open your Mangrove Biochar project’s batch type configuration.
- Set the partition cadence to per-delivery (ID-based partitioning).
- Verify the batch type is linked to the correct ledger and model output.
Step 2: Add LCA event types
Add two new event types in Data Inputs > Input Settings:Energy Consumption
| Datapoint | Slug | Type |
|---|---|---|
| Electricity (kWh) | electricity-kwh | number |
| Propane (gallons) | propane-gallons | number |
| Period start | period-start | date |
| Period end | period-end | date |
Transportation
| Datapoint | Slug | Type |
|---|---|---|
| Distance (km) | distance-km | number |
| Fuel type | fuel-type | text |
| Delivery ID | delivery-id | text |
Step 3: Add emission factors as static inputs
Configure these as static inputs in the resource library:| Factor | Value | Unit |
|---|---|---|
| Grid emission factor | 0.417 | kg CO2e/kWh |
| Propane emission factor | 5.72 | kg CO2e/gallon |
| Diesel emission factor | 2.68 | kg CO2e/liter |
| Fuel consumption rate | 0.30 | L/km |
Step 4: Build LCA calculations in the model
Expand your model in the Model Editor :Electricity emissions
electricity_emissions = electricity_kwh × grid_emission_factor / 1000(Divide by 1000 to convert kg to tonnes)Transport emissions
transport_emissions = distance_km × fuel_consumption_rate × diesel_emission_factor / 1000Allocate shared emissions
Use the
data_point_proportion operator to allocate electricity and propane emissions proportionally by biochar mass across batches.Total allocated emissions per batch
batch_emissions = allocated_electricity + allocated_propane + transport_emissionsStep 5: Create test data
Add events representing one month of operations: 4 Biochar Deliveries:| Delivery | Date | Mass (t) | Carbon % |
|---|---|---|---|
| DEL-001 | Jan 5 | 3 | 80% |
| DEL-002 | Jan 12 | 5 | 78% |
| DEL-003 | Jan 19 | 4 | 82% |
| DEL-004 | Jan 26 | 2 | 79% |
- Electricity: 10,000 kWh
- Propane: 500 gallons
| Delivery | Distance (km) |
|---|---|
| DEL-001 | 150 |
| DEL-002 | 200 |
| DEL-003 | 180 |
| DEL-004 | 120 |
Step 6: Generate and verify batches
- Go to Production Accounting and generate batches for January.
- Verify that 4 separate batches are created (one per delivery).
-
For each batch, check:
- Gross carbon calculation matches expected values
- Allocated emissions are proportional to mass
- Transport emissions are directly assigned to the correct batch
- Net carbon = gross - total emissions
Success criteria
You have completed the Module 3 exercise when:- Per-delivery partitioning configured — generating batches creates one batch per delivery event
- 4 test deliveries created across different January dates, each generating its own batch
- Energy Consumption and Transportation event types created with appropriate datapoints
- Emission factors stored as static inputs in the resource library
- Process emissions calculated correctly (electricity × factor, propane × factor, transport × factor)
- Emissions allocated — electricity and propane proportionally by mass, transport directly to each batch
- Net carbon = gross carbon - total allocated emissions for each batch
- Allocation sums match — total allocated emissions across all batches equals the total period emissions