Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,16 @@
# Änderungen

## Unveröffentlicht

* Neu: **Kristalle (anisotrope Materialien)** im Materialeditor (hp-FEM M19, ADR-0015): einachsig (n_o, n_e, Achse über θ gegen die Normale und φ
gegen x), zweiachsig (drei Hauptindizes, Euler-Winkel z-x-z) oder voller symmetrischer Tensor, im Laborsystem (x quer zu den Linien, y längs, z die
Normale); in Formen, Schichten und Substrat, das Einfallsmedium bleibt isotrop. Nur mit dem Löser `hpfem.grating` (Schichten oder Substrat aus
Kristall: `AnisotropicStack`); Rotationskörper lehnen Kristalle ab.
* Neu: **Jones- und Mueller-Matrizen** je ausbreitungsfähiger Ordnung (`hpfem.grating.jones`, Option „Jones- und Mueller-Matrizen berechnen“):
Reiter „Jones / Mueller“ mit der Mueller-Matrix (Einzelpunkt als Karte, Durchlauf als 4×4 Kurven, normiert auf m_00) und der Jones-Tabelle
(Betrag, Phase, Effizienz); bei einem Kristallsubstrat sind die Zeilen der transmittierten Matrix die beiden Moden. Gegen die analytische
Jones-Matrix einer flachen Kristallplatte auf Kristallsubstrat: 3·10⁻¹⁶.

## 0.3.0 (2026-10-09)

