nodes.gold_decision

nodes.gold_decision

Gold Layer - Decision Support Hamilton Nodes

Hamilton nodes that provide decision-useful metrics for investment, operations, and compliance.

These nodes extend the base emissions calculations with actionable business intelligence.

Functions

Name	Description
compliance_watch_list	Filter operators requiring compliance monitoring.
decision_summary_stats	Calculate portfolio summary statistics.
investment_opportunities	Filter and rank investment opportunities by NPV.
operational_improvement_targets	Filter operators with high improvement potential.
operator_decision_metrics	Calculate decision metrics for investment, operations, and compliance.
operator_parent_decision_metrics	Parent-level decision metrics (investment, operations, compliance).

compliance_watch_list

nodes.gold_decision.compliance_watch_list(
    operator_decision_metrics: pd.DataFrame,
)

Filter operators requiring compliance monitoring.

Returns: DataFrame sorted by regulatory risk

decision_summary_stats

nodes.gold_decision.decision_summary_stats(
    operator_decision_metrics: pd.DataFrame,
)

Calculate portfolio summary statistics.

Returns: Dictionary with aggregated metrics

investment_opportunities

nodes.gold_decision.investment_opportunities(
    operator_decision_metrics: pd.DataFrame,
)

Filter and rank investment opportunities by NPV.

Filters: - Positive NPV (>$1M) - Reasonable payback (<7 years) - Manageable regulatory risk (<75) - Material scale (>50 kt CO2e/year) - Valid production data (>10,000 BOE/year) - Reasonable intensity (<500 kg CO2e/BOE) - Valid (non-NaN) intensity

Returns: DataFrame sorted by NPV descending

operational_improvement_targets

nodes.gold_decision.operational_improvement_targets(
    operator_decision_metrics: pd.DataFrame,
)

Filter operators with high improvement potential.

Returns: DataFrame sorted by opportunity priority

operator_decision_metrics

nodes.gold_decision.operator_decision_metrics(
    operator_petrinex_emissions: pd.DataFrame,
)

Calculate decision metrics for investment, operations, and compliance.

Returns: DataFrame with investment scores, efficiency metrics, and compliance risk

operator_parent_decision_metrics

nodes.gold_decision.operator_parent_decision_metrics(
    operator_parent_emissions: pd.DataFrame,
)

Parent-level decision metrics (investment, operations, compliance).

Args: operator_parent_emissions: Parent-level emissions data

Returns: DataFrame with parent-level decision metrics