sorbflow 0.3.0__py3-none-any.whl

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.
Files changed (56) hide show
  1. sorbflow/__init__.py +41 -0
  2. sorbflow/__main__.py +5 -0
  3. sorbflow/_arrays.py +40 -0
  4. sorbflow/_version.py +3 -0
  5. sorbflow/adapters/__init__.py +1 -0
  6. sorbflow/calibration/__init__.py +5 -0
  7. sorbflow/calibration/batch_objective.py +118 -0
  8. sorbflow/calibration/least_squares.py +207 -0
  9. sorbflow/calibration/measurements.py +49 -0
  10. sorbflow/calibration/profile.py +327 -0
  11. sorbflow/cli.py +64 -0
  12. sorbflow/design/__init__.py +6 -0
  13. sorbflow/design/cad.py +65 -0
  14. sorbflow/design/hydraulics.py +99 -0
  15. sorbflow/equilibrium/__init__.py +17 -0
  16. sorbflow/equilibrium/isotherms.py +117 -0
  17. sorbflow/fit.py +7 -0
  18. sorbflow/io/__init__.py +7 -0
  19. sorbflow/io/experimental.py +159 -0
  20. sorbflow/io/parquet.py +79 -0
  21. sorbflow/io/results.py +50 -0
  22. sorbflow/kinetics/__init__.py +5 -0
  23. sorbflow/kinetics/sphere.py +112 -0
  24. sorbflow/observation.py +174 -0
  25. sorbflow/optimization/__init__.py +5 -0
  26. sorbflow/optimization/nsga2.py +161 -0
  27. sorbflow/optimize.py +5 -0
  28. sorbflow/py.typed +0 -0
  29. sorbflow/reactors/__init__.py +6 -0
  30. sorbflow/reactors/_ldf_jacobian.py +58 -0
  31. sorbflow/reactors/batch.py +87 -0
  32. sorbflow/reactors/column.py +151 -0
  33. sorbflow/reactors/hsdm.py +167 -0
  34. sorbflow/schemas.py +496 -0
  35. sorbflow/simulate.py +6 -0
  36. sorbflow/solvers/__init__.py +7 -0
  37. sorbflow/solvers/integration.py +152 -0
  38. sorbflow/solvers/options.py +74 -0
  39. sorbflow/solvers/results.py +318 -0
  40. sorbflow/uncertainty/__init__.py +5 -0
  41. sorbflow/uncertainty/monte_carlo.py +129 -0
  42. sorbflow/units.py +53 -0
  43. sorbflow/validate/__init__.py +35 -0
  44. sorbflow/web/__init__.py +5 -0
  45. sorbflow/web/__main__.py +6 -0
  46. sorbflow/web/app.py +278 -0
  47. sorbflow/web/config.py +213 -0
  48. sorbflow/web/server.py +302 -0
  49. sorbflow/web/ui.py +50 -0
  50. sorbflow-0.3.0.dist-info/METADATA +121 -0
  51. sorbflow-0.3.0.dist-info/RECORD +56 -0
  52. sorbflow-0.3.0.dist-info/WHEEL +5 -0
  53. sorbflow-0.3.0.dist-info/entry_points.txt +2 -0
  54. sorbflow-0.3.0.dist-info/licenses/LICENSE +202 -0
  55. sorbflow-0.3.0.dist-info/licenses/NOTICE +12 -0
  56. sorbflow-0.3.0.dist-info/top_level.txt +1 -0
