processforge 0.3.1__tar.gz → 0.3.3__tar.gz

{processforge-0.3.1/src/processforge.egg-info → processforge-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: processforge
-Version: 0.3.1
+Version: 0.3.3
 Summary: A Python-based process simulation framework for chemical engineering applications.
 Author-email: Processforge Team <team@processforge.dev>
 License-Expression: BSD-3-Clause
@@ -30,7 +30,6 @@ Requires-Dist: pandas>=2.2
 Requires-Dist: zarr>=3.0
 Requires-Dist: coolprop>=7.2.0
 Requires-Dist: typer>=0.12
-Requires-Dist: pip>=26.1.2
 Provides-Extra: eo
 Requires-Dist: pyomo>=6.7; extra == "eo"
 Provides-Extra: eo-casadi
@@ -103,9 +102,9 @@ uv tool install "processforge[modelica]"
 3. **Initialize, plan, and apply**
 
    ```bash
-   pf init
-   pf plan hydraulic-chain.json
-   pf apply hydraulic-chain.json
+   pf init flowsheets/hydraulic-chain.json
+   pf plan flowsheets/hydraulic-chain.json
+   pf apply flowsheets/hydraulic-chain.json
    ```
 
    `plan` validates the flowsheet (schema, DOF, units) without running the solver; `apply` solves it and stores a snapshot.
@@ -115,7 +114,6 @@ uv tool install "processforge[modelica]"
    `pf apply` writes results under `outputs/`:
    - `*_results.zarr` — simulation results store (per-variable arrays, composition flattened)
    - `*_results.zarr.schema.json` — schema file describing streams, variables, dtypes, units, shapes, and run provenance
-   - `*_validation.xlsx` — validation report
    - `*.pfstate/` — versioned snapshot store with a `latest` pointer
 
    For flowsheets with Tank units (dynamic), use `pf run` instead of `pf apply` to solve with the SM solver.

{processforge-0.3.1 → processforge-0.3.3}/README.md

@@ -43,9 +43,9 @@ uv tool install "processforge[modelica]"
 3. **Initialize, plan, and apply**
 
    ```bash
-   pf init
-   pf plan hydraulic-chain.json
-   pf apply hydraulic-chain.json
+   pf init flowsheets/hydraulic-chain.json
+   pf plan flowsheets/hydraulic-chain.json
+   pf apply flowsheets/hydraulic-chain.json
    ```
 
    `plan` validates the flowsheet (schema, DOF, units) without running the solver; `apply` solves it and stores a snapshot.
@@ -55,7 +55,6 @@ uv tool install "processforge[modelica]"
    `pf apply` writes results under `outputs/`:
    - `*_results.zarr` — simulation results store (per-variable arrays, composition flattened)
    - `*_results.zarr.schema.json` — schema file describing streams, variables, dtypes, units, shapes, and run provenance
-   - `*_validation.xlsx` — validation report
    - `*.pfstate/` — versioned snapshot store with a `latest` pointer
 
    For flowsheets with Tank units (dynamic), use `pf run` instead of `pf apply` to solve with the SM solver.

{processforge-0.3.1 → processforge-0.3.3}/flowsheets/closed-loop-chain.json

@@ -118,7 +118,7 @@
       "type": "Pump",
       "in": "before_pump_1",
       "out": "after_pump_1",
-      "deltaP": 200000.0,
+      "delta_p": 200000.0,
       "efficiency": 0.75,
       "material": 3
     },

processforge-0.3.3/flowsheets/custom/crimson/MUWS_HB.json

