FHOPS tree-inventory handoff

Nemora can export a synthetic stand to the FHOPS fhops.tree.inventory.v1 contract and register a FHOPS scenario against it. FHOPS remains the consumer; Nemora does not import FHOPS.

Export

from nemora.export import export_fhops_tree_inventory

export = export_fhops_tree_inventory(
    synthetic_trees,
    "build/handoff/inventory",
    block_id="B01",
    inventory_id="nemora-example-stand",
)

The export writes tree_inventory.csv and tree_inventory.meta.json, including the CSV SHA-256, tree count, units, CRS, review status, and caveats. Coordinates are deterministic synthetic placement unless the source tree list already has a spatial contract.

Register a scenario

from nemora.fhops_handoff import register_fhops_scenario, validate_fhops_scenario_pin

registration = register_fhops_scenario(
    "path/to/fhops/scenario-template",
    "build/handoff/scenario",
    "build/handoff/inventory",
    block_id="B01",
    work_required_m3=530.543340,
)
assert validate_fhops_scenario_pin(registration.scenario_path)

Registration copies the scenario template, writes the tree-inventory pin and checksums, and optionally reconciles the block work_required and volume_per_ha_m3. It fails if the inventory block is not declared or the metadata checksum does not match.

Independent yield check

from nemora.yield_check import estimate_inventory_volume

estimate = estimate_inventory_volume(tree_table)
print(estimate.total_volume_m3)

The estimator is a paraboloid-style independent check, not a taper model. It uses DBH, total height, a 70% merchantable-height ratio, and a 0.5 form factor. Report the difference from FHOPS processed volume rather than forcing a match.

Run FHOPS

fhops tree system build/handoff/scenario/scenario.yaml \
  --block B01 --feller H1 --skidder H2 --skidder H3 \
  --processor H5 --loader H4 --truck-capacity 5 --truck-count 1 \
  --landing-capacity 15 --out build/handoff/system

The ground system is one block/one landing per run. A multi-block set is a catalog of separate scenarios, not a simultaneous multi-block optimizer.

Limits

  • Synthetic inventories are not surveyed stands or tree maps.

  • The independent volume estimate is a geometric check, not a taper model.

  • Machine rates are reference/fixture values, not field-calibrated.

  • No operational, financial, or regulatory claim is made.