processforge 0.6.0__tar.gz → 0.6.2__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {processforge-0.6.0/src/processforge.egg-info → processforge-0.6.2}/PKG-INFO +18 -1
- {processforge-0.6.0 → processforge-0.6.2}/README.md +17 -0
- {processforge-0.6.0 → processforge-0.6.2}/pyproject.toml +1 -1
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/__init__.py +44 -22
- processforge-0.6.2/src/processforge/cli/apply.py +55 -0
- processforge-0.6.2/src/processforge/cli/run.py +30 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/persistence/artifact_store.py +94 -6
- processforge-0.6.2/src/processforge/runner.py +788 -0
- {processforge-0.6.0 → processforge-0.6.2/src/processforge.egg-info}/PKG-INFO +18 -1
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge.egg-info/SOURCES.txt +3 -0
- processforge-0.6.2/tests/test_artifact_store.py +84 -0
- {processforge-0.6.0 → processforge-0.6.2}/tests/test_cli.py +41 -154
- processforge-0.6.2/tests/test_runner.py +141 -0
- processforge-0.6.0/src/processforge/cli/apply.py +0 -209
- processforge-0.6.0/src/processforge/cli/run.py +0 -221
- {processforge-0.6.0 → processforge-0.6.2}/LICENSE +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/MANIFEST.in +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/flowsheets/closed-loop-chain.json +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/flowsheets/coupled/msre_coupled.json +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/flowsheets/custom/crimson/MUWS_HB.json +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/flowsheets/custom/crimson/simple_water_system.json +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/flowsheets/custom/simple_hyrdaulic_scheme.json +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/flowsheets/festim/hydrogen_transport_1d.json +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/flowsheets/festim/tds_tungsten.json +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/flowsheets/hydraulic-chain.json +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/flowsheets/openmc/msre_eigenvalue.json +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/setup.cfg +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/__main__.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/_schema.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/analysis/__init__.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/analysis/dof.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/api/__init__.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/api/serve.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/cli/__init__.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/cli/common.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/cli/diagram.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/cli/display.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/cli/export_fmu.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/cli/export_modelica.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/cli/init.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/cli/persist.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/cli/plan.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/cli/runs.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/cli/validate.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/compose.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/coupling.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/eo/__init__.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/eo/backends/__init__.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/eo/backends/base.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/eo/backends/casadi_backend.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/eo/backends/pyomo_backend.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/eo/backends/scipy_backend.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/eo/flowsheet.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/eo/jacobian.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/eo/mixin.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/eo/solver.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/eo/stream_var.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/eo/units/__init__.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/eo/units/flash_eo.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/eo/units/heater_eo.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/eo/units/pipes_eo.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/eo/units/pump_eo.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/eo/units/strainer_eo.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/eo/units/valve_eo.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/flowsheet.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/fmu/__init__.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/fmu/_fmi_vars.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/fmu/builder.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/fmu/interface.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/fmu/slave_template.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/lock.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/modelica/__init__.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/modelica/mo_writer.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/modelica/omc_runner.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/modelica/transpiler.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/modelica/unit_equations.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/output_collector.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/pathsim/__init__.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/pathsim/adapter.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/pcl/__init__.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/pcl/compiler.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/pcl/namespace.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/persistence/__init__.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/persistence/archive.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/provenance.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/__init__.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/_sim_strategy.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/base.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/base_jacobian_mixin.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/base_simulation_provider.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/cantera_jacobian.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/cantera_provider.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/container_client.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/coolprop_provider.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/errors.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/festim/__init__.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/festim/build_helpers.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/festim/provider.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/festim/result_extraction.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/festim/strategies.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/jacobian_contributor.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/manager.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/modelica_jacobian.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/modelica_provider.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/openmc/__init__.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/openmc/build_helpers.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/openmc/provider.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/openmc/result_extraction.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/openmc/strategies.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/reference_state_registry.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/providers/registry.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/quantity.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/result.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/result_schema.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/schemas/__init__.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/schemas/festim/festim_model.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/schemas/flowsheet_schema.json +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/schemas/openmc/openmc_model.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/simulate.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/solver.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/state.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/thermo.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/types.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/units/__init__.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/units/base.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/units/cstr.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/units/flash.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/units/heater.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/units/pfr.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/units/pipes.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/units/pump.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/units/registry.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/units/solver_unit.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/units/strainer.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/units/tank.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/units/valve.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/utils/__init__.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/utils/flowsheet_diagram.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/utils/mermaid_diagram.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/utils/s3_upload.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/utils/topology.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/utils/unit_consistency.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/utils/validate_flowsheet.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge/utils/validation.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge.egg-info/dependency_links.txt +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge.egg-info/entry_points.txt +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge.egg-info/requires.txt +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/src/processforge.egg-info/top_level.txt +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/tests/test_container_client.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/tests/test_coupling.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/tests/test_display.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/tests/test_festim_provider.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/tests/test_festim_schema.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/tests/test_fmu_solverunit.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/tests/test_init.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/tests/test_openmc_provider.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/tests/test_pathsim_adapter.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/tests/test_persist.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/tests/test_provider_errors.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/tests/test_providers.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/tests/test_result_zarr.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/tests/test_runs_command.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/tests/test_s3_upload.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/tests/test_state.py +0 -0
- {processforge-0.6.0 → processforge-0.6.2}/tests/test_types.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: processforge
|
|
3
|
-
Version: 0.6.
|
|
3
|
+
Version: 0.6.2
|
|
4
4
|
Summary: A Python-based process simulation framework for chemical engineering applications.
|
|
5
5
|
Author-email: Processforge Team <team@processforge.dev>
|
|
6
6
|
License-Expression: BSD-3-Clause
|
|
@@ -134,13 +134,30 @@ uv tool install "processforge[modelica]"
|
|
|
134
134
|
|
|
135
135
|
## Python API
|
|
136
136
|
|
|
137
|
+
### Low-level API
|
|
138
|
+
|
|
137
139
|
```python
|
|
138
140
|
from processforge import EOFlowsheet, validate_flowsheet
|
|
141
|
+
|
|
139
142
|
config = validate_flowsheet("flowsheets/hydraulic-chain.json")
|
|
140
143
|
fs = EOFlowsheet(config, backend="scipy")
|
|
141
144
|
results = fs.run()
|
|
142
145
|
```
|
|
143
146
|
|
|
147
|
+
### High-level runner (web-app friendly)
|
|
148
|
+
|
|
149
|
+
```python
|
|
150
|
+
from processforge import run_flowsheet
|
|
151
|
+
|
|
152
|
+
result = run_flowsheet("flowsheets/hydraulic-chain.json")
|
|
153
|
+
print(result.run_id, result.status, result.remote_uris)
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
`run_flowsheet` and `apply_flowsheet` perform the full CLI lifecycle
|
|
157
|
+
(validate, health-check, solve, persist, and upload the pfarchive to S3) and
|
|
158
|
+
return structured results instead of calling `SystemExit`. See
|
|
159
|
+
[docs/usage.md](docs/usage.md) for a FastAPI + S3/Railway example.
|
|
160
|
+
|
|
144
161
|
## Usage
|
|
145
162
|
See the [usage guide](docs/usage.md) for CLI commands and workflows.
|
|
146
163
|
|
|
@@ -67,13 +67,30 @@ uv tool install "processforge[modelica]"
|
|
|
67
67
|
|
|
68
68
|
## Python API
|
|
69
69
|
|
|
70
|
+
### Low-level API
|
|
71
|
+
|
|
70
72
|
```python
|
|
71
73
|
from processforge import EOFlowsheet, validate_flowsheet
|
|
74
|
+
|
|
72
75
|
config = validate_flowsheet("flowsheets/hydraulic-chain.json")
|
|
73
76
|
fs = EOFlowsheet(config, backend="scipy")
|
|
74
77
|
results = fs.run()
|
|
75
78
|
```
|
|
76
79
|
|
|
80
|
+
### High-level runner (web-app friendly)
|
|
81
|
+
|
|
82
|
+
```python
|
|
83
|
+
from processforge import run_flowsheet
|
|
84
|
+
|
|
85
|
+
result = run_flowsheet("flowsheets/hydraulic-chain.json")
|
|
86
|
+
print(result.run_id, result.status, result.remote_uris)
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
`run_flowsheet` and `apply_flowsheet` perform the full CLI lifecycle
|
|
90
|
+
(validate, health-check, solve, persist, and upload the pfarchive to S3) and
|
|
91
|
+
return structured results instead of calling `SystemExit`. See
|
|
92
|
+
[docs/usage.md](docs/usage.md) for a FastAPI + S3/Railway example.
|
|
93
|
+
|
|
77
94
|
## Usage
|
|
78
95
|
See the [usage guide](docs/usage.md) for CLI commands and workflows.
|
|
79
96
|
|
|
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "processforge"
|
|
7
|
-
version = "0.6.
|
|
7
|
+
version = "0.6.2"
|
|
8
8
|
description = "A Python-based process simulation framework for chemical engineering applications."
|
|
9
9
|
readme = "README.md"
|
|
10
10
|
license = "BSD-3-Clause"
|
|
@@ -10,44 +10,66 @@ Provides steady-state and dynamic process simulation capabilities including:
|
|
|
10
10
|
- Equation-oriented (EO) steady-state solver via EOFlowsheet
|
|
11
11
|
"""
|
|
12
12
|
|
|
13
|
+
__version__ = "0.6.2"
|
|
14
|
+
|
|
15
|
+
from .eo import EOFlowsheet, EOSolver
|
|
13
16
|
from .flowsheet import Flowsheet
|
|
14
17
|
from .provenance import build_run_info
|
|
15
|
-
from .solver import Solver
|
|
16
|
-
from .thermo import rachford_rice
|
|
17
|
-
from .utils.validate_flowsheet import validate_flowsheet
|
|
18
18
|
from .result import (
|
|
19
19
|
plot_results,
|
|
20
20
|
plot_timeseries,
|
|
21
21
|
save_results_zarr,
|
|
22
22
|
)
|
|
23
|
+
from .runner import (
|
|
24
|
+
ApplyResult,
|
|
25
|
+
ConvergenceError,
|
|
26
|
+
FlowsheetValidationError,
|
|
27
|
+
ProcessforgeRunError,
|
|
28
|
+
ProviderRunError,
|
|
29
|
+
ProviderUnavailableError,
|
|
30
|
+
RunResult,
|
|
31
|
+
StatePersistenceError,
|
|
32
|
+
apply_flowsheet,
|
|
33
|
+
run_flowsheet,
|
|
34
|
+
)
|
|
35
|
+
from .solver import Solver
|
|
36
|
+
from .thermo import rachford_rice
|
|
37
|
+
from .units.flash import Flash
|
|
38
|
+
from .units.heater import Heater
|
|
39
|
+
from .units.pipes import Pipes
|
|
23
40
|
from .units.pump import Pump
|
|
24
|
-
from .units.valve import Valve
|
|
25
41
|
from .units.strainer import Strainer
|
|
26
42
|
from .units.tank import Tank
|
|
27
|
-
from .units.
|
|
28
|
-
from .
|
|
29
|
-
from .units.heater import Heater
|
|
30
|
-
from .eo import EOFlowsheet, EOSolver
|
|
31
|
-
|
|
32
|
-
__version__ = "0.6.0"
|
|
43
|
+
from .units.valve import Valve
|
|
44
|
+
from .utils.validate_flowsheet import validate_flowsheet
|
|
33
45
|
|
|
34
46
|
__all__ = [
|
|
35
|
-
"
|
|
47
|
+
"ApplyResult",
|
|
48
|
+
"ConvergenceError",
|
|
36
49
|
"EOFlowsheet",
|
|
37
50
|
"EOSolver",
|
|
38
|
-
"
|
|
39
|
-
"
|
|
40
|
-
"
|
|
41
|
-
"
|
|
42
|
-
"
|
|
43
|
-
"
|
|
44
|
-
"
|
|
51
|
+
"Flash",
|
|
52
|
+
"Flowsheet",
|
|
53
|
+
"FlowsheetValidationError",
|
|
54
|
+
"Heater",
|
|
55
|
+
"Pipes",
|
|
56
|
+
"ProcessforgeRunError",
|
|
57
|
+
"ProviderRunError",
|
|
58
|
+
"ProviderUnavailableError",
|
|
45
59
|
"Pump",
|
|
46
|
-
"
|
|
60
|
+
"RunResult",
|
|
61
|
+
"Solver",
|
|
62
|
+
"StatePersistenceError",
|
|
47
63
|
"Strainer",
|
|
48
64
|
"Tank",
|
|
49
|
-
"
|
|
50
|
-
"Flash",
|
|
51
|
-
"Heater",
|
|
65
|
+
"Valve",
|
|
52
66
|
"__version__",
|
|
67
|
+
"apply_flowsheet",
|
|
68
|
+
"build_run_info",
|
|
69
|
+
"plot_results",
|
|
70
|
+
"plot_timeseries",
|
|
71
|
+
"rachford_rice",
|
|
72
|
+
"run_flowsheet",
|
|
73
|
+
"save_results_zarr",
|
|
74
|
+
"validate_flowsheet",
|
|
53
75
|
]
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
"""``pf apply`` — state-based warm start with homotopy fallback."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
from typing import Literal
|
|
6
|
+
|
|
7
|
+
import typer
|
|
8
|
+
from loguru import logger
|
|
9
|
+
|
|
10
|
+
from ..runner import ProcessforgeRunError, apply_flowsheet
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
def apply(
|
|
14
|
+
flowsheet: str = typer.Argument(help="Path to the flowsheet JSON file"),
|
|
15
|
+
backend: Literal["scipy", "pyomo", "casadi"] | None = typer.Option(
|
|
16
|
+
None,
|
|
17
|
+
"--backend",
|
|
18
|
+
help="Override the flowsheet's simulation.backend",
|
|
19
|
+
),
|
|
20
|
+
tolerance: float = typer.Option(
|
|
21
|
+
1e-6,
|
|
22
|
+
"--tolerance",
|
|
23
|
+
help="Newton solver convergence tolerance (default: 1e-6)",
|
|
24
|
+
),
|
|
25
|
+
max_iter: int = typer.Option(
|
|
26
|
+
50,
|
|
27
|
+
"--max-iter",
|
|
28
|
+
help="Max Newton iterations (default: 50)",
|
|
29
|
+
),
|
|
30
|
+
skip_homotopy: bool = typer.Option(
|
|
31
|
+
False,
|
|
32
|
+
"--skip-homotopy",
|
|
33
|
+
help="Disable homotopy fallback; cold-start only",
|
|
34
|
+
),
|
|
35
|
+
) -> None:
|
|
36
|
+
"""Apply flowsheet: drift detection, warm-start, homotopy fallback, convergence guardrails."""
|
|
37
|
+
try:
|
|
38
|
+
result = apply_flowsheet(
|
|
39
|
+
flowsheet,
|
|
40
|
+
backend=backend,
|
|
41
|
+
tolerance=tolerance,
|
|
42
|
+
max_iter=max_iter,
|
|
43
|
+
skip_homotopy=skip_homotopy,
|
|
44
|
+
)
|
|
45
|
+
except ProcessforgeRunError as exc:
|
|
46
|
+
logger.error(str(exc))
|
|
47
|
+
raise SystemExit(1) from exc
|
|
48
|
+
|
|
49
|
+
logger.info("=== Apply Summary ===")
|
|
50
|
+
logger.info(f" Status : {result.status}")
|
|
51
|
+
logger.info(f" Run ID : {result.run_id}")
|
|
52
|
+
logger.info(f" Snapshot ID : {result.snapshot_id}")
|
|
53
|
+
logger.info(f" Archive : {result.archive_path}")
|
|
54
|
+
if result.remote_uris:
|
|
55
|
+
logger.info(f" Remote URIs : {len(result.remote_uris)} object(s) in S3")
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
"""``pf run`` — run a process simulation from a flowsheet JSON file."""
|
|
2
|
+
from __future__ import annotations
|
|
3
|
+
|
|
4
|
+
import typer
|
|
5
|
+
from loguru import logger
|
|
6
|
+
|
|
7
|
+
from ..runner import ProcessforgeRunError, run_flowsheet
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
def run(
|
|
11
|
+
flowsheet: str = typer.Argument(help="Path to the flowsheet JSON file"),
|
|
12
|
+
export_images: bool = typer.Option(
|
|
13
|
+
False,
|
|
14
|
+
"--export-images",
|
|
15
|
+
help="Generate PNG plots for simulation outputs",
|
|
16
|
+
),
|
|
17
|
+
) -> None:
|
|
18
|
+
"""Run a process simulation from a flowsheet JSON file."""
|
|
19
|
+
try:
|
|
20
|
+
result = run_flowsheet(flowsheet, export_images=export_images)
|
|
21
|
+
except ProcessforgeRunError as exc:
|
|
22
|
+
logger.error(str(exc))
|
|
23
|
+
raise SystemExit(1) from exc
|
|
24
|
+
|
|
25
|
+
logger.info("=== Run Summary ===")
|
|
26
|
+
logger.info(f" Status : {result.status}")
|
|
27
|
+
logger.info(f" Run ID : {result.run_id}")
|
|
28
|
+
logger.info(f" Archive : {result.archive_path}")
|
|
29
|
+
if result.remote_uris:
|
|
30
|
+
logger.info(f" Remote URIs : {len(result.remote_uris)} object(s) in S3")
|
|
@@ -10,8 +10,6 @@ from __future__ import annotations
|
|
|
10
10
|
|
|
11
11
|
import hashlib
|
|
12
12
|
import os
|
|
13
|
-
from datetime import datetime, timezone
|
|
14
|
-
from typing import Optional
|
|
15
13
|
|
|
16
14
|
from loguru import logger
|
|
17
15
|
|
|
@@ -44,9 +42,9 @@ def _artifact_kind(path: str) -> str:
|
|
|
44
42
|
class ArtifactStore:
|
|
45
43
|
"""Register and upload simulation artifact files to object storage."""
|
|
46
44
|
|
|
47
|
-
def __init__(self, bucket:
|
|
45
|
+
def __init__(self, bucket: str | None = None, prefix: str | None = None):
|
|
48
46
|
self.bucket = bucket or os.environ.get("S3_BUCKET")
|
|
49
|
-
self.prefix = prefix
|
|
47
|
+
self.prefix = prefix or os.environ.get("S3_PREFIX", "processforge")
|
|
50
48
|
|
|
51
49
|
# ------------------------------------------------------------------
|
|
52
50
|
# Registration
|
|
@@ -55,8 +53,8 @@ class ArtifactStore:
|
|
|
55
53
|
self,
|
|
56
54
|
path: str,
|
|
57
55
|
*,
|
|
58
|
-
name:
|
|
59
|
-
kind:
|
|
56
|
+
name: str | None = None,
|
|
57
|
+
kind: str | None = None,
|
|
60
58
|
run_id: str = "",
|
|
61
59
|
flowsheet_hash: str = "",
|
|
62
60
|
unit: str = "",
|
|
@@ -115,6 +113,96 @@ class ArtifactStore:
|
|
|
115
113
|
logger.warning(f"S3 upload of '{artifact.name}' failed: {exc}")
|
|
116
114
|
return artifact
|
|
117
115
|
|
|
116
|
+
# ------------------------------------------------------------------
|
|
117
|
+
# Host-side archive upload
|
|
118
|
+
# ------------------------------------------------------------------
|
|
119
|
+
def upload_file(
|
|
120
|
+
self,
|
|
121
|
+
path: str,
|
|
122
|
+
*,
|
|
123
|
+
remote_key: str,
|
|
124
|
+
) -> str | None:
|
|
125
|
+
"""Upload a single local file to a specific S3 key.
|
|
126
|
+
|
|
127
|
+
Returns the S3 URI on success, or ``None`` when S3 is not configured or
|
|
128
|
+
the upload failed.
|
|
129
|
+
"""
|
|
130
|
+
if not self.bucket or not os.path.exists(path):
|
|
131
|
+
return None
|
|
132
|
+
try:
|
|
133
|
+
import s3fs
|
|
134
|
+
|
|
135
|
+
uri = f"s3://{self.bucket}/{remote_key}"
|
|
136
|
+
fs = s3fs.S3FileSystem(**s3_storage_options())
|
|
137
|
+
fs.put(path, uri)
|
|
138
|
+
logger.info(f"Uploaded file '{os.path.basename(path)}' to {uri}")
|
|
139
|
+
return uri
|
|
140
|
+
except Exception as exc: # noqa: BLE001
|
|
141
|
+
logger.warning(f"S3 upload of '{path}' failed: {exc}")
|
|
142
|
+
return None
|
|
143
|
+
|
|
144
|
+
def upload_directory(
|
|
145
|
+
self,
|
|
146
|
+
local_dir: str,
|
|
147
|
+
*,
|
|
148
|
+
key_prefix: str,
|
|
149
|
+
run_id: str = "",
|
|
150
|
+
flowsheet_hash: str = "",
|
|
151
|
+
) -> list[str]:
|
|
152
|
+
"""Recursively upload a local directory to S3 under *key_prefix*.
|
|
153
|
+
|
|
154
|
+
Relative paths inside *local_dir* are preserved in the S3 keys. Returns
|
|
155
|
+
the list of URIs that were uploaded (or an empty list when S3 is
|
|
156
|
+
disabled).
|
|
157
|
+
"""
|
|
158
|
+
if not self.bucket or not os.path.isdir(local_dir):
|
|
159
|
+
return []
|
|
160
|
+
|
|
161
|
+
base_key = "/".join(p for p in [self.prefix, flowsheet_hash, run_id, key_prefix] if p)
|
|
162
|
+
try:
|
|
163
|
+
import s3fs
|
|
164
|
+
|
|
165
|
+
fs = s3fs.S3FileSystem(**s3_storage_options())
|
|
166
|
+
except Exception as exc: # noqa: BLE001
|
|
167
|
+
logger.warning(f"S3 upload of directory '{local_dir}' failed: {exc}")
|
|
168
|
+
return []
|
|
169
|
+
|
|
170
|
+
uris: list[str] = []
|
|
171
|
+
for root, _dirs, files in os.walk(local_dir):
|
|
172
|
+
for name in files:
|
|
173
|
+
local_path = os.path.join(root, name)
|
|
174
|
+
rel = os.path.relpath(local_path, local_dir)
|
|
175
|
+
key = f"{base_key}/{rel}"
|
|
176
|
+
uri = f"s3://{self.bucket}/{key}"
|
|
177
|
+
try:
|
|
178
|
+
fs.put(local_path, uri)
|
|
179
|
+
uris.append(uri)
|
|
180
|
+
except Exception as exc: # noqa: BLE001
|
|
181
|
+
logger.warning(f"S3 upload of '{rel}' failed: {exc}")
|
|
182
|
+
logger.info(f"Uploaded directory '{local_dir}' to {len(uris)} S3 object(s)")
|
|
183
|
+
return uris
|
|
184
|
+
|
|
185
|
+
def persist_archive(
|
|
186
|
+
self,
|
|
187
|
+
archive_path: str,
|
|
188
|
+
*,
|
|
189
|
+
run_id: str = "",
|
|
190
|
+
flowsheet_hash: str = "",
|
|
191
|
+
) -> list[str]:
|
|
192
|
+
"""Upload an entire processforge pfarchive directory to S3.
|
|
193
|
+
|
|
194
|
+
Keys are laid out as ``<prefix>/<flowsheet_hash>/<run_id>/archive/<relpath>``.
|
|
195
|
+
This uploads the run manifest, Zarr results, snapshots, and registry
|
|
196
|
+
files from the host process so they are durable even when the host's
|
|
197
|
+
local disk is ephemeral.
|
|
198
|
+
"""
|
|
199
|
+
return self.upload_directory(
|
|
200
|
+
archive_path,
|
|
201
|
+
key_prefix="archive",
|
|
202
|
+
run_id=run_id,
|
|
203
|
+
flowsheet_hash=flowsheet_hash,
|
|
204
|
+
)
|
|
205
|
+
|
|
118
206
|
# ------------------------------------------------------------------
|
|
119
207
|
# Container-side convenience: persist all artifacts in engine outputs
|
|
120
208
|
# ------------------------------------------------------------------
|