processforge 0.2.24__tar.gz → 0.2.34__tar.gz

processforge-0.2.34/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: processforge
+Version: 0.2.34
+Summary: A Python-based process simulation framework for chemical engineering applications.
+Author-email: Processforge Team <team@processforge.dev>
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://github.com/urjanova/processforge
+Project-URL: Repository, https://github.com/urjanova/processforge
+Project-URL: Issues, https://github.com/urjanova/processforge/issues
+Keywords: process,simulation,chemical,engineering,flowsheet
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Chemistry
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=2.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: scipy>=1.14
+Requires-Dist: matplotlib>=3.9
+Requires-Dist: loguru>=0.7
+Requires-Dist: jsonschema>=4.20
+Requires-Dist: graphviz>=0.20
+Requires-Dist: pandas>=2.2
+Requires-Dist: zarr>=3.0
+Requires-Dist: coolprop>=7.2.0
+Requires-Dist: pi>=0.1.2
+Requires-Dist: pip>=26.1.2
+Provides-Extra: eo
+Requires-Dist: pyomo>=6.7; extra == "eo"
+Provides-Extra: eo-casadi
+Requires-Dist: pyomo>=6.7; extra == "eo-casadi"
+Requires-Dist: casadi>=3.6; extra == "eo-casadi"
+Provides-Extra: fmu
+Requires-Dist: pythonfmu>=0.6; extra == "fmu"
+Provides-Extra: modelica
+Requires-Dist: OMPython>=4.0.0; extra == "modelica"
+Requires-Dist: fmpy>=0.3; extra == "modelica"
+Provides-Extra: cantera
+Requires-Dist: cantera>=3.0; extra == "cantera"
+Provides-Extra: coolprop
+Requires-Dist: coolprop>=6.6; extra == "coolprop"
+Provides-Extra: pcl
+Requires-Dist: pint>=0.24; extra == "pcl"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx; extra == "docs"
+Requires-Dist: sphinx-rtd-theme; extra == "docs"
+Dynamic: license-file
+
+# Processforge
+
+![processforge-logo](images/processforge-logo.svg)
+
+A lightweight Python framework for process simulation, coupling hydraulic, thermal, and reactor workflows.
+
+## Install
+
+```bash
+uv add processforge
+```
+
+For CoolProp-backed units:
+
+```bash
+uv add "processforge[coolprop]"
+```
+
+Optional solver backends:
+
+```bash
+uv add "processforge[eo]"
+uv add "processforge[eo-casadi]"
+uv add "processforge[modelica]"
+```
+
+## Quick start
+
+Use `plan` to validate and preview changes, then `apply` to solve and store a snapshot. For flowsheets without Tank units, use `apply` to solve with the EO solver. 
+
+```bash
+pf init
+pf plan flowsheets/hydraulic-chain.json
+pf apply flowsheets/hydraulic-chain.json
+```
+For flowsheets with Tank units, use `run` to solve with the SM solver. For direct run mode (for dynamic flowsheets with Tank units), use `run`:
+
+```bash
+pf run flowsheets/hydraulic-chain.json
+```
+
+## Python API
+
+```python
+from processforge import EOFlowsheet, validate_flowsheet
+config = validate_flowsheet("flowsheets/hydraulic-chain.json")
+fs = EOFlowsheet(config, backend="scipy")
+results = fs.run()
+```
+
+## Usage and Docker
+Processforge is also available as Docker images, and can be run in the cloud. See the [usage guide](docs/usage.md) for CLI commands, workflows, Docker, and cloud notes.
+
+## Flowsheets
+The core of Processforge is the flowsheet JSON format, which defines materials, units, and recycle rules. See below for more information on the formats and example flowsheets.
+- [docs/flowsheets.md](docs/flowsheets.md) : flowsheet JSON format, materials, units, and recycle rules
+- [flowsheets/](flowsheets/) : example flowsheets shipped with the repo
+
+
+## License
+
+BSD 3-Clause License

processforge-0.2.34/README.md