sorbflow/web/server.py ADDED
@@ -0,0 +1,302 @@
1
+ """Loopback-only HTTP boundary for the optional stdlib SorbFlow interface."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import argparse
6
+ import hmac
7
+ import json
8
+ import sys
9
+ import time
10
+ from dataclasses import asdict
11
+ from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
12
+ from pathlib import Path
13
+ from typing import Any, cast
14
+ from urllib.parse import urlsplit
15
+
16
+ from .app import BusyError, WebApplication
17
+ from .config import MAX_REQUEST_BYTES, SCIENTIFIC_STATUS, examples, parse_request, strict_object
18
+ from .ui import page
19
+
20
+
21
+ class SorbFlowHTTPServer(ThreadingHTTPServer):
22
+ """Local development server; it does not expose the filesystem as static content."""
23
+
24
+ daemon_threads = True
25
+ request_queue_size = 8
26
+
27
+ def __init__(self, application: WebApplication, port: int) -> None:
28
+ self.application = application
29
+ super().__init__(("127.0.0.1", port), RequestHandler)
30
+ application.port = self.server_port
31
+
32
+ def server_close(self) -> None:
33
+ self.application.close()
34
+ super().server_close()
35
+
36
+
37
+ class RequestHandler(BaseHTTPRequestHandler):
38
+ server_version = "SorbFlow-local"
39
+ sys_version = ""
40
+
41
+ @property
42
+ def application(self) -> WebApplication:
43
+ return cast(SorbFlowHTTPServer, self.server).application
44
+
45
+ def setup(self) -> None:
46
+ super().setup()
47
+ self.connection.settimeout(5)
48
+
49
+ def log_message(self, format: str, *args: Any) -> None:
50
+ """Do not log tokens, arbitrary URL contents or control characters."""
51
+
52
+ def _send(self, status: int, payload: bytes, kind: str, filename: str | None = None) -> None:
53
+ if status >= 400 and self.command == "POST":
54
+ self._discard_rejected_body()
55
+ self.send_response(status)
56
+ self.send_header("Content-Type", kind)
57
+ self.send_header("Content-Length", str(len(payload)))
58
+ self.send_header("Cache-Control", "no-store")
59
+ self.send_header("X-Content-Type-Options", "nosniff")
60
+ self.send_header("Referrer-Policy", "no-referrer")
61
+ self.send_header("Cross-Origin-Resource-Policy", "same-origin")
62
+ self.send_header("X-Frame-Options", "DENY")
63
+ nonce = self.application.nonce
64
+ self.send_header(
65
+ "Content-Security-Policy",
66
+ "default-src 'none'; "
67
+ f"script-src 'nonce-{nonce}'; style-src 'nonce-{nonce}'; "
68
+ "connect-src 'self'; img-src 'self' blob:; base-uri 'none'; "
69
+ "frame-ancestors 'none'; form-action 'self'; object-src 'none'",
70
+ )
71
+ self.send_header("Connection", "close")
72
+ if filename is not None:
73
+ self.send_header("Content-Disposition", f'attachment; filename="{filename}"')
74
+ self.end_headers()
75
+ self.wfile.write(payload)
76
+ self.close_connection = True
77
+
78
+ def _discard_rejected_body(self) -> None:
79
+ """Avoid closing over an unread bounded POST, without trusting its framing.
80
+
81
+ A close with incoming bytes can reset TCP before the client receives its
82
+ error. Discard up to twice the accepted request limit, so a modestly
83
+ oversized rejected upload can still receive its 413 response. Never
84
+ parse or execute the discarded body. The total drain has a hard deadline,
85
+ including fragmented uploads; larger declared bodies are not drained.
86
+ """
87
+ if getattr(self, "_post_body_started", False):
88
+ return
89
+ self._post_body_started = True
90
+ lengths = self.headers.get_all("Content-Length", [])
91
+ if self.headers.get("Transfer-Encoding") is not None or len(lengths) != 1:
92
+ return
93
+ text = lengths[0]
94
+ if not text.isascii() or not text.isdigit() or len(text) > 10:
95
+ return
96
+ remaining = int(text)
97
+ if not 0 < remaining <= 2 * MAX_REQUEST_BYTES:
98
+ return
99
+ timeout = self.connection.gettimeout()
100
+ deadline = time.monotonic() + 0.5
101
+ try:
102
+ while remaining:
103
+ available = deadline - time.monotonic()
104
+ if available <= 0:
105
+ break
106
+ self.connection.settimeout(available)
107
+ chunk = self.rfile.read1(min(remaining, 8192))
108
+ if not chunk:
109
+ break
110
+ remaining -= len(chunk)
111
+ except OSError:
112
+ pass # Still attempt the original error response; this connection closes.
113
+ finally:
114
+ self.connection.settimeout(timeout)
115
+
116
+ def _json(self, status: int, data: object) -> None:
117
+ self._send(
118
+ status,
119
+ json.dumps(data, ensure_ascii=False, allow_nan=False).encode("utf-8"),
120
+ "application/json; charset=utf-8",
121
+ )
122
+
123
+ def _security(self, *, token: bool, mutation: bool = False) -> bool:
124
+ hosts = self.headers.get_all("Host", [])
125
+ allowed = {f"127.0.0.1:{self.application.port}", f"localhost:{self.application.port}"}
126
+ if len(hosts) != 1 or hosts[0].lower() not in allowed:
127
+ self._json(403, {"error": "Only the exact local Host is accepted"})
128
+ return False
129
+ origins = self.headers.get_all("Origin", [])
130
+ if len(origins) > 1 or (mutation and not origins):
131
+ self._json(403, {"error": "A same-origin request is required"})
132
+ return False
133
+ if origins and origins[0] != f"http://{hosts[0].lower()}":
134
+ self._json(403, {"error": "Cross-origin requests are not accepted"})
135
+ return False
136
+ tokens = self.headers.get_all("X-SorbFlow-Token", [])
137
+ if token and (
138
+ len(tokens) != 1
139
+ or len(tokens[0]) > 200
140
+ or not tokens[0].isascii()
141
+ or not hmac.compare_digest(tokens[0], self.application.token)
142
+ ):
143
+ self._json(403, {"error": "Invalid local session token"})
144
+ return False
145
+ return True
146
+
147
+ def _path(self) -> str:
148
+ parsed = urlsplit(self.path)
149
+ if (
150
+ not self.path.startswith("/")
151
+ or parsed.scheme
152
+ or parsed.netloc
153
+ or parsed.query
154
+ or parsed.fragment
155
+ or len(parsed.path) > 2048
156
+ ):
157
+ raise ValueError("Only local paths without query parameters are accepted")
158
+ return parsed.path
159
+
160
+ def do_GET(self) -> None:
161
+ try:
162
+ path = self._path()
163
+ if not self._security(token=path != "/"):
164
+ return
165
+ if path == "/":
166
+ self._send(
167
+ 200,
168
+ page(self.application.token, self.application.nonce),
169
+ "text/html; charset=utf-8",
170
+ )
171
+ elif path == "/api/info":
172
+ self._json(
173
+ 200,
174
+ {
175
+ "scientific_status": SCIENTIFIC_STATUS,
176
+ "job_timeout_s": self.application.job_timeout_s,
177
+ "units": "SI; dry adsorbent basis",
178
+ "limits": {
179
+ "request_bytes": MAX_REQUEST_BYTES,
180
+ "axial_cells": 64,
181
+ "radial_cells": 12,
182
+ "samples": 401,
183
+ "active_jobs": 1,
184
+ },
185
+ },
186
+ )
187
+ elif path == "/api/examples":
188
+ self._json(200, {"examples": examples()})
189
+ elif path == "/api/jobs":
190
+ self._json(200, {"jobs": self.application.jobs()})
191
+ else:
192
+ parts = path.strip("/").split("/")
193
+ if len(parts) == 3 and parts[:2] == ["api", "jobs"]:
194
+ self._json(200, self.application.get(parts[2]))
195
+ elif len(parts) == 5 and parts[:2] == ["api", "jobs"] and parts[3] == "files":
196
+ data = self.application.download(parts[2], parts[4])
197
+ kind = (
198
+ "application/json"
199
+ if parts[4].endswith(".json")
200
+ else "text/csv"
201
+ if parts[4].endswith(".csv")
202
+ else "text/plain"
203
+ )
204
+ self._send(200, data, kind + "; charset=utf-8", parts[2] + "_" + parts[4])
205
+ else:
206
+ self._json(404, {"error": "Unknown local endpoint"})
207
+ except (KeyError, FileNotFoundError):
208
+ self._json(404, {"error": "Unknown job or unavailable file"})
209
+ except (ValueError, UnicodeError):
210
+ self._json(400, {"error": "Invalid local request"})
211
+ except OSError:
212
+ self._json(500, {"error": "Local output could not be read"})
213
+
214
+ def do_POST(self) -> None:
215
+ self._post_body_started = False
216
+ if not self._security(token=True, mutation=True):
217
+ return
218
+ try:
219
+ path = self._path()
220
+ if path not in {"/api/validate", "/api/jobs"}:
221
+ self._json(404, {"error": "Unknown local endpoint"})
222
+ return
223
+ if self.headers.get("Transfer-Encoding") is not None:
224
+ self._json(400, {"error": "Transfer-Encoding is not supported"})
225
+ return
226
+ if self.headers.get("Content-Type", "").split(";", 1)[0].lower() != "application/json":
227
+ self._json(415, {"error": "Content-Type must be application/json"})
228
+ return
229
+ lengths = self.headers.get_all("Content-Length", [])
230
+ if len(lengths) != 1:
231
+ self._json(411, {"error": "One Content-Length header is required"})
232
+ return
233
+ length = int(lengths[0])
234
+ if not 0 < length <= MAX_REQUEST_BYTES:
235
+ self._json(413, {"error": "Request exceeds the 64 KiB local limit"})
236
+ return
237
+ self._post_body_started = True
238
+ raw = self.rfile.read(length)
239
+ if len(raw) != length:
240
+ raise ValueError("Incomplete request body")
241
+ spec = parse_request(strict_object(raw.decode("utf-8")))
242
+ if path == "/api/validate":
243
+ self._json(
244
+ 200,
245
+ {
246
+ "ok": True,
247
+ "reactor": spec.reactor,
248
+ "config_sha256": spec.config_sha256,
249
+ "canonical_config_json": spec.config_json,
250
+ "solver_options": asdict(spec.options),
251
+ "scientific_status": SCIENTIFIC_STATUS,
252
+ },
253
+ )
254
+ else:
255
+ self._json(202, self.application.submit(spec))
256
+ except BusyError as exc:
257
+ self._json(429, {"error": str(exc)})
258
+ except (ValueError, UnicodeError, RecursionError) as exc:
259
+ self._json(400, {"error": str(exc)[:600]})
260
+ except OSError:
261
+ self._json(500, {"error": "Local run directory could not be created"})
262
+
263
+ def do_OPTIONS(self) -> None:
264
+ self._json(405, {"error": "Only local GET and POST endpoints are supported"})
265
+
266
+
267
+ def create_server(
268
+ *,
269
+ host: str = "127.0.0.1",
270
+ port: int = 8765,
271
+ output: str | Path = "runs/gui",
272
+ job_timeout_s: float = 30,
273
+ ) -> SorbFlowHTTPServer:
274
+ """Build a server without starting its request loop; port=0 supports isolated tests."""
275
+ if host not in ("127.0.0.1", "localhost"):
276
+ raise ValueError("The local GUI binds only to 127.0.0.1 (or localhost)")
277
+ if type(port) is not int or not 0 <= port <= 65535:
278
+ raise ValueError("port must be an integer within [0,65535]")
279
+ return SorbFlowHTTPServer(WebApplication(output, job_timeout_s=job_timeout_s), port)
280
+
281
+
282
+ def main(argv: list[str] | None = None) -> int:
283
+ parser = argparse.ArgumentParser(
284
+ description="SorbFlow local scientific interface (not production)"
285
+ )
286
+ parser.add_argument("--host", default="127.0.0.1")
287
+ parser.add_argument("--port", type=int, default=8765)
288
+ parser.add_argument("--output", type=Path, default=Path("runs/gui"))
289
+ args = parser.parse_args(argv)
290
+ try:
291
+ with create_server(host=args.host, port=args.port, output=args.output) as server:
292
+ print(f"SorbFlow local: http://127.0.0.1:{server.server_port}", flush=True)
293
+ print(SCIENTIFIC_STATUS, flush=True)
294
+ print("Press Ctrl+C to close this GUI and its own running job.", flush=True)
295
+ try:
296
+ server.serve_forever()
297
+ except KeyboardInterrupt:
298
+ pass
299
+ except (OSError, ValueError) as exc:
300
+ print(f"SorbFlow web error: {exc}", file=sys.stderr)
301
+ return 2
302
+ return 0
sorbflow/web/ui.py ADDED
@@ -0,0 +1,50 @@
1
+ # ruff: noqa: E501
2
+ """Self-contained local UI. No external assets; untrusted strings use textContent."""
3
+
4
+ from __future__ import annotations
5
+
6
+ import html
7
+ import json
8
+
9
+ _PAGE = r"""<!doctype html>
10
+ <html lang="es"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
11
+ <title>SorbFlow · laboratorio local</title>
12
+ <style nonce="__NONCE__">
13
+ :root{font-family:system-ui,-apple-system,Segoe UI,sans-serif;color:#1b3042;background:#f2f6fa;font-synthesis:none}*{box-sizing:border-box}body{margin:0}header,main{max-width:1280px;margin:auto;padding:24px}header{display:flex;align-items:center;justify-content:space-between;gap:20px}h1{margin:0;font-size:30px;letter-spacing:-1px}h2{font-size:18px;margin:0 0 18px}p{line-height:1.5}.sub{color:#5a6c7b;font-size:14px;margin:6px 0}.badge{font-size:12px;border:1px solid #ce9839;background:#fff8df;color:#795614;border-radius:20px;padding:7px 12px;white-space:nowrap}main{padding-top:0}.notice{background:#e7eff8;border-left:4px solid #2e648e;border-radius:8px;padding:12px 16px;margin-bottom:20px;font-size:14px}.grid{display:grid;grid-template-columns:minmax(320px,1fr) minmax(320px,1.1fr);gap:20px}.card{background:#fff;border:1px solid #dbe4ec;border-radius:14px;padding:22px;box-shadow:0 3px 12px #193e5e06}label{display:block;font-size:13px;font-weight:600;margin-bottom:7px}select,input,textarea,button{font:inherit}select,input{width:100%;padding:9px;border:1px solid #bccbd8;border-radius:7px;background:white;color:#243b4c}textarea{width:100%;min-height:310px;padding:12px;border:1px solid #bccbd8;border-radius:8px;font:12px/1.5 ui-monospace,Consolas,monospace;resize:vertical;tab-size:2;color:#16344b;background:#fbfdff}select:focus,input:focus,textarea:focus{outline:2px solid #8cbadd;outline-offset:1px}.row{display:flex;gap:10px;align-items:end}.row>*{flex:1}.controls{display:grid;grid-template-columns:repeat(4,1fr);gap:10px;margin:14px 0}button{border:0;border-radius:8px;padding:11px 16px;background:#205d8d;color:#fff;cursor:pointer;font-weight:600}.secondary{color:#205d8d;background:#e8f0f7}.smallbutton{font-size:12px;padding:8px 11px}button:disabled{opacity:.5;cursor:wait}.help{font-size:12px;color:#607586;margin:9px 0 14px}#status{min-height:42px;padding:12px;background:#f3f7fa;border-radius:8px;margin-bottom:16px;white-space:pre-wrap}.error{color:#993f2e}.metrics{display:grid;grid-template-columns:1fr 1fr;gap:10px;margin:15px 0}.metric{border:1px solid #dde7ef;border-radius:9px;padding:12px}.metric strong{display:block;font-size:20px;overflow-wrap:anywhere}.metric span{font-size:12px;color:#607586}canvas{width:100%;height:290px;display:block;border:1px solid #e4ebf2;border-radius:9px}#downloads{display:flex;flex-wrap:wrap;gap:8px;margin-top:14px}#history{margin-top:20px}.historyitem{display:flex;justify-content:space-between;align-items:center;gap:10px;border-top:1px solid #e4ebf2;padding:10px 0;font-size:12px}.muted{font-size:12px;color:#6a7e8d}footer{font-size:12px;color:#617685;margin:20px 0 0}.hidden{display:none}@media(max-width:850px){.grid{grid-template-columns:1fr}header{align-items:flex-start;flex-direction:column}.controls{grid-template-columns:1fr 1fr}canvas{height:250px}}
14
+ </style></head><body>
15
+ <header><div><h1>SorbFlow</h1><p class="sub">Laboratorio local de adsorción acuosa · API científica 0.3</p></div><span class="badge">Resultados trazables</span></header>
16
+ <main><div class="notice">Simulación exploratoria con el motor Python propio. Los ejemplos son sintéticos; no representan un material calibrado ni un diseño certificado.</div>
17
+ <div class="grid"><section class="card"><h2>1. Configurar el ensayo</h2><div class="row"><div><label for="example">Ejemplo sintético</label><select id="example"></select></div><button id="load" class="secondary">Cargar</button></div>
18
+ <p class="help">La configuración JSON usa unidades SI según el nombre de cada campo. Concentración: kg/m³; carga: kg/kg seco; tiempo: s. 1 mg/L = 0,001 kg/m³. No se infieren unidades.</p>
19
+ <label for="config">Configuración física</label><textarea id="config" spellcheck="false" aria-label="Configuración JSON en unidades SI"></textarea>
20
+ <div class="controls"><div><label for="method">Integrador</label><select id="method"><option>BDF</option><option>Radau</option></select></div><div><label for="cells">Celdas axiales</label><input id="cells" type="number" min="2" max="64" value="40"></div><div><label for="radial">Celdas radiales</label><input id="radial" type="number" min="2" max="12" value="8"></div><div><label for="samples">Salidas</label><input id="samples" type="number" min="2" max="401" value="201"></div></div>
21
+ <div class="row"><button id="validate" class="secondary">Validar configuración</button><button id="run">Simular</button></div><p class="help">Una simulación a la vez. Límite local de ejecución: <span id="timeout">30</span> s. La malla de salida no fija los pasos internos. HSDM puede requerir una malla mayor mediante la API/CLI.</p></section>
22
+ <section class="card"><h2>2. Examinar resultados</h2><div id="status" role="status" aria-live="polite">Cargando ejemplos…</div><canvas id="plot" aria-label="Concentración de salida frente al tiempo"></canvas><div class="metrics"><div class="metric"><strong id="last">—</strong><span>Concentración final · kg/m³</span></div><div class="metric"><strong id="mass">—</strong><span>Máximo residuo de masa · kg</span></div></div><div class="muted" id="detail">Cada simulación incluye controles de balance de masa y de estado.</div><div id="downloads"></div><div id="history"><h2>Trabajos de esta sesión</h2><div id="jobs" class="muted">Sin simulaciones.</div></div></section></div>
23
+ <footer>Salida aislada por identificador, sin sobrescritura. No se ejecuta FAST ni se modifican datasets. Este servidor está limitado al equipo local.</footer></main>
24
+ <script nonce="__NONCE__">
25
+ 'use strict';
26
+ const TOKEN=__TOKEN__;let examples=[],reactor='batch',active=null,timer=null;
27
+ const el=id=>document.getElementById(id);const headers={'X-SorbFlow-Token':TOKEN};
28
+ function status(text,error=false){el('status').textContent=text;el('status').className=error?'error':'';}
29
+ async function api(path,body){const r=await fetch(path,{method:body===undefined?'GET':'POST',headers:body===undefined?headers:{...headers,'Content-Type':'application/json'},body:body===undefined?undefined:JSON.stringify(body),credentials:'same-origin'});const data=await r.json();if(!r.ok)throw new Error(data.error||'No se pudo completar la solicitud');return data;}
30
+ function payload(){return {reactor,config_json:el('config').value,options:{method:el('method').value,axial_cells:Number(el('cells').value),radial_cells:Number(el('radial').value)},samples:Number(el('samples').value)};}
31
+ function load(){const selected=examples.find(x=>x.id===el('example').value);if(!selected)return;reactor=selected.reactor;el('config').value=JSON.stringify(JSON.parse(selected.config_json),null,2);el('cells').value=reactor==='batch'?'40':'24';el('radial').value='8';status('Ejemplo sintético cargado. Revise parámetros y unidades antes de simular.');}
32
+ function plot(preview){const canvas=el('plot'),ctx=canvas.getContext('2d'),ratio=window.devicePixelRatio||1;canvas.width=Math.round(canvas.clientWidth*ratio);canvas.height=Math.round(canvas.clientHeight*ratio);ctx.scale(ratio,ratio);const w=canvas.clientWidth,h=canvas.clientHeight,l=65,r=18,t=24,b=45;ctx.clearRect(0,0,w,h);ctx.fillStyle='#607586';ctx.font='11px system-ui';if(!preview){ctx.fillText('La curva aparecerá tras una simulación completa.',22,40);return;}const x=preview.time_s.map(v=>v/60),y=preview.outlet_concentration_kg_m3;const xmax=Math.max(...x,1e-12),ymax=Math.max(...y,1e-12)*1.08;ctx.strokeStyle='#e1e9f0';ctx.lineWidth=1;for(let i=0;i<=4;i++){const yy=t+(h-t-b)*i/4;ctx.beginPath();ctx.moveTo(l,yy);ctx.lineTo(w-r,yy);ctx.stroke();ctx.fillText((ymax*(1-i/4)).toExponential(1),3,yy+4);const xx=l+(w-l-r)*i/4;ctx.fillText((xmax*i/4).toFixed(1),xx-8,h-24);}ctx.fillText('Salida · kg/m³',l,t-9);ctx.fillText('Tiempo · min',w/2-30,h-6);ctx.strokeStyle='#1f6b9d';ctx.lineWidth=2.4;ctx.beginPath();x.forEach((v,i)=>{const xx=l+(w-l-r)*v/xmax,yy=t+(h-t-b)*(1-y[i]/ymax);i?ctx.lineTo(xx,yy):ctx.moveTo(xx,yy);});ctx.stroke();}
33
+ async function download(id,name){try{const r=await fetch('/api/jobs/'+id+'/files/'+name,{headers,credentials:'same-origin'});if(!r.ok){const err=await r.json();throw new Error(err.error);}const url=URL.createObjectURL(await r.blob()),a=document.createElement('a');a.href=url;a.download=id+'_'+name;document.body.appendChild(a);a.click();a.remove();setTimeout(()=>URL.revokeObjectURL(url),1000);}catch(e){status(e.message,true);}}
34
+ function files(job){el('downloads').replaceChildren();const names=job.status==='succeeded'?['result.json','timeseries.csv','summary.json','job.log']:['summary.json','job.log'];names.forEach(name=>{const button=document.createElement('button');button.className='secondary smallbutton';button.textContent=name;button.addEventListener('click',()=>download(job.id,name));el('downloads').appendChild(button);});}
35
+ async function refresh(){try{const data=await api('/api/jobs');el('jobs').replaceChildren();if(!data.jobs.length){el('jobs').textContent='Sin simulaciones.';return;}data.jobs.forEach(job=>{const row=document.createElement('div');row.className='historyitem';const label=document.createElement('span');label.textContent=job.reactor+' · '+job.id.slice(0,10)+' · '+job.status;const button=document.createElement('button');button.className='secondary smallbutton';button.textContent='Ver';button.addEventListener('click',()=>poll(job.id));row.append(label,button);el('jobs').appendChild(row);});}catch(e){status(e.message,true);}}
36
+ async function poll(id){try{const job=await api('/api/jobs/'+id);if(job.status==='queued'||job.status==='running'){status('Simulación '+job.status+' · '+job.id.slice(0,10));clearTimeout(timer);timer=setTimeout(()=>poll(id),600);return;}active=null;el('run').disabled=false;files(job);if(job.status==='succeeded'){status('Simulación completada. Para decisiones de diseño, compare con una malla más fina.');plot(job.preview);const y=job.preview.outlet_concentration_kg_m3;el('last').textContent=y[y.length-1].toExponential(3);el('mass').textContent=job.diagnostics.max_abs_mass_residual_kg.toExponential(3);el('detail').textContent='Residuo escalado máximo: '+job.diagnostics.max_scaled_mass_residual.toExponential(3)+'. Balance de masa verificado.';}else{status((job.status==='timed_out'?'Tiempo local agotado. ':'La simulación no produjo un resultado exitoso. ')+(job.error||'Consultar el registro.'),true);}await refresh();}catch(e){active=null;el('run').disabled=false;status(e.message,true);}}
37
+ el('load').addEventListener('click',load);el('validate').addEventListener('click',async()=>{try{const data=await api('/api/validate',payload());status('Configuración y límites locales correctos. No valida la física ni los parámetros.\nSHA-256: '+data.config_sha256);}catch(e){status(e.message,true);}});
38
+ el('run').addEventListener('click',async()=>{el('run').disabled=true;try{const job=await api('/api/jobs',payload());active=job.id;await refresh();await poll(job.id);}catch(e){el('run').disabled=false;status(e.message,true);}});
39
+ async function init(){try{const info=await api('/api/info');el('timeout').textContent=String(info.job_timeout_s);const data=await api('/api/examples');examples=data.examples;examples.forEach(example=>{const option=document.createElement('option');option.value=example.id;option.textContent=example.label;el('example').appendChild(option);});plot(null);load();await refresh();}catch(e){status(e.message,true);}}
40
+ init();
41
+ </script></body></html>"""
42
+
43
+
44
+ def page(token: str, nonce: str) -> bytes:
45
+ """Token is a generated secret, never caller-provided HTML or configuration text."""
46
+ return (
47
+ _PAGE.replace("__NONCE__", html.escape(nonce, quote=True))
48
+ .replace("__TOKEN__", json.dumps(token))
49
+ .encode("utf-8")
50
+ )
@@ -0,0 +1,121 @@
1
+ Metadata-Version: 2.4
2
+ Name: sorbflow
3
+ Version: 0.3.0
4
+ Summary: Configurable aqueous adsorption modelling: batch and fixed-bed LDF/HSDM simulation, calibration, uncertainty and design
5
+ Author: Karel Aldrin Sanchez Hernandez, David Esteban Rodriguez Saiz, Dayana Ximena Cabrera Obando, Gabriela Johana Romo Cadena
6
+ Maintainer: Karel Aldrin Sanchez Hernandez
7
+ License-Expression: Apache-2.0
8
+ Project-URL: Homepage, https://github.com/karelsanchez/SorbFlow
9
+ Project-URL: Documentation, https://sorbflow.readthedocs.io
10
+ Project-URL: Repository, https://github.com/karelsanchez/SorbFlow
11
+ Project-URL: Issues, https://github.com/karelsanchez/SorbFlow/issues
12
+ Project-URL: Changelog, https://github.com/karelsanchez/SorbFlow/blob/main/CHANGELOG.md
13
+ Keywords: adsorption,water treatment,fixed-bed,breakthrough curve,LDF,HSDM,isotherm,simulation
14
+ Classifier: Development Status :: 3 - Alpha
15
+ Classifier: Intended Audience :: Science/Research
16
+ Classifier: Intended Audience :: Education
17
+ Classifier: Natural Language :: Spanish
18
+ Classifier: Operating System :: OS Independent
19
+ Classifier: Programming Language :: Python :: 3
20
+ Classifier: Programming Language :: Python :: 3 :: Only
21
+ Classifier: Programming Language :: Python :: 3.11
22
+ Classifier: Programming Language :: Python :: 3.12
23
+ Classifier: Programming Language :: Python :: 3.13
24
+ Classifier: Topic :: Scientific/Engineering
25
+ Classifier: Topic :: Scientific/Engineering :: Chemistry
26
+ Classifier: Typing :: Typed
27
+ Requires-Python: >=3.11
28
+ Description-Content-Type: text/markdown
29
+ License-File: LICENSE
30
+ License-File: NOTICE
31
+ Requires-Dist: pint<0.26,>=0.24
32
+ Requires-Dist: numpy<3,>=1.26
33
+ Requires-Dist: scipy<2,>=1.12
34
+ Provides-Extra: dev
35
+ Requires-Dist: pytest<10,>=8; extra == "dev"
36
+ Requires-Dist: pytest-cov<8,>=5; extra == "dev"
37
+ Requires-Dist: ruff<1,>=0.9; extra == "dev"
38
+ Requires-Dist: mypy<2,>=1.14; extra == "dev"
39
+ Requires-Dist: build<2,>=1; extra == "dev"
40
+ Requires-Dist: scipy-stubs<2,>=1.14; extra == "dev"
41
+ Requires-Dist: ezdxf<2,>=1.3; extra == "dev"
42
+ Provides-Extra: optimize
43
+ Requires-Dist: pymoo<0.7,>=0.6.1; extra == "optimize"
44
+ Provides-Extra: parquet
45
+ Requires-Dist: pyarrow<27,>=17; extra == "parquet"
46
+ Dynamic: license-file
47
+
48
+ # SorbFlow
49
+
50
+ **SorbFlow** es una herramienta en Python para modelar, simular, calibrar y diseñar
51
+ procesos de adsorción en fase acuosa, en reactores batch y en columnas de lecho fijo.
52
+
53
+ ```bash
54
+ pip install sorbflow # núcleo
55
+ pip install "sorbflow[optimize]" # + optimización multiobjetivo NSGA-II
56
+ pip install "sorbflow[parquet]" # + exportación Parquet
57
+ ```
58
+
59
+ ## Qué hace
60
+
61
+ - **Equilibrio**: isotermas lineal, Langmuir y Freundlich, con derivadas analíticas.
62
+ - **Cinética y transporte**: fuerza impulsora lineal (LDF) y difusión superficial
63
+ homogénea (HSDM) con resistencia de película, dispersión axial y condiciones de
64
+ frontera de Danckwerts.
65
+ - **Motores numéricos**: volúmenes finitos conservativos en el eje del lecho y en el
66
+ radio de la partícula, integradores rígidos BDF/Radau, Jacobiano analítico disperso
67
+ y modo *streaming* de baja memoria.
68
+ - **Calibración e incertidumbre**: ajuste de isotermas y constantes cinéticas,
69
+ diagnósticos SVD, perfiles de verosimilitud, objetivos multiensayo, Monte Carlo
70
+ con semilla y sensibilidad local.
71
+ - **Diseño**: EBCT, pérdida de carga de Ergun, potencia de bombeo, costo de operación,
72
+ envolvente DXF y optimización multiobjetivo con restricciones.
73
+ - **Trazabilidad**: cada resultado guarda configuración, unidades, versiones, revisión
74
+ del código, balance de masa y huellas SHA-256.
75
+ - **Tres formas de uso** sobre el mismo motor: API Python, comando `sorbflow` e
76
+ interfaz web local (`python -m sorbflow.web`).
77
+
78
+ Cualquier soluto, adsorbente o mezcla de N componentes se describe como datos de
79
+ configuración, con unidades SI explícitas.
80
+
81
+ ## Uso rápido
82
+
83
+ ```bash
84
+ sorbflow column column_ldf.json --output resultados --cells 100
85
+ ```
86
+
87
+ ```python
88
+ from pathlib import Path
89
+ from sorbflow import SimulationConfig
90
+ from sorbflow.simulate import column
91
+ from sorbflow.solvers import SolverOptions
92
+
93
+ config = SimulationConfig.from_json(Path("column_ldf.json").read_text())
94
+ result = column(config, options=SolverOptions(axial_cells=200, jacobian="analytic"))
95
+ print(result.outlet_concentration_kg_m3[-1])
96
+ ```
97
+
98
+ Las configuraciones de ejemplo (`batch_ldf.json`, `column_ldf.json`,
99
+ `column_hsdm.json`) están en la carpeta `examples/` del repositorio.
100
+
101
+ ## Modelo de columna (resumen)
102
+
103
+ ```text
104
+ ε ∂c/∂t + ρ_b ∂q̄/∂t = −∂J/∂z, J = u c − ε D_ax ∂c/∂z
105
+ LDF: ∂q̄/∂t = k_LDF [q*(c) − q̄]
106
+ HSDM: ∂q/∂t = D_s r⁻² ∂/∂r (r² ∂q/∂r), ρ_p D_s ∂q/∂r|_R = k_f (c − c_s)
107
+ ```
108
+
109
+ ## Calidad
110
+
111
+ 588 pruebas automatizadas; integración continua en Windows y Linux con Python 3.11,
112
+ 3.12 y 3.13; verificación frente a soluciones de referencia; documentación construida
113
+ en modo estricto.
114
+
115
+ ## Documentación, cita y licencia
116
+
117
+ - Documentación: https://sorbflow.readthedocs.io
118
+ - Autores: Karel Aldrin Sanchez Hernandez, David Esteban Rodriguez Saiz,
119
+ Dayana Ximena Cabrera Obando y Gabriela Johana Romo Cadena.
120
+ - Cita: archivo `CITATION.cff` del repositorio.
121
+ - Licencia: Apache-2.0.
@@ -0,0 +1,56 @@
1
+ sorbflow/__init__.py,sha256=Lnvor537zsknK1Sg86GdzYNMUWe3Seet2oF7NyEpDes,742
2
+ sorbflow/__main__.py,sha256=cxozUMUSi8Sqj1y7ehjAfFnEeUbZ-RH6xJNiUrZg3lE,98
3
+ sorbflow/_arrays.py,sha256=E7LagjF64rI-w2DDgvMmGyRJpHFjer_LVPBxBBcF8N0,1436
4
+ sorbflow/_version.py,sha256=gE_flSNfRKth0b1aJVCXQkiVrvaJeXTDzG30XU33HsI,71
5
+ sorbflow/cli.py,sha256=q0vxzTMo1CSQoFr0Rbf-82ixZmVa4DkRkjQ54W6-Sz4,2737
6
+ sorbflow/fit.py,sha256=sl9mOzhunbhuzK1rQbYFEbDFmZds8-d9XZt1bfWgg2o,338
7
+ sorbflow/observation.py,sha256=Fdv4sf8-57YAdAn36Y2NF-GYZ7OHKBpftikHs3c45m0,7401
8
+ sorbflow/optimize.py,sha256=qPjTBF8U-w8QV4eOIF4faJJazkg6--2iVwD6frGANbs,235
9
+ sorbflow/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
10
+ sorbflow/schemas.py,sha256=yKnYkslR_QC37upkMtgO7hErLXs_uvvKMMmcG8h_XmA,18631
11
+ sorbflow/simulate.py,sha256=5dzTzTa-hhFfPcbAEVP8tcKyhf0FM0dxRnZKppNqk6g,208
12
+ sorbflow/units.py,sha256=xWUBlLNPoSVq6ZCj8pj33OigUnQjQkdibjaQOAa3bq8,1924
13
+ sorbflow/adapters/__init__.py,sha256=h2lhiHINvdbuC7d7-JnaNumT04InF8w2inY7-n6A1Fg,89
14
+ sorbflow/calibration/__init__.py,sha256=XEWyh8ivKEUiRpKLIBIuznO-1rOeb42y9zG7sdWatlQ,221
15
+ sorbflow/calibration/batch_objective.py,sha256=1ue3W6V6Rvlb_-qmfwoRH9HEJ1cVFZ_2NiYDG7SnUmI,5655
16
+ sorbflow/calibration/least_squares.py,sha256=ZOGybzloTcIdinx59vjgSPg_f6PeeGmfrlRL3Ky17cI,7978
17
+ sorbflow/calibration/measurements.py,sha256=17f-K6DiVJ5kdkDgG7Y2mOe6hhtcHyJZd7NuFsPshtA,2331
18
+ sorbflow/calibration/profile.py,sha256=5WqsPFX2dNTATgQvVrrx9BSS5wD3jrLIHVfZA8Iosmo,13928
19
+ sorbflow/design/__init__.py,sha256=hNB5PDKxey4Dr7Vl9lW_aMDF1ucOm1rq5DXgfj2zV_A,276
20
+ sorbflow/design/cad.py,sha256=Dcw9DUOw1A03SfcQsG1PU_aHV5tM_10vARisQHQelYM,1946
21
+ sorbflow/design/hydraulics.py,sha256=upOi1zFOPLzWPgCcraGwvy2edbSR__P3yWl1EACmjQY,3368
22
+ sorbflow/equilibrium/__init__.py,sha256=EMRqD3CmRATqHltf6GTaQx4dHHcc2Ok2MS9AmKDufgo,354
23
+ sorbflow/equilibrium/isotherms.py,sha256=Miltf2zKMVp0GHFH6g28uiQO71iZuo-hGOyTU8emgBc,4638
24
+ sorbflow/io/__init__.py,sha256=gb52CZ8u6rVdlu1eA-ngnG16k2pzNpuLorQ_FcRUdC4,226
25
+ sorbflow/io/experimental.py,sha256=ldtpU84L_nNWYCb4I-6JDfBv2D5wmFqLnBOCPgBMCMs,6155
26
+ sorbflow/io/parquet.py,sha256=Ezod9kyXGvzI_YfSc9klI8bhDj0O55ftYl03HiWBaHo,3477
27
+ sorbflow/io/results.py,sha256=6jV7MNksWPK5W33SMXHfxgCGlONM6ljwax8gLO5K28g,1679
28
+ sorbflow/kinetics/__init__.py,sha256=bLYbASTO0Xhu1JcGP3E1XFIjBCfuhexKZgFqCtbbM6I,133
29
+ sorbflow/kinetics/sphere.py,sha256=YjAsEZvGhIkB-2plGlQBSl0bAoEjMth6w76W8gelges,4194
30
+ sorbflow/optimization/__init__.py,sha256=dmgiabDWTC72mwOiuqjNKNlhnoEWqW81JOlonGKN5TY,214
31
+ sorbflow/optimization/nsga2.py,sha256=N6sqsubghOhkszcRoLvrqWnlBLfSadALWn_uZCc19kM,6236
32
+ sorbflow/reactors/__init__.py,sha256=2X5on0J7fybODNA_esqfj_Wbqbvwl8SZACbo0wMsnw0,177
33
+ sorbflow/reactors/_ldf_jacobian.py,sha256=ZvGzA89iEajd677kZaYuD1G9ca1isexrx0WxTuY1OSs,3052
34
+ sorbflow/reactors/batch.py,sha256=7JptouFrzkrZ3zWYLgwddSbTFbYmbtZaOJMuHEUIA0w,3198
35
+ sorbflow/reactors/column.py,sha256=ScnoJVttvyyI3GlWsjymqb6raT_nO_A7BLYm188Wv5E,6326
36
+ sorbflow/reactors/hsdm.py,sha256=l9yrkWnsP3hWcHNe6uKnYW0wngmp_wwqbkxFq9E0rg8,6074
37
+ sorbflow/solvers/__init__.py,sha256=NFDPKABc4grYs_1u-yfQ86U6uVB1o9GSgDtm8KgSn6c,279
38
+ sorbflow/solvers/integration.py,sha256=8ibI6J2W0dlxpPdcLjXKCZnuNcGkINIFkyx2wiCs-44,6295
39
+ sorbflow/solvers/options.py,sha256=4XdhBXlRWJwF7WJF5JOo9bcHhLsl7SktcuO6bp1pmwY,2998
40
+ sorbflow/solvers/results.py,sha256=LnhJ6JD3t0ANJ4Tum-VfGfWuCYG8LIvDtApraVO5qmg,12852
41
+ sorbflow/uncertainty/__init__.py,sha256=axYUFkHLbruZitgSvyuNhXvhCVHTQRZabuPRbSa8I5A,226
42
+ sorbflow/uncertainty/monte_carlo.py,sha256=kgKncbnumGi0Gg_KU70qz1bSg-Zdi8WR0I2nkJSZT8k,5103
43
+ sorbflow/validate/__init__.py,sha256=IzOeBq0a5-VMYBImzqIrtiuYklx6h5SjpT4-WmRpwrw,1139
44
+ sorbflow/web/__init__.py,sha256=7Ffznp5NFQ4QAe6TH-O4H61cYK4T63ZGo0jTCEgzN_0,193
45
+ sorbflow/web/__main__.py,sha256=gvmur84Q3tKHpIgr6Cr_gHRu4OfoLAGxlN4KtZ3jjcI,153
46
+ sorbflow/web/app.py,sha256=ikYN_VUeiEOnlYk2AGrz3scK8t4ePuIzoT0Mw-uGqJw,11700
47
+ sorbflow/web/config.py,sha256=9ggoJx8mHznqcCitv3KvHodDR2OE74XvITM2hquRN00,8422
48
+ sorbflow/web/server.py,sha256=E8R_2dlS7Sk3mkY6xI9B6gN9sIAzOO90a2wKxdsgf1g,12614
49
+ sorbflow/web/ui.py,sha256=rvCPgtpSe1RHROJf-JYhXQHeGGedWLgxo4VRT-solhE,11994
50
+ sorbflow-0.3.0.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
51
+ sorbflow-0.3.0.dist-info/licenses/NOTICE,sha256=DhKMbIJz55aHqeRRaAlfmoOnvk3g4LFmsVb_91O7j6E,548
52
+ sorbflow-0.3.0.dist-info/METADATA,sha256=AFtvrtKNy-EE2CGuG3HUI4KGzhIR6ii2ZYfTgZqUMQE,5158
53
+ sorbflow-0.3.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
54
+ sorbflow-0.3.0.dist-info/entry_points.txt,sha256=eFh8HY9q0a9JejSKZ-MEfUbRnmyvMkmaahEs6U_tTK8,47
55
+ sorbflow-0.3.0.dist-info/top_level.txt,sha256=AkrVKePA8rNQI8se-eXHfdXY6plTjKN1bXVAztSfG4Q,9
56
+ sorbflow-0.3.0.dist-info/RECORD,,
@@ -0,0 +1,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: setuptools (84.2.1)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ sorbflow = sorbflow.cli:main