@@ -0,0 +1,216 @@
+{
+  "metadata": {
+    "name": "Make-up Water System",
+    "description": "A two-pump, five-valve, one-strainer, one tank steady-state make-up water system.",
+    "version": "2.0"
+  },
+  "providers": {
+    "coolprop": {
+      "type": "coolprop"
+    }
+  },
+  "materials": {
+    "Water": {
+      "id": 1
+    },
+    "Steel": {
+      "id": 2
+    }
+  },
+   "streams": {
+    "feed": {
+      "T": 313.00,
+      "P": 101325,
+      "flowrate": 1,
+      "z": { "Water": 1.0 }
+    }
+   },
+   
+   "units": {
+
+    "tank_1": {
+      "type": "Tank",
+      "in": ["feed", "recycle_to_tank"],
+      "out": "after_tank_1",
+      "outlet_flow": 1.0,
+      "initial_n": {
+        "Benzene": 9.0,
+        "Toluene": 1.0
+      },
+      "initial_T": 298.15,
+      "P": 101325,
+      "duty": 0.0,
+      "material": 1
+    },
+     
+  "pipe_1": {
+      "type": "Pipes",
+      "in": "after_tank_1",
+      "out": "after_pipe_1",
+      "delta_p": 1000.0,
+      "diameter": 0.05,
+      "material": 2
+    },    
+    "global_valve_1": {
+       "type": "Valve",
+       "in": "after_pipe_1",
+       "out": "after_global_valve_1",
+       "opening": 50,
+       "pressure_ratio": 0.5,
+       "q_flowrate": 50,
+       "material": 2
+    },
+    "pipe_2": {
+      "type": "Pipes",
+      "in": "after_global_valve_1",
+      "out": "after_pipe_2",
+      "delta_p": 1000.0,
+      "diameter": 0.05,
+      "material": 2
+    },
+    
+    "low_pressure_pump":{
+       "type": "Pump",
+       "in": "after_pipe_2",
+       "out": "after_low_pressure_pump",
+       "q_flowrate": 4,
+       "head": 57,
+       "efficiency": 36,
+       "power": 1.3,
+       "cap": 2.5,
+       "motor_rating": 370,
+       "design_press": 6,
+       "material": 2,
+       "delta_p": 1000.0
+     },
+    "pipe_3": {
+      "type": "Pipes",
+      "in": "after_low_pressure_pump",
+      "out": "after_pipe_3",
+      "delta_p": 1000.0,
+      "diameter": 0.05,
+      "material": 2
+    },
+    "non_return_valve_1": {
+       "type": "Valve",
+       "in": "after_pipe_3",
+       "out": "after_non_return_valve_1",
+       "q_flowrate": 4,
+       "pressure_ratio": 0.5,
+       "pressure_drop": 0.72,
+       "material": 2
+    },
+    "pipe_4": {
+      "type": "Pipes",
+      "in": "after_non_return_valve_1",
+      "out": "after_pipe_4",
+      "delta_p": 1000.0,
+      "diameter": 0.05,
+      "material": 2
+    },
+    "strainer": {
+       "type": "Strainer",
+       "in": "after_pipe_4",
+       "out": "after_strainer",
+       "q_flowrate": 4,
+       "pressure_drop": 0.192,
+       "material": 2,       
+       "delta_p": 1000.0
+    },
+    "pipe_5": {
+      "type": "Pipes",
+      "in": "after_strainer",
+      "out": "after_pipe_5",
+      "delta_p": 1000.0,
+      "diameter": 0.05,
+      "material": 2
+    },
+     "global_valve_2": {
+       "type": "Valve",
+       "in": "after_pipe_5",
+       "out": "after_global_valve_2",
+       "opening": 50,
+       "q_flowrate": 50,
+       "material": 2,       
+       "pressure_ratio": 0.5
+    },
+    "pipe_6": {
+      "type": "Pipes",
+      "in": "after_global_valve_2",
+      "out": "after_pipe_6",
+      "delta_p": 1000.0,
+      "diameter": 0.05,
+      "material": 2
+    },
+    "high_pressure_pump":{
+       "type": "Pump",
+       "in": "after_pipe_6",
+       "out": "after_high_pressure_pump",
+       "q_flowrate": 35,
+       "head": 32,
+       "efficiency": 25,
+       "power": 4.75,
+       "cap": 600,
+       "discharge_press": 50,
+       "motor_rating": 7.5,
+       "relief_press": 200,
+       "material": 2,
+       "delta_p": 1000.0
+    },
+    "pipe_7": {
+      "type": "Pipes",
+      "in": "after_high_pressure_pump",
+      "out": "after_pipe_7",
+      "delta_p": 1000.0,
+      "diameter": 0.05,
+      "material": 2
+    },
+     "non_return_valve_2": {
+       "type": "Valve",
+       "in": "after_pipe_7",
+       "out": "after_non_return_valve_2",
+       "q_flowrate": 4,
+       "pressure_drop": 0.72,
+       "material": 2,       
+       "pressure_ratio": 0.5
+     },
+     "pipe_8": {
+      "type": "Pipes",
+      "in": "after_non_return_valve_2",
+      "out": "after_pipe_8",
+      "delta_p": 1000.0,
+      "diameter": 0.05,
+      "material": 2
+    },
+    "global_valve_3": {
+       "type": "Valve",
+       "in": "after_pipe_8",
+       "out": "after_valve_3",
+       "opening": 50,
+       "q_flowrate": 50,
+       "material": 2,
+       "pressure_ratio": 0.5
+    },
+
+
+    "pipe_9": {
+      "type": "Pipes",
+      "in": "after_valve_3",
+      "out": "recycle_to_tank",
+      "delta_p": 1000.0,
+      "diameter": 0.08,
+      "material": 2
+    }
+  
+  },
+  "simulation": {
+    "mode": "dynamic",
+    "t0": 0.0,
+    "tf": 17.0,
+    "dt": 1.0,
+    "backend": "scipy"
+  }
+}
+
+
+