@@ -0,0 +1,62 @@
+# Processforge
+
+![processforge-logo](images/processforge-logo.svg)
+
+A lightweight Python framework for process simulation, coupling hydraulic, thermal, and reactor workflows.
+
+## Install
+
+```bash
+uv add processforge
+```
+
+For CoolProp-backed units:
+
+```bash
+uv add "processforge[coolprop]"
+```
+
+Optional solver backends:
+
+```bash
+uv add "processforge[eo]"
+uv add "processforge[eo-casadi]"
+uv add "processforge[modelica]"
+```
+
+## Quick start
+
+Use `plan` to validate and preview changes, then `apply` to solve and store a snapshot. For flowsheets without Tank units, use `apply` to solve with the EO solver. 
+
+```bash
+pf init
+pf plan flowsheets/hydraulic-chain.json
+pf apply flowsheets/hydraulic-chain.json
+```
+For flowsheets with Tank units, use `run` to solve with the SM solver. For direct run mode (for dynamic flowsheets with Tank units), use `run`:
+
+```bash
+pf run flowsheets/hydraulic-chain.json
+```
+
+## Python API
+
+```python
+from processforge import EOFlowsheet, validate_flowsheet
+config = validate_flowsheet("flowsheets/hydraulic-chain.json")
+fs = EOFlowsheet(config, backend="scipy")
+results = fs.run()
+```
+
+## Usage and Docker
+Processforge is also available as Docker images, and can be run in the cloud. See the [usage guide](docs/usage.md) for CLI commands, workflows, Docker, and cloud notes.
+
+## Flowsheets
+The core of Processforge is the flowsheet JSON format, which defines materials, units, and recycle rules. See below for more information on the formats and example flowsheets.
+- [docs/flowsheets.md](docs/flowsheets.md) : flowsheet JSON format, materials, units, and recycle rules
+- [flowsheets/](flowsheets/) : example flowsheets shipped with the repo
+
+
+## License
+
+BSD 3-Clause License

{processforge-0.2.24 → processforge-0.2.34}/flowsheets/closed-loop-chain.json

