h2integrate.converters.hydrogen.geologic.h2_well_subsurface_baseclass#

Classes

GeoH2SubsurfaceCostBaseClass(**kwargs)

OpenMDAO component for modeling subsurface well costs in a geologic hydrogen plant.

GeoH2SubsurfaceCostConfig(*, cost_year, ...)

Configuration for cost parameters in natural and geologic hydrogen well subsurface

GeoH2SubsurfacePerformanceBaseClass(**kwargs)

OpenMDAO component for modeling the performance of the well subsurface for

GeoH2SubsurfacePerformanceConfig(*, ...)

Configuration for performance parameters in natural and geologic hydrogen subsurface

class h2integrate.converters.hydrogen.geologic.h2_well_subsurface_baseclass.GeoH2SubsurfacePerformanceConfig(*, borehole_depth, well_diameter, well_geometry, rock_type, grain_size)#
Configuration for performance parameters in natural and geologic hydrogen subsurface

well sub-models.

This class defines key performance parameters shared across both natural and stimulated subsurface geologic hydrogen models.

Parameters:
  • borehole_depth (float)

  • well_diameter (str)

  • well_geometry (str)

  • rock_type (str)

  • grain_size (float)

borehole_depth#

Total depth of the borehole in meters, potentially including turns.

Type:

float

well_diameter#

The relative diameter of the well. Valid options: “small” (e.g., from OSD3500_FY25.xlsx) or “large”.

Type:

str

well_geometry#

The geometric structure of the well. Valid options: “vertical” or “horizontal”.

Type:

str

rock_type#

The type of rock formation being drilled to extract geologic hydrogen. Valid options: “peridotite” or “bei_troctolite”.

Type:

str

grain_size#

The grain size of the rocks used to extract hydrogen, in meters.

Type:

float

borehole_depth: float#
well_diameter: str#
well_geometry: str#
rock_type: str#
grain_size: float#
class h2integrate.converters.hydrogen.geologic.h2_well_subsurface_baseclass.GeoH2SubsurfacePerformanceBaseClass(**kwargs)#
OpenMDAO component for modeling the performance of the well subsurface for

geologic hydrogen.

This component represents the performance model for geologic hydrogen production, which can describe either natural or stimulated hydrogen generation processes. All configuration inputs are sourced from a corresponding GeoH2PerformanceConfig instance.

options#
OpenMDAO options dictionary that must include:
  • plant_config (dict): Plant-level configuration parameters.

  • tech_config (dict): Technology-specific configuration parameters.

  • driver_config (dict): Driver or simulation-level configuration parameters.

Type:

dict

config#

Parsed configuration object containing performance model inputs.

Type:

GeoH2PerformanceConfig

Inputs:
borehole_depth (float):

The total borehole depth, in meters (may include directional sections).

grain_size (float):

The characteristic grain size of the rock formation, in meters.

Outputs:
wellhead_gas_out (ndarray):

The wellhead gas production rate profile over a one-year period (8760 hours), in kilograms per hour.

hydrogen_out (ndarray):

The hydrogen production rate profile over a one-year period (8760 hours), in kilograms per hour.

total_wellhead_gas_produced (float):

The total wellhead gas produced over the plant lifetime, in kilograms per year.

total_hydrogen_produced (float):

The total hydrogen produced over the plant lifetime, in kilograms per year.

initialize()#

Perform any one-time initialization run at instantiation.

setup()#

Declare inputs and outputs.

Available attributes:

name pathname comm options

class h2integrate.converters.hydrogen.geologic.h2_well_subsurface_baseclass.GeoH2SubsurfaceCostConfig(*, cost_year, borehole_depth, well_diameter, well_geometry)#
Configuration for cost parameters in natural and geologic hydrogen well subsurface

sub-models.

This class defines cost parameters that are shared across both natural and stimulated (engineered) geologic hydrogen subsurface systems.

Parameters:
  • cost_year (int)

  • borehole_depth (float)

  • well_diameter (str)

  • well_geometry (str)

borehole_depth#

Total depth of the borehole, in meters (may include horizontal turns).

Type:

float

well_diameter#

Relative diameter of the well. Valid options: “small” (e.g., OSD3500_FY25.xlsx) or “large”.

Type:

str

well_geometry#

Structural configuration of the well. Valid options: “vertical” or “horizontal”.

Type:

str

borehole_depth: float#
well_diameter: str#
well_geometry: str#
class h2integrate.converters.hydrogen.geologic.h2_well_subsurface_baseclass.GeoH2SubsurfaceCostBaseClass(**kwargs)#

OpenMDAO component for modeling subsurface well costs in a geologic hydrogen plant.

This component calculates capital and operating costs for subsurface well systems in a geologic hydrogen plant, applicable to both natural and stimulated hydrogen production modes.

config#

Parsed configuration object containing subsurface cost model parameters.

Type:

GeoH2SubsurfaceCostConfig

Inputs:
borehole_depth (float):

Total borehole depth, in meters (may include directional drilling sections).

wellhead_gas_out (ndarray):

Wellhead gas production rate profile over the simulation period, in kg/h.

total_wellhead_gas_produced (float):

Total wellhead gas produced over the plant lifetime, in kg/year.

Outputs:
bare_capital_cost (float):

Raw capital expenditure (CAPEX) without multipliers, in USD.

CapEx (float):

Total effective CAPEX including contracting and contingency multipliers, in USD.

OpEx (float):

Total operating expense (OPEX) for the system, in USD/year.

Fixed_OpEx (float):

Annual fixed OPEX component that does not scale with hydrogen output, in USD/year.

Variable_OpEx (float):

Variable OPEX per kilogram of wellhead gas produced, in USD/kg.

setup()#

Declare inputs and outputs.

Available attributes:

name pathname comm options

calc_drill_cost(x)#