* Neu: **Radial unendliche Schichten** bei Rotationskörpern (durch die PML bis zur Wand): planare Spiegel, Membranen, Schichtwellenleiter; DBR-Generator
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ Die App startet die Rechnung (Worker) als eigenen Prozess in einem Python mit `h
| Teil | Python | Pakete |
|---|---|---|
| App (Oberfläche, Gmsh, Auswertung) | beliebiges Python ≥ 3.10 | `pip install -r requirements.txt` |
| Rechnung (Worker) | ein Python mit `hpfem` | [hp-FEM](https://github.com/PhotonPower/hp-FEM) **ab 0.4** empfohlen (`hpfem.grating`, Resonanzen, Prüfungen; Ableitungen ab dem Stand M16 auf `main`). Ältere Versionen mit `ConicalScattering` gehen mit den klassischen Lösern. |
| Rechnung (Worker) | ein Python mit `hpfem` | [hp-FEM](https://github.com/PhotonPower/hp-FEM) **ab 0.4** empfohlen (`hpfem.grating`, Resonanzen, Prüfungen; Ableitungen ab dem Stand M16, Kristalle und Jones-/Mueller-Matrizen ab M19 auf `main`). Ältere Versionen mit `ConicalScattering` gehen mit den klassischen Lösern. |

## Installation und Start (Windows, eine Umgebung für App und Rechnung)

Expand Down
8 changes: 4 additions & 4 deletions docs/ARCHITEKTUR.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@
|---|---|
| `fem_app.py` | Streamlit-Seite mit fünf Reitern (Modell, Netz, Rechnung, Ergebnisse, Info) und Seitenleiste. Prüft beim Start, dass alle Module zur gleichen Version gehören. |
| `fem_geometry.py` | Modell (Schichten, Formen, Beleuchtung, Gebiet), Vorlagen, Validierung, PML-Auslegung, Gmsh-Netz (physikalische Gruppen für den hpfem-Reader), Vorschau und Netzbilder. |
| `fem_materials.py` | Optische Konstanten ohne hpfem: Bibliothek (CSV aus `python/hpfem/data` und Sellmeier), n+ik, ε, Drude, Tabelle. Gleiche Werte wie `hpfem.materials`. |
| `fem_materials.py` | Optische Konstanten ohne hpfem: Bibliothek (CSV aus `python/hpfem/data` und Sellmeier), n+ik, ε, Drude, Tabelle, Kristall (`tensor_at`: 3×3-Tensor im Laborsystem; `eps_at` gibt für Kristalle den größten Hauptwert für Netzweiten). Gleiche Werte wie `hpfem.materials`. |
| `fem_run.py` | Durchlaufwerte, Job-Datei, Start des Workers als Hintergrundprozess (PYTHONPATH nur für einen Quell-Build mit gebautem Modul), Abbruchdatei, Prüflauf (`--check`), Bibliotheksprüfung (Version, Funktionen), Log- und Fortschrittsauswertung. |
| `fem_worker.py` | Läuft im hpfem-Python. Liest `job.json` und `mesh.msh`, rechnet je Durchlaufpunkt (Streuung oder Resonanzen), schreibt Ergebnisse nach jedem Punkt. Mit `--check` nur Prüfungen und Speicherschätzung. |
| `fem_ui.py` | Gemeinsame Streamlit-Bausteine beider Modi (Materialeditor, Tabellen, Bilder mit Download, CSV). |
Expand All @@ -31,8 +31,8 @@
## Schnittstelle App ↔ Worker

* Der App-Prozess schreibt `<Arbeitsordner>/run/job.json` (Modell, Schichtlage, Beleuchtung, Durchlauf, Löser, Karten, Konvergenzstudie) und `mesh.msh` (Gmsh 4.1, ASCII).
* `job.json` enthält außerdem `task` (`scattering` oder `resonances`) und `resonance` (`num_modes`, `krylov_dimension`); `solver.engine` ist `grating`, `grating_hp`, `conical`, `inplane` oder `inplane_hp`, dazu `jacobian`, `scalar`, `check` und unter `adaptive` `estimator` (`residual`/`dwr`) und `mirror_periodic`.
* Der Worker schreibt `log.txt` mit den Zeilen `PROGRESS i/n`, `STEP s/S`, `PHASE name`, `ESTIMATE …`, `DIAG severity code: text`, `WARN …`, `ERROR …`, `CANCELLED` und `DONE`, danach `results.json` (nach jedem Punkt aktualisiert; bei `grating` zusätzlich `diagnostics`, `timing`, `flux_balance`, `A_exact`, `amplitudes`, `jacobian`), `maps_<i>.npz` (Raster, mit `H` und `S`), `tri_<i>.npz` (Elemente, exakt, mit `values_H` und `values_S`), `hpmesh_<i>.npz` (Endnetz der hp-Adaptivität) und bei Resonanzen `mode_<i>_<m>.npz`.
* `job.json` enthält außerdem `task` (`scattering` oder `resonances`) und `resonance` (`num_modes`, `krylov_dimension`); `solver.engine` ist `grating`, `grating_hp`, `conical`, `inplane` oder `inplane_hp`, dazu `jacobian`, `scalar`, `check`, `jones` (Jones-/Mueller-Matrizen über `grating.jones`) und unter `adaptive` `estimator` (`residual`/`dwr`) und `mirror_periodic`.
* Der Worker schreibt `log.txt` mit den Zeilen `PROGRESS i/n`, `STEP s/S`, `PHASE name`, `ESTIMATE …`, `DIAG severity code: text`, `WARN …`, `ERROR …`, `CANCELLED` und `DONE`, danach `results.json` (nach jedem Punkt aktualisiert; bei `grating` zusätzlich `diagnostics`, `timing`, `flux_balance`, `A_exact`, `amplitudes`, `jacobian` und mit `solver.jones` `jones`: je Ordnung `"R0"`, `"T-1"`, … ein Dict mit `J` (2×2, Paare [Re, Im]; Spalten einfallend s, p), `M` (4×4 Mueller) und `channels` (Zeilennamen, `s`/`p` oder die Moden eines Kristallsubstrats)), `maps_<i>.npz` (Raster, mit `H` und `S`), `tri_<i>.npz` (Elemente, exakt, mit `values_H` und `values_S`), `hpmesh_<i>.npz` (Endnetz der hp-Adaptivität) und bei Resonanzen `mode_<i>_<m>.npz`.
* Abbruch: die App legt `<Rechenordner>/cancel` an; der Worker fragt die Datei zwischen den Phasen eines Lösungsschritts (Fortschritts-Callback von hpfem) und zwischen den Punkten ab und endet mit `CANCELLED`.
* Ein erneutes Ausführen der Streamlit-Seite beendet den Worker nicht: die App findet ihn über das Prozessobjekt und die Logdatei wieder.

Expand All @@ -52,4 +52,4 @@ H_sca = H − `incident_h_field`), in homogener Umgebung `conical_cross_sections

Das Gmsh-Netz trägt die Ränder als `hpfem.box_tag` (1 links, 2 rechts, 3 unten, 4 oben), damit `hpfem.grating` es direkt nimmt; die Materialflächen sind 1 bis N.