@@ -45,7 +45,7 @@
   },
   "material_mixes": {
     "Benzene_Toluene_Mix": {
-      "friendly_material_mix_id": 1,
+      "id": 1,
       "percent_type": "ao",
       "components": [
         {"name": "Benzene", "fraction": 0.5},

processforge-0.2.34/flowsheets/custom/simple_hyrdaulic_scheme.json

@@ -0,0 +1,202 @@
+{
+  "metadata": {
+    "name": "Hydraulic Chain Example",
+    "description": "A two-pump, one-valve, one-strainer steady-state hydraulic system.",
+    "version": "2.0"
+  },
+  "providers": {
+    "coolprop": {
+      "type": "coolprop"
+    }
+  },
+  "materials": {
+    "Benzene": {
+      "id": 1
+    },
+    "Toluene": {
+      "id": 2
+    },
+    "Steel": {
+      "id": 3
+    }
+  },
+  "material_mixes": {
+    "Benzene_Toluene_Mix": {
+      "friendly_material_mix_id": 1,
+      "percent_type": "ao",
+      "components": [
+        {"name": "Benzene", "fraction": 0.8},
+        {"name": "Toluene", "fraction": 0.2}
+      ]
+    }
+  },
+  "streams": {
+    "feed": {
+      "T": 298.15,
+      "P": 101325,
+      "flowrate": 38,
+      "material_mix": 1
+    }
+  },
+  "units": {
+    "pipe_1": {
+      "type": "Pipes",
+      "in": "feed",
+      "out": "after_pipe_1",
+      "delta_p": 1000.0,
+      "diameter": 0.040,
+      "material": 3
+    },
+    "valve_1": {
+      "type": "Valve",
+      "in": "after_pipe_1",
+      "out": "after_valve_1",
+      "pressure_ratio": 0.5,
+      "material": 3
+    },
+    "pipe_2": {
+      "type": "Pipes",
+      "in": "after_valve_1",
+      "out": "after_pipe_2",
+      "delta_p": 1000.0,
+      "diameter": 0.08,
+      "material": 3
+    },
+    "pump_1": {
+      "type": "Pump",
+      "in": "after_pipe_2",
+      "out": "after_pump_1",
+      "deltaP": 600000.0,
+      "efficiency": 0.75,
+      "material": 3
+    },
+    "pipe_3": {
+      "type": "Pipes",
+      "in": "after_pump_1",
+      "out": "after_pipe_3",
+      "delta_p": 1000.0,
+      "diameter": 0.08,
+      "material": 3
+    },
+    "strainer_1": {
+      "type": "Strainer",
+      "in": "after_pipe_3",
+      "out": "after_strainer_1",
+      "deltaP": 5000.0,
+      "material": 3
+    },
+    "pipe_4": {
+      "type": "Pipes",
+      "in": "after_strainer_1",
+      "out": "after_pipe_4",
+      "delta_p": 1000.0,
+      "diameter": 0.08,
+      "material": 3
+    },
+    "pipe_1a": {
+      "type": "Pipes",
+      "in": "after_strainer_1",
+      "out": "after_pipe_1a",
+      "delta_p": 1000.0,
+      "diameter": 0.08,
+      "material": 3
+    },
+    "valve_1a": {
+      "type": "Valve",
+      "in": "after_pipe_1a",
+      "out": "after_valve_1a",
+      "pressure_ratio": 0.5,
+      "material": 3
+    },
+    "pipe_2a": {
+      "type": "Pipes",
+      "in": "after_valve_1a",
+      "out": "after_pipe_2a",
+      "delta_p": 1000.0,
+      "diameter": 0.08,
+      "material": 3
+    },
+    "valve_2": {
+      "type": "Valve",
+      "in": "after_pipe_4",
+      "out": "after_valve_2",
+      "pressure_ratio": 0.5,
+      "material": 3
+    },
+    "pipe_5": {
+      "type": "Pipes",
+      "in": "after_valve_2",
+      "out": "after_pipe_5",
+      "delta_p": 1000.0,
+      "diameter": 0.08,
+      "material": 3
+    },
+    "pump_2": {
+      "type": "Pump",
+      "in": "after_pipe_5",
+      "out": "after_pump_2",
+      "deltaP": 600000.0,
+      "efficiency": 0.75,
+      "material": 3
+    },
+    "pipe_6": {
+      "type": "Pipes",
+      "in": "after_pump_2",
+      "out": "after_pipe_6",
+      "delta_p": 1000.0,
+      "diameter": 0.08,
+      "material": 3
+    },
+    "valve_3": {
+      "type": "Valve",
+      "in": "after_pipe_6",
+      "out": "after_valve_3",
+      "pressure_ratio": 0.5,
+      "material": 3
+    },
+    "pipe_7": {
+      "type": "Pipes",
+      "in": "after_valve_3",
+      "out": "after_pipe_7",
+      "delta_p": 1000.0,
+      "diameter": 0.08,
+      "material": 3
+    },
+    "valve_4": {
+      "type": "Valve",
+      "in": "after_pipe_7",
+      "out": "after_valve_4",
+      "pressure_ratio": 0.5,
+      "material": 3
+    },
+    "pipe_8": {
+      "type": "Pipes",
+      "in": "after_valve_4",
+      "out": "after_pipe_8",
+      "delta_p": 1000.0,
+      "diameter": 0.08,
+      "material": 3
+    },
+    "valve_5": {
+      "type": "Valve",
+      "in": ["after_pipe_8","after_pipe_2a"],
+      "out": "after_valve_5",
+      "pressure_ratio": 0.5,
+      "material": 3
+    },
+    "pipe_9": {
+      "type": "Pipes",
+      "in": "after_valve_5",
+      "out": "after_pipe_9",      
+      "delta_p": 1000.0,
+      "diameter": 0.025,
+      "material": 3
+    }
+    
+  },
+  "simulation": {
+    "mode":"dynamic",
+    "t_final": 20,
+    "t_step": 1 
+  }
+}

processforge-0.2.34/flowsheets/festim/hydrogen_transport_1d.json

@@ -0,0 +1,70 @@
+{
+  "metadata": {
+    "name": "FESTIM Hydrogen Transport — 1D Diffusion",
+    "description": "Simple 1D hydrogen diffusion through a slab. Fixed concentration BCs: c=1 on left, c=0 on right. D_0=1 m²/s, E_D=0 eV, T=300 K.",
+    "version": "1.0"
+  },
+  "providers": {
+    "festim": {
+      "type": "festim",
+      "url": "http://localhost:9002",
+      "output_dir": "festim"
+    }
+  },
+  "materials": {
+    "default": {
+      "id": 1,
+      "extra": {
+        "D_0": 1,
+        "E_D": 0.0
+      }
+    }
+  },
+  "streams": {},
+  "units": {
+    "festim_solver": {
+      "type": "SolverUnit",
+      "provider": "festim",
+      "sim_type": "hydrogen_transport",
+      "mesh": {
+        "vertices": [0.0, 0.001, 0.002, 0.003, 0.004, 0.005, 0.006, 0.007, 0.008, 0.009, 0.01]
+      },
+      "species": [
+        { "name": "H" }
+      ],
+      "subdomains": {
+        "volume": [
+          { "id": 1, "borders": [0.0, 0.01], "material": "default" }
+        ],
+        "surface": [
+          { "id": 2, "x": 0.0 },
+          { "id": 3, "x": 0.01 }
+        ]
+      },
+      "boundary_conditions": [
+        { "type": "fixed_concentration", "subdomain_id": 2, "species": "H", "value": 1 },
+        { "type": "fixed_concentration", "subdomain_id": 3, "species": "H", "value": 0 }
+      ],
+      "exports": [
+        { "type": "vtx_species", "field": "H", "filename": "hydrogen_concentration.bp", "times": "milestones" },
+        { "type": "profile_1d", "field": "H", "volume_id": 1, "times": "milestones" }
+      ],
+      "solver_config": {
+        "atol": 1e-10,
+        "rtol": 1e-10,
+        "final_time": 2,
+        "temperature": 300,
+        "stepsize": {
+          "initial_value": 0.05,
+          "growth_factor": 1.1,
+          "cutback_factor": 0.9,
+          "target_nb_iterations": 4,
+          "milestones": [0.05, 0.1, 0.2, 0.5, 1]
+        }
+      }
+    }
+  },
+  "simulation": {
+    "mode": "steady"
+  }
+}

{processforge-0.2.24 → processforge-0.2.34}/flowsheets/hydraulic-chain.json

@@ -22,7 +22,7 @@
   },
   "material_mixes": {
     "Water_Toluene_Mix": {
-      "friendly_material_mix_id": 1,
+      "id": 1,
       "percent_type": "ao",
       "components": [
         {"name": "Water", "fraction": 0.8},
@@ -104,6 +104,8 @@
   },
   "simulation": {
     "mode": "steady",
-    "backend": "scipy"
+    "t0": 0.0,
+    "tf": 20.0,
+    "dt": 1.0
   }
 }

{processforge-0.2.24 → processforge-0.2.34}/flowsheets/openmc/msre_eigenvalue.json

@@ -1,14 +1,15 @@
 {
   "metadata": {
-    "name": "MSRE Eigenvalue — DAGMC geometry",
-    "description": "Molten Salt Reactor Experiment eigenvalue simulation. Replicates openmc.py reference script. DAGMC geometry loaded from .h5m file. 7 materials matching h5m volume tags: graphite, inor, salt, inconel, helium, Graveyard, helium_comp.",
-    "version": "1.1"
+    "name": "MSRE Eigenvalue — CSG geometry",
+    "description": "Molten Salt Reactor Experiment criticality calculation. Fission source at reactor centre inside a homogeneous salt sphere. 5 materials: graphite, inor, salt, inconel, helium.",
+    "version": "1.3"
   },
   "providers": {
     "openmc": {
       "type": "openmc",
-      "output_dir": "outputs/openmc/msre_run",
-      "cross_sections": "tmp_files/cross_sections/cross_sections.xml"
+      "url": "http://localhost:9001",
+      "output_dir": "openmc/msre_run",
+      "cross_sections": "${OPENMC_DATA_ROOT}/cross_sections/cross_sections.xml"
     }
   },
   "materials": {
@@ -70,26 +71,23 @@
         { "name": "He4", "percent": 1.0, "percent_type": "ao" }
       ]
     }
-    
   },
   "streams": {},
   "units": {
     "openmc_solver": {
       "type": "SolverUnit",
       "provider": "openmc",
-      "material":3,
-      "sim_type": "eigenvalue_dagmc",
+      "material": 3,
+      "sim_type": "eigenvalue_csg",
       "solver_config": {
-        "dagmc_path": "/home/hrishiballal/Documents/Github/urjanova/processforge/tmp_files/geometry/msre_simple.h5m",
         "batches": 20,
         "inactive": 5,
         "particles": 20000,
-        "run_mode": "eigenvalue",
-        "source_box": {
-          "lower_left":  [-125, -125,   0],
-          "upper_right": [ 125,  125, 500],
-          "only_fissionable": true
+        "source_point": {
+          "xyz": [0.0, 0.0, 0.0]
         },
+        "point_source_sphere_radius": 200.0,
+        "point_source_material": "salt",
         "mesh_tallies": [
           {
             "tally_id": 1,

{processforge-0.2.24 → processforge-0.2.34}/pyproject.toml

@@ -4,14 +4,14 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "processforge"
-version = "0.2.24"
+version = "0.2.34"
 description = "A Python-based process simulation framework for chemical engineering applications."
 readme = "README.md"
 license = "BSD-3-Clause"
 license-files = ["LICENSE"]
 requires-python = ">=3.12"
 authors = [
-    {name = "Process Forge Team", email = "team@processforge.dev"},
+    {name = "Processforge Team", email = "team@processforge.dev"},
 ]
 classifiers = [
     "Development Status :: 3 - Alpha",
@@ -26,24 +26,20 @@ classifiers = [
 keywords = ["process", "simulation", "chemical", "engineering", "flowsheet"]
 dependencies = [
     "numpy>=2.0",
+    "pydantic>=2.0",
     "scipy>=1.14",
-    "coolprop>=6.6",
     "matplotlib>=3.9",
     "loguru>=0.7",
     "jsonschema>=4.20",
     "graphviz>=0.20",
     "pandas>=2.2",
     "zarr>=3.0",
+    "coolprop>=7.2.0",
+    "pi>=0.1.2",
+    "pip>=26.1.2",
 ]
 
 [project.optional-dependencies]
-api = [
-    "fastapi>=0.110",
-    "uvicorn[standard]>=0.29",
-    "boto3>=1.34",
-    "s3fs>=2024.3",
-    "pydantic>=2.0",
-]
 eo = [
     "pyomo>=6.7",
 ]
@@ -61,6 +57,9 @@ modelica = [
 cantera = [
     "cantera>=3.0",
 ]
+coolprop = [
+    "coolprop>=6.6",
+]
 pcl = [
     "pint>=0.24",
 ]
@@ -84,7 +83,6 @@ Issues = "https://github.com/urjanova/processforge/issues"
 [project.scripts]
 processforge = "processforge.simulate:main"
 pf = "processforge.simulate:main"
-pf-serve = "processforge.api.serve:main"
 
 [tool.setuptools.packages.find]
 where = ["src"]

{processforge-0.2.24 → processforge-0.2.34}/src/processforge/__init__.py

@@ -13,7 +13,7 @@ Provides steady-state and dynamic process simulation capabilities including:
 from .flowsheet import Flowsheet
 from .provenance import build_run_info
 from .solver import Solver
-from .thermo import get_enthalpy_molar, get_Cp_molar, get_K_values, rachford_rice
+from .thermo import rachford_rice
 from .utils.validate_flowsheet import validate_flowsheet
 from .result import (
     plot_results,
@@ -36,9 +36,6 @@ __all__ = [
     "EOFlowsheet",
     "EOSolver",
     "Solver",
-    "get_enthalpy_molar",
-    "get_Cp_molar",
-    "get_K_values",
     "rachford_rice",
     "validate_flowsheet",
     "plot_results",