processforge-0.3.3/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",
+      "delta_p": 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",
+      "delta_p": 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",
+      "delta_p": 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.3.1 → processforge-0.3.3}/flowsheets/hydraulic-chain.json

@@ -43,7 +43,7 @@
       "type": "Pump",
       "in": "feed",
       "out": "after_pump_1",
-      "deltaP": 100000.0,
+      "delta_p": 100000.0,
       "efficiency": 0.75,
       "material": 3
     },
@@ -74,7 +74,7 @@
       "type": "Strainer",
       "in": "after_pipe_2",
       "out": "after_strainer_1",
-      "deltaP": 5000.0,
+      "delta_p": 5000.0,
       "material": 3
     },
     "pipe_3": {
@@ -89,7 +89,7 @@
       "type": "Pump",
       "in": "after_pipe_3",
       "out": "after_pump_2",
-      "deltaP": 200000.0,
+      "delta_p": 200000.0,
       "efficiency": 0.8,
       "material": 3
     },

{processforge-0.3.1 → processforge-0.3.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "processforge"
-version = "0.3.1"
+version = "0.3.3"
 description = "A Python-based process simulation framework for chemical engineering applications."
 readme = "README.md"
 license = "BSD-3-Clause"
@@ -36,7 +36,6 @@ dependencies = [
     "zarr>=3.0",
     "coolprop>=7.2.0",
     "typer>=0.12",
-    "pip>=26.1.2",
 ]
 
 [project.optional-dependencies]

{processforge-0.3.1 → processforge-0.3.3}/src/processforge/__init__.py

@@ -29,7 +29,7 @@ from .units.flash import Flash
 from .units.heater import Heater
 from .eo import EOFlowsheet, EOSolver
 
-__version__ = "0.3.0"
+__version__ = "0.3.2"
 
 __all__ = [
     "Flowsheet",

{processforge-0.3.1 → processforge-0.3.3}/src/processforge/analysis/dof.py

@@ -29,9 +29,9 @@ class SystemDOFReport:
 #   - a string means the key must be present
 #   - a tuple means at least one of the keys must be present
 _UNIT_REQUIRED: dict[str, list] = {
-    "Pump":            ["deltaP"],
+    "Pump":            ["delta_p"],
     "Valve":           ["pressure_ratio"],
-    "Strainer":        ["deltaP"],
+    "Strainer":        ["delta_p"],
     "Pipes":           ["delta_p", "diameter"],
     "Heater":          [("duty", "outlet_T")],    # at least one of these
     "Flash":           ["P"],