Die Löser `grating` und `grating_hp`, Resonanzen und der Prüflauf brauchen hp-FEM ab 0.4 (`hpfem.grating`), die Ableitungen den Stand mit `grating.jacobian` (M16 S1). Die App fragt die Bibliothek beim Start ab (`fem_run.probe_library`) und bietet nur an, was vorhanden ist. Der klassische Löser nutzt neuere Funktionen, wenn vorhanden (`AdaptiveMesh.set_periodic`, `problem.sample`, `problem.triangulate`, `absorbed_power_by_tag`, `sample(quantity="H"/"S")`) und fällt sonst auf Schleife und Rasterintegration zurück. Das Protokoll nennt dann den Grund.
Die Löser `grating` und `grating_hp`, Resonanzen und der Prüflauf brauchen hp-FEM ab 0.4 (`hpfem.grating`), die Ableitungen den Stand mit `grating.jacobian` (M16 S1), Kristalle und Jones-/Mueller-Matrizen den Stand M19 (`AnisotropicStack`, `Material.anisotropic`, `grating.jones`; Merkmale `crystals` und `jones` der Bibliotheksprüfung). Die App fragt die Bibliothek beim Start ab (`fem_run.probe_library`) und bietet nur an, was vorhanden ist. Der klassische Löser nutzt neuere Funktionen, wenn vorhanden (`AdaptiveMesh.set_periodic`, `problem.sample`, `problem.triangulate`, `absorbed_power_by_tag`, `sample(quantity="H"/"S")`) und fällt sonst auf Schleife und Rasterintegration zurück. Das Protokoll nennt dann den Grund.
51 changes: 44 additions & 7 deletions fem_gui/fem_app.py
Original file line number Diff line number Diff line change
Expand Up @@ -33,13 +33,13 @@

# ---- all files of the app must come from the same version: name what is missing instead of a traceback
_REQUIRED = {
"fem_materials.py": (fm, ["library_available", "eps_at", "nk", "describe", "valid_range", "LIBRARY"]),
"fem_materials.py": (fm, ["library_available", "eps_at", "nk", "describe", "valid_range", "LIBRARY", "is_crystal", "tensor_at", "principal_values"]),
"fem_geometry.py": (fg, ["presets", "validate", "layout", "preview_figure", "mesh_figure", "build_mesh", "suggest_domain", "pml_plan", "shift_shapes",
"centering_shift", "shapes_x_extent", "material_index_map", "load_model", "new_shape", "parse_points", "shape_polygon", "reader_check"]),
"fem_post.py": (fp, ["load_results", "results_dataframe", "fig_spectrum", "fig_pscan", "load_map", "derived", "fig_map", "fig_cut", "fig_absorption",
"fig_absorption_sweep", "fig_adaptive_steps", "fig_hpmesh", "load_tri", "derived_tri", "fig_map_tri", "fig_materials",
"available_quantities", "jacobian_dataframe", "fig_jacobian", "resonances_dataframe", "fig_resonances", "timing_dataframe",
"balance_dataframe"]),
"balance_dataframe", "jones_orders", "jones_dataframe", "mueller_dataframe", "fig_mueller"]),
"fem_run.py": (fr, ["sweep_values", "wavelength_range", "make_job", "write_job", "start_worker", "read_log", "progress_info", "log_flags", "library_warnings",
"default_python", "probe_library", "run_check", "request_cancel", "estimate_line", "diagnostics_lines"]),
}
Expand All @@ -51,7 +51,7 @@
if not (HERE / _f).is_file():
_old.append(f"{_f}: nicht gefunden (muss neben fem_app.py liegen)")
_wmiss = [k for k in ("absorbed_exact", "triangulation_data", "set_periodic", "symmetrise_periodic", "design_pml", "GratingRun", "adaptive_grating_point",
"resonance_point", "check_job", "jacobian_data") if k not in _wtext]
"resonance_point", "check_job", "jacobian_data", "jones_data") if k not in _wtext]
if _wmiss:
_old.append(f"fem_worker.py: veraltet (es fehlt {', '.join(_wmiss)})")
else:
Expand Down Expand Up @@ -104,7 +104,7 @@ def init_state():
ensure_uids(S.model)
S.mesh_settings = dict(cells_per_wavelength=3.0, skin_cells=1.0, interface_factor=0.7, curved=True, pml_cells_per_wavelength=6.0)
S.solver = dict(order=4, backend="AUTO", pml_target=1e-3, pml_angle_cap_deg=80.0, orders_max=3, order_points=64, engine="grating",
jacobian=False, scalar="auto", check=True,
jacobian=False, scalar="auto", check=True, jones=False,
adaptive=dict(p0=3, steps=12, max_dofs=150000, dorfler=0.5, tol=1e-4, reuse_mesh=True, estimator="residual", mirror_periodic=True))
S.maps = dict(enabled=True, indices=[0], res_nm=4.0, triangulate=True, subdiv=3, hs=True)
S.task, S.resonance = "scattering", dict(num_modes=6, krylov_dimension=0)
Expand Down Expand Up @@ -509,7 +509,10 @@ def iso_results(view, res, rmodel, mode):
def _bump():
S.ver += 1

