Custom user-defined models

Custom user-defined models#

Overview#

H2Integrate now supports user-defined models that operate alongside built-in wrapped models for performance, cost, and financial analysis. This feature enables users to integrate proprietary or external tools with the H2Integrate framework, unlocking more flexible and extensible workflows.

Why use custom models?#

Users may want to:

  • Use proprietary models developed in-house.

  • Integrate with tools outside of H2Integrate (e.g., Aspen, Excel, or custom Python code).

  • Model technologies not yet covered by existing wrapped models.

This feature allows any custom model that conforms to OpenMDAO standards and uses the appropriate configuration interfaces to be used within the H2Integrate ecosystem.

Examples#

The models in the following two examples use standard H2Integrate configuration utilities and OpenMDAO components.

Note

You can combine an existing H2Integrate model and a custom model for the same technology within a single analysis. For example, you can use a built-in performance model and a custom finance model for a given technology.

Custom Technology Model Example: paper mill model#

To demonstrate this capability, we include a minimal example of a custom technology model: a paper mill. This example includes:

  • A PaperMillPerformance model that converts electricity input to paper output.

  • A PaperMillCost model that estimates capital and operational expenditures.

  • A PaperMillFinance technology finance model that computes the levelized cost of paper production (LCOP).

Refer to the Paper Mill Model Example for a complete walkthrough.

Custom General Finance Model Example: simple LCO finance model#

To demonstrate this capability, we include an example of a custom general finance model: a simple LCO (levelized cost of) calculation found in Example 08: Wind Electrolyzer Example. This example includes:

  • A SimpleLCOFinanceConfig: configuration class that is populated with inputs specific to that finance model.

  • A SimpleLCOFinance general finance model that computes the levelized cost of a commodity

Key benefits#

  • Flexibility: Use any modeling tool or codebase that suits your domain or organization.

  • Interoperability: Integrate with the broader H2Integrate pipeline, including downstream analyses.

  • Confidentiality: Keep proprietary models external to the H2Integrate codebase.

Key concepts#

  • Custom models are defined as OpenMDAO components.

  • Configuration is handled using attrs and BaseConfig for consistent validation and input/output management.

  • Inputs and outputs should follow standard naming and unit conventions where applicable.

  • Models can be integrated into the broader H2Integrate workflow, including scenario execution and results processing.

Getting started#

To use a custom model in your H2Integrate project, we recommend you look at existing models in the H2Integrate codebase to help guide the process. After learning the basic structure from those models, you can follow these steps:

  1. Create configuration classes

    Create a configuration class that inherits from BaseConfig for any performance, cost, or financial parameters your model needs.

  2. Implement OpenMDAO components

    Define your model logic using om.ExplicitComponent.

  3. Merge inputs

    Use merge_shared_inputs to integrate with existing input structures.

  4. Use in a workflow

    Treat your custom model as a drop-in component in your analysis workflow.

Note

Your custom model cannot have the same name as an existing H2Integrate model. To remove ambiguity of which model would be used, an error will be raised if a custom model shares a name with an existing H2Integrate model.

This feature supports broader adoption of H2I by allowing integration with the tools and models users already trust.

Note

Custom models can include calls to external tools (e.g. an Excel macro) within the compute function as long as the required inputs and outputs are properly defined and handled.

Contents