Sample Cases

The packaged sample cases provide reproducible inputs for public PinchProblem and PinchWorkspace workflows.

Included Cases

basic_pinch.json

Minimal direct-integration process example for first-run validation and baseline graph interpretation.

crude_preheat_train.json

Process-only case that is useful for direct integration and dt_cont sensitivity studies.

crude_preheat_train_multiperiod.json

Named-period derivative of the crude preheat train for real multiperiod direct targeting and cross-period comparison.

zonal_site.json

Hierarchical site-style case for multi-zone and aggregated Total Site workflows.

zonal_site_multiperiod.json

Seasonal named-period derivative of the site-style case for multiperiod Total Site and indirect integration workflows.

pulp_mill.json

Larger site-style example used in the packaged Total Site notebook.

heat_pump_targeting.json

Compact HPR screening input data for direct Heat Pump experimentation, including the current Parallel vapour compression cycles option, without the larger multi-case notebook flow.

chocolate_factory.json

Advanced direct-versus-indirect Carnot HPR and refrigeration example used in the packaged notebook workflow.

process_mvr.json

Small pressure-defined gas-stream case for direct process MVR component creation, lifecycle inspection, and retargeting in notebook 11.

Four-stream-Yee-and-Grossmann-1990-1.json

Converted OpenHENS Yee and Grossmann four-stream heat exchanger network synthesis example used by notebooks 15 through 17.

How To Copy Them

Browse or copy packaged cases through OpenPinch.resources when an editable local copy is useful:

from OpenPinch.resources import copy_sample_case, list_sample_cases

print(list_sample_cases())
copy_sample_case("basic_pinch.json", "basic_pinch.json")

The public problem and workspace constructors load a packaged case by name when no local file with that name exists:

from OpenPinch import PinchProblem, PinchWorkspace

problem = PinchProblem("basic_pinch.json")
workspace = PinchWorkspace(
    source="crude_preheat_train.json",
    project_name="crude_preheat_train",
)

Choosing The Right Case

  • Use basic_pinch.json for first-run validation and graph reading.

  • Use crude_preheat_train.json for process-only sensitivity studies.

  • Use crude_preheat_train_multiperiod.json when the same process needs named operating periods such as turndown, base, and peak.

  • Use zonal_site.json or pulp_mill.json when you need a real site-style indirect integration example.

  • Use zonal_site_multiperiod.json when the site answer needs seasonal or named-period comparison.

  • Use heat_pump_targeting.json when you want a smaller direct HPR screening input data set.

  • Use chocolate_factory.json when you want to study the advanced direct-versus-indirect HPR and refrigeration surface used by notebooks 08 through 10.

  • Use process_mvr.json for the pressure-defined process MVR component workflow in notebook 11.

  • Use Four-stream-Yee-and-Grossmann-1990-1.json when you want the converted OpenHENS four-stream synthesis studies in notebooks 15 through 17.