ui.material_editor(model, ver, inc["wavelength_nm"], used_materials(model), rename_material, _bump)
ui.material_editor(model, ver, inc["wavelength_nm"], used_materials(model), rename_material, _bump,
crystals=bool(FEATS.get("crystals")) or any(fm.is_crystal(v) for v in model["materials"].values()))
if not FEATS.get("crystals"):
st.caption("Kristalle (anisotrope Materialien) brauchen hp-FEM mit M19 (AnisotropicStack).")
names = list(model["materials"])

# ---------------------------------------------------------------- stack
Expand Down Expand Up @@ -725,12 +728,36 @@ def _bump():
elif not errors:
st.info("Noch kein Netz erzeugt.")

def jones_view(res, mode):
"""Results tab of the Jones and Mueller matrices (hpfem.grating.jones): order and point, the Mueller figure, the Jones table."""
pts = [p for p in res["points"] if "error" not in p and p.get("jones")]
if not pts:
st.info("Keine Jones-Matrizen in dieser Rechnung (Reiter 3: Löser „hpfem.grating“, „Jones- und Mueller-Matrizen berechnen“).")
return
keys = fp.jones_orders(pts)
c = st.columns(3)
key = c[0].selectbox("Ordnung", keys, key="jones_order", format_func=lambda k: f"{'reflektiert' if k[0] == 'R' else 'transmittiert'} m = {k[1:]}")
show_fig(fp.fig_mueller(pts, mode, key), f"mueller_{key}.png", "dl_mueller")
which = c[1].selectbox("Punkt Nr.", [p["index"] for p in pts], key="jones_pt") if len(pts) > 1 else pts[0]["index"]
pt = next(p for p in pts if p["index"] == which)
st.markdown("**Jones-Matrix**")
jdf = fp.jones_dataframe(pt, key)
table_show(jdf)
st.markdown("**Mueller-Matrix (normiert auf m_00)**")
table_show(fp.mueller_dataframe(pt, key))
st.download_button("Jones-Matrix (CSV)", csv_bytes(jdf), file_name=f"jones_{key}_{which}.csv", mime="text/csv", key="dl_jones_csv")
st.caption("Leistungsnormiert: die Spaltensummen von |J|² sind die Effizienzen der Ordnung für einfallendes s bzw. p. Basis s, p nach "
"conical_polarisation von hp-FEM (ŝ = k̂ × n̂, p̂ = ŝ × k̂ im Lösersystem; gegenüber dem Laborsystem wechseln J_sp und J_ps das Vorzeichen). "
"Stokes (I, Q, U, V) mit Q = |E_s|² − |E_p|²; m_00 ist die Effizienz für unpolarisiertes Licht. Bei einem Kristallsubstrat sind die "
"Zeilen der transmittierten Matrix die beiden Moden (ordentlich, außerordentlich).")


# ================================================================================================================== 3 Rechnung
with t_run:
sv, mp_ = S.solver, S.maps
mp_.setdefault("triangulate", True)
mp_.setdefault("subdiv", 3)
for k_, v_ in dict(jacobian=False, scalar="auto", check=True).items():
for k_, v_ in dict(jacobian=False, scalar="auto", check=True, jones=False).items():
sv.setdefault(k_, v_)
for k_, v_ in dict(estimator="residual", mirror_periodic=True).items():
sv["adaptive"].setdefault(k_, v_)
Expand Down Expand Up @@ -833,6 +860,14 @@ def _bump():
sv["check"] = c[2].checkbox("Prüfungen der Bibliothek: Fehler stoppen den Punkt", value=bool(sv["check"]), key="sv_check",
help="hpfem.diagnostics vor jeder Rechnung (Netz, periodische Ränder, PML, Auflösung, Materialbereich, streifende "
"Ordnungen …). Warnungen erscheinen im Protokoll und unter Ergebnisse.")
sv["jones"] = st.checkbox("Jones- und Mueller-Matrizen berechnen", value=bool(sv["jones"]) and bool(FEATS.get("jones")), key="sv_jones",
disabled=not FEATS.get("jones"),
help="hpfem.grating.jones (M19): löst je Punkt für s und p und liefert für jede ausbreitungsfähige Ordnung die "
"leistungsnormierte Jones-Matrix (Spalten: einfallend s, p; Zeilen: ausfallend s, p bzw. die beiden Moden eines "
"Kristallsubstrats) und die Mueller-Matrix (Stokes I, Q, U, V). Doppelte Rechenzeit.")
crystal_names = [n for n, v in S.model["materials"].items() if fm.is_crystal(v)]
if crystal_names and not (sv["engine"] == "grating" and S.task == "scattering"):
st.error(f"Kristalle ({', '.join(crystal_names)}) rechnet nur der Löser „hpfem.grating“ (Streuung); bitte diesen Löser wählen.")
if S.task == "resonances":
rs_ = S.resonance
c = st.columns(3)
Expand Down Expand Up @@ -1067,7 +1102,7 @@ def prepare_job(folder):
st.caption(f"Ordner mit allen Dateien: {view}")
elif res is not None:
sub = st.tabs(["Spektrum / Ordnungen", "Feldkarten", "Schnitte", "Absorption", "Prüfung, Bilanz, Zeit", "Ableitungen", "Konvergenz in p",
"hp-Adaptivität", "Tabelle und Export"])
"hp-Adaptivität", "Tabelle und Export", "Jones / Mueller"])
with sub[0]:
if len(df) and "R" in df:
show_fig(fp.fig_spectrum(df, mode), "spektrum.png", "dl_spec")
Expand Down Expand Up @@ -1159,6 +1194,8 @@ def prepare_job(folder):
if len(tdf):
st.markdown("**Rechenzeit je Phase (s)**")
table_show(tdf)
with sub[9]:
jones_view(res, mode)
with sub[5]:
jac_pts = [p for p in res["points"] if p.get("jacobian")]
if not jac_pts:
Expand Down
3 changes: 3 additions & 0 deletions fem_gui/fem_axi_worker.py
Original file line number Diff line number Diff line change
Expand Up @@ -68,6 +68,9 @@ def cancelled(self):
def materials(self, lam_nm):
"""MaterialMap at lam_nm for every tag of the mesh (the emitter box carries 101 + index with the material of 1 + index); the background
of the map is the surrounding medium (the contrast source of the scattered-field formulation is measured against it)."""
bad = [n for n in self.names if fm.is_crystal(self.model["materials"][n])]
if bad:
raise ValueError(f"Kristalle ({', '.join(bad)}) sind bei Rotationskörpern nicht möglich")
e_bg = fm.eps_at(self.model["materials"][self.model["background"]], lam_nm)
mm = self.h.MaterialMap(self.h.Material(complex(e_bg)))
eps = {}
Expand Down
2 changes: 2 additions & 0 deletions fem_gui/fem_geometry.py
Original file line number Diff line number Diff line change
Expand Up @@ -258,6 +258,8 @@ def validate(model, lam_nm=None):
f"y {lay['y_sub_bottom']:.0f} … {lay['y_cover_top']:.0f} nm)."))
if lam_nm is not None:
try:
if fm.is_crystal(model["materials"][model["cover"]]):
msgs.append(("error", "Das Einfallsmedium muss isotrop sein (kein Kristall)."))
e = fm.eps_at(model["materials"][model["cover"]], lam_nm)
if abs(e.imag) > 1e-9 or e.real < 1:
msgs.append(("error", "Das Einfallsmedium muss verlustfrei sein (ε reell, ≥ 1)."))
Expand Down
Loading
Loading