From 2e1c0596c1f3c5fb70d8465ef632096b25d5cc65 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 15:59:56 +0000 Subject: [PATCH 01/11] Fix build of Python module - discus/prog/CMakeLists.txt: drop hdf_write.f90, which was removed in de3fae9 (now in lib_f90); configure failed without this. - python/CMakeLists.txt: link experi_all before discus_all, since experi_kdo calls exp3_pdf; otherwise suite_python fails on import with an undefined symbol. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_018Yw8KkfPLawp8Po4f5Bc9v --- discus/prog/CMakeLists.txt | 2 +- python/CMakeLists.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/discus/prog/CMakeLists.txt b/discus/prog/CMakeLists.txt index 9faef7d3..4e8b6085 100644 --- a/discus/prog/CMakeLists.txt +++ b/discus/prog/CMakeLists.txt @@ -85,7 +85,7 @@ set( LIBS lib_f90 lib_f90c kuplot_all ${DIFFUSE_LIBS}) if (DEFINED ENV{HDF5_INC_DIR}) include_directories($ENV{HDF5_INC_DIR}) endif () - set (SOURCES_ALL ${SOURCES_ALL} hdf_write.f90) +# set (SOURCES_ALL ${SOURCES_ALL} hdf_write.f90) message (DISCUS " HDF5 is ON ${DIFFUSE_HDF5} ") #else (DIFFUSE_HDF5) # set (SOURCES_ALL ${SOURCES_ALL} hdf_write_no.f90) diff --git a/python/CMakeLists.txt b/python/CMakeLists.txt index 62a3f4e2..18688f4f 100644 --- a/python/CMakeLists.txt +++ b/python/CMakeLists.txt @@ -5,7 +5,7 @@ find_package(F2PY REQUIRED) message(STATUS "F2PY included from: ${F2PY_INCLUDE_DIR}") -set(PYLINK_LIBS discus_suite_all diffev_all refine_all discus_all kuplot_all experi_all) +set(PYLINK_LIBS discus_suite_all diffev_all refine_all experi_all discus_all kuplot_all) set(PYLINK_LIBS ${PYLINK_LIBS} lib_f90 lib_f90c finufft_lib) set(PYLINK_LIBS ${PYLINK_LIBS} ${DIFFUSE_LIBS} ${MPI_Fortran_LIBRARIES}) set(PYLINK_LIBS ${PYLINK_LIBS} ${PGPLOT_PGPLOT_LIBRARY} ${X11_X11_LIB} ${PNG_LIBRARY} ${HDF5_LIBRARIES}) From e8b41289bb608abba0c5fbeb109d8e6b91db0214 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 16:08:07 +0000 Subject: [PATCH 02/11] WP0 0.9: CI workflow and in-process Python interface tests - python/CMakeLists.txt: link experi_all before discus_all; experi_kdo calls exp3_pdf, so suite_python failed on import with an undefined symbol. - tests/python/suite_session.py: test helper around suite_python. run() uses a driver macro with a completion flag and raises MacroError when a command error stops the macro; dataset()/dataset_2d() return KUPLOT data sets as NumPy arrays. - tests/python/test_suite_python.py: expressions, error detection, crystal build, 1-D/2-D Fourier and Debye powder, checked against the legacy RESULTS/ files and against golden data. - tests/python/compare.py + tests/golden/: R-value and golden .npz/meta.json handling (DIFFUSE_UPDATE_GOLDEN=1 rewrites them). - .github/workflows/tests.yml: build with -DDIFFUSE_PYTHON=ON, run pytest and the legacy tests tagged fast,mc on Ubuntu 24.04. - Docs: tests/README.md, WP0 progress log, and the rule that work is built against and merged into claude-python-app until the first Python release (migration plan and new CLAUDE.md). Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_018Yw8KkfPLawp8Po4f5Bc9v --- .github/workflows/tests.yml | 72 ++++++ CLAUDE.md | 26 +++ .../DiffuseCode_Python_Migration_Plan.md | 2 + migration/WP0_Test_Baseline.md | 46 +++- python/CMakeLists.txt | 2 +- tests/README.md | 32 +++ tests/golden/02.1d/fourier_1d.npz | Bin 0 -> 5478 bytes tests/golden/02.1d/meta.json | 10 + tests/golden/02.2d/fourier_2d.npz | Bin 0 -> 50214 bytes tests/golden/02.2d/meta.json | 10 + tests/golden/02.powder/meta.json | 10 + tests/golden/02.powder/powder_debye.npz | Bin 0 -> 7400 bytes tests/python/compare.py | 87 +++++++ tests/python/conftest.py | 29 +++ tests/python/suite_session.py | 116 +++++++++ tests/python/test_suite_python.py | 220 ++++++++++++++++++ 16 files changed, 657 insertions(+), 5 deletions(-) create mode 100644 .github/workflows/tests.yml create mode 100644 CLAUDE.md create mode 100644 tests/golden/02.1d/fourier_1d.npz create mode 100644 tests/golden/02.1d/meta.json create mode 100644 tests/golden/02.2d/fourier_2d.npz create mode 100644 tests/golden/02.2d/meta.json create mode 100644 tests/golden/02.powder/meta.json create mode 100644 tests/golden/02.powder/powder_debye.npz create mode 100644 tests/python/compare.py create mode 100644 tests/python/suite_session.py create mode 100644 tests/python/test_suite_python.py diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml new file mode 100644 index 00000000..92e1a4b5 --- /dev/null +++ b/.github/workflows/tests.yml @@ -0,0 +1,72 @@ +# Build DiffuseCode with the Python module and run the tests. +# +# 1. pytest tests/python – Python interface (suite_python) + golden data +# 2. legacy macro tests – tools/run_legacy_tests.py, tags fast and mc +# +# Development happens on claude-python-app until the first release of the +# Python package; feature branches (claude/**) merge into it. +name: tests + +on: + push: + branches: [claude-python-app, "claude/**"] + pull_request: + branches: [claude-python-app] + workflow_dispatch: + +concurrency: + group: tests-${{ github.ref }} + cancel-in-progress: true + +jobs: + linux: + runs-on: ubuntu-24.04 + timeout-minutes: 60 + env: + FC: gfortran + CC: gcc + CXX: g++ + steps: + - uses: actions/checkout@v4 + + - name: Install dependencies + run: | + sudo apt-get update + sudo apt-get install -y --no-install-recommends \ + gfortran cmake make libfftw3-dev libhdf5-dev libreadline-dev \ + libpng-dev libx11-dev zlib1g-dev pgplot5 xvfb \ + python3-dev python3-numpy python3-pytest + + - name: Configure + run: | + cmake -S . -B build -DCMAKE_BUILD_TYPE=Release \ + -DDIFFUSE_PYTHON=ON -DPGPLOT_DIR=/usr/lib/pgplot5 \ + -DPYTHON_EXECUTABLE=/usr/bin/python3 -Wno-dev + + - name: Build + run: cmake --build build -j "$(nproc)" + + - name: Python tests (pytest) + env: + DIFFUSE_PYTHON_PATH: ${{ github.workspace }}/build/python + DIFFUSE_REQUIRE_PYTHON: "1" + # DISCUS_SUITE is not set here, so the legacy macro tests inside + # pytest are skipped; the next step runs them in parallel. + run: python3 -m pytest tests/python -v --junitxml=pytest-results.xml + + - name: Legacy macro tests + run: | + python3 tools/run_legacy_tests.py \ + --exe build/suite/prog/discus_suite -j "$(nproc)" \ + --tags fast,mc --junit legacy-results.xml --workdir legacy-work + + - name: Upload results + if: always() + uses: actions/upload-artifact@v4 + with: + name: test-results + path: | + pytest-results.xml + legacy-results.xml + legacy-work/**/*.log + if-no-files-found: ignore diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 00000000..0ae3609c --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,26 @@ +# DiffuseCode – notes for Claude Code sessions + +## Branches + +Until the first release of the Python package, **all migration work is built +against and merged into `claude-python-app`**, not `master`. Start feature +branches from `origin/claude-python-app` and target pull requests at it. + +## Plan and progress + +- `migration/DiffuseCode_Python_Migration_Plan.md` – overall plan (option B, + work packages WP0–WP10). +- `migration/WP0_Test_Baseline.md` – test baseline tasks and progress log. +- `tests/README.md` – how to run the tests. + +## Build and test + +```bash +FC=gfortran CC=gcc CXX=g++ cmake -S . -B build -DCMAKE_BUILD_TYPE=Release \ + -DDIFFUSE_PYTHON=ON -DPGPLOT_DIR=/usr/lib/pgplot5 +cmake --build build -j +DIFFUSE_PYTHON_PATH=build/python python3 -m pytest tests/python +python3 tools/run_legacy_tests.py --exe build/suite/prog/discus_suite -j 4 --tags fast,mc +``` + +CMake needs `FC` set. Keep build trees outside `tests/`. diff --git a/migration/DiffuseCode_Python_Migration_Plan.md b/migration/DiffuseCode_Python_Migration_Plan.md index aa1814b5..086148c3 100644 --- a/migration/DiffuseCode_Python_Migration_Plan.md +++ b/migration/DiffuseCode_Python_Migration_Plan.md @@ -2,6 +2,8 @@ A high-level look at the current Fortran code and options for separating compute from the command language, graphics and I/O, with a web front end as a later goal. +> **Branches:** until the first release of the Python package, all migration work is built against and merged into the **`claude-python-app`** branch, not `master`. Feature branches start from `claude-python-app`, and pull requests target it. CI (`.github/workflows/tests.yml`) runs on pushes to it and on pull requests into it. + > **Related documents:** progress on WP0 is tracked in [`WP0_Test_Baseline.md`](WP0_Test_Baseline.md); test gaps are in [`WP0_Test_Coverage_Gaps.md`](WP0_Test_Coverage_Gaps.md). `mixscat` is deprecated and not part of the migration. 1. [What the code is today](#1-what-the-code-is-today) diff --git a/migration/WP0_Test_Baseline.md b/migration/WP0_Test_Baseline.md index bf7b7015..e398cf21 100644 --- a/migration/WP0_Test_Baseline.md +++ b/migration/WP0_Test_Baseline.md @@ -162,15 +162,17 @@ tests/ # existing macro tests stay where they are test_all.mac # kept for interactive use (unchanged) manifest.toml # [done] list of tests (TOML: read by Python's standard library) README.md # [done] how to run the tests - golden/ # 0.6: reference outputs, one folder per test id + golden/ # 0.6: [started] reference outputs, one folder per test id python/ # pytest harness conftest.py # [done] registers the manifest tags as markers test_legacy_macros.py # [done] one test per manifest entry + manifest checks - compare.py # 0.6: numeric comparisons (R-value, max-abs, atom sets) + compare.py # [started] R-value, golden .npz read/write (0.6) + suite_session.py # [done] test helper around the f2py module suite_python + test_suite_python.py # [done] in-process Python tests against RESULTS/ and golden/ tools/ run_legacy_tests.py # [done] runner -> console table, JUnit XML, JSON .github/workflows/ - legacy-tests.yml # 0.9: build + run on every push to claude-python-app + tests.yml # [done] 0.9: build + pytest + legacy tests on claude-python-app ``` ### Tasks @@ -186,7 +188,7 @@ tools/ | 0.6 | **Golden data capture** | For each test, copy key outputs (intensities, powder, PDF, 3D-PDF, final structure/CIF, histograms) into `tests/golden//` with a `meta.json` (DiffuseCode version, git commit, compiler, flags, date). Python compares with NumPy (R-value, max-abs, atom-set match) using tolerances from the manifest. Keep the macro self-checks as a second line of defence. | Every test has at least one golden numeric output | 3–4 d | | 0.7 | **Coverage expansion** | Confirm the uncovered-command list from 1.3, then add short, deterministic tests for the commands that WP3–WP8 will wrap first: space-group expansion / `wyckoff`, `patterson`, `inverse`, `rmc`, `molecularize`/`demolecularize`, `perioditize`, `storage`/`super`, `bragg`, and kuplot `fit`. | All commands planned for WP3–WP8 have at least one test | 5–8 d | | 0.8 | **Build fixes** | Make `suite/prog/CMakeLists.txt` honour `DIFFUSE_GRAPHICS`. Make the PGPLOT install paths configurable / optional. Drop the hard `FC` requirement in favour of CMake's normal compiler detection. | `cmake -DDIFFUSE_GRAPHICS=OFF` builds and the suite passes | 1–2 d | -| 0.9 | **CI** | GitHub Actions on `ubuntu-24.04`: apt (gfortran, FFTW, HDF5, readline, PNG, X11, pgplot5, xvfb), build, run `tools/run_legacy_tests.py --tags fast,mc`, upload JUnit + logs. Nightly job for `slow`/`mpi`. Add a macOS job once Linux is stable. | Red/green status on every push to `claude-python-app` | 1–2 d | +| 0.9 ✅ | **CI** | GitHub Actions on `ubuntu-24.04`: apt (gfortran, FFTW, HDF5, readline, PNG, X11, pgplot5, xvfb), build, run `tools/run_legacy_tests.py --tags fast,mc`, upload JUnit + logs. Nightly job for `slow`/`mpi`. Add a macOS job once Linux is stable. | Red/green status on every push to `claude-python-app` | 1–2 d | | 0.10 | **Repo hygiene** | Run `cleanup.mac` logic, remove committed generated outputs, add a `.gitignore` for them, and keep only inputs + `RESULTS/` + `golden/`. Consider Git LFS for golden files larger than ~1 MB. | `git status` is clean after a test run | 1 d | **Total: about 4–6 weeks for one developer.** That fits the "months 0–3" @@ -278,3 +280,39 @@ Checked: | Display already taken | retried on another display, PASS | | Runner and pytest at the same time | all pass; no display clashes | | `test_all.mac` (interactive mode) | all 13 sections SUCCESS | + +### 0.9 (and start of 0.6) – CI and Python-interface tests + +* **Build fix:** `python/CMakeLists.txt` linked `experi_all` after + `discus_all`. `experi_kdo` calls `exp3_pdf`, so the f2py module built but + failed on import with `undefined symbol: __exp3_pdf_menu_MOD_exp3_pdf`. + `experi_all` now comes first. +* `tests/python/suite_session.py` wraps `suite_python` for tests. `run()` + writes a driver macro that `cd`s into the test folder (the suite keeps its + own working directory, so `os.chdir` is not enough) and sets `r[499]` on + its last line. A command error ends the whole macro run, so a flag that is + not set raises `MacroError`. `dataset()` / `dataset_2d()` return KUPLOT + data sets as NumPy arrays. +* `tests/python/test_suite_python.py`: expressions, error detection, crystal + build, 1-D Fourier, 2-D Fourier and Debye powder, run in-process. The + 1-D Fourier and powder results are compared with the legacy `RESULTS/` + files (R < 1e-3; actual about 1e-6) and all three with golden data. +* `tests/python/compare.py` and `tests/golden//` (`.npz` + `meta.json`): + first golden data for `02.1d`, `02.2d`, `02.powder`. Rewrite with + `DIFFUSE_UPDATE_GOLDEN=1`. +* `.github/workflows/tests.yml`: Ubuntu 24.04, apt dependencies, build with + `-DDIFFUSE_PYTHON=ON`, then pytest (`DIFFUSE_REQUIRE_PYTHON=1`, so a broken + module fails instead of skipping), then the legacy runner with + `--tags fast,mc`. JUnit XML and logs are uploaded. + +Limits of the f2py module that the tests work around (to fix in WP2): +`execute_macro` reports errors only as text; `set_value` only works on +user-defined variables, not `r[]`; data come back as single precision. + +Checked (gfortran 13, 4 cores): + +| Run | Result | +|---|---| +| `pytest tests/python`, `OMP_NUM_THREADS` 1 and 4 | 9 passed (33 legacy macro tests skipped, no `DISCUS_SUITE`), under 1 s | +| Same build, `run_legacy_tests.py -j 4 --tags fast,mc` | 29 PASS, 1 RAN, 2 SKIPPED | + diff --git a/python/CMakeLists.txt b/python/CMakeLists.txt index 62a3f4e2..18688f4f 100644 --- a/python/CMakeLists.txt +++ b/python/CMakeLists.txt @@ -5,7 +5,7 @@ find_package(F2PY REQUIRED) message(STATUS "F2PY included from: ${F2PY_INCLUDE_DIR}") -set(PYLINK_LIBS discus_suite_all diffev_all refine_all discus_all kuplot_all experi_all) +set(PYLINK_LIBS discus_suite_all diffev_all refine_all experi_all discus_all kuplot_all) set(PYLINK_LIBS ${PYLINK_LIBS} lib_f90 lib_f90c finufft_lib) set(PYLINK_LIBS ${PYLINK_LIBS} ${DIFFUSE_LIBS} ${MPI_Fortran_LIBRARIES}) set(PYLINK_LIBS ${PYLINK_LIBS} ${PGPLOT_PGPLOT_LIBRARY} ${X11_X11_LIB} ${PNG_LIBRARY} ${HDF5_LIBRARIES}) diff --git a/tests/README.md b/tests/README.md index 2a85cb43..8765cdb3 100644 --- a/tests/README.md +++ b/tests/README.md @@ -75,6 +75,38 @@ DISCUS_SUITE=/path/to/discus_suite pytest tests/python -m "not slow" Without `DISCUS_SUITE` only the manifest checks run. +## 3. Python interface: `tests/python/test_suite_python.py` + +Runs DISCUS in-process through the f2py module `suite_python` and checks the +results as NumPy arrays, against the legacy `RESULTS/` files and against +golden data in `tests/golden//`. Build with `-DDIFFUSE_PYTHON=ON`, then: + +```bash +DIFFUSE_PYTHON_PATH=/path/to/build/python pytest tests/python +``` + +| Variable | Meaning | +|---|---| +| `DIFFUSE_PYTHON_PATH` | folder that holds `suite_python*.so` (`/python`) | +| `DIFFUSE_REQUIRE_PYTHON=1` | fail instead of skip if the module cannot be imported (used in CI) | +| `DIFFUSE_UPDATE_GOLDEN=1` | write the golden files instead of comparing; review the diff before committing | + +To add a test, use the `suite` fixture: `suite.run(commands, folder)` runs +macro text with `folder` as working directory and raises `MacroError` if a +command fails; `suite.value("n[1]")` evaluates an expression; +`suite.dataset(1)` / `suite.dataset_2d(1)` return KUPLOT data set 1. Load +results into KUPLOT (`kuplot`, `rese`, `load ...`) to read them back. +`compare.check_golden(id, name, r_max=..., axis..., result)` handles golden +data. The Fortran state is global and shared by all tests in one pytest run, +so start each calculation with the relevant `reset`. + +## CI + +`.github/workflows/tests.yml` builds with the Python module and runs the +pytest tests, then the legacy tests tagged `fast` and `mc`, on every push to +`claude-python-app` (and `claude/**` branches) and on pull requests into +`claude-python-app`. + ## Adding a test 1. Write the macro so that it sets `LTEST_MAC = TRUE` when its result is diff --git a/tests/golden/02.1d/fourier_1d.npz b/tests/golden/02.1d/fourier_1d.npz new file mode 100644 index 0000000000000000000000000000000000000000..94f0268c4c30a79d0daf0725598403ef48d66e49 GIT binary patch literal 5478 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 literal 0 HcmV?d00001 diff --git a/tests/golden/02.1d/meta.json b/tests/golden/02.1d/meta.json new file mode 100644 index 00000000..deb7e537 --- /dev/null +++ b/tests/golden/02.1d/meta.json @@ -0,0 +1,10 @@ +{ + "fourier_1d": { + "date": "2026-11-16T16:05:43+00:00", + "git_commit": "2e9a50e24ca1b5ec09811a2298577a44e123e10d", + "machine": "x86_64", + "numpy": "2.5.3", + "platform": "Linux-6.18.44-fc-v470-x86_64-with-glibc2.39", + "r_max": 1e-05 + } +} diff --git a/tests/golden/02.2d/fourier_2d.npz b/tests/golden/02.2d/fourier_2d.npz new file mode 100644 index 0000000000000000000000000000000000000000..5255c681043c2972b523bb63c6625f09fc11367a GIT binary patch literal 50214 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 Slbk>Pf{4JKFj})8zx^ND9>44W literal 0 HcmV?d00001 diff --git a/tests/python/compare.py b/tests/python/compare.py new file mode 100644 index 00000000..8888d543 --- /dev/null +++ b/tests/python/compare.py @@ -0,0 +1,87 @@ +"""Numeric comparisons and golden reference data for the Python tests. + +Golden data live in ``tests/golden//``: one ``.npz`` per +result plus ``meta.json`` (git commit, date, platform, NumPy version). + +To (re)create them, run the tests with ``DIFFUSE_UPDATE_GOLDEN=1``. Those +tests then write their result and are skipped instead of compared. Review +the diff before committing new golden files. +""" + +from __future__ import annotations + +import datetime as _dt +import json +import os +import platform +import subprocess +from pathlib import Path + +import numpy as np +import pytest + +REPO = Path(__file__).resolve().parents[2] +GOLDEN = REPO / "tests" / "golden" + + +def rvalue(obs, calc) -> float: + """Unweighted R-value sqrt(sum (o - c)^2 / sum o^2), as KUPLOT ``rval ..., one``.""" + obs = np.asarray(obs, dtype=np.float64) + calc = np.asarray(calc, dtype=np.float64) + if obs.shape != calc.shape: + raise ValueError(f"shape mismatch: {obs.shape} vs {calc.shape}") + return float(np.sqrt(np.sum((obs - calc) ** 2) / np.sum(obs ** 2))) + + +def load_columns(path: Path, ncol: int = 2) -> np.ndarray: + """Read a whitespace-separated text file, skipping ``#`` header lines.""" + return np.loadtxt(path, comments="#", usecols=range(ncol), ndmin=2) + + +def _meta() -> dict: + try: + commit = subprocess.run(["git", "-C", str(REPO), "rev-parse", "HEAD"], + capture_output=True, text=True, check=True).stdout.strip() + except (OSError, subprocess.CalledProcessError): + commit = "unknown" + return { + "git_commit": commit, + "date": _dt.datetime.now(_dt.timezone.utc).isoformat(timespec="seconds"), + "platform": platform.platform(), + "machine": platform.machine(), + "numpy": np.__version__, + } + + +def updating() -> bool: + return os.environ.get("DIFFUSE_UPDATE_GOLDEN", "") not in ("", "0") + + +def check_golden(test_id: str, name: str, *, r_max: float, **arrays) -> None: + """Compare ``arrays`` with ``golden//.npz``. + + Axis arrays (any key except the last) must match to float32 rounding; + the last array is the result and must have an R-value below ``r_max``. + With DIFFUSE_UPDATE_GOLDEN=1 the file is (re)written and the test skipped. + """ + folder = GOLDEN / test_id + path = folder / f"{name}.npz" + if updating(): + folder.mkdir(parents=True, exist_ok=True) + np.savez_compressed(path, **arrays) + meta_path = folder / "meta.json" + meta = json.loads(meta_path.read_text()) if meta_path.exists() else {} + meta[name] = _meta() | {"r_max": r_max} + meta_path.write_text(json.dumps(meta, indent=2, sort_keys=True) + "\n") + pytest.skip(f"golden data written to {path.relative_to(REPO)}") + if not path.exists(): + pytest.fail(f"no golden data {path.relative_to(REPO)}; " + "run once with DIFFUSE_UPDATE_GOLDEN=1") + ref = np.load(path) + assert sorted(ref.files) == sorted(arrays), f"golden keys {ref.files} != {list(arrays)}" + *axes, result = arrays + for key in axes: + np.testing.assert_allclose(arrays[key], ref[key], rtol=1e-6, atol=1e-6, + err_msg=f"axis '{key}' differs from golden") + r = rvalue(ref[result], arrays[result]) + assert r < r_max, f"R-value of '{result}' against golden is {r:.3g} (limit {r_max})" diff --git a/tests/python/conftest.py b/tests/python/conftest.py index ac0c33bc..9f4f8575 100644 --- a/tests/python/conftest.py +++ b/tests/python/conftest.py @@ -14,3 +14,32 @@ def pytest_configure(config): for tag, text in TAGS.items(): config.addinivalue_line("markers", f"{tag}: {text}") + + +# ---------------------------------------------------------------- suite_python +import os +import sys +from pathlib import Path + +import pytest + +sys.path.insert(0, str(Path(__file__).parent)) # suite_session, compare + + +@pytest.fixture(scope="session") +def suite(): + """The in-process DISCUS suite (f2py module suite_python). + + Skips the test if the module cannot be imported. Build it with + -DDIFFUSE_PYTHON=ON and set DIFFUSE_PYTHON_PATH=/python. + The Fortran state is global, so there is one session per pytest run. + """ + from suite_session import SuiteSession, import_suite_python + try: + module = import_suite_python() + except ImportError as exc: + if os.environ.get("DIFFUSE_REQUIRE_PYTHON"): + raise + pytest.skip(f"suite_python not importable ({exc}); " + "set DIFFUSE_PYTHON_PATH=/python") + return SuiteSession(module) diff --git a/tests/python/suite_session.py b/tests/python/suite_session.py new file mode 100644 index 00000000..a547d277 --- /dev/null +++ b/tests/python/suite_session.py @@ -0,0 +1,116 @@ +"""Thin test helper around the f2py module ``suite_python``. + +``suite_python`` (built with ``-DDIFFUSE_PYTHON=ON``) runs the whole +DISCUS suite inside the Python process. Its interface is small: + + initialize_suite() once per process + execute_macro("@/abs/path.mac") run a macro (errors are only printed) + get_value("expr") evaluate an expression, e.g. "n[1]" + get_data_sets() number of KUPLOT data sets + get_data_length(ik) points in KUPLOT data set ik + get_data(ik, x, y) fill float32 arrays x, y in place + get_data_3d(ik, x, y, z, nx, ny) same for a 2-D (grid) data set + +This helper adds what the tests need on top of that: + +* ``run()`` writes the commands to a driver macro that first changes into a + working folder (the suite keeps its own working directory; os.chdir does + not change it) and sets a flag on its last line. A command error ends the + whole macro run, so a flag that is not set means the macro failed, and + ``run()`` raises ``MacroError``. +* ``dataset()`` / ``dataset_2d()`` return KUPLOT data sets as NumPy arrays. + +The module is found through ``$DIFFUSE_PYTHON_PATH`` (the folder that holds +``suite_python*.so``, normally ``/python``) or the normal import path. +""" + +from __future__ import annotations + +import importlib +import itertools +import os +import sys +from pathlib import Path + +import numpy as np + +# r[] runs from 0 to MAXPAR = 500 (lib_f90/param_mod.f90). Tests leave the +# top of the range to this helper. +FLAG = "r[499]" + + +class MacroError(RuntimeError): + """A macro run through ``SuiteSession.run`` did not reach its end.""" + + +def import_suite_python(): + """Return the ``suite`` module object of suite_python, or raise ImportError.""" + path = os.environ.get("DIFFUSE_PYTHON_PATH") + if path and path not in sys.path: + sys.path.insert(0, path) + return importlib.import_module("suite_python").suite + + +class SuiteSession: + """One initialised DISCUS suite in this process (there can only be one).""" + + def __init__(self, module): + self.s = module + self.s.initialize_suite() + self._count = itertools.count() + + # -- running commands ------------------------------------------------- + def run(self, commands: str, cwd: Path) -> None: + """Run ``commands`` (macro text) with ``cwd`` as working directory. + + Raises MacroError if a command error stopped the macro. + """ + cwd = Path(cwd).resolve() + driver = cwd / f"_pytest_driver_{next(self._count)}.mac" + driver.write_text( + f"cd {cwd}\n" + f"{FLAG} = 0\n" + f"{commands.strip()}\n" + f"{FLAG} = 1\n") + self.s.execute_macro("@" + str(driver)) + if self.value(FLAG) != 1.0: + raise MacroError( + f"macro did not finish (see the ***...*** lines in the captured " + f"output); driver: {driver}") + + def value(self, expression: str) -> float: + """Value of a suite expression, e.g. ``n[1]`` or ``lat[1]``.""" + return float(self.s.get_value(expression)) + + # -- KUPLOT data ------------------------------------------------------ + def n_datasets(self) -> int: + return int(self.s.get_data_sets()) + + def dataset(self, ik: int) -> tuple[np.ndarray, np.ndarray]: + """KUPLOT data set ``ik`` (1-based) as arrays ``(x, y)``.""" + self._check_ik(ik) + n = int(self.s.get_data_length(ik)) + x = np.empty(n, np.float32) + y = np.empty(n, np.float32) + self.s.get_data(ik, x, y) + return x, y + + def dataset_2d(self, ik: int) -> tuple[np.ndarray, np.ndarray, np.ndarray]: + """KUPLOT grid data set ``ik`` as ``(x[nx], y[ny], z[nx, ny])``.""" + self._check_ik(ik) + n = int(self.s.get_data_length(ik)) + x = np.empty(n, np.float32) + y = np.empty(n, np.float32) + z = np.empty(n, np.float32) + nx = np.zeros(1, np.int32) + ny = np.zeros(1, np.int32) + self.s.get_data_3d(ik, x, y, z, nx, ny) + nx, ny = int(nx[0]), int(ny[0]) + if nx * ny != n: + raise ValueError(f"data set {ik} is not a grid ({nx} x {ny} != {n})") + return x[::ny].copy(), y[:ny].copy(), z.reshape(nx, ny) + + def _check_ik(self, ik: int) -> None: + if not 1 <= ik <= self.n_datasets(): + raise IndexError(f"KUPLOT data set {ik} does not exist " + f"({self.n_datasets()} loaded)") diff --git a/tests/python/test_suite_python.py b/tests/python/test_suite_python.py new file mode 100644 index 00000000..305b01b8 --- /dev/null +++ b/tests/python/test_suite_python.py @@ -0,0 +1,220 @@ +"""Tests for the in-process Python interface (f2py module suite_python). + +These run DISCUS inside the Python process and read results back as NumPy +arrays. Each calculation is checked two ways: + +* against the legacy reference file in ``tests//RESULTS/`` (the same + file the macro test compares with), which shows that the Python path gives + the same answer as ``discus_suite``; +* against golden data in ``tests/golden//`` (see compare.py), which is + what the Python API work (WP3–WP5) will be tested against. + + DIFFUSE_PYTHON_PATH=/python pytest tests/python/test_suite_python.py + +Without the module these tests are skipped (set DIFFUSE_REQUIRE_PYTHON=1 to +make that an error instead, as CI does). +""" + +from __future__ import annotations + +import shutil +from pathlib import Path + +import numpy as np +import pytest + +from compare import check_golden, load_columns, rvalue +from suite_session import MacroError + +TESTS = Path(__file__).resolve().parents[1] +SCATTERING = TESTS / "02.Calculation_Scattering" + + +@pytest.fixture +def scattering_dir(tmp_path): + """Fresh folder with the inputs from 02.Calculation_Scattering.""" + for name in ("silicon.cell", "primitive.cell", "example3.stru"): + shutil.copy(SCATTERING / name, tmp_path) + shutil.copytree(SCATTERING / "RESULTS", tmp_path / "RESULTS") + return tmp_path + + +# ------------------------------------------------------------------ basics +def test_expression(suite, tmp_path): + assert suite.value("2*3+1") == 7.0 + suite.run("r[1] = 2.5\nr[2] = r[1]**2", tmp_path) + assert suite.value("r[2]") == pytest.approx(6.25) + + +def test_macro_error_raises(suite, tmp_path): + with pytest.raises(MacroError): + suite.run("discus\n no_such_command 1,2\nexit", tmp_path) + # the session is still usable afterwards + suite.run("r[3] = 4", tmp_path) + assert suite.value("r[3]") == 4.0 + + +def test_missing_dataset_raises(suite, tmp_path): + suite.run("kuplot\n rese\nexit", tmp_path) + with pytest.raises(IndexError): + suite.dataset(1) + + +# --------------------------------------------------------------- structure +def test_build_crystal(suite, scattering_dir): + suite.run(""" +discus + read + cell silicon.cell, 3, 2, 1 + r[10] = n[1] + r[11] = lat[1] + r[12] = lat[6] +exit +""", scattering_dir) + assert suite.value("r[10]") == 6 # one atom per cell, 3*2*1 cells + assert suite.value("r[11]") == pytest.approx(5.0) + assert suite.value("r[12]") == pytest.approx(90.0) + + +# ----------------------------------------------------------------- Fourier +FOURIER_1D = """ +discus + read + cell silicon.cell, 7, 1, 1 + fourier + reset + neutron + ll -2.5, 0.00, 0.00 + lr 2.5, 0.00, 0.00 + ul -2.5, 0.00, 0.00 + na 1001 + no 1 + abs h + ord k + temp ign + disp off + set aver, 0.0 + lots off + run + exit + output + outf py_1d.inte + value inte + form stan + run + exit +exit +kuplot + rese + load xy, py_1d.inte +exit +""" + + +def test_fourier_1d(suite, scattering_dir): + """Same calculation as tests/02.Calculation_Scattering/1d.mac 7.""" + suite.run(FOURIER_1D, scattering_dir) + h, inte = suite.dataset(1) + assert h.shape == (1001,) + assert h[0] == pytest.approx(-2.5) and h[-1] == pytest.approx(2.5) + # a row of atoms along a: the strongest intensity is at an integer h + assert h[np.argmax(inte)] == pytest.approx(round(h[np.argmax(inte)]), abs=1e-4) + + legacy = load_columns(scattering_dir / "RESULTS" / "1d.inte") + np.testing.assert_allclose(h, legacy[:, 0], atol=1e-5) + assert rvalue(legacy[:, 1], inte) < 1e-3 + + check_golden("02.1d", "fourier_1d", r_max=1e-5, h=h, intensity=inte) + + +def test_fourier_2d(suite, scattering_dir): + """2-D (hk0) section of example3.stru, coarser than 2d.mac (121 x 121).""" + suite.run(""" +discus + read + stru example3.stru + fourier + reset + xray + ll 0.0, 0.0, 0.0 + lr 4.0, 0.0, 0.0 + ul 0.0, 4.0, 0.0 + na 121 + no 121 + temp use + disp off + wvle 1.00 + abs h + ord k + set aver, 0 + run + exit + output + outf py_2d.inte + value inte + form stan + run + exit +exit +kuplot + rese + load ni, py_2d.inte +exit +""", scattering_dir) + h, k, inte = suite.dataset_2d(1) + assert h.shape == (121,) and k.shape == (121,) and inte.shape == (121, 121) + assert h[-1] == pytest.approx(4.0) and k[-1] == pytest.approx(4.0) + # strongest intensity at the origin and at the Bragg points (integer h,k) + i, j = np.unravel_index(np.argmax(inte), inte.shape) + assert h[i] == pytest.approx(round(h[i]), abs=1e-4) + assert k[j] == pytest.approx(round(k[j]), abs=1e-4) + + check_golden("02.2d", "fourier_2d", r_max=1e-5, h=h, k=k, intensity=inte) + + +# ------------------------------------------------------------------ powder +def test_powder_debye(suite, scattering_dir): + """Same calculation as tests/02.Calculation_Scattering/powder.mac 10.""" + suite.run(""" +set parallel, useomp:serial +discus + read + cell primitive.cell, 10, 10, 10 + powder + reset + xray + set axis, q + set calc, debye + set disp, off + set delta, 0.0 + set qmin, 0.500 + set qmax, 7.100 + set dq, 0.005 + set profile, off + set temp, use + set wvle, 0.20000 + set four, four + set lpcor, bragg, 26.58 + run + exit + output + outf py_powder.inte + value inte + form powder, tth, 1.0, 180, 0.01 + run + exit +exit +kuplot + rese + load xy, py_powder.inte +exit +""", scattering_dir) + tth, inte = suite.dataset(1) + assert np.all(np.diff(tth) > 0) + assert np.all(inte >= 0) + + legacy = load_columns(scattering_dir / "RESULTS" / "powder.inte") + np.testing.assert_allclose(tth, legacy[:, 0], atol=1e-4) + assert rvalue(legacy[:, 1], inte) < 1e-3 + + check_golden("02.powder", "powder_debye", r_max=1e-5, tth=tth, intensity=inte) From fa85a9f4fab8e10d62bf85930b49d8c333bb0732 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 16:23:34 +0000 Subject: [PATCH 03/11] Demo Python API: read a structure, calculate a powder pattern, plot it - python/diffuse/: first Python package on top of suite_python. read_structure() reads CIF/.cell (with supercell) or .stru, Crystal.atoms() returns names and fractional coordinates, powder() returns a PowderPattern (NumPy q/intensity) with a matplotlib plot(), run_macro() runs anything not wrapped yet. DISCUS output is captured, errors raise MacroError with the *** lines, and inputs are read from a scratch copy because DISCUS writes converted files next to them. - python/examples/powder_demo.py + anatase.cif: X-ray vs neutron and crystal-size broadening for anatase; python/README.md explains it. - tests/python/test_diffuse_api.py (+ golden data): reading, supercells, errors, powder peak positions, reloading an older Crystal, plotting and the demo script. The test helper moved into the package; the suite fixture now returns diffuse.session(). - CI installs matplotlib; docs and WP0 log updated. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_018Yw8KkfPLawp8Po4f5Bc9v --- .github/workflows/tests.yml | 5 +- migration/WP0_Test_Baseline.md | 31 ++- python/README.md | 89 ++++++++ python/diffuse/__init__.py | 27 +++ python/diffuse/_session.py | 193 ++++++++++++++++++ python/diffuse/crystal.py | 149 ++++++++++++++ python/diffuse/powder.py | 109 ++++++++++ python/examples/anatase.cif | 101 +++++++++ python/examples/powder_demo.png | Bin 0 -> 178008 bytes python/examples/powder_demo.py | 66 ++++++ tests/README.md | 11 +- tests/golden/api.powder_anatase/meta.json | 18 ++ .../api.powder_anatase/neutron_debye.npz | Bin 0 -> 11330 bytes .../golden/api.powder_anatase/xray_debye.npz | Bin 0 -> 11225 bytes tests/python/conftest.py | 21 +- tests/python/suite_session.py | 116 ----------- tests/python/test_diffuse_api.py | 147 +++++++++++++ tests/python/test_suite_python.py | 2 +- 18 files changed, 950 insertions(+), 135 deletions(-) create mode 100644 python/README.md create mode 100644 python/diffuse/__init__.py create mode 100644 python/diffuse/_session.py create mode 100644 python/diffuse/crystal.py create mode 100644 python/diffuse/powder.py create mode 100644 python/examples/anatase.cif create mode 100644 python/examples/powder_demo.png create mode 100644 python/examples/powder_demo.py create mode 100644 tests/golden/api.powder_anatase/meta.json create mode 100644 tests/golden/api.powder_anatase/neutron_debye.npz create mode 100644 tests/golden/api.powder_anatase/xray_debye.npz delete mode 100644 tests/python/suite_session.py create mode 100644 tests/python/test_diffuse_api.py diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index 92e1a4b5..80ff10bd 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -1,6 +1,6 @@ # Build DiffuseCode with the Python module and run the tests. # -# 1. pytest tests/python – Python interface (suite_python) + golden data +# 1. pytest tests/python – diffuse package, suite_python, golden data, demo # 2. legacy macro tests – tools/run_legacy_tests.py, tags fast and mc # # Development happens on claude-python-app until the first release of the @@ -35,7 +35,7 @@ jobs: sudo apt-get install -y --no-install-recommends \ gfortran cmake make libfftw3-dev libhdf5-dev libreadline-dev \ libpng-dev libx11-dev zlib1g-dev pgplot5 xvfb \ - python3-dev python3-numpy python3-pytest + python3-dev python3-numpy python3-pytest python3-matplotlib - name: Configure run: | @@ -50,6 +50,7 @@ jobs: env: DIFFUSE_PYTHON_PATH: ${{ github.workspace }}/build/python DIFFUSE_REQUIRE_PYTHON: "1" + MPLBACKEND: Agg # DISCUS_SUITE is not set here, so the legacy macro tests inside # pytest are skipped; the next step runs them in parallel. run: python3 -m pytest tests/python -v --junitxml=pytest-results.xml diff --git a/migration/WP0_Test_Baseline.md b/migration/WP0_Test_Baseline.md index e398cf21..b5c31dc5 100644 --- a/migration/WP0_Test_Baseline.md +++ b/migration/WP0_Test_Baseline.md @@ -167,7 +167,6 @@ tests/ # existing macro tests stay where they are conftest.py # [done] registers the manifest tags as markers test_legacy_macros.py # [done] one test per manifest entry + manifest checks compare.py # [started] R-value, golden .npz read/write (0.6) - suite_session.py # [done] test helper around the f2py module suite_python test_suite_python.py # [done] in-process Python tests against RESULTS/ and golden/ tools/ run_legacy_tests.py # [done] runner -> console table, JUnit XML, JSON @@ -287,7 +286,7 @@ Checked: `discus_all`. `experi_kdo` calls `exp3_pdf`, so the f2py module built but failed on import with `undefined symbol: __exp3_pdf_menu_MOD_exp3_pdf`. `experi_all` now comes first. -* `tests/python/suite_session.py` wraps `suite_python` for tests. `run()` +* A test helper wraps `suite_python` (now `diffuse.session()`, see below). `run()` writes a driver macro that `cd`s into the test folder (the suite keeps its own working directory, so `os.chdir` is not enough) and sets `r[499]` on its last line. A command error ends the whole macro run, so a flag that is @@ -316,3 +315,31 @@ Checked (gfortran 13, 4 cores): | `pytest tests/python`, `OMP_NUM_THREADS` 1 and 4 | 9 passed (33 legacy macro tests skipped, no `DISCUS_SUITE`), under 1 s | | Same build, `run_legacy_tests.py -j 4 --tags fast,mc` | 29 PASS, 1 RAN, 2 SKIPPED | +### Demo API: `python/diffuse/` (ahead of WP3/WP5) + +A first Python package for the demo, built on `suite_python`: +`read_structure()` (CIF, `.cell`, `.stru`, with supercells), `Crystal.atoms()`, +`powder()` returning NumPy arrays, `PowderPattern.plot()` with matplotlib, +and `run_macro()` for everything else. See `python/README.md`. + +* The test helper moved into the package (`diffuse/_session.py`), and the + `suite` fixture now returns `diffuse.session()`. The session also captures + DISCUS output (stdout/stderr go to a temporary file during each call, with + `GFORTRAN_UNBUFFERED_PRECONNECTED=y` so nothing is flushed late), and + `MacroError` carries the `***` error lines. +* `n[]` and `lat[]` are only defined inside the `discus` section; the read + macro copies them to `r[490]`–`r[496]`, which are reserved for the package + (`r[499]` is the completion flag). +* Reading a CIF makes DISCUS write a `.stru` file next to the input, so + inputs are copied to a scratch folder first. +* `python/examples/powder_demo.py`: anatase from `anatase.cif` (COD 1010942), + X-ray vs neutron and crystal-size broadening, saved as a PNG. Peak positions + were checked against the allowed I4₁/amd reflections ((101) strongest for + X-rays at Q = 1.81 Å⁻¹). +* `tests/python/test_diffuse_api.py`: 12 tests (reading, supercells, errors, + powder grid and (101) position, X-ray/neutron golden data, reloading an + older `Crystal`, plotting, the demo script). CI installs matplotlib. + +Checked: `pytest tests/python` gives 21 passed (33 legacy macro tests skipped +without `DISCUS_SUITE`), about 2 s, with `OMP_NUM_THREADS` 1 and 4. + diff --git a/python/README.md b/python/README.md new file mode 100644 index 00000000..6200170c --- /dev/null +++ b/python/README.md @@ -0,0 +1,89 @@ +# DiffuseCode from Python + +`python/diffuse/` is an early Python API for DISCUS. It currently covers a +small set of commands: reading a structure and calculating a powder pattern. +The results are NumPy arrays, so they can be plotted with matplotlib or any +other library. + +```python +import diffuse as dc + +cr = dc.read_structure("examples/anatase.cif", supercell=(10, 10, 4)) +print(cr) # Crystal('anatase.cif', supercell=(10, 10, 4), natoms=4800, ...) + +p = dc.powder(cr, qmin=0.5, qmax=10, dq=0.005, radiation="xray") +p.q, p.intensity # NumPy arrays +p.plot() # matplotlib; p.plot(x="tth") for 2-theta +``` + +![Powder patterns of anatase](examples/powder_demo.png) + +## Running the demo + +Build DiffuseCode with the Python module (from the repository root): + +```bash +FC=gfortran CC=gcc CXX=g++ cmake -S . -B build -DCMAKE_BUILD_TYPE=Release \ + -DDIFFUSE_PYTHON=ON -DPGPLOT_DIR=/usr/lib/pgplot5 +``` + +```bash +cmake --build build -j +``` + +Then run the demo (needs NumPy and matplotlib): + +```bash +DIFFUSE_PYTHON_PATH=build/python PYTHONPATH=python python3 python/examples/powder_demo.py --show +``` + +It reads `examples/anatase.cif`, calculates X-ray and neutron patterns for a +10×10×4 supercell and an X-ray pattern for a 3×3×1 crystal, and writes +`powder_demo.png`. + +For Jupyter, set the two variables before starting it, or at the top of the +notebook before `import diffuse`: + +```python +import os, sys +os.environ["DIFFUSE_PYTHON_PATH"] = "/path/to/build/python" +sys.path.insert(0, "/path/to/DiffuseCode/python") +import diffuse as dc +``` + +## What is in the API + +| Call | What it does | +|---|---| +| `read_structure(path, supercell=None)` | Reads `.cif` or `.cell` (asymmetric unit; space group applied, `supercell` cells built) or `.stru` (whole crystal, read as is). Returns a `Crystal`. | +| `Crystal.natoms`, `.lattice`, `.volume` | Atom count, `(a, b, c, alpha, beta, gamma)`, cell volume | +| `Crystal.atoms()`, `.positions()` | Atom names and fractional coordinates as arrays | +| `powder(crystal, qmin, qmax, dq, radiation, wavelength, method, temperature, lp_correction)` | Powder pattern on a Q grid. `radiation`: `"xray"`, `"neutron"`, `"electron"`; `method`: `"debye"` or `"complete"`. Returns a `PowderPattern`. | +| `PowderPattern.q`, `.intensity`, `.two_theta()`, `.plot()` | Results and a quick matplotlib plot | +| `run_macro(text)` | Runs any DISCUS macro text, for commands that are not wrapped yet | +| `MacroError` | Raised when a DISCUS command fails; the message holds the `***` error lines | + +## How it works, and its limits + +This version drives the existing f2py module `suite_python` +(`python/suite_python.f90`). Python writes the commands to a small macro, +DISCUS runs it in the same process, and the results come back through +files or KUPLOT data sets. See `diffuse/_session.py`. + +* DISCUS holds **one structure at a time** per process. A `Crystal` remembers + how it was made, and `powder()` reads it in again if another structure was + loaded since. +* DISCUS output is captured, not printed. Set `DIFFUSE_ECHO=1`, or call + `dc.session(echo=True)`, to see it. The last output is in + `dc.session().last_output`. +* Input files are copied to a scratch folder first, because DISCUS writes + converted files (for example `.stru` from `.cif`) next to its input. + +The migration plan (`migration/DiffuseCode_Python_Migration_Plan.md`, +WP1–WP5) replaces `suite_python` underneath with a `bind(C)` core and a +proper `pip install`. The aim is to keep this API while doing so. + +## Tests + +`tests/python/test_diffuse_api.py` covers this API, and CI runs it together +with the demo script. See `tests/README.md`. diff --git a/python/diffuse/__init__.py b/python/diffuse/__init__.py new file mode 100644 index 00000000..e243a317 --- /dev/null +++ b/python/diffuse/__init__.py @@ -0,0 +1,27 @@ +"""DiffuseCode from Python (early demo API). + + import diffuse as dc + + cr = dc.read_structure("anatase.cif", supercell=(6, 6, 3)) + p = dc.powder(cr, qmin=0.5, qmax=10, dq=0.005, radiation="xray") + p.plot() + +This first version drives DISCUS through the f2py module ``suite_python`` +(build with ``-DDIFFUSE_PYTHON=ON`` and set ``DIFFUSE_PYTHON_PATH`` to +``/python``). DISCUS holds one structure at a time, in this process. +See migration/DiffuseCode_Python_Migration_Plan.md for where this is going. +""" + +from ._session import DiffuseError, MacroError, Session, session +from .crystal import Crystal, read_structure +from .powder import PowderPattern, powder + +__all__ = [ + "Crystal", "DiffuseError", "MacroError", "PowderPattern", "Session", + "powder", "read_structure", "run_macro", "session", +] + + +def run_macro(commands: str, cwd=None) -> str: + """Run DISCUS macro text (escape hatch for commands not wrapped yet).""" + return session().run(commands, cwd) diff --git a/python/diffuse/_session.py b/python/diffuse/_session.py new file mode 100644 index 00000000..c672dbf2 --- /dev/null +++ b/python/diffuse/_session.py @@ -0,0 +1,193 @@ +"""The one DISCUS suite that lives in this Python process. + +For now everything runs through the f2py module ``suite_python`` (built with +``-DDIFFUSE_PYTHON=ON``): Python writes the commands to a small macro and +the suite runs it. The planned bind(C) core (migration plan, WP2) will +replace this module; the public API in ``diffuse`` is meant to stay the same. + +What this layer adds on top of ``suite_python``: + +* **Errors become exceptions.** A command error ends the whole macro run. + Every macro written here sets a flag on its last line; if the flag is not + set, ``run()`` raises ``MacroError`` with the ``***...***`` error lines. +* **Output is captured.** The suite writes to the process's stdout/stderr. + ``run()`` sends both file descriptors to a temporary file while the macro + runs, and keeps the text in ``Session.last_output``. Pass ``echo=True`` + (or set ``DIFFUSE_ECHO=1``) to print it as well. +* **Working directory.** The suite keeps its own working directory, so each + macro starts with ``cd ``. +""" + +from __future__ import annotations + +import atexit +import importlib +import itertools +import os +import re +import shutil +import sys +import tempfile +from pathlib import Path + +import numpy as np + +# Must be set before libgfortran is loaded, so that output written while +# stdout is redirected is not flushed later, after it has been restored. +os.environ.setdefault("GFORTRAN_UNBUFFERED_PRECONNECTED", "y") + +# r[] runs from 0 to MAXPAR = 500 (lib_f90/param_mod.f90); the top entry is +# reserved for the completion flag. +FLAG = "r[499]" +_ANSI = re.compile(r"\x1b\[[0-9;]*m") + + +class DiffuseError(RuntimeError): + """Base class for errors raised by the diffuse package.""" + + +class MacroError(DiffuseError): + """A command failed inside DISCUS; ``.output`` holds the captured text.""" + + def __init__(self, message: str, output: str = ""): + super().__init__(message) + self.output = output + + +def _import_suite_python(): + path = os.environ.get("DIFFUSE_PYTHON_PATH") + if path and path not in sys.path: + sys.path.insert(0, path) + try: + return importlib.import_module("suite_python").suite + except ImportError as exc: + raise ImportError( + "The DISCUS Python module 'suite_python' was not found. Build " + "DiffuseCode with -DDIFFUSE_PYTHON=ON and set " + "DIFFUSE_PYTHON_PATH=/python.") from exc + + +class _Capture: + """Send file descriptors 1 and 2 to a temporary file.""" + + def __init__(self): + self.text = "" + + def __enter__(self): + sys.stdout.flush() + sys.stderr.flush() + self._file = tempfile.TemporaryFile(mode="w+b") + self._saved = [os.dup(1), os.dup(2)] + os.dup2(self._file.fileno(), 1) + os.dup2(self._file.fileno(), 2) + return self + + def __exit__(self, *exc): + os.dup2(self._saved[0], 1) + os.dup2(self._saved[1], 2) + for fd in self._saved: + os.close(fd) + self._file.seek(0) + self.text = _ANSI.sub("", self._file.read().decode(errors="replace")) + self._file.close() + return False + + +class Session: + """Wrapper around the in-process DISCUS suite. Use ``diffuse.session()``.""" + + def __init__(self, echo: bool | None = None): + self.echo = bool(os.environ.get("DIFFUSE_ECHO")) if echo is None else echo + self.last_output = "" + self._s = _import_suite_python() + self._count = itertools.count() + self._workdir = Path(tempfile.mkdtemp(prefix="diffuse_")) + atexit.register(shutil.rmtree, self._workdir, ignore_errors=True) + self.current_crystal = None # the Crystal now held by DISCUS + with _Capture() as cap: + self._s.initialize_suite() + self._show(cap.text) + + def _show(self, text: str) -> None: + self.last_output = text + if self.echo and text: + print(text, end="" if text.endswith("\n") else "\n") + + @property + def workdir(self) -> Path: + """Scratch folder for files written by DISCUS.""" + return self._workdir + + def run(self, commands: str, cwd: str | os.PathLike | None = None) -> str: + """Run macro text with ``cwd`` as working directory; return the output. + + Raises MacroError if a command error stopped the macro. + """ + cwd = Path(cwd or self._workdir).resolve() + driver = self._workdir / f"_driver_{next(self._count)}.mac" + driver.write_text( + f"cd {cwd}\n" + f"{FLAG} = 0\n" + f"{commands.strip()}\n" + f"{FLAG} = 1\n") + with _Capture() as cap: + self._s.execute_macro("@" + str(driver)) + ok = self._s.get_value(FLAG) == 1.0 + self._show(cap.text) + if not ok: + errors = [line.strip() for line in cap.text.splitlines() if "***" in line] + raise MacroError("DISCUS command failed:\n " + "\n ".join(errors or ["(no message)"]), + cap.text) + return cap.text + + def value(self, expression: str) -> float: + """Value of a DISCUS expression, e.g. ``n[1]`` or ``lat[1]``.""" + with _Capture() as cap: + v = float(self._s.get_value(expression)) + if "***" in cap.text: + raise MacroError(f"cannot evaluate '{expression}':\n " + cap.text.strip(), cap.text) + return v + + # -- KUPLOT data sets ------------------------------------------------- + def n_datasets(self) -> int: + return int(self._s.get_data_sets()) + + def dataset(self, ik: int) -> tuple[np.ndarray, np.ndarray]: + """KUPLOT data set ``ik`` (1-based) as float32 arrays ``(x, y)``.""" + self._check_ik(ik) + n = int(self._s.get_data_length(ik)) + x = np.empty(n, np.float32) + y = np.empty(n, np.float32) + self._s.get_data(ik, x, y) + return x, y + + def dataset_2d(self, ik: int) -> tuple[np.ndarray, np.ndarray, np.ndarray]: + """KUPLOT grid data set ``ik`` as ``(x[nx], y[ny], z[nx, ny])``.""" + self._check_ik(ik) + n = int(self._s.get_data_length(ik)) + x, y, z = (np.empty(n, np.float32) for _ in range(3)) + nx = np.zeros(1, np.int32) + ny = np.zeros(1, np.int32) + self._s.get_data_3d(ik, x, y, z, nx, ny) + nx, ny = int(nx[0]), int(ny[0]) + if nx * ny != n: + raise ValueError(f"data set {ik} is not a grid ({nx} x {ny} != {n})") + return x[::ny].copy(), y[:ny].copy(), z.reshape(nx, ny) + + def _check_ik(self, ik: int) -> None: + if not 1 <= ik <= self.n_datasets(): + raise IndexError(f"KUPLOT data set {ik} does not exist " + f"({self.n_datasets()} loaded)") + + +_SESSION: Session | None = None + + +def session(echo: bool | None = None) -> Session: + """The process-wide Session (created on first use).""" + global _SESSION + if _SESSION is None: + _SESSION = Session(echo=echo) + elif echo is not None: + _SESSION.echo = echo + return _SESSION diff --git a/python/diffuse/crystal.py b/python/diffuse/crystal.py new file mode 100644 index 00000000..bf4e2b3d --- /dev/null +++ b/python/diffuse/crystal.py @@ -0,0 +1,149 @@ +"""Reading structures into DISCUS.""" + +from __future__ import annotations + +import os +import shutil +from dataclasses import dataclass, field +from pathlib import Path + +import numpy as np + +from ._session import DiffuseError, session + +# Files that DISCUS reads as an asymmetric unit (then applies the space +# group and builds the supercell) and files it reads as a whole crystal. +_CELL_SUFFIXES = {".cell", ".cif"} +_STRU_SUFFIXES = {".stru"} + + +@dataclass(eq=False) +class Crystal: + """A structure loaded into DISCUS. + + DISCUS holds one structure at a time. A Crystal remembers how it was + made, so a calculation on an older Crystal reads it in again first. + """ + + path: Path + supercell: tuple[int, int, int] | None + natoms: int + lattice: tuple[float, float, float, float, float, float] # a, b, c, alpha, beta, gamma + _atoms: tuple[np.ndarray, np.ndarray] | None = field(default=None, repr=False) + + @property + def a(self) -> float: + return self.lattice[0] + + @property + def volume(self) -> float: + """Volume of one unit cell in Å^3.""" + a, b, c, al, be, ga = self.lattice + ca, cb, cg = np.cos(np.radians([al, be, ga])) + return float(a * b * c * np.sqrt(1 - ca**2 - cb**2 - cg**2 + 2 * ca * cb * cg)) + + def atoms(self) -> tuple[np.ndarray, np.ndarray]: + """Atom names and fractional coordinates, shape (natoms,) and (natoms, 3). + + DISCUS saves the crystal to a ``.stru`` file, which is read back here. + """ + if self._atoms is None: + _ensure_loaded(self) + s = session() + out = s.workdir / "atoms.stru" + out.unlink(missing_ok=True) + s.run(f"discus\n save\n outfile {out.name}\n write all\n run\n exit\nexit", + cwd=s.workdir) + lines = out.read_text().splitlines() + start = next(i for i, line in enumerate(lines) if line.split()[:1] == ["atoms"]) + 1 + rows = [line.replace(",", " ").split() for line in lines[start:] if line.strip()] + names = np.array([r[0] for r in rows]) + xyz = np.array([[float(v) for v in r[1:4]] for r in rows]) + if len(names) != self.natoms: + raise DiffuseError(f"saved structure has {len(names)} atoms, expected {self.natoms}") + self._atoms = (names, xyz) + return self._atoms + + def positions(self) -> np.ndarray: + """Fractional coordinates, shape (natoms, 3).""" + return self.atoms()[1] + + def __repr__(self) -> str: + cell = ", ".join(f"{v:g}" for v in self.lattice) + sc = f", supercell={self.supercell}" if self.supercell else "" + return f"Crystal('{self.path.name}'{sc}, natoms={self.natoms}, lattice=({cell}))" + + +def read_structure(path: str | os.PathLike, + supercell: tuple[int, int, int] | int | None = None) -> Crystal: + """Read a structure file into DISCUS. + + ``.cell`` and ``.cif`` files hold an asymmetric unit: DISCUS applies the + space group and builds ``supercell`` unit cells (default 1 x 1 x 1). + ``.stru`` files hold a whole crystal and are read as they are, unless a + ``supercell`` is given. + """ + path = Path(path).expanduser().resolve() + if not path.is_file(): + raise FileNotFoundError(path) + suffix = path.suffix.lower() + if suffix not in _CELL_SUFFIXES | _STRU_SUFFIXES: + raise DiffuseError(f"unsupported structure file '{path.name}' " + f"(use {', '.join(sorted(_CELL_SUFFIXES | _STRU_SUFFIXES))})") + if isinstance(supercell, int): + supercell = (supercell,) * 3 + if supercell is not None: + supercell = tuple(int(n) for n in supercell) + if len(supercell) != 3 or min(supercell) < 1: + raise ValueError(f"supercell must be three positive integers, not {supercell}") + + if suffix in _STRU_SUFFIXES and supercell is None: + command = f"stru {path.name}" + else: + nx, ny, nz = supercell or (1, 1, 1) + command = f"cell {path.name}, {nx}, {ny}, {nz}" + + # DISCUS may write files next to the input (a CIF is converted to .stru + # first), so read a copy in the session's scratch folder. + s = session() + inputs = s.workdir / "input" + shutil.rmtree(inputs, ignore_errors=True) + inputs.mkdir() + shutil.copy(path, inputs / ("structure" + suffix)) + command = command.replace(path.name, "structure" + suffix, 1) + + # n[] and lat[] exist only inside the discus section: copy them to the + # r[] entries reserved for this package (r[490] ... r[498]). + s.run(f""" +discus + read + {command} + r[490] = n[1] + r[491] = lat[1] + r[492] = lat[2] + r[493] = lat[3] + r[494] = lat[4] + r[495] = lat[5] + r[496] = lat[6] +exit +""", cwd=inputs) + crystal = Crystal( + path=path, + supercell=supercell, + natoms=int(s.value("r[490]")), + lattice=tuple(s.value(f"r[{i}]") for i in range(491, 497)), + ) + s.current_crystal = crystal + return crystal + + +def _ensure_loaded(crystal: Crystal) -> None: + """Make ``crystal`` the structure DISCUS holds, reading it again if needed.""" + s = session() + if s.current_crystal is crystal: + return + fresh = read_structure(crystal.path, crystal.supercell) + if fresh.natoms != crystal.natoms: + raise DiffuseError(f"{crystal.path.name} now gives {fresh.natoms} atoms, " + f"not {crystal.natoms}; has the file changed?") + s.current_crystal = crystal diff --git a/python/diffuse/powder.py b/python/diffuse/powder.py new file mode 100644 index 00000000..7f074d16 --- /dev/null +++ b/python/diffuse/powder.py @@ -0,0 +1,109 @@ +"""Powder diffraction patterns.""" + +from __future__ import annotations + +from dataclasses import dataclass, field + +import numpy as np + +from ._session import session +from .crystal import Crystal, _ensure_loaded + +_RADIATION = {"xray": "xray", "x-ray": "xray", "neutron": "neutron", "electron": "electron"} +_METHOD = {"debye": "debye", "complete": "compl"} + + +@dataclass +class PowderPattern: + """A calculated powder pattern on an evenly spaced Q grid.""" + + q: np.ndarray # Å^-1 + intensity: np.ndarray + settings: dict = field(default_factory=dict) + crystal: Crystal | None = None + + def two_theta(self, wavelength: float | None = None) -> np.ndarray: + """2θ in degrees for ``wavelength`` (default: the one used).""" + lam = wavelength or self.settings["wavelength"] + return np.degrees(2 * np.arcsin(np.clip(self.q * lam / (4 * np.pi), -1, 1))) + + def plot(self, ax=None, *, x: str = "q", **kwargs): + """Plot with matplotlib; ``x`` is ``"q"`` or ``"tth"``. Returns the Axes.""" + import matplotlib.pyplot as plt + + if ax is None: + _, ax = plt.subplots(figsize=(8, 4.5)) + if x == "q": + xs, label = self.q, r"$Q$ (Å$^{-1}$)" + elif x == "tth": + xs, label = self.two_theta(), r"$2\theta$ (°)" + f", λ = {self.settings['wavelength']} Å" + else: + raise ValueError("x must be 'q' or 'tth'") + kwargs.setdefault("lw", 1.0) + kwargs.setdefault("label", self.crystal.path.stem if self.crystal else None) + ax.plot(xs, self.intensity, **kwargs) + ax.set_xlabel(label) + ax.set_ylabel("Intensity (arb. units)") + ax.set_xlim(xs[0], xs[-1]) + return ax + + +def powder(crystal: Crystal, *, qmin: float = 0.5, qmax: float = 10.0, dq: float = 0.005, + radiation: str = "xray", wavelength: float = 0.2, method: str = "debye", + temperature: bool = True, lp_correction: str = "none") -> PowderPattern: + """Calculate the powder pattern of ``crystal`` with DISCUS. + + Parameters + ---------- + qmin, qmax, dq : Q range and step in Å^-1. + radiation : "xray", "neutron" or "electron". + wavelength : in Å (used for the Q limit, Lorentz-polarisation and 2θ). + method : "debye" (Debye equation, any structure) or "complete" + (Fourier on a reciprocal-space grid, for periodic crystals). + temperature : apply the atomic displacement parameters. + lp_correction : "none", "bragg" or "neutron" Lorentz-polarisation factor. + """ + try: + rad = _RADIATION[radiation.lower()] + calc = _METHOD[method.lower()] + except KeyError as exc: + raise ValueError(f"unknown option {exc}; radiation: {sorted(set(_RADIATION))}, " + f"method: {sorted(_METHOD)}") from None + if not 0 < qmin < qmax or dq <= 0: + raise ValueError("need 0 < qmin < qmax and dq > 0") + + _ensure_loaded(crystal) + s = session() + out = s.workdir / "powder.dat" + out.unlink(missing_ok=True) + s.run(f""" +discus + powder + reset + {rad} + set axis, q + set calc, {calc} + set disp, off + set delta, 0.0 + set qmin, {qmin} + set qmax, {qmax} + set dq, {dq} + set profile, off + set temp, {"use" if temperature else "ignore"} + set wvle, {wavelength} + set four, four + set lpcor, {lp_correction} + run + exit + output + outf {out.name} + value inte + form powder, q + run + exit +exit +""", cwd=s.workdir) + data = np.loadtxt(out, comments="#", ndmin=2) + settings = dict(qmin=qmin, qmax=qmax, dq=dq, radiation=rad, wavelength=wavelength, + method=method, temperature=temperature, lp_correction=lp_correction) + return PowderPattern(q=data[:, 0], intensity=data[:, 1], settings=settings, crystal=crystal) diff --git a/python/examples/anatase.cif b/python/examples/anatase.cif new file mode 100644 index 00000000..3fb0c357 --- /dev/null +++ b/python/examples/anatase.cif @@ -0,0 +1,101 @@ +#------------------------------------------------------------------------------ +#$Date: 2016-02-18 15:37:37 +0000 (Thu, 18 Feb 2016) $ +#$Revision: 176729 $ +#$URL: file:///home/coder/svn-repositories/cod/cif/1/01/09/1010942.cif $ +#------------------------------------------------------------------------------ +# +# This file is available in the Crystallography Open Database (COD), +# http://www.crystallography.net/ +# +# All data on this site have been placed in the public domain by the +# contributors. +# +data_1010942 +loop_ +_publ_author_name +'Parker, R L' +_publ_section_title +; +Zur Kristallstruktur von Anastas und Rutil. (II. Teil. Die +Anastasstruktur). +; +_journal_coden_ASTM ZEKGAX +_journal_name_full +; +Zeitschrift fuer Kristallographie, Kristallgeometrie, Kristallphysik, +Kristallchemie (-144,1977) +; +_journal_page_first 1 +_journal_page_last 54 +_journal_volume 59 +_journal_year 1924 +_chemical_formula_structural 'Ti O2' +_chemical_formula_sum 'O2 Ti' +_chemical_name_mineral Anatase +_chemical_name_systematic 'Titanium oxide' +_space_group_IT_number 141 +_symmetry_cell_setting tetragonal +_symmetry_space_group_name_Hall 'I 4bw 2bw -1bw' +_symmetry_space_group_name_H-M 'I 41/a m d ' +_cell_angle_alpha 90 +_cell_angle_beta 90 +_cell_angle_gamma 90 +_cell_formula_units_Z 4 +_cell_length_a 3.73 +_cell_length_b 3.73 +_cell_length_c 9.37 +_cell_volume 130.4 +_cod_original_sg_symbol_H-M 'I 41/a m d S' +_cod_database_code 1010942 +loop_ +_symmetry_equiv_pos_as_xyz +x,y,z +-x,-y,z +x,1/2+y,1/4-z +-x,1/2-y,1/4-z +-x,y,z +x,-y,z +-x,1/2+y,1/4-z +x,1/2-y,1/4-z +y,x,-z +-y,-x,-z +y,1/2+x,1/4+z +-y,1/2-x,1/4+z +-y,x,-z +y,-x,-z +-y,1/2+x,1/4+z +y,1/2-x,1/4+z +1/2+x,1/2+y,1/2+z +1/2-x,1/2-y,1/2+z +1/2+x,y,3/4-z +1/2-x,-y,3/4-z +1/2-x,1/2+y,1/2+z +1/2+x,1/2-y,1/2+z +1/2-x,y,3/4-z +1/2+x,-y,3/4-z +1/2+y,1/2+x,1/2-z +1/2-y,1/2-x,1/2-z +1/2+y,x,3/4+z +1/2-y,-x,3/4+z +1/2-y,1/2+x,1/2-z +1/2+y,1/2-x,1/2-z +1/2-y,x,3/4+z +1/2+y,-x,3/4+z +loop_ +_atom_site_label +_atom_site_type_symbol +_atom_site_symmetry_multiplicity +_atom_site_Wyckoff_symbol +_atom_site_fract_x +_atom_site_fract_y +_atom_site_fract_z +_atom_site_occupancy +_atom_site_attached_hydrogens +_atom_site_calc_flag +Ti1 Ti4+ 4 a 0. 0. 0. 1. 0 d +O1 O2- 8 e 0. 0. 0.2 1. 0 d +loop_ +_atom_type_symbol +_atom_type_oxidation_number +Ti4+ 4.000 +O2- -2.000 diff --git a/python/examples/powder_demo.png b/python/examples/powder_demo.png new file mode 100644 index 0000000000000000000000000000000000000000..ef92e8bf81c6f53447a2086fc13ff7fddcbaa239 GIT binary patch literal 178008 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

gR92DHUUAf-epuv~2c?s!0%5DyaZ%m7_>1E?4 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 z%0DV?c3*&@PhHJs?$zB!V=eLfCX(p}ZIPcMN#9AES04M^4zC&yTutnFSD*N$hjj%0 z?cvVSZ(}xDxF5IjN}_cJMuj|pbq@{;BdwU2vEBrM=Byn*@`h|3QYQu0f};z`a^PsC z6$8$2zrqTVrx58YeEK5;Ru7`-P@0`zY~&-TlyBtv3|-2G^YiTN(`5`YR31Av3hgE< z`%G;2rHvDEDY1iN1qHMX4U>;tC+L*ijdk|i&3X4pdD9vAFi7k4-*Uy&U4twf_IyoK zkQ(^Uy$}=D@;!7F(mHgwipE1X6*Poxz(2HjoNXsLZ?LiPoDPMC?N4o3{hR!D zRdn~6=qFqWk+CK9Fc#rQhmdzz-Kwk0_hf)c{8YsJ@#MD;9+;y<-1O8Z8}~DDZv<~0 z>a_2I672U;!$H8Bwh`&e85ws&sc$~kP1n1>!{jc*yI4MdwA$LW(&K$^Os)O5McS=9 z{CxY5wo^uR-9~M6g18l3YFsOfrNdP!JcN?iQl;8z?Yp>Ihn19N4eUEUqn9;x<_vsk zz!B(5Yuh1t7esE=vf_hi4aS5>JryR#*bDT@x#;MjSdh<=AvfYn5IJ$6vWiNvek&oE zq{U24Pn$Ji&op{Ny6gveTX1ltg8c!UMeDXxAl`2U5|j^oM6hQ2lG{w<^Q7KEBR`}S zC=9-w`0o32m0tmDB4Fazjg`_?vEh&3X1Zn6bTqO#`J?O7aE%tCS1`xp4by3QA57Bp zEamdc+FyFFX#@v8Qgvc-jFf4)6hPSNyx+>Hx`7^5Mx8#pW0yu5CYjnL9r zKAhs6Pt5&LR8pC>b6Sdx!^vnE1FpzDMZ z#E{O?)o0d?>YJl61v_q}9}^Gpc}b}~6050&DhS<=@(*_p0#dfWS?8A_5l#*BhBu)hx% zl92sD+fnr=w-5Z*Z+-){m}T02h3=t*;qrcZ<+CEJzTe6Fy**a(Z*1dxZq!-m1#sDY z9%~Fvq=;(pd2=gD?Jw^poo zNWHUhyuINoa`o_yEpC6LMUX4I+U))7+c~W|D|*S6X1F*dG{$O9uk3#omvTKkvBd_( z&X=xM`vB0kmJ#3$#U$J9Q}@s7v=)sP*iCNFcf?@2ee}cl?zbKgU9Uet)iB_V-t^&2 zrzDQ$Pqadp{w|TAo6{-%uLSNIPGL(X!*+EiI(kr|^Fjn(#4x32=vcD`xp;-1UB``s&HaM43_+{>VS;Lv#u|!i*~Onb zS3LAy4Go3@bJhId16^`XR$09fKz9+3`N2x*%w0nNib;ZpjeVvkr}Y|NhhkIZ3OH|0 zX9A6q$3#N3jW8TqoB`3n6~EMB1{o83r>+lAut@`1&)8^P?!4mJz{q`i>`;36Y<<)H z5G-s>(}WNATBPb;mWIKRWYTtQvZ51^E8Mhy?hi(8**9xzm4Y&x4}Y02^5Tb@9@}`7 znGk2Y#YwI_MC0G(;xR1oBNW>cbboRo=Zr+z-So_2xVGIDt#H|vG?b8*C_qCxXq7hE z0L$0GGHvS5tSBa>hpA<2vh|MHRJE!U(-U=Ep1sd;2Yo(3%m}{%!*me83=|}M9TiWC{dJ4+dJ*T3PtduU2w!A9r&X5ORp~l4&JtspAo3%o zXn;5gD)sGo&;Ujgh=Vli2OXP%lI3w$Nc9Jf{0@J<&C_D*rrJGP9(?%0=JVMwr+X$X zR@^$1OnP{s1kM zaO1HmAP5yno_vGkAuXlH?NwNqY&RNtcyA}Ia~CxmFjse zm3LTw4bwzL(TP4trH`)%PqCS26k^jqafX9dF0H(2B=hN0-$tY8d}@j-IUHlFFN#;z z-cvH`0idmBBYN$G@os+E{_#q|iYz<-xdHF*^G-7|ANS#BPfN$7k8`dZm1GN_fLn#O zubO4!q~NU|4IZ?*wRHWHzh>2C=F$zOKePW7rL?vQ6Z%KJUf|oKo+aNrR995Dk^7#< z`MsROcVDtd@?=kfW4(iB4vDR&=h%PAJpI^}Y;9yh1`DHL3O6A=!EqrB@X532Q!PaW z%KDLkTvoD9T|cXv$Z}eYoPA0iXV17fL%NK^!|gBb7Q+5M_xESJAH>#_isQ^%SlSMLG~>KfSoOlX5JQAXT=&2 zPc_)Dn)1rQx4c&jUomiZE8)px z;*R)-!}OyE%_%f^+@n%DkM}ju$Sv;`ZTzAuH_`o_-#op`DSJ0ITsJF;?R@;ChK{#R zGQ}9&s#ni8%IPe8^25K(cqRrkSLQcctT57_-+EtL`?Sg8D9qiO<)IL5`kA&xsVjbA z))PQ6{WLW5+jjairt-NkM2VIroQC{{3glHOLx;DCB!8n)YN! zV6wzj`zw5We2BCM{1|yKA;HR}@P=6)t4SnW;cfQ<1nJUg*miNDA&cgbJOfBpdPqlP zlwhx1yHE|r5m=1r`cF1t3ca?w$MA14C!gLl`i7n3&fPG&`|2EVpEkCv=kT50JX}4) znmiyonMXzE9=wZf7gZH()}VJaRFyZ_-47IRfwcjVN|mo&YHo=;F?&cWDbJ<1uVLvq z9*{(v4gx>!b$N(e?hfr9&cP;ZoWBuRL)mAuCKy2AKCI*YmZO$BZxfwzgoVNrX>@jv ztog+b4k6yDd!r#fqpKc62Rnd3kVdXTIP%vp&Z5|S={cWEr~r+QOp($#l*+2uP8x=g0NuW3z?Gt|-`a zWe5r+BuvC>%yD&C#Gwp#6LORoSyevicXC36)0xbc**fGPx*(bbgf^TFzX(O1Lc+2s*M-d}UV zzkI`A!3|aFGTjv`{c&NTv0Ofu$kR}muyxAfoKF;5WYwBBOe!3^E|Z-?41U9q(8bg* zbB1f{Hb*6wiUeWj_VXOuTOEc$xwZE+e2j2yCU6X zOLmtY=P6M|Y;zXA1TX0pLB`V@?sGcxv_q zco!mi+^2HimV&AD$0xKj2*4Rp00L3UIy5By(VNnMpY5QDuYsH^kb|_fNw+MKLepkcHpTapyx7DTr=OZSeYMJL4 zX$O^3A61>{r9`H0%deabTueLJ%ee)w>z)fsn=wPf-hSp*{?!~crCoaW5e&`E)${CD zn%6H4QvA(d#YK@*1ghECQ0Gq;mJF{+D6>}`Qxxa+eV=NL+Hd}NJ6(Qpq&u#Wt8w}N zvGkQuQGQ?BATTtjfHbK5lx_iO5$OhL>F#bANo7`nTAh#`jVp*!E(|MPzF zgKN2#bMA9?T(P&%Gq!8OX7_yTXQa)xp$^?mgSl|KbE89coQX0r4DNsdAedX#zDnoF zn*uY1<+7Fnb5a6M#;wq8_0ZLxu(lP$QwcSJBLA78W5L1u3kcN&>nu8iGU6Jx^Bynn ztlsFtRgJX?T-z`b_YY>U1HtjJj4phD9)>C)%MQpzWtDDAho{0v(l%&P*J1CHkOA2U z9<;idk)UwB%2Og21l7|zk=mQ42rqp}!Tw!iCUap}{>W!zrUYBg-+6Q$zK%O?>36s@ zDW7T@seH3Qv))vW-`-X(KdEN}nQ9pp_Vy?g50Yi932&D1?b!620w%KUGHA{AaPd@I0EEi3*Ffhjfni{#_Bq18e5^(Ms5ud5L= z^y2?Ho<4-K2Nscqkfq5Zp4l>Tkw7v{TK;Fm*uz1{2oMAV27Pl8bTx<2EUD0Gr71SR zK~q`Ypx}M)__Us6$J(L3{)We@B4>C#^oG6jKG|rS%SBg~0Pl{3>ei>aOh_Iup#aA2 zGNx%iCP~U)DYhU^7=U&C&N@|kLir_qb&Ge<5xDrV2u+~249 zv%C0wG8dE{44BUFej0IwdDfq>5xHh@tfCiIAj6vA_v!mgq4WJka2!B9;2B&g>4~%J4R!_{8jM|H`0G@*`z5%S%#mN8n?iPwGk35Nt0&d8u40e`?|#MoIr3rHRrCe=u^Gk;7vI;_8hCD z1=O$E46Y2Q};ymYEwCEh|e{1*PwfQ?m(sEubWf?^QOxcZUtxyb>dwV zu%`{v8-9t?1vqGT=CzaqfsKhBMXZG-<4*xRa{AG;D>4s^faJ&&iFng}n9AuK9}J@mj^M5CKg%>mZTx-!Yauf>5~en18Q z1Q%wuc}Hsqwq{68xOE+$FTJdMD0dbw>lg4NElV~*tWq7yon2ae0Skfj}p`3Ic|G z%l=dnFL4miK}tIHbP3-#&i6<{WV7Jo_~^lrZJ{fCA9%?_F%JH8tbbzIt@ z{kT2PKdjXXxg;pD?uj-$FKJ6J3#1P1EJS<EnmyJxR6XmwNXPBvzGZ#r`(zRA?`nSS4+@bf?AVF$fuF>MJR@E zt*M}4t-Z+kt~1aAHdIfcZjrr9&#|>Q9-3=-xz%D=9^-?OVMO!X>3(Va1f`HAK*=8a zsKGd@q~4vj*JB41r*)a-nX+_Fd!NoX4C`jAtQ$mj+`FZLDO>~;ri8LK%FZN+Xb z{}rRgv{J(f15c@sFCF9!Mj5WHs>z#OKPBheK`i!T0P|*peaC=M{5`rbb219S6#K<} z-3pwaV@tN*lCo8T?{&t51ZxXLnmnyIFLBBd;*b~Aol1Ro>~VFoxO^o3@kw-i^Api` zc25j_K{S0~eBRM&r0jr{mHABVF@4F`hWZe*$Jpj|z094c!kc3)X-bVE5P3aj)ZJsq>VykJEYxd9mv>V4=sY`-J+)lV&zA6_La5}>GefqRh9fb-c5I0vl zlW1sbKR%jbC<2U1+KNWUhE7#^Y2$g~>ACk>>r@{w-UHV~_l(zZ0vEyk&xCU|R*}-^ zX@d-_mFo^_lrrqZ(J%eg>_da%8;B}tj$k6et?4>`d+`Ewma_@a?vQ@c4*3wV!Cqo^qNcl$i|Rglg5?6-4v z=O}=Q?EK>D)wE z{8ZW2M_nK-Ui%Pwo(U1zd)dezjhj58&khHkEw?+h^PeACgP3|`V~y#WT!+ zrjmC5Vb#om@`(2uQGcujgx=0dy8ao+)m=j6QaM<7d^cDe#FKh6_Sb%cY@39rbOS(E>u(@R|rVHyHN z>tONy0@9n>j*V|5WY0YGC9XjjwcIfA2E?J-VqzpNgP=gfynM`$fcNS74bPWJzz}R! z0eM}g+pTC55;tG;^S^grwkuo#66kNEFn5wIARx9TCxN^`a_Y1*v7uA z#Q8iD_+pg{Pu#guDWUAB=QTkSK{(CJb9dx`&ifazpm+nlpv?csc`E*y_)%%u?Va>c z2+?6MVvJkZ)ul0&5Kr`u=pMo@{~*e+Y`T!fQc|0II#-j3a*r%Ex<~v(BU_@2N$es@Ek+uAYs_9KA&qo(kFA%RWoiY`(COijq+r8HgB zHpnfq;}NJ~MJ)eiRVzDSagG*^S|ZDInv(cp>a&B;k4&@vP>8 z(4hFzld;S?ui|f1sTh^}r2rm1vvl~J#%&|;uW=u7Wp>Rg=c}bU^Iz*m9K;lWc-eE# z`07sV1}}uPy&>4*%i}XQ2CGy#*gsVg%iikFEQpG?S3!KB{@XY#O^M;H{ml=Ca0p(^sB3WGbky3I&uSXo9?x74 zFj@a^&@48veL>~??A6osdU-?OLTPvq07{PF6G+*?3SoWajOM~Pn}TmDV&)}j71n7! zsFy5&gN~j^mZ0B<0293R25D$L(eD&;46wVzCFhH`F~O}?4< zL1C5`X!TTzKnH#`7J-5VevvwvWvu^eH=T0 zu+;~YCG>o`W$^r|)c!Ns_C*@&5VJ_g?o}6eSX$YzLzc~L$}O|F#XG9uJXjrvL#K!1 zNz?ezck_pqL!c!A5^}Nda{JhgrFO#zZKOMv0|ySETb?# z3OEOBKQ0jeM&e1!C6FO8x=ThR66>wy+p6vDtnV`Mj~$>of6GR@VXb|^bRBpA`$GZ0 zw7PEBuSorMP!{+|pN{(euVJ@D<&MJKaapRWe~15-t{cpF`fDf91z)__mbyR3c*OZ- zsqm++W<=Ut%_tAVf$X~t!m$<-0ZO%JQ_CiLfCUBs)#tR72LJ<1%~<&4cwuBM$EpPP zuFs)MemM9TDVBX*C+I55vQ`iS4W9_IR41-|K7)7=L2_TF)Kl$)T>Fgy_L{ja z*%{c)FrhcxezIk=WUFX$|@|K|C ziH`Z&X`>J2r&Q=M52I881DX0ZU4yfvQUYrFR>#eVKPm{u^KILs52HW`=A-<7#3g04 zU-VsUmJ=o&cPFq)Us{u3bM?VQod>78?BG#7kUVvOcSc(2CdPS`0;=pFs_NatS(RYIJ|)h+=?AQ zSDMod;!yuEF+D^3771*ukkt0Sx`S~$@h4sE$M%p8xuXZwri`CCo?%qFyt7TiT>yF~ zHS)c(z~SiFIKouqNEoSbv}H}p4|OB{LN&{Zv7C04{GA6cBuhzdWiBX;j?0eH`&ztD ztAwoV#B*Lt3;R1g8FE*2Yb#gQT1fxb0nV;K42MDAl9jhByVuy)xbhpEaK6qMhZ&KX z)$cXDo&p2~cWHQ!DJkvPNP-Y(Vr;DGt*^y~_~$C}(3A|Tpy@Q6QQ=C;F)%bOXzlGI zp93{1^(5{h+gV33_XHK7v#yDE{5b5$Kq=}9{0CA`A-e_Mk12-=-lHlH3lqF_sd{EG z-)d`8z$fgm;C*nq-fP?}!hK!(+a06;=zsoQ@KvD5leI4Cz4Wc#bNom)&Kc2QgRAwo ztcI72+E>7LhCsHieeJ2eKjKm-rvUWmf$^0@d^?U~t62J;H|^+$XeU6A92ywjwm9yY zOz5jv*0P7VAyPCjA#6VfUp`aYH8Ers&M7;;o0tT#YnRd_GS^AeS(pdIFZc}JRJ|Y2 zMN0@W!yq53O#&E%OL8y~_KXdz+D`IIF^bPkT|&i@dUW4@wcD)^!^}~6`#KMjS-=$2 z0An#0xF&#)ALtO~ziE+U$=awp>Y3vQe!%v5; z{>x7fP~vyuWHt(G!uofdoPA#Pfs zKTys-+o>)*ukxh+X2-*l&Zd;YweG02P6E?T8_u9RiB5IsoX_wdTc3 zH!P?1i@@Fl9K;J9fWg037pT9L=f3{Qdg=SsR3|0%H_8!bHWjqdK1r`L%QQL$Im#G1ogE22Pm16pJK${ z)M1{}&Tjm+M^>v^WhZtbLHuyR(n?)o8e-XAlfIBa@zZ* zLRLCJ4IW1fv|aDY`B`axv^axGW6_z44)^Z!E_62y75(3w-%|q@Xl$(v;LMpSlx(M zJajXZ+;p?n$CJTd%37D@^<&=IA*4WtJU`i8y$IWU$RnMDmytxaE`5Al&CZ?~ZV5&* z@pc%yrQR?htlYJLK?3rdk{%%X|J*DrtsJf&4FN;3YLx=iijMY_W>GL^IN^(XlEz<8 z7f!k$a>tD#P9uj2$*Jsm$FidCrPl6)@%ijXcR-I;!|eE9ih*YGY6*+!Ni7rn&V6!1 z`+L_m4^kMIQqam`=baksbA1yQL)%{5#$7|J!sjCk?=IFoTwVlLlTUQ-(nv z!4?3sk?4a7k+E{TJUiaAGN0@3dJKG%#pF^xmHl0;VE%>@E1T#jEHN9Hx_gWya-1Fk z!q*vVnr*QppvmlF&;3uClVY>%9Qn{OHmZsN!3QAZAAofZ2t2MsHspXq1X!(fZks;3 zm$_NGs1Iifo&d_Ve@x!Hk2{&P-V#SSiu3QumQ*|cqP<0+aZUpCpS#$`@ zW4vt_sh+pgCVpL9Q&#(NCM;{>c=avO2K7=Kb*A&>?ai9w^dVQE@STrE3Ua@ITBqGc zH0gLS9KBp__#K^D#nW5!>G`eYe2b}9n?-?oCBtor3t%pTa$^_m`d48K5>nq><>&Bi zUUjBFPjg6tqDv$-n=WJv$!}to;jt+XJ6|5p=kB~KTshPn(s<^ z=qYtRW>d-B*9Ln7N7gH~Z|O%XF?=v-*ZADYFqp@2b> zadM0YY?Qx0FX)oV>%Gt78wt~6HtM39qOWyi^?e{bOI$#cG{6DqxNZ1Q>?i;r1K%&5 z=YQ+rx)p)PW+)yw9|YqRgf6!_%)DA)?J4*3k#Q5mVgnN{w*YA~W#JUFy&f|Mfo){a zWH)(cxQJM3L39j;Tv6vv`H;eFNBw1jiid_hkF9!y6Rx%^cpF@Wd{_P; z#04JF)kSF+YdO`~&^Sk>uGVU)&e+tIoXHq(A`RCB&8^ZD8D+41yeK{-Fd=h~N><}P3`H#Zne&&R}!#6v>tK!<=uE4b4NirLfG5wZ$OdaftIIdU7A(SL^0+uHMGD|4K$`v%@$K0oEOu{ zD%!--K4;9>CN9HNf7g|x&890^M5p_;1XYx9HfeGeLsHI$C55Hdo&3_dc0Q{dtVQFM zlq5zFd1^8LD0FF>*x=1*_qO8&SsA74q>kI>HKyKkGGU!>3efq`CVe?uN6M>aA;k*E zSxl@Li@)7&`bC8AT-%mi6vmK2)$Ptu0We zj$%jhc9`j=#}Vir+mCh!qYP+nHk$umrX+c9dm~CGYDI(dNBe24#l+R6SV%h z18~59hCvM^XXDDVt_Ru~+S*6ksoSU*Ml({qvdB zymw_xlMAL&2CAr%@L_ZZGX@EiI={_O%BY(8pcpsOozVHjdUW`CALdz0su`P}lx`7j zq(I4&%@R1e(eRh+(vhWdf+$FDzuF+ZqyQ4L9T&uOFiP{o1vD8^@^_B7dC~Pt);Imb zFHXOgEk7u0nEbAX%m0Y+Nf*`-*Wj;`kaEYhR=;S6b>(`wNW5H_l9gdCeOrzn)@>)K z^I0X4++V4yXlm!e{`sU@%ZD#2pH#-@SQjr&XsJeqHx7%s>e)n;S);D7HI=CLg{Mnl z?jl~z3vrwRAKvG9c^n^W4()_3KO;{!95bG)mL5sS^nddOFMp`U|K;AkqLEn{WNc^t zM&#{x;6NuPY7hnQRM;VNah&ikF&*{FJYDqAN)ywin$#5F#JYPLxD5ywqzKur?F+qxF!Yi7xT3=YquH*>>=RQnW zPR9#w8xMUC=C}S?T+JmZ?ze<};v}WAGCm*-S(u}dGW_r;51Op`Y+FeR$_%Bbj>>Re z-#r@djmFnMwVHZe7A7X;nsb|V7;ZZc1O$|N%l4ucM%}lIW5Kvo4~}h1sjxja92fQ)C90mF%`(XM)o@qmi!PH zst&8GAg%dmh}2b4B9Av=|3cVS^{%g}XAEi@dAk;d!$0kB1(tK z=?LpP)(XH5YDc6qRa2`m1BgV*mT`KQ!WjA3u#Lna-5w;oC0DKg%sCHWHh{ zPrB$k{j#czw!vE>idix6JMHvQpXebR>S#NzqJ^3IoMyM5Y=qIpFJDW_`0xCUSw$K( zPgx?lUO8`3MVdnG`=a(9W~cH-yoxzPcHhjoiaHUFG#Hp%|NYS4Na!U&War;@XFZ!| zngT0YUG0S+oym{d>{7>2`yF+kn+Ii7cZ^%fYhJH!6W`+RLWwqzl4548`-F8P*s-E9 z#40)_Z@T-U{yKFOw22cnhItZ^?nU+FSBlJE(A)Cn5u?>NHJRgQ%tQnvq+9U+wme z6U=*8B~Jt)GHiN^keOCcIJLLl9|A|mzqgSS1j@36&yoE>9t=G$B8?pKZus|iS~*4lnTJWn=Z#EU!-rk8e-o4FB<%m zHmu3qOiHhuCs}lbzaPpr32Gj<;UQz?Jss`P2jf$KDbMSl+d?ZhL@KrQT5^dt>DwQV zrjO{KU{D(;hQh*qPBbqZ@It7cCt7VA;D2rhIt7`DC;~WP6&%TR=#n7rH zl~x}%$ICCb0>C9_41pmvwwmY^sPDP{*nDbIk_s~!TNNXX+_>hNa!{#Y8$ftm0%7#F?R4ee$4V5R9Y%B)ZQ1TtsnCoPi68OwN^Oz|CA=9cKDG1>Y2(na;Z6%x{bSb5AT zr6Lx#{qDx-BvM%1bDs%iQcNFFuJ)~1`j@(gylbik4k194fJE7@_65nx{ORhKD6&^X z(mBb2&X5pfG!a^PB@YxmUGL5N{)obW+JTwqBZ>fWG-hG8&^x}4{-$ZlOSaIM(O^*o zM*6-_8P2~Lkiq&N2Yj@OD%Ev_(IFDo2^dSfhwdl2e=XH^5eWgp&q+kz@Z?~@&A23}h2{q_S!Kfms zcrrr^w)o}w3^?y2qHyB#Tx!x^0+-}V`mc6NL7Pz^$q9E(i$EBWLaQ^Ips`Rece{O{ zgF^@fY4Sc(_^lY4;j!Cucpr4%iJ{`JvX$xr{uhtfcFSZG!gC#bsD_UpuZ@Lq)tsk? z8`pMQYbc+_e=0^*lk|(pAs$igdw*OsDakg+3J=A!kT}_PvMv|SI!I-G40jCR9bsL# zfiK;BHF?Kz zs`wSnX_N(0!A&Rf(xW9w+$-^7%*;kTg{4%6sT9%1ttU{Ai!yY%ZR8?WDX&62L#66p z+gN&A%kk&%;=hsut#$$HkBg^7!`IIjA6`4qvSi^S7IDnB70ufQjMsw^gxrVO{^M6S zn|NTScP9FGnGH74$~MpjZ?Auk>!aNN>f~7LIF($Gq)8ePS=ktwotMmV;DK{_X5G&L zhjO!%+Q?T3MBWELv?7ib9(*c)y-HKrhRhQZAW+|s6ekSI(`~sUfg$4Q2xDf zfi3E4thQ=b-jTz~5-f~U7l{{rxt%$G!s27<>lZrKuyJ_egu=4;OHn&&e=sleH(OJM z{~!PK^NrHGha;OXRQdfqt{Lx;5A)@DWw3|grb#`unNkK>zY5rOIV$q9-mQ%6Wz~X+ ziK~S-<2#u7y)b^{0nNtw!<`RB3a>Kt&UsWk+`RN-Y}mYYfkleaLnV_1e}x6sV-_g9 z*m}P@e?iR|OfqjKxp<+|+Y8m}wR~cG+^M0!VYX2^5UYT7RHm=4E^!>bfp%`L#O$5l zA`G6z?}z<{N;;{t^7&SU)M>oSc3gwzR3!lygwtl(yy{O>%)fegGyq+4LEBvBOfEYn zTOKjlSMT(wQCpDs3+R*#z;k0k)vP5$U9{$Y}GdsjqRLGAYC z+EQqHk4fJ+-5ME%Kf?mRdRERB|Be!R#v8AyrI1n~NW09DkWC{L!yG0FaWQf%X4RYH ziv;W417ZBMVpFDEU$LYH2D}3_$o+)n>w?8EVrC2GsOzg2L&pWq;i$@`bul=EKdi+C24?_&-p?seJ)WYG&?M-&Z4LK%7N7BI4{C$AMOc! z(Ss4D?JB~@|M=S`VM8Rq*>-D7K7-g5|6Y{?Job&dOA1A}9A?SnMVx&8pYMj`2vzNC zI5-AlD5d&Pj^PeJi8TZ~s%+CE$k3Bp%fM}0>eBl2k2YEtLes?JmZD@=j(4J9qDkFY zzr`#8UBhY9zfOqG%nkLF9rCTNF_+Qps*cg8am0irltRC`SrjFr&g^)5^(|?|&M>uW zf^ePsZbM8{mcG&6Q-oitT{2W%OM3`aDu3--zZ^djXaoE7D)RooeI?Zi%b-1+0oIQ3D_&_lBt%1_Oh^Hw>6I(1(^6O??hdbGOt4w^pU)Un9L`zoNI4I!m&cc!%BN(|MY z{MoRF*jw4D9b&PKalTcL{xsjtAo|%i1HlY^w|LQb`|^_73TZIY{0_z$Q0#L@kTYq; z6X~7+oyD+N_zXPt-5#F$U8wxdlDn8=nMN0sE;n!{d5RsLTYHhZNMAZ~YaD}oArIu_ zTqc*Mq^a!$^7%}aP)RgW!77b~$$FYS#Kl&^)P0l{bo|KK(~ zQK__%a1Du(-=AkjEyHj>7Gx%HYRno;&x$Jr z(5-k0IQo{Y8|Ng38?diLQ&&Rj$ZrlMS+$xg}?U)M8jrsgoT95*!`)PUYAVwBm5OtqHNanTK>G^2mZ~x zIeq^^nL>5NI^^NT-r|)H+>z_ys;LTPn-I#cM%RQwd;tK^jFAH zEZgbve47GBQ6BYR5t=#PnZIw2_SK;p2jM~4ecJ9BOF!ohaDW3eR8U3TkH;Nw{(8#u zUw2>TLT``r_Kg#DesUYo-_^beoN!OjF9ou3a7!9B%ifE^Tc1Eb59$Q0&h6|#qOb>W@7C7~l!ule}lv&gvAn4xHq}X(xGd6oRkCO{OPjmv-~C?A*^453y5q zw0cI*Rb6%Pxx;D{Qk~_Z4ql=EspQYA*Hij+Fa#)K;E~Dcqwj*pdOrqfEKI?-Jn)bA zAHSinQH;BroxA0twS26Q!t$qK{D*W2fmO0!9jzz(@qbMz1!7q3jm>6W@LS+!#v?Ab zPuDil9H;91oTj<@j!bTIYR6t-0O15;Kq~sug?a9m&ahc<`c2wCIZAwX@WfT;EuZ0$ zF@sECHcbG}Q$R=czfy3fPGJ^7Me-gu#;*lasi(W;VOYMdA`EI3Ta7zd{hLe5&doLB z`HDIIUO_reUmni~fn)5joI~s55B15ni=JU(*C@w$e{zbG8vLn@9#(U2_sW4NUQP>3 zOz-V}xdQteG?JN^%TTJowvjzV5a;?$B0gPl=y>iE=*#UYkSRMYjg&O_F8A zuxW)pP~dCgM{H%cQLhyU&s!K661Ojr+TRn1Wa8vW8Fg$ro)NChf>2WsPXu9_g~8dt zl&*S@(ssH}8bxu%I?Uc>q4pgkPd?U!_TH>5U4AnCMTY+FH~f@jes0=tCDftkcxS7t zxIPWu{A@e|Y$^Ql-lrY3Ql9Pu;Lsk>OSdG`F&dzwm3wHsUOlqPS+q1VaOdx$3RJbY zF%R=rwKYB(cOTHQiJn*rcAB*T`Y>mPieF&6>8=Y?w-y@u3v8R@oVkHpj}yA~p-!7oV!+)AO!N!SttvCzz6zlEFTEv&yZ z7&|fWoZt4!6s(>Y!AjpL>hXS{5{lNEQrw7OoO|^XNpN=^L7o(RqKj|RoL-48pD*8_s3rA5+7bNOxC>k!@Nqxy5E`39G_ap zmIxF?E-Hc#qIQh&J-y|Ts`o;8=QvkRU{UjQbw8RR?v8J0N!C1tcAUkCSz>X!yjzD7 znUMpiE(|>+?d_fg&ve#w+JFYG03T2Ktg&j$)ROO~za?F|OMb9OLq7Inyj<;>Cd z9i0|X=<>fLvs0s|xt}$Q>_z7jRsK3F$_3pyCx^Jvf-1-;yaq92hSuqBwjILek~BWs zH^i|$T1btrp|`F&P7xl@=P9RPW$WYdu?NOxjrv3`;To;`>|JRNtA~-+2TYV+LZa}F zEjbn}>*!LZL?_4I(cUXrXvx3E<|nZg)ag7ILtcsfZLt+n?dB7#8n;|A&?K~;U1g(& zb&*~gcdfn!n#YrKkGt!&Q56db%8;e#qET^^XYg|;ATXJ%2We-;_T|$_DB?$Iq_6-_ zj-U{=G`e$2q3>G%O{pS_A*|!x9XpaKymQhInXEAX9H<$t^?%=2@r41M{6}Gq+adjn z?euZMnx(3VeEi7QOzrUpTy%(|!L{Cr5%#brH-9!DE?;}^=(@IX=gnF*czb@JEmK%c zr`EQkDg9P2@zBPXXW-d%nL;y5m-1vUG?+AXL2eh`RG}j&x+Nz4h<^#jm(mdHeScAP zZ{>Dv8Z+>mpEy^la6Z1ws7xI#CQs^(1!2OU;^d4a>y=3(6sq*^D@4CV>_4%5!AE(5voX9JLoC5M#V+IKD~!{_sO*dGkI z&5hA<(I`LA0sS6#Q47i=}q1GWd+i@ zo1NUpU>5Q&?5rJi+|3fYCH$eO7K9K7{I<*3bkFa-z}kvn-L;kF_n}YZ%kQ<_Or^a< zbv#Sa3hfi%+i|Mp+No(4X3p9L+Fk$-Vp&Y<7_pm^8z%>#uzerVI;nw+`YdZh*Y!B# zEqQnSq?3DmsiF_syX0F_EBkHC3P{>fpcK-e->Q=XRQu6Xxss8^kN(V33K)3P7A_Xe^lHHo<0S7tNw5)9eX%KeqcQNG z2Ih7=3U-@Vr<34G)K_k&7V$S68c3_X1&NW33*8m~U6-6<3VQSthx}7E1Faj<+z6;AKEy_6EqtG~z&MhvD z{iN`YQv?U?A+la`yVyT{OZMWZy74*AOGUkE4MK37=NG)K<^JE_xcCzaX42=g%(mfP z=~|w%JJs9+UjPg%7(n%s6lq$&YRV#lCbv^wvjdnE05CRe=1Yb(9Z0k1En2=AA5umP z9hxTNNB_Iy%r8$zm)jW%G2=W+10*!X5B0AR?>H{Z$h>A#sim24Y<)>J+6o_i=E^vB z`7O%p=QU`Dw}D`;%7?{Wx7d9_>#!QUALcyZl$z`oZyDAjP)9YZ-Ft~8S)xKu&&OK| znXxvxn^0v^c;y{>GfjxQzoT!E^~L;WoU}jTqeI&MU8UQ9Ku>ay=<)Ni+7;8+P3rH~ z|IIoW>)^0JJvHeQc2^_UZvKtX?fLL%q^kTY-H5?BN;NHQU4#7l>*;0c@~8QY)>X?7 zck{{Wii)X!M=%p$7)5O4(|H}I{g=*0Z5%@Q0;;$r^QroKHKh}oyLo?Jsjpj&bLM3R zugpdr3@-9W0sF*O_o-7y1|RROln9DKVCbIY^$*SVc5TvO^~%||@f`;C3ZjtK!jY4n zB-di=vhEPiS*36Xb}&HtNZeHOm1N+D;WoH`kFV-^fUGu4O-KC2`;{zy$p)>n7`2CX zH{?q{Jj#>$>`roJZ z|F91np)iIgyp&S@z*!gcoK{r7(PghF^*B5i^g?b*Sypwv#fDiu6%z}VFrk|qq4<|q zJBzR|P>j!jr@DqMw$MehT4AYqdf|d5`qU|%B9_;)Xg)(Dp2D<-0%rKzShIpJNmX4t zTGJj|l!@fKr^agD-yCQftgkd3p^kR%lt$mVWWcI@g`=vg;}uqHbB3oJ-0Ze_5V$n$ zmYM%9aln`^uQGhn8n>m>56eM9kW5158aO}pQn{Q(vasaz=r(lbi0*ys5gI20@;d9&SY0a*Jj*-w`eG~n)%AYzOP$=HYG+C zz!BFF0^mJS$%ww_4M#0T;Im*wxo?GhKz5`WF0woq-=qzj=K3Y$*GYjyxJ?8&>RwvgLl)1^%hO|IKSwRno!Y3LxcKN#k zIReK)>tUgX2N7Zk>a2^!ya&(QJHPuz_GGEnW$~13!7h_vY3AZBW&L*oWuZT*U00L< z;=yDsXg)!8nElS#b0x?GNx;G@Xka(Cfv|~=)djPh83Ls8m>#?W>?k8uv!#p*AiiiT zuoBSfRPR*Im}FhlesB19p;{W&)d7dAs_QIHyJfXwc{>?(Gzjv7Z+vf|DvRaMo1ta-2!EjZ>T@ju+M;ON} zLC)y~hvWPTn{N|$1kmATz9Q3WR>(X61Am2F-X2}h8xxQBIlVFN3C{9a;_8!f>YZ^5#?A9Cqo=CqaA;L{L+q4IJ?c8&N5o|@gE?xAx9}_fX ze#8hGEODo08R2J)!z`zXt^@yCuD$27?M4pkxqJtp)ZZ`$UpF-a$(zJt@*1F&V9-n} zH#gVVC?=0|$DK|pA*D}(+@XknC>%%*Uk{QTX>`5n*&yjyev2QX!Tw?SjXX6sF<-Xf zg$LR6(n%8@%2>PFFHxOAd(CUG<|{dOi)y+S;%b<_ziwfLpm-CA!$kVODbSY>J^^~> zGWcT;o&gsF))-3wb+g=N&#?4aQC1q@%X7*#m-bIX=$FeGl;a>EX%~0#W$=ZAhzEP? z7E`EIOaKzA^cqbg2UOV9U4neyh!@!Z<|PZs=O5LPzQqpWyiKYIXNJ1P@38Wf{MnZi zo!q|xXjW#l!r0%PUyXth|667XVS9*zX{_tX)qf)Jw#V1E*8>+8?+8WfPju%*Xf+;5 zRA<}6=nSWqIMzn~Z~J zKUCG`FYs-%n_eBP+}-t^T)1BZpQP015C|jB!{5Z&$}(=9DeNvf>3ay_32=qmc;2TA zA4qHJqJF=wC!*ew`K-u)S3T4K0NDDC#-Ezbf7=vw4(epx+Oy|?=NfaAQX({`IjyMQ zMNTd2jn&q?6w&eNE;3smt$C+D(rjPRUMLAMvVL+DL1c^$e!thiloVa?OaKV63F{Sy z7X*@-avVfPeyA0To zQijYvlK?LQ;2i~EM7iVoj@DxxXH?`b3jI6QI8Ac`Yezu|70=ae^zh>8s~W*E2Qz~~ zZby};t1$x`Z)2_!`6S06#>}Y}d_J2q;f$Ta2ptPkzDN3aNgyj^kdTLPh z$jCNlSB}bS;KSSLQ#Y1NFXUed+6%A}DjW{95cy*Z3mIs|j?d3(M6Lv=i9uocD|9{lIbySvH*FK7(fKn#s3F4nwFFPasHBV;U$4gex@aPpaw8u(T6rVD3EKrdt75GvpBOmK2-v&@swP_z+lEOaZ?^9d^W46Ed|FxB!=VcF4Kob}Z^Q#gAFgoJcyqA-Ou zv39t7{1$$jf zx1nsJ^`L83_EA5_y4IR#s;PD_x4gqSSXw{1)kB40F^l7R%GO9H)_v9?*SFQD(_1m# zzQo*i&TN0O8F#h{pCWNtyi-jstV7#22an>-bT&tKUO?>)Bmv#aOS-JIg{BilU})Zf zKlR-rd`xH4ncm`o;j^%eDjE5ym9C#;M4JyXXo^?k%CR*Ha^I%7B8K{ zihYB2_PX={UOG0fY<+LeRr##x^V+_YsXba|0mt8#2dh|o81 zXL<~LJqe@LZ(3R2d|hEb@cVS8P&~1Zzu`fd0LH_nqw87n;Plvd!Z(|>s_(Owv*-r? zQrFM=Oqo7_p0a^mcgo-Xarvb%sTTfl$jX{;&e;5tD)c3lwr3}On$)ZH$$TtdSkI)y=&8~b>we^Qy?%^d znXY;Q=9%D@?G@bP9Uj*Df@i8m&b$|5B_{DA?r})f)cEg>3%VPp+0V}1 zensEO!uEkOdP@RUbnbH2&`!1iN_?OGF(`3NGKC>G)wDc%;Ou0}Rm_q1_S)x)30ntQ zE(y^M%$jrFK=Z4(C_+-+Y#LzGHNuBNHg4YweJMx2e}eE=_U2;SE%!OKAc*5@4yhu6kV_zfQx#Aynrr;;D(m zk=muB+cRv<4XeUB_TQqcE zC6I5a^8U!)B(-4iTILRcI5jypGY&P_%T>x~jh-;`^)Y;FFC=~RsAPI~v*z3p3a z`Hp+oHHQ+@-sLkFvD>ob$E$+F+idqIe(PL-n>M}GLTJQ)TOS|&m3h^#a7!v=ol~LH z*nwBhZ|H7@P}Mm~&^BIiOLD7~<`8LzbMrZULEoV&O!)=8iqhu1yF_TO-tR7!11WRd zdp}cjP0+F38WYHV+_3WQuF~HwXns_fErq&$L0{HIQbyvIj8tWbB%I0v6V8PlCk`CV zmX?_>-}jGzb5M!q_y!rHRtWLQS`c!DjdGg^;aF>#7VBHqq9}(^VyI#7qwBV88aj_e z^vzBN`xYhb7028Iu@%)m*1|$KGH1KR=nn*~q8rf*<%GIcj|ypVq^MMdbpPh6$$G#% zj^hUvW*yU52Z&mv2b7+3^bAk}ohu`5+W5VUzs3ltgDSgD0Nf+9cUh6kvzq+AGf4>0 zpqjQ*>!F9|CqoSfsvR1tKke@w#kO#lZg36Bve^<^a+yhzBVvrj(0%p8FIkz!pK{bJ zh!q2WPJim&5k@_}vXOUugwB?nZ|Fh~vB6aKuxc_`z6m>^_7j5=&u_8lzB8)*>9?=( zAPO(WGT1P0EvkzZF^^a#d_k=qfAh)TlTpUpu(@#%bn+UoSo z3i$cmb~i%t;7=Rs-DZv7o@5c;^K8-31VR?jm6Vhwc)&NwlFWO}2N*gZMb*l$R2>cV zO%8QK^XW^!3005Q2VzGjN52?a?bk2-@|yARwbh)@{XgRxlBb&>%F?M zH<*~St9Dt6N64-6-iGk1BwenD7Iw@a2XUh+YsL<;mIQlLU;dNPdJqNCJ(H=@c#He} zTJ-qd3D%*`&*v7Kf(XtWMKFq36vmd<&{M&im~&cic6iX;2cvWP#?mkpb%>&uM(; zh{^T(V^$rgR^% zv|Ooe0=7C`1`~JJgDx-vF&~xSg_q$+L`~tK+d9bHgY3LyrNGf~&vbT_LOLZex;lfm zoVoQym|`vHP%Nez$i`n5MV$WX!+>n_vhe&4l1{9+~&;Ah@2Si8cUZ?N@tGzLw%uRL$PWR<>Hac+P&Gem+EXK(zWQV$eJ5b=DTq zi-&CAO5U3Q?IT~t-n>%zVeHpL*7j_de$9HCx@3b5re1J!k3MUK^MRT^oi!u}ZOZ7@ z+wh2SR-R3dp=l5oB4WnOFUn!OLVbhDj(SCIw6xBIDs?V%bp`~M>Y^W!n4+)JwaiQ4 zK;R7U9iJ;FI-h*G8WI^8$^yiN0E>-BEK-*)#89Qr#`c-yd>){ibYQfj0NGN~A-1kQ zYAPC1;lzMqet-0;_wF-0%{TYDR0peP{4XA=*N7fm*RK=oG-iGKtB@b_m+a!J+Sdnp zy0K+Zf~e{j4;+7=vTFQR2-+HZ)4JXG3F2^30zM?_9;BZV*IS-(s&|jHICAg9(rCfn z7hNHD9=xx4djD$`?;AJ$@^Cs$vtNXH4`g+- z*M$yGFNUnBvOI{iTa)@|k>aY5p2_d{XSLmVG|IgrixI@>%B?P)C{Uf>sYhNiYt|h@ z^m8nbU$*>ko)KNf`&_Ofr1J@r1dAY-JssnXIucjM!W|rJgQgVl%WMnLW z`mM!I=EJWHLvDq-!T84=Ds2lp-z#kGu4HeTz06mC?#9KINMMpBx>!nn)W_VO+`)6q zCdVg!^8~LD;M}OucJB`0)=Y-23u_@N_P~w7`9r~cf1&Eh4v=VX@58ckv6L>!+sIz! zKCP68_n1F_M)tA5SHgs3WPP12y`vL$uysOc9%ZIS$J0jK4};h5tZy_$3^g%l>Gr|R zT#fa=HFvl*ZPj|j*~p$QZpgH>D~8sAHa(mt1s%uUn~nHB=y0kpB43#mh6BbK-<-v0 zpIa#)R*8J>ig4+W6=(~hLvizYq3VmfmvkgdBR`>z#Go`8v&J)7H)|BG)XzKXC;kOW zi`zAE%24HpYHXSb^|U^*zt;$5+3u)`_s0tEy$p0e`q5vV(d|qSH$Y8cbY`<=r7#)J zeS?9WbZWDG7Eu5mj_mY1ep`1j4y#dbf@=OWT~e`HiIvs|fd2gcAxEInuy3WjHelZQ zOV9FS?aq@99?4!M&OVWou9t;YE$MQYFXJ@{vE2h)re659@g4^&6KS6>cwayz-_du{ zfd{g10vE|M^(oGo_Rn#o^1#Yut1^di@{H9cyO3#1#V~em4fq{BboU-@T053i!7B|= zTM<79Dkj(W>A!b=j!Zo{)q%=q&#y;bDEI08{Tt10E*Q4nZ@c#mwKF}_t~35j;U7-( zt^JUMrNJEX+9+|-F5|CVsu#u|4mm8Etxfe%t7=#}V%0AoIcsAWW*ojwu}N|5|9cS&$7 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 literal 0 HcmV?d00001 diff --git a/python/examples/powder_demo.py b/python/examples/powder_demo.py new file mode 100644 index 00000000..050004f5 --- /dev/null +++ b/python/examples/powder_demo.py @@ -0,0 +1,66 @@ +"""Demo: read a CIF, calculate powder patterns with DISCUS, plot with matplotlib. + + DIFFUSE_PYTHON_PATH=/python PYTHONPATH=python \\ + python3 python/examples/powder_demo.py [--show] [--out powder_demo.png] + +The structure is anatase (TiO2), COD entry 1010942 (anatase.cif here). +""" + +import argparse +import time +from pathlib import Path + +import matplotlib.pyplot as plt + +import diffuse as dc + +HERE = Path(__file__).resolve().parent + + +def main(): + parser = argparse.ArgumentParser(description=__doc__.splitlines()[0]) + parser.add_argument("--cif", default=HERE / "anatase.cif", type=Path) + parser.add_argument("--out", default="powder_demo.png", type=Path) + parser.add_argument("--show", action="store_true", help="open a plot window") + args = parser.parse_args() + + # 1. Read the structure: DISCUS applies the space group and builds a supercell + crystal = dc.read_structure(args.cif, supercell=(10, 10, 4)) + print(crystal) + + # 2. Powder patterns: X-rays and neutrons, Debye equation + t0 = time.perf_counter() + xray = dc.powder(crystal, qmin=0.5, qmax=10, dq=0.005, radiation="xray") + neutron = dc.powder(crystal, qmin=0.5, qmax=10, dq=0.005, radiation="neutron") + print(f"two patterns of {len(xray.q)} points in {time.perf_counter() - t0:.2f} s") + + # 3. Finite-size broadening: the same structure as a much smaller crystal + small = dc.read_structure(args.cif, supercell=(3, 3, 1)) + xray_small = dc.powder(small, qmin=0.5, qmax=10, dq=0.005, radiation="xray") + + # 4. Plot: these are plain NumPy arrays, so any plotting library works + fig, (top, bottom) = plt.subplots(2, 1, figsize=(9, 7), sharex=True, + constrained_layout=True) + top.plot(xray.q, xray.intensity / xray.intensity.max(), lw=1, label="X-ray") + top.plot(neutron.q, neutron.intensity / neutron.intensity.max(), lw=1, label="neutron") + top.set_title(f"Anatase, {crystal.supercell[0]}×{crystal.supercell[1]}×" + f"{crystal.supercell[2]} unit cells ({crystal.natoms} atoms)") + top.set_ylabel("Intensity (normalised)") + top.legend() + + for p, label in ((xray, f"{crystal.natoms} atoms"), (xray_small, f"{small.natoms} atoms")): + bottom.plot(p.q, p.intensity / p.intensity.max(), lw=1, label=label) + bottom.set_title("X-ray: crystal size broadens the peaks") + bottom.set_xlabel(r"$Q$ (Å$^{-1}$)") + bottom.set_ylabel("Intensity (normalised)") + bottom.set_xlim(xray.q[0], xray.q[-1]) + bottom.legend() + + fig.savefig(args.out, dpi=150) + print(f"plot written to {args.out}") + if args.show: + plt.show() + + +if __name__ == "__main__": + main() diff --git a/tests/README.md b/tests/README.md index 8765cdb3..8a26e77d 100644 --- a/tests/README.md +++ b/tests/README.md @@ -75,11 +75,13 @@ DISCUS_SUITE=/path/to/discus_suite pytest tests/python -m "not slow" Without `DISCUS_SUITE` only the manifest checks run. -## 3. Python interface: `tests/python/test_suite_python.py` +## 3. Python: `tests/python/test_suite_python.py`, `test_diffuse_api.py` -Runs DISCUS in-process through the f2py module `suite_python` and checks the +Run DISCUS in-process through the f2py module `suite_python` and check the results as NumPy arrays, against the legacy `RESULTS/` files and against -golden data in `tests/golden//`. Build with `-DDIFFUSE_PYTHON=ON`, then: +golden data in `tests/golden//`. `test_diffuse_api.py` tests the +`diffuse` package (`python/diffuse/`, see `python/README.md`) and the demo +script `python/examples/powder_demo.py` (needs matplotlib). Build with `-DDIFFUSE_PYTHON=ON`, then: ```bash DIFFUSE_PYTHON_PATH=/path/to/build/python pytest tests/python @@ -91,7 +93,8 @@ DIFFUSE_PYTHON_PATH=/path/to/build/python pytest tests/python | `DIFFUSE_REQUIRE_PYTHON=1` | fail instead of skip if the module cannot be imported (used in CI) | | `DIFFUSE_UPDATE_GOLDEN=1` | write the golden files instead of comparing; review the diff before committing | -To add a test, use the `suite` fixture: `suite.run(commands, folder)` runs +To add a test, use the `suite` fixture (the session from `diffuse.session()`) or +the `diffuse` functions directly. `suite.run(commands, folder)` runs macro text with `folder` as working directory and raises `MacroError` if a command fails; `suite.value("n[1]")` evaluates an expression; `suite.dataset(1)` / `suite.dataset_2d(1)` return KUPLOT data set 1. Load diff --git a/tests/golden/api.powder_anatase/meta.json b/tests/golden/api.powder_anatase/meta.json new file mode 100644 index 00000000..aab0e785 --- /dev/null +++ b/tests/golden/api.powder_anatase/meta.json @@ -0,0 +1,18 @@ +{ + "neutron_debye": { + "date": "2026-11-16T16:22:21+00:00", + "git_commit": "3dc76f37aa560abc94b0f41f89a93e9279105507", + "machine": "x86_64", + "numpy": "2.5.3", + "platform": "Linux-6.18.44-fc-v470-x86_64-with-glibc2.39", + "r_max": 1e-05 + }, + "xray_debye": { + "date": "2026-11-16T16:22:21+00:00", + "git_commit": "3dc76f37aa560abc94b0f41f89a93e9279105507", + "machine": "x86_64", + "numpy": "2.5.3", + "platform": "Linux-6.18.44-fc-v470-x86_64-with-glibc2.39", + "r_max": 1e-05 + } +} diff --git a/tests/golden/api.powder_anatase/neutron_debye.npz b/tests/golden/api.powder_anatase/neutron_debye.npz new file mode 100644 index 0000000000000000000000000000000000000000..6ab60052f49b5d743aee74f0b325f3175563e8c3 GIT binary patch literal 11330 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 WVGSi&6x2T%h`(j`JGL?Xq5lBy9&3mI literal 0 HcmV?d00001 diff --git a/tests/golden/api.powder_anatase/xray_debye.npz b/tests/golden/api.powder_anatase/xray_debye.npz new file mode 100644 index 0000000000000000000000000000000000000000..7ccee59ffd90760a8aed49abaf95b9651864d0c9 GIT binary patch literal 11225 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 literal 0 HcmV?d00001 diff --git a/tests/python/conftest.py b/tests/python/conftest.py index 9f4f8575..5597a56d 100644 --- a/tests/python/conftest.py +++ b/tests/python/conftest.py @@ -16,30 +16,31 @@ def pytest_configure(config): config.addinivalue_line("markers", f"{tag}: {text}") -# ---------------------------------------------------------------- suite_python +# ------------------------------------------------------- diffuse / suite_python import os import sys from pathlib import Path import pytest -sys.path.insert(0, str(Path(__file__).parent)) # suite_session, compare +HERE = Path(__file__).resolve().parent +sys.path.insert(0, str(HERE)) # compare.py +sys.path.insert(0, str(HERE.parents[1] / "python")) # the diffuse package @pytest.fixture(scope="session") def suite(): - """The in-process DISCUS suite (f2py module suite_python). + """The in-process DISCUS suite (``diffuse.session()``). - Skips the test if the module cannot be imported. Build it with - -DDIFFUSE_PYTHON=ON and set DIFFUSE_PYTHON_PATH=/python. + Skips the test if the f2py module suite_python cannot be imported. Build + it with -DDIFFUSE_PYTHON=ON and set DIFFUSE_PYTHON_PATH=/python + (DIFFUSE_REQUIRE_PYTHON=1 turns the skip into an error, as in CI). The Fortran state is global, so there is one session per pytest run. """ - from suite_session import SuiteSession, import_suite_python + import diffuse try: - module = import_suite_python() + return diffuse.session() except ImportError as exc: if os.environ.get("DIFFUSE_REQUIRE_PYTHON"): raise - pytest.skip(f"suite_python not importable ({exc}); " - "set DIFFUSE_PYTHON_PATH=/python") - return SuiteSession(module) + pytest.skip(str(exc).splitlines()[0]) diff --git a/tests/python/suite_session.py b/tests/python/suite_session.py deleted file mode 100644 index a547d277..00000000 --- a/tests/python/suite_session.py +++ /dev/null @@ -1,116 +0,0 @@ -"""Thin test helper around the f2py module ``suite_python``. - -``suite_python`` (built with ``-DDIFFUSE_PYTHON=ON``) runs the whole -DISCUS suite inside the Python process. Its interface is small: - - initialize_suite() once per process - execute_macro("@/abs/path.mac") run a macro (errors are only printed) - get_value("expr") evaluate an expression, e.g. "n[1]" - get_data_sets() number of KUPLOT data sets - get_data_length(ik) points in KUPLOT data set ik - get_data(ik, x, y) fill float32 arrays x, y in place - get_data_3d(ik, x, y, z, nx, ny) same for a 2-D (grid) data set - -This helper adds what the tests need on top of that: - -* ``run()`` writes the commands to a driver macro that first changes into a - working folder (the suite keeps its own working directory; os.chdir does - not change it) and sets a flag on its last line. A command error ends the - whole macro run, so a flag that is not set means the macro failed, and - ``run()`` raises ``MacroError``. -* ``dataset()`` / ``dataset_2d()`` return KUPLOT data sets as NumPy arrays. - -The module is found through ``$DIFFUSE_PYTHON_PATH`` (the folder that holds -``suite_python*.so``, normally ``/python``) or the normal import path. -""" - -from __future__ import annotations - -import importlib -import itertools -import os -import sys -from pathlib import Path - -import numpy as np - -# r[] runs from 0 to MAXPAR = 500 (lib_f90/param_mod.f90). Tests leave the -# top of the range to this helper. -FLAG = "r[499]" - - -class MacroError(RuntimeError): - """A macro run through ``SuiteSession.run`` did not reach its end.""" - - -def import_suite_python(): - """Return the ``suite`` module object of suite_python, or raise ImportError.""" - path = os.environ.get("DIFFUSE_PYTHON_PATH") - if path and path not in sys.path: - sys.path.insert(0, path) - return importlib.import_module("suite_python").suite - - -class SuiteSession: - """One initialised DISCUS suite in this process (there can only be one).""" - - def __init__(self, module): - self.s = module - self.s.initialize_suite() - self._count = itertools.count() - - # -- running commands ------------------------------------------------- - def run(self, commands: str, cwd: Path) -> None: - """Run ``commands`` (macro text) with ``cwd`` as working directory. - - Raises MacroError if a command error stopped the macro. - """ - cwd = Path(cwd).resolve() - driver = cwd / f"_pytest_driver_{next(self._count)}.mac" - driver.write_text( - f"cd {cwd}\n" - f"{FLAG} = 0\n" - f"{commands.strip()}\n" - f"{FLAG} = 1\n") - self.s.execute_macro("@" + str(driver)) - if self.value(FLAG) != 1.0: - raise MacroError( - f"macro did not finish (see the ***...*** lines in the captured " - f"output); driver: {driver}") - - def value(self, expression: str) -> float: - """Value of a suite expression, e.g. ``n[1]`` or ``lat[1]``.""" - return float(self.s.get_value(expression)) - - # -- KUPLOT data ------------------------------------------------------ - def n_datasets(self) -> int: - return int(self.s.get_data_sets()) - - def dataset(self, ik: int) -> tuple[np.ndarray, np.ndarray]: - """KUPLOT data set ``ik`` (1-based) as arrays ``(x, y)``.""" - self._check_ik(ik) - n = int(self.s.get_data_length(ik)) - x = np.empty(n, np.float32) - y = np.empty(n, np.float32) - self.s.get_data(ik, x, y) - return x, y - - def dataset_2d(self, ik: int) -> tuple[np.ndarray, np.ndarray, np.ndarray]: - """KUPLOT grid data set ``ik`` as ``(x[nx], y[ny], z[nx, ny])``.""" - self._check_ik(ik) - n = int(self.s.get_data_length(ik)) - x = np.empty(n, np.float32) - y = np.empty(n, np.float32) - z = np.empty(n, np.float32) - nx = np.zeros(1, np.int32) - ny = np.zeros(1, np.int32) - self.s.get_data_3d(ik, x, y, z, nx, ny) - nx, ny = int(nx[0]), int(ny[0]) - if nx * ny != n: - raise ValueError(f"data set {ik} is not a grid ({nx} x {ny} != {n})") - return x[::ny].copy(), y[:ny].copy(), z.reshape(nx, ny) - - def _check_ik(self, ik: int) -> None: - if not 1 <= ik <= self.n_datasets(): - raise IndexError(f"KUPLOT data set {ik} does not exist " - f"({self.n_datasets()} loaded)") diff --git a/tests/python/test_diffuse_api.py b/tests/python/test_diffuse_api.py new file mode 100644 index 00000000..cac4746d --- /dev/null +++ b/tests/python/test_diffuse_api.py @@ -0,0 +1,147 @@ +"""Tests for the demo Python API: diffuse.read_structure, diffuse.powder, plotting. + + DIFFUSE_PYTHON_PATH=/python pytest tests/python/test_diffuse_api.py +""" + +from __future__ import annotations + +import os +import subprocess +import sys +from pathlib import Path + +import numpy as np +import pytest + +from compare import check_golden + +REPO = Path(__file__).resolve().parents[2] +EXAMPLES = REPO / "python" / "examples" +ANATASE = EXAMPLES / "anatase.cif" +SCATTERING = REPO / "tests" / "02.Calculation_Scattering" + + +@pytest.fixture +def dc(suite): + """The diffuse package, with the DISCUS session up.""" + import diffuse + return diffuse + + +# ------------------------------------------------------------- structures +def test_read_cif_unit_cell(dc): + cr = dc.read_structure(ANATASE) + assert cr.natoms == 12 # Ti4 O8 in the I41/amd cell + assert cr.lattice == pytest.approx((3.73, 3.73, 9.37, 90, 90, 90)) + assert cr.volume == pytest.approx(3.73 * 3.73 * 9.37, rel=1e-6) + names, xyz = cr.atoms() + assert sorted(set(names)) == ["O2-", "TI4+"] + assert (names == "TI4+").sum() == 4 + assert xyz.shape == (12, 3) + assert np.all((xyz >= -0.5) & (xyz <= 1.0)) + + +@pytest.mark.parametrize("supercell, natoms", [((2, 3, 1), 72), (2, 96)]) +def test_read_cif_supercell(dc, supercell, natoms): + cr = dc.read_structure(ANATASE, supercell=supercell) + assert cr.natoms == natoms + assert len(cr.positions()) == natoms + + +def test_read_stru_as_is(dc): + cr = dc.read_structure(SCATTERING / "example3.stru") + assert cr.natoms == 2500 + assert cr.supercell is None + + +def test_read_errors(dc, tmp_path): + with pytest.raises(FileNotFoundError): + dc.read_structure(tmp_path / "missing.cif") + bad = tmp_path / "x.xyz" + bad.write_text("1\n\nC 0 0 0\n") + with pytest.raises(dc.DiffuseError): + dc.read_structure(bad) + with pytest.raises(ValueError): + dc.read_structure(ANATASE, supercell=(0, 1, 1)) + + +def test_macro_error_message(dc): + with pytest.raises(dc.MacroError) as info: + dc.run_macro("discus\n no_such_command 1\nexit") + assert "Unknown command" in str(info.value) + assert "***" in info.value.output + + +# ----------------------------------------------------------------- powder +def anatase_pattern(dc, **kw): + cr = dc.read_structure(ANATASE, supercell=(10, 10, 4)) + return dc.powder(cr, qmin=0.5, qmax=6.0, dq=0.005, **kw) + + +def test_powder_grid_and_peaks(dc): + p = anatase_pattern(dc) + assert p.q[0] == pytest.approx(0.5) and p.q[-1] == pytest.approx(6.0) + assert np.allclose(np.diff(p.q), 0.005) + assert np.all(p.intensity >= 0) + # strongest X-ray line of anatase is (101): Q = 2 pi sqrt(1/a^2 + 1/c^2) + a, c = 3.73, 9.37 + q101 = 2 * np.pi * np.sqrt(1 / a**2 + 1 / c**2) + assert p.q[np.argmax(p.intensity)] == pytest.approx(q101, abs=0.01) + assert p.two_theta()[0] == pytest.approx(np.degrees(2 * np.arcsin(0.5 * 0.2 / (4 * np.pi)))) + check_golden("api.powder_anatase", "xray_debye", r_max=1e-5, q=p.q, intensity=p.intensity) + + +def test_powder_neutron_differs(dc): + x = anatase_pattern(dc, radiation="xray") + n = anatase_pattern(dc, radiation="neutron") + np.testing.assert_allclose(x.q, n.q) + assert not np.allclose(x.intensity / x.intensity.max(), n.intensity / n.intensity.max(), + atol=0.05) + check_golden("api.powder_anatase", "neutron_debye", r_max=1e-5, q=n.q, intensity=n.intensity) + + +def test_powder_reloads_older_crystal(dc): + """DISCUS holds one structure; powder() on an older Crystal reads it again.""" + big = dc.read_structure(ANATASE, supercell=(6, 6, 3)) + first = dc.powder(big, qmax=5.0) + small = dc.read_structure(ANATASE, supercell=(2, 2, 1)) + assert dc.session().current_crystal is small + again = dc.powder(big, qmax=5.0) + assert dc.session().current_crystal is big + np.testing.assert_allclose(again.intensity, first.intensity, rtol=1e-10) + + +def test_powder_bad_options(dc): + cr = dc.read_structure(ANATASE) + with pytest.raises(ValueError): + dc.powder(cr, radiation="gamma") + with pytest.raises(ValueError): + dc.powder(cr, qmin=5, qmax=1) + + +# --------------------------------------------------------------- plotting +def test_plot(dc): + mpl = pytest.importorskip("matplotlib") + mpl.use("Agg") + import matplotlib.pyplot as plt + + p = anatase_pattern(dc) + ax = p.plot() + line = ax.get_lines()[0] + np.testing.assert_allclose(line.get_xdata(), p.q) + ax2 = p.plot(x="tth") + assert ax2.get_xlim()[0] == pytest.approx(p.two_theta()[0]) + plt.close("all") + + +def test_demo_script(tmp_path): + """python/examples/powder_demo.py runs and writes its plot (own process).""" + pytest.importorskip("matplotlib") + if not os.environ.get("DIFFUSE_PYTHON_PATH"): + pytest.skip("DIFFUSE_PYTHON_PATH not set") + env = os.environ | {"PYTHONPATH": str(REPO / "python"), "MPLBACKEND": "Agg"} + out = tmp_path / "demo.png" + r = subprocess.run([sys.executable, str(EXAMPLES / "powder_demo.py"), "--out", str(out)], + env=env, capture_output=True, text=True, timeout=300) + assert r.returncode == 0, r.stdout + r.stderr + assert out.stat().st_size > 10_000 diff --git a/tests/python/test_suite_python.py b/tests/python/test_suite_python.py index 305b01b8..d7af6337 100644 --- a/tests/python/test_suite_python.py +++ b/tests/python/test_suite_python.py @@ -24,7 +24,7 @@ import pytest from compare import check_golden, load_columns, rvalue -from suite_session import MacroError +from diffuse import MacroError TESTS = Path(__file__).resolve().parents[1] SCATTERING = TESTS / "02.Calculation_Scattering" From 3f1c636355c04c41d7fea1416328e8d97d10e923 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 16:25:17 +0000 Subject: [PATCH 04/11] CI: re-run failed Monte-Carlo tests before failing the build 04.sro3 failed once in CI on code that had passed. MMC ignores the seed (known bug, WP0 task 0.5a), so tests tagged mc are random and can miss their statistical limits by chance. run_legacy_tests.py gets --retry-mc N: a failed mc test is re-run up to N times; a pass on retry is reported as flaky with the first failure, and a real regression still fails. CI uses --retry-mc 2. Documented in tests/README.md and the WP0 log. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_018Yw8KkfPLawp8Po4f5Bc9v --- .github/workflows/tests.yml | 5 ++++- migration/WP0_Test_Baseline.md | 15 +++++++++++++++ tests/README.md | 1 + tools/run_legacy_tests.py | 20 ++++++++++++++++++++ 4 files changed, 40 insertions(+), 1 deletion(-) diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index 80ff10bd..cdd2a2e8 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -56,10 +56,13 @@ jobs: run: python3 -m pytest tests/python -v --junitxml=pytest-results.xml - name: Legacy macro tests + # MMC ignores "seed" (known bug, WP0 task 0.5a), so tests tagged mc are + # random and checked against statistical limits. A failed mc test is + # re-run; a pass on retry is reported as flaky, a real break still fails. run: | python3 tools/run_legacy_tests.py \ --exe build/suite/prog/discus_suite -j "$(nproc)" \ - --tags fast,mc --junit legacy-results.xml --workdir legacy-work + --tags fast,mc --retry-mc 2 --junit legacy-results.xml --workdir legacy-work - name: Upload results if: always() diff --git a/migration/WP0_Test_Baseline.md b/migration/WP0_Test_Baseline.md index b5c31dc5..8d02925f 100644 --- a/migration/WP0_Test_Baseline.md +++ b/migration/WP0_Test_Baseline.md @@ -343,3 +343,18 @@ and `run_macro()` for everything else. See `python/README.md`. Checked: `pytest tests/python` gives 21 passed (33 legacy macro tests skipped without `DISCUS_SUITE`), about 2 s, with `OMP_NUM_THREADS` 1 and 4. +### Flaky Monte-Carlo test in CI + +CI run 2 failed on `04.sro3` (FAIL from its own check) with exactly the code +that passed in run 1; locally it passed 8 times in a row. MMC does not use +the value set with `seed` (known bug, task 0.5a), so tests tagged `mc` are +random and checked against statistical limits (R < 0.38, correlations +within ±0.08), and they can fail by chance. + +Until 0.5a is fixed, `run_legacy_tests.py --retry-mc N` re-runs a failed +`mc` test up to N times. A pass on retry is counted as PASS, with the +message `flaky: passed on retry k; first run ...` in the summary and the +JUnit report. A real regression fails every attempt, and the run still +fails. CI uses `--retry-mc 2`. Once `seed` works, the `mc` tests should get +fixed seeds and the retry should be removed. + diff --git a/tests/README.md b/tests/README.md index 8a26e77d..1465917c 100644 --- a/tests/README.md +++ b/tests/README.md @@ -37,6 +37,7 @@ Useful options: | `--id '04.*'` | only tests whose id matches (repeatable) | | `--junit FILE`, `--json FILE` | machine-readable reports | | `--workdir DIR`, `--keep` | where copies and logs go; keep passing tests' copies too | +| `--retry-mc N` | re-run a failed test tagged `mc` up to N times; a pass on retry is reported as `flaky` (MMC ignores `seed`, WP0 0.5a) | | `--list` | show what would run | | `--check-test-all` | check that `manifest.toml` and `test_all.mac` list the same macros | diff --git a/tools/run_legacy_tests.py b/tools/run_legacy_tests.py index 5b933c87..86e10e59 100755 --- a/tools/run_legacy_tests.py +++ b/tools/run_legacy_tests.py @@ -403,6 +403,9 @@ def main(argv: list[str] | None = None) -> int: help="first X display number used with xvfb " "(default: 100 + a number derived from the process ID)") p.add_argument("--timeout-scale", type=float, default=1.0) + p.add_argument("--retry-mc", type=int, default=0, metavar="N", + help="re-run a failed test tagged 'mc' up to N times; a pass on " + "retry counts as PASS but is reported as flaky") p.add_argument("--list", action="store_true", help="list the selected tests and exit") p.add_argument("--check-test-all", action="store_true", help="compare the manifest with test_all.mac and exit") @@ -464,6 +467,23 @@ def main(argv: list[str] | None = None) -> int: results[r.id] = r print(f" {r.status:<8} {r.id} ({r.seconds} s)", flush=True) + # Monte-Carlo tests are not reproducible yet (seed does not fix MMC runs, + # WP0 task 0.5a) and are checked against statistical limits, so they can + # fail by chance. Re-run those, one at a time; a real regression fails + # every time. + for t in to_run: + r = results[t.id] + if r.status not in BAD or "mc" not in t.tags: + continue + first = f"{r.status}: {r.message}" if r.message else r.status + for attempt in range(1, opts.retry_mc + 1): + r = run_one(t, exe, work, displays, opts) + print(f" {r.status:<8} {r.id} (retry {attempt}, {r.seconds} s)", flush=True) + if r.status not in BAD: + r.message = f"flaky: passed on retry {attempt}; first run {first}" + break + results[t.id] = r + ordered = [results[t.id] for t in to_run] + skipped print() print_summary(ordered) From 216d40dec41271acbcec010cab4881ebd80e807b Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 16:32:06 +0000 Subject: [PATCH 05/11] Fix seed: set the whole random-generator state, not only its first word "seed " copied only the given value(s) into the compiler's generator state (gfortran: 8 words) and left the other words at their clock-based start-up values, so runs with the same seed differed. ini_ran_ix now derives the remaining words from the user's values. Serial MMC with the same seed now gives a byte-identical structure (04.SRO/SRO_0). With OpenMP threads MMC is still not reproducible: random_number keeps a state per thread that random_seed does not reset, and threads update the shared crystal in timing-dependent order. Documented in the WP0 log (task 0.5a). Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_018Yw8KkfPLawp8Po4f5Bc9v --- lib_f90/random_state_mod.f90 | 7 +++++++ migration/WP0_Test_Baseline.md | 30 ++++++++++++++++++++++++++++++ 2 files changed, 37 insertions(+) diff --git a/lib_f90/random_state_mod.f90 b/lib_f90/random_state_mod.f90 index d799aea1..4129a3de 100644 --- a/lib_f90/random_state_mod.f90 +++ b/lib_f90/random_state_mod.f90 @@ -112,6 +112,13 @@ SUBROUTINE ini_ran_ix(np, iwerte, iaddit) DO i=1, MIN(np,nseeds) ! Loop over all seeds or all provided values seed_vals(i) = iwerte(i) ENDDO +! The compiler's generator state usually has more words than the user gave +! (gfortran: 8). Fill the rest from the user's values, so that the same +! "seed" command always gives the same sequence. Before, these words kept +! their clock-based values from the start-up initialisation. + DO i=np+1, nseeds + seed_vals(i) = 2*MOD(IABS(iwerte(MOD(i-1,np)+1))+INIT(1)*i, INIT(2)) - INIT(2) + i + ENDDO CALL RANDOM_SEED(PUT=seed_vals) ! idum = 0 ! User provided three numbers ENDIF diff --git a/migration/WP0_Test_Baseline.md b/migration/WP0_Test_Baseline.md index 8d02925f..a8f7d898 100644 --- a/migration/WP0_Test_Baseline.md +++ b/migration/WP0_Test_Baseline.md @@ -358,3 +358,33 @@ JUnit report. A real regression fails every attempt, and the run still fails. CI uses `--retry-mc 2`. Once `seed` works, the `mc` tests should get fixed seeds and the retry should be removed. +### 0.5a – `seed` (first half fixed) + +**Cause 1 (fixed): `seed` set only part of the generator state.** DISCUS uses +the Fortran intrinsic `random_number`. gfortran's state has 8 integers +(`random_seed(size=...)`). `ini_ran_ix` (`lib_f90/random_state_mod.f90`) +copied only the values the user gave (`seed 1234` gives one) and left the +other words at their clock-based values from start-up, so every run was +different. The remaining words are now derived from the user's values. + +**Cause 2 (open): OpenMP.** With threads, MMC is still not reproducible. +`random_number` keeps one state per thread, and `random_seed(put=...)` only +resets the calling thread's; the worker threads keep their own. The threads +also change the shared crystal while others evaluate their moves, so the +result depends on timing. A fix needs per-thread streams seeded from the +`seed` value, plus a fixed order for applying the moves. + +Checked with `04.SRO/SRO_0/sro.0.mac 0.7,1.5`, `seed` directly before the +macro, comparing `example0.stru`: + +| Setting | Same seed twice | Different seed | +|---|---|---| +| before the fix, `useomp:serial` | different | – | +| after the fix, `useomp:serial` | **identical** | different | +| after the fix, `nthreads:4` | different (cause 2) | different | + +The earlier test (section 1.3, finding 4) used `OMP_NUM_THREADS=1`, but the +SRO macros call `set parallel, nthreads:all`, which overrides it, so that +run was threaded. After the fix, `pytest tests/python` and the legacy runner +(`--tags fast,mc`) pass as before. + From 5d90c3abd1c4d92d2180957e658aa68aa8c768fe Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 16:34:06 +0000 Subject: [PATCH 06/11] Runner: seed Monte-Carlo tests and run them on one thread Tests tagged mc now run with "seed " before the macro (--seed, default 1234, or a per-test "seed" in the manifest) and with OMP_THREAD_LIMIT=1, which also caps "set parallel, nthreads:all" inside the macros. Threaded MMC is not reproducible even with a seed, so one thread is needed for repeatable results. --no-seed gives the old behaviour. Seeded tests no longer need to run alone, so the "exclusive" ones share the pool. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_018Yw8KkfPLawp8Po4f5Bc9v --- tests/python/test_legacy_macros.py | 2 +- tools/run_legacy_tests.py | 44 ++++++++++++++++++++++++++---- 2 files changed, 39 insertions(+), 7 deletions(-) diff --git a/tests/python/test_legacy_macros.py b/tests/python/test_legacy_macros.py index 63e942ac..c49d9ba0 100644 --- a/tests/python/test_legacy_macros.py +++ b/tests/python/test_legacy_macros.py @@ -65,7 +65,7 @@ def workdir(): def test_macro(test, workdir): opts = argparse.Namespace( xvfb=not os.environ.get("DISPLAY") and runner.shutil.which("xvfb-run") is not None, - omp_threads=None, timeout_scale=1.0, keep=False) + omp_threads=None, timeout_scale=1.0, keep=False, seed=runner.DEFAULT_SEED) displays = runner.queue.Queue() displays.put(100 + (os.getpid() % 100) * 8) r = runner.run_one(test, EXE, workdir, displays, opts) diff --git a/tools/run_legacy_tests.py b/tools/run_legacy_tests.py index 86e10e59..444f5cf8 100755 --- a/tools/run_legacy_tests.py +++ b/tools/run_legacy_tests.py @@ -16,6 +16,12 @@ RAN check = "none": the macro finished, but nothing was verified SKIPPED enabled = false in the manifest, or filtered out by --tags +Randomness: tests tagged "mc" are seeded (--seed, default 1234, or the +test's own "seed" in the manifest): the driver runs "seed " before the +macro, and the run is limited to one OpenMP thread (OMP_THREAD_LIMIT=1), +because threaded MMC is not reproducible even with a seed. --no-seed gives +the old behaviour: unseeded, with the macro's own thread settings. + Exit code: 0 if no test is FAIL, ABORTED or TIMEOUT, else 1. 2 = usage error. Only the Python standard library is used (Python >= 3.11 for tomllib). @@ -61,6 +67,7 @@ ERROR_LINE = re.compile(r"\*\*\*[A-Z ]{3,5}\*\*\*") XVFB_FAILED = "Xvfb failed to start" XVFB_ATTEMPTS = 3 +DEFAULT_SEED = 1234 # --------------------------------------------------------------------- manifest @@ -77,6 +84,7 @@ class Test: in_test_all: bool = True enabled: bool = True skip_reason: str = "" + seed: int | None = None # overrides --seed for this test (tag mc only) def load_manifest(path: Path) -> list[Test]: @@ -181,7 +189,16 @@ def macro_string(s: str) -> str: return s -def write_driver(t: Test, run_dir: Path, result_file: Path, root: Path) -> Path: +def test_seed(t: Test, opts) -> int | None: + """Seed for a test tagged mc, or None (unseeded run).""" + seed = getattr(opts, "seed", None) + if "mc" not in t.tags or seed is None: + return None + return t.seed if t.seed is not None else seed + + +def write_driver(t: Test, run_dir: Path, result_file: Path, root: Path, + seed: int | None = None) -> Path: args = f" {t.args}" if t.args else "" lines = [ "# generated by tools/run_legacy_tests.py", @@ -194,8 +211,10 @@ def write_driver(t: Test, run_dir: Path, result_file: Path, root: Path) -> Path: "LTEST_BATCH = TRUE", f'LTEST_FILE = "%c", "{macro_string(str(result_file))}"', "set wait, off", - f"@{t.macro}{args}", ] + if seed is not None: + lines.append(f"seed {seed}") + lines.append(f"@{t.macro}{args}") if t.check == "macro": lines.append(f"@{macro_string(str(root / 'check.mac'))} {t.macro}") lines += [ @@ -252,7 +271,8 @@ def run_one(t: Test, exe: Path, work: Path, displays: queue.Queue, opts) -> Resu copy_test_tree(t, root) run_dir = root / t.dir result_file = root / "zz_results.txt" - driver = write_driver(t, run_dir, result_file, root) + seed = test_seed(t, opts) + driver = write_driver(t, run_dir, result_file, root, seed) log_path = work / f"{t.id}.log" cmd = [str(exe), "-macro", driver.name] @@ -264,6 +284,11 @@ def run_one(t: Test, exe: Path, work: Path, displays: queue.Queue, opts) -> Resu env["PGPLOT_DIR"] = "/usr/lib/pgplot5" if opts.omp_threads: env["OMP_NUM_THREADS"] = str(opts.omp_threads) + if seed is not None: + # Threaded MMC is not reproducible (per-thread random states, update + # order); OMP_THREAD_LIMIT also caps "set parallel, nthreads:all". + env["OMP_NUM_THREADS"] = "1" + env["OMP_THREAD_LIMIT"] = "1" # Temporary files of discus_suite and xvfb-run stay inside the work dir. env["TMPDIR"] = str(root / "tmp") (root / "tmp").mkdir() @@ -403,6 +428,10 @@ def main(argv: list[str] | None = None) -> int: help="first X display number used with xvfb " "(default: 100 + a number derived from the process ID)") p.add_argument("--timeout-scale", type=float, default=1.0) + p.add_argument("--seed", type=int, default=DEFAULT_SEED, + help="seed for tests tagged 'mc', run on one thread (default %(default)s)") + p.add_argument("--no-seed", dest="seed", action="store_const", const=None, + help="run 'mc' tests unseeded, with their own thread settings") p.add_argument("--retry-mc", type=int, default=0, metavar="N", help="re-run a failed test tagged 'mc' up to N times; a pass on " "retry counts as PASS but is reported as flaky") @@ -446,7 +475,9 @@ def main(argv: list[str] | None = None) -> int: work = work.resolve() work.mkdir(parents=True, exist_ok=True) print(f"discus_suite : {exe}\nwork dir : {work}\n" - f"tests : {len(to_run)} to run, {len(skipped)} skipped\n", flush=True) + f"tests : {len(to_run)} to run, {len(skipped)} skipped\n" + f"mc tests : {'unseeded' if opts.seed is None else f'seed {opts.seed}, one thread'}\n", + flush=True) by_id = {t.id: t for t in tests} results: dict[str, Result] = {} @@ -457,8 +488,9 @@ def main(argv: list[str] | None = None) -> int: # Tests tagged "exclusive" set their own OpenMP thread count (for example # "set parallel, useomp:use, nthreads:all") and slow everything down badly # when they share the CPUs. They run one at a time after the others. - shared = [t for t in to_run if "exclusive" not in t.tags] - alone = [t for t in to_run if "exclusive" in t.tags] + # Seeded tests are limited to one thread, so they can share. + alone = [t for t in to_run if "exclusive" in t.tags and test_seed(t, opts) is None] + shared = [t for t in to_run if t not in alone] for batch, width in ((shared, jobs), (alone, 1)): with cf.ThreadPoolExecutor(max_workers=width) as pool: futures = [pool.submit(run_one, t, exe, work, displays, opts) for t in batch] From 2e98dd35a6a5377f7f7ee233a69c0354265b899e Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 16:35:58 +0000 Subject: [PATCH 07/11] Python: flush Fortran output before reading the capture CI failed test_macro_error_message: MacroError said "(no message)" and the DISCUS text appeared at the end of the job log. On Ubuntu the apt NumPy loads libgfortran (through OpenBLAS) before diffuse sets GFORTRAN_UNBUFFERED_PRECONNECTED, so the setting is ignored and the output stays buffered until exit. suite_python gets flush_output(), which flushes the output and error units; the session calls it before and after each captured call. Reproduced locally with GFORTRAN_UNBUFFERED_PRECONNECTED=n: fails before, passes after. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_018Yw8KkfPLawp8Po4f5Bc9v --- python/diffuse/_session.py | 27 ++++++++++++++++++++++----- python/suite_python.f90 | 22 ++++++++++++++++++++++ 2 files changed, 44 insertions(+), 5 deletions(-) diff --git a/python/diffuse/_session.py b/python/diffuse/_session.py index c672dbf2..2bc9a67c 100644 --- a/python/diffuse/_session.py +++ b/python/diffuse/_session.py @@ -68,12 +68,21 @@ def _import_suite_python(): class _Capture: - """Send file descriptors 1 and 2 to a temporary file.""" + """Send file descriptors 1 and 2 to a temporary file. - def __init__(self): + ``flush`` writes out what the Fortran runtime still buffers. Setting + GFORTRAN_UNBUFFERED_PRECONNECTED is not enough on its own: libgfortran + reads it once, when it is first loaded, and NumPy (through OpenBLAS) may + have loaded it before this module. + """ + + def __init__(self, flush=None): self.text = "" + self._flush = flush def __enter__(self): + if self._flush is not None: + self._flush() # output from before the capture sys.stdout.flush() sys.stderr.flush() self._file = tempfile.TemporaryFile(mode="w+b") @@ -83,6 +92,8 @@ def __enter__(self): return self def __exit__(self, *exc): + if self._flush is not None: + self._flush() os.dup2(self._saved[0], 1) os.dup2(self._saved[1], 2) for fd in self._saved: @@ -104,10 +115,16 @@ def __init__(self, echo: bool | None = None): self._workdir = Path(tempfile.mkdtemp(prefix="diffuse_")) atexit.register(shutil.rmtree, self._workdir, ignore_errors=True) self.current_crystal = None # the Crystal now held by DISCUS - with _Capture() as cap: + # flush_output() is in suite_python.f90 since the demo API; builds + # without it rely on GFORTRAN_UNBUFFERED_PRECONNECTED alone. + self._flush = getattr(self._s, "flush_output", None) + with self._capture() as cap: self._s.initialize_suite() self._show(cap.text) + def _capture(self) -> _Capture: + return _Capture(self._flush) + def _show(self, text: str) -> None: self.last_output = text if self.echo and text: @@ -130,7 +147,7 @@ def run(self, commands: str, cwd: str | os.PathLike | None = None) -> str: f"{FLAG} = 0\n" f"{commands.strip()}\n" f"{FLAG} = 1\n") - with _Capture() as cap: + with self._capture() as cap: self._s.execute_macro("@" + str(driver)) ok = self._s.get_value(FLAG) == 1.0 self._show(cap.text) @@ -142,7 +159,7 @@ def run(self, commands: str, cwd: str | os.PathLike | None = None) -> str: def value(self, expression: str) -> float: """Value of a DISCUS expression, e.g. ``n[1]`` or ``lat[1]``.""" - with _Capture() as cap: + with self._capture() as cap: v = float(self._s.get_value(expression)) if "***" in cap.text: raise MacroError(f"cannot evaluate '{expression}':\n " + cap.text.strip(), cap.text) diff --git a/python/suite_python.f90 b/python/suite_python.f90 index 3135aa52..7b71e3a9 100644 --- a/python/suite_python.f90 +++ b/python/suite_python.f90 @@ -34,6 +34,7 @@ MODULE suite PUBLIC get_data_length ! Returns length of KUPLOT data set ik PUBLIC get_data_sets ! Returns number of loaded KUPLOT data sets public python_error +PUBLIC flush_output ! Flush the Fortran output units (for Python output capture) ! CONTAINS !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! @@ -318,4 +319,25 @@ SUBROUTINE python_error(num) ! END SUBROUTINE python_error ! +! +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +! +SUBROUTINE flush_output() +! +! Write out anything the Fortran runtime still holds for the output and +! error units. Python redirects these file descriptors to capture the +! text; buffered output would otherwise appear later, outside the capture. +! +USE prompt_mod +USE, INTRINSIC :: ISO_FORTRAN_ENV, ONLY: OUTPUT_UNIT, ERROR_UNIT +! +IMPLICIT NONE +! +FLUSH(OUTPUT_UNIT) +FLUSH(ERROR_UNIT) +IF(output_io /= OUTPUT_UNIT .AND. output_io /= ERROR_UNIT) FLUSH(output_io) +IF(error_io /= OUTPUT_UNIT .AND. error_io /= ERROR_UNIT) FLUSH(error_io) +! +END SUBROUTINE flush_output +! END MODULE suite From fb58383f50fa3b6dd984a7fa04da8c918210b73e Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 16:37:25 +0000 Subject: [PATCH 08/11] Docs: seeded mc tests are repeatable; rare broken Fourier in 04.sro3 All 16 enabled mc tests, run twice with seed 1234 on one thread, gave byte-identical outputs and passed, except one 04.sro3 run: identical MC structure, but the Fourier step (lots + nufft) wrote Infinity/zeros and a NaN 3D-PDF. Not reproduced in 14 further runs. CI keeps --retry-mc 2 for this; documented in the WP0 log, tests/README.md and the workflow. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_018Yw8KkfPLawp8Po4f5Bc9v --- .github/workflows/tests.yml | 7 ++++--- migration/WP0_Test_Baseline.md | 25 +++++++++++++++++++++++++ tests/README.md | 1 + 3 files changed, 30 insertions(+), 3 deletions(-) diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index cdd2a2e8..2f2c1c41 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -56,9 +56,10 @@ jobs: run: python3 -m pytest tests/python -v --junitxml=pytest-results.xml - name: Legacy macro tests - # MMC ignores "seed" (known bug, WP0 task 0.5a), so tests tagged mc are - # random and checked against statistical limits. A failed mc test is - # re-run; a pass on retry is reported as flaky, a real break still fails. + # Tests tagged mc run with "seed 1234" on one thread (repeatable). A + # failed mc test is still re-run: 04.sro3 rarely gets a broken Fourier + # result (WP0 log). A pass on retry is reported as flaky; a real break + # still fails. run: | python3 tools/run_legacy_tests.py \ --exe build/suite/prog/discus_suite -j "$(nproc)" \ diff --git a/migration/WP0_Test_Baseline.md b/migration/WP0_Test_Baseline.md index a8f7d898..09a6995e 100644 --- a/migration/WP0_Test_Baseline.md +++ b/migration/WP0_Test_Baseline.md @@ -388,3 +388,28 @@ SRO macros call `set parallel, nthreads:all`, which overrides it, so that run was threaded. After the fix, `pytest tests/python` and the legacy runner (`--tags fast,mc`) pass as before. +### 0.5 – seeded Monte-Carlo tests + +`run_legacy_tests.py` now runs every test tagged `mc` with `seed 1234` (option +`--seed`, or a test's own `seed` in the manifest) and with +`OMP_THREAD_LIMIT=1`. The limit also caps `set parallel, nthreads:all` in the +SRO macros (DISCUS reports "maximum threads 1"). `--no-seed` gives the old +behaviour. Seeded tests run on one thread, so the `exclusive` tests no longer +need to run alone. + +Checked by running all 16 enabled `mc` tests twice (`--keep`) and comparing +every output file: **byte-identical** in both runs, apart from the generated +driver macro (it contains the work-folder path) and one `04.sro3` run, see +below. All pass with seed 1234. + +**New finding: rare broken Fourier result in `04.sro3`.** In one of the two +runs, `04.sro3` aborted. Its MC structure (`example3.stru`) was identical +to the other run's, but the Fourier step (`fourier.mac`: random `lots` +plus `set technique:nufft`) wrote 1530 `Infinity` values and blocks of zeros +to `example3.inte`, and NaN to `example3.3DPDF`; `kex3.mac` then failed on +`zmax[3]`. 14 more seeded runs (6 serial, 8 with 4 at a time) all gave the +same correct result, so it is rare (1 in about 17 so far). It may also +explain the original CI failure of `04.sro3` (run 2). Needs its own +investigation: uninitialised memory or a race in the lots/NUFFT path are +candidates. Until then, CI keeps `--retry-mc 2`. + diff --git a/tests/README.md b/tests/README.md index 1465917c..49ded9f3 100644 --- a/tests/README.md +++ b/tests/README.md @@ -37,6 +37,7 @@ Useful options: | `--id '04.*'` | only tests whose id matches (repeatable) | | `--junit FILE`, `--json FILE` | machine-readable reports | | `--workdir DIR`, `--keep` | where copies and logs go; keep passing tests' copies too | +| `--seed N`, `--no-seed` | tests tagged `mc` run with `seed N` (default 1234; a test's own `seed` in the manifest wins) on one OpenMP thread, so they repeat exactly; `--no-seed` runs them unseeded with their own thread settings | | `--retry-mc N` | re-run a failed test tagged `mc` up to N times; a pass on retry is reported as `flaky` (MMC ignores `seed`, WP0 0.5a) | | `--list` | show what would run | | `--check-test-all` | check that `manifest.toml` and `test_all.mac` list the same macros | From 7d35a875055d2bfd40daea361356dc5179095eff Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 16:55:21 +0000 Subject: [PATCH 09/11] Documentation: Sphinx site with API reference and example gallery - docs/: Sphinx with MyST Markdown pages (index, installation), an API reference from the docstrings (autodoc + napoleon), and the migration plan, WP0 documents and tests/README.md pulled in at build time. - sphinx-gallery runs every script in python/examples/; powder_demo.py is now a gallery example (text between code cells, plt.show()). The committed PNG is replaced by the generated gallery page. - Public docstrings in NumPy style (Parameters, Returns, Raises, Examples). - CI builds the docs with -W after the tests and uploads the HTML as the docs-html artifact. Nothing is published: GitHub Pages of this repository serves the DISCUS homepage (gh-pages). - Tests run every example script; python/README.md and CLAUDE.md explain how to build the docs and what new API needs. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_018Yw8KkfPLawp8Po4f5Bc9v --- .github/workflows/tests.yml | 25 ++++++- CLAUDE.md | 11 +++ docs/.gitignore | 4 + docs/api.md | 42 +++++++++++ docs/conf.py | 100 +++++++++++++++++++++++++ docs/index.md | 38 ++++++++++ docs/install.md | 63 ++++++++++++++++ docs/requirements.txt | 7 ++ python/README.md | 34 ++++++++- python/diffuse/_session.py | 6 +- python/diffuse/crystal.py | 73 +++++++++++++++--- python/diffuse/powder.py | 80 +++++++++++++++++--- python/examples/README.rst | 5 ++ python/examples/powder_demo.png | Bin 178008 -> 0 bytes python/examples/powder_demo.py | 124 +++++++++++++++++-------------- tests/python/test_diffuse_api.py | 9 +-- 16 files changed, 531 insertions(+), 90 deletions(-) create mode 100644 docs/.gitignore create mode 100644 docs/api.md create mode 100644 docs/conf.py create mode 100644 docs/index.md create mode 100644 docs/install.md create mode 100644 docs/requirements.txt create mode 100644 python/examples/README.rst delete mode 100644 python/examples/powder_demo.png diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index 2f2c1c41..6fd52f8a 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -2,6 +2,8 @@ # # 1. pytest tests/python – diffuse package, suite_python, golden data, demo # 2. legacy macro tests – tools/run_legacy_tests.py, tags fast and mc +# 3. documentation – Sphinx (docs/), uploaded as the "docs-html" +# artifact; not published anywhere yet # # Development happens on claude-python-app until the first release of the # Python package; feature branches (claude/**) merge into it. @@ -35,7 +37,7 @@ jobs: sudo apt-get install -y --no-install-recommends \ gfortran cmake make libfftw3-dev libhdf5-dev libreadline-dev \ libpng-dev libx11-dev zlib1g-dev pgplot5 xvfb \ - python3-dev python3-numpy python3-pytest python3-matplotlib + python3-dev python3-numpy python3-pytest python3-matplotlib python3-venv - name: Configure run: | @@ -65,6 +67,27 @@ jobs: --exe build/suite/prog/discus_suite -j "$(nproc)" \ --tags fast,mc --retry-mc 2 --junit legacy-results.xml --workdir legacy-work + - name: Documentation + if: success() || failure() + env: + DIFFUSE_PYTHON_PATH: ${{ github.workspace }}/build/python + MPLBACKEND: Agg + # Warnings are errors, so broken docstrings or links fail the build. + # --system-site-packages: use the apt NumPy/matplotlib that the + # compiled module was built against. + run: | + python3 -m venv --system-site-packages .venv-docs + .venv-docs/bin/pip install --quiet -r docs/requirements.txt + .venv-docs/bin/python -m sphinx -W --keep-going -b html docs docs/_build/html + + - name: Upload documentation + if: success() || failure() + uses: actions/upload-artifact@v4 + with: + name: docs-html + path: docs/_build/html + if-no-files-found: ignore + - name: Upload results if: always() uses: actions/upload-artifact@v4 diff --git a/CLAUDE.md b/CLAUDE.md index 0ae3609c..dc1dc0d8 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -24,3 +24,14 @@ python3 tools/run_legacy_tests.py --exe build/suite/prog/discus_suite -j 4 --tag ``` CMake needs `FC` set. Keep build trees outside `tests/`. + +## Documentation + +Sphinx in `docs/` (MyST Markdown, autodoc + napoleon, sphinx-gallery over +`python/examples/`). Build with +`DIFFUSE_PYTHON_PATH=build/python python3 -m sphinx -W -b html docs docs/_build/html` +(`DIFFUSE_DOCS_OFFLINE=1` without network). New public API needs a NumPy-style +docstring, an entry in `docs/api.md`, and an example in `python/examples/`. +CI uploads the HTML as the `docs-html` artifact. Do not publish to the +`gh-pages` branch: it holds the DISCUS homepage. + diff --git a/docs/.gitignore b/docs/.gitignore new file mode 100644 index 00000000..540b03f2 --- /dev/null +++ b/docs/.gitignore @@ -0,0 +1,4 @@ +_build/ +_generated/ +gallery/ +sg_execution_times.rst diff --git a/docs/api.md b/docs/api.md new file mode 100644 index 00000000..f13f8c2c --- /dev/null +++ b/docs/api.md @@ -0,0 +1,42 @@ +# API reference + +```{eval-rst} +.. currentmodule:: diffuse +``` + +## Structures + +```{eval-rst} +.. autofunction:: read_structure + +.. autoclass:: Crystal + :members: atoms, positions, volume, a +``` + +## Powder diffraction + +```{eval-rst} +.. autofunction:: powder + +.. autoclass:: PowderPattern + :members: two_theta, plot +``` + +## Running DISCUS directly + +```{eval-rst} +.. autofunction:: run_macro + +.. autofunction:: session + +.. autoclass:: Session + :members: run, value, dataset, dataset_2d, workdir, last_output +``` + +## Errors + +```{eval-rst} +.. autoexception:: DiffuseError + +.. autoexception:: MacroError +``` diff --git a/docs/conf.py b/docs/conf.py new file mode 100644 index 00000000..4afb9bcd --- /dev/null +++ b/docs/conf.py @@ -0,0 +1,100 @@ +"""Sphinx configuration for the DiffuseCode Python documentation. + +Build (from the repository root): + + pip install -r docs/requirements.txt + DIFFUSE_PYTHON_PATH=build/python python3 -m sphinx -W -b html docs docs/_build/html + +The example gallery runs python/examples/*.py and needs the suite_python +module (DIFFUSE_PYTHON_PATH). Without it, set DIFFUSE_DOCS_NO_GALLERY=1 to +build everything except the gallery. Without network access, set +DIFFUSE_DOCS_OFFLINE=1 (no links into the Python/NumPy/matplotlib docs). +""" + +import os +import shutil +import sys +from pathlib import Path + +DOCS = Path(__file__).resolve().parent +REPO = DOCS.parent +sys.path.insert(0, str(REPO / "python")) + +project = "DiffuseCode Python" +author = "The DiffuseCode developers" +copyright = "DiffuseCode developers" + +extensions = [ + "myst_parser", # Markdown pages + "sphinx.ext.autodoc", # API pages from docstrings + "sphinx.ext.autosummary", + "sphinx.ext.napoleon", # NumPy-style docstrings + "sphinx.ext.intersphinx", # links to the NumPy, matplotlib, Python docs + "sphinx.ext.viewcode", +] + +source_suffix = {".rst": "restructuredtext", ".md": "markdown"} +exclude_patterns = ["_build", "**.ipynb_checkpoints"] +myst_heading_anchors = 3 + +# -- API docs ----------------------------------------------------------------- +autodoc_member_order = "bysource" +autodoc_typehints = "description" +autodoc_default_options = {"members": True} +napoleon_google_docstring = False +napoleon_numpy_docstring = True +napoleon_use_rtype = False +# diffuse loads suite_python only when a session starts, so importing it for +# the API pages works without the compiled module. + +intersphinx_mapping = { + "python": ("https://docs.python.org/3", None), + "numpy": ("https://numpy.org/doc/stable/", None), + "matplotlib": ("https://matplotlib.org/stable/", None), +} +if os.environ.get("DIFFUSE_DOCS_OFFLINE"): # no network: no outside links + intersphinx_mapping = {} + +# The migration documents skip heading levels in places; that is fine there. +suppress_warnings = ["myst.header"] + +# -- Pages taken from elsewhere in the repository ------------------------------- +# The migration documents stay in migration/ (one source of truth); copy them +# into the docs tree so that the links between them keep working. +_generated = DOCS / "_generated" +shutil.rmtree(_generated, ignore_errors=True) +(_generated / "migration").mkdir(parents=True) +for md in sorted((REPO / "migration").glob("*.md")): + shutil.copy(md, _generated / "migration" / md.name) +shutil.copy(REPO / "tests" / "README.md", _generated / "testing.md") + +# -- Example gallery ------------------------------------------------------------ +if not os.environ.get("DIFFUSE_DOCS_NO_GALLERY"): + extensions.append("sphinx_gallery.gen_gallery") + sphinx_gallery_conf = { + "examples_dirs": str(REPO / "python" / "examples"), + "gallery_dirs": "gallery", + "filename_pattern": r"\.py$", # run every example + "download_all_examples": False, + "matplotlib_animations": False, + "image_scrapers": ("matplotlib",), + } +else: + # Keep the table of contents valid: a placeholder instead of the gallery. + shutil.rmtree(DOCS / "gallery", ignore_errors=True) + (DOCS / "gallery").mkdir() + (DOCS / "gallery" / "index.md").write_text( + "# Examples\n\nThe example gallery was not built " + "(`DIFFUSE_DOCS_NO_GALLERY` was set).\n") + exclude_patterns.append("sg_execution_times.rst") + +# -- HTML ------------------------------------------------------------------------- +html_theme = "pydata_sphinx_theme" +html_title = "DiffuseCode Python" +html_theme_options = { + "github_url": "https://github.com/tproffen/DiffuseCode", + "navigation_with_keys": False, + "show_toc_level": 2, + "header_links_before_dropdown": 3, +} +html_static_path = [] diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 00000000..f4055714 --- /dev/null +++ b/docs/index.md @@ -0,0 +1,38 @@ +# DiffuseCode from Python + +```{warning} +This is an early preview. The Python interface covers a small set of DISCUS +commands so far, and the API may still change. It is built from the +`claude-python-app` branch. +``` + +The `diffuse` package runs [DISCUS](https://github.com/tproffen/DiffuseCode) +from Python. You read a structure, run a calculation, and get the results back +as NumPy arrays, ready for matplotlib, SciPy or your own analysis. + +```python +import diffuse as dc + +cr = dc.read_structure("anatase.cif", supercell=(10, 10, 4)) +p = dc.powder(cr, qmin=0.5, qmax=10, dq=0.005, radiation="xray") +p.plot() +``` + +```{toctree} +:maxdepth: 2 +:caption: Using it + +install +gallery/index +api +``` + +```{toctree} +:maxdepth: 1 +:caption: Development + +_generated/testing +_generated/migration/DiffuseCode_Python_Migration_Plan +_generated/migration/WP0_Test_Baseline +_generated/migration/WP0_Test_Coverage_Gaps +``` diff --git a/docs/install.md b/docs/install.md new file mode 100644 index 00000000..aad0d4be --- /dev/null +++ b/docs/install.md @@ -0,0 +1,63 @@ +# Installation + +There is no `pip install` yet (that comes with the packaging work, WP1 in +the migration plan). For now, build DiffuseCode with its Python module and +point Python at the build. + +## Build + +On Debian or Ubuntu, install the build dependencies: + +```bash +sudo apt-get install -y gfortran cmake libfftw3-dev libhdf5-dev libreadline-dev \ + libpng-dev libx11-dev zlib1g-dev pgplot5 python3-dev python3-numpy python3-matplotlib +``` + +Then, from the repository root: + +```bash +FC=gfortran CC=gcc CXX=g++ cmake -S . -B build -DCMAKE_BUILD_TYPE=Release \ + -DDIFFUSE_PYTHON=ON -DPGPLOT_DIR=/usr/lib/pgplot5 +cmake --build build -j +``` + +This builds `discus_suite` and the Python module `build/python/suite_python*.so`. + +## Use + +Two settings tell Python where things are: + +* `DIFFUSE_PYTHON_PATH`: the folder with the compiled module (`build/python`). +* the `python/` folder of the repository on the Python path, for the + `diffuse` package. + +```bash +export DIFFUSE_PYTHON_PATH=$PWD/build/python +export PYTHONPATH=$PWD/python +python3 python/examples/powder_demo.py +``` + +In a Jupyter notebook, set them before `import diffuse`: + +```python +import os, sys +os.environ["DIFFUSE_PYTHON_PATH"] = "/path/to/DiffuseCode/build/python" +sys.path.insert(0, "/path/to/DiffuseCode/python") +import diffuse as dc +``` + +## How it works, and its limits + +This version drives DISCUS through the f2py module `suite_python`: Python +writes the commands to a small macro, DISCUS runs it in the same process, and +the results come back through files or KUPLOT data sets. + +* DISCUS holds **one structure at a time** per process. A {class}`~diffuse.Crystal` + remembers how it was made, and {func}`~diffuse.powder` reads it in again if + another structure was loaded since. +* DISCUS output is captured, not printed. Set `DIFFUSE_ECHO=1`, or call + `dc.session(echo=True)`, to see it; the last output is in + `dc.session().last_output`. +* A failed DISCUS command raises {class}`~diffuse.MacroError` with DISCUS's + own error lines. +* {func}`~diffuse.run_macro` runs any DISCUS commands that are not wrapped yet. diff --git a/docs/requirements.txt b/docs/requirements.txt new file mode 100644 index 00000000..51a24da2 --- /dev/null +++ b/docs/requirements.txt @@ -0,0 +1,7 @@ +# Documentation build (see docs/conf.py) +sphinx>=7.2 +myst-parser>=2.0 +pydata-sphinx-theme>=0.15 +sphinx-gallery>=0.15 +matplotlib +numpy diff --git a/python/README.md b/python/README.md index 6200170c..526fff9d 100644 --- a/python/README.md +++ b/python/README.md @@ -16,7 +16,8 @@ p.q, p.intensity # NumPy arrays p.plot() # matplotlib; p.plot(x="tth") for 2-theta ``` -![Powder patterns of anatase](examples/powder_demo.png) +The documentation (installation, API reference and an example gallery with +plots) is built from `docs/`; see "Documentation" below. ## Running the demo @@ -34,12 +35,12 @@ cmake --build build -j Then run the demo (needs NumPy and matplotlib): ```bash -DIFFUSE_PYTHON_PATH=build/python PYTHONPATH=python python3 python/examples/powder_demo.py --show +DIFFUSE_PYTHON_PATH=build/python PYTHONPATH=python python3 python/examples/powder_demo.py ``` It reads `examples/anatase.cif`, calculates X-ray and neutron patterns for a -10×10×4 supercell and an X-ray pattern for a 3×3×1 crystal, and writes -`powder_demo.png`. +10×10×4 supercell and an X-ray pattern for a 3×3×1 crystal, and shows the +plot. For Jupyter, set the two variables before starting it, or at the top of the notebook before `import diffuse`: @@ -83,6 +84,31 @@ The migration plan (`migration/DiffuseCode_Python_Migration_Plan.md`, WP1–WP5) replaces `suite_python` underneath with a `bind(C)` core and a proper `pip install`. The aim is to keep this API while doing so. +## Documentation + +Sphinx sources are in `docs/`: Markdown pages, the API reference generated +from the docstrings (NumPy style), and a gallery made by running every script +in `python/examples/`. To build it: + +```bash +pip install -r docs/requirements.txt +``` + +```bash +DIFFUSE_PYTHON_PATH=build/python python3 -m sphinx -W -b html docs docs/_build/html +``` + +`DIFFUSE_DOCS_NO_GALLERY=1` skips the gallery (no compiled module needed); +`DIFFUSE_DOCS_OFFLINE=1` skips the links into the NumPy/matplotlib docs. +CI builds the docs on every push and keeps the HTML as the `docs-html` +artifact of the run. They are not published yet (GitHub Pages of this +repository serves the DISCUS homepage). + +When adding to the API: give every public function a NumPy-style docstring +(Parameters, Returns, Raises, Examples), list it in `docs/api.md`, and add an +example script to `python/examples/` for each new capability (it becomes a +gallery page and is run by the tests). + ## Tests `tests/python/test_diffuse_api.py` covers this API, and CI runs it together diff --git a/python/diffuse/_session.py b/python/diffuse/_session.py index 2bc9a67c..5fa33c56 100644 --- a/python/diffuse/_session.py +++ b/python/diffuse/_session.py @@ -47,7 +47,11 @@ class DiffuseError(RuntimeError): class MacroError(DiffuseError): - """A command failed inside DISCUS; ``.output`` holds the captured text.""" + """A command failed inside DISCUS. + + The message holds DISCUS's ``***`` error lines; ``output`` holds all + the text DISCUS wrote during the failed call. + """ def __init__(self, message: str, output: str = ""): super().__init__(message) diff --git a/python/diffuse/crystal.py b/python/diffuse/crystal.py index bf4e2b3d..b81edaa2 100644 --- a/python/diffuse/crystal.py +++ b/python/diffuse/crystal.py @@ -19,10 +19,22 @@ @dataclass(eq=False) class Crystal: - """A structure loaded into DISCUS. - - DISCUS holds one structure at a time. A Crystal remembers how it was - made, so a calculation on an older Crystal reads it in again first. + """A structure loaded into DISCUS. Create it with :func:`read_structure`. + + DISCUS holds one structure at a time. A ``Crystal`` remembers how it was + made, so a calculation on an older ``Crystal`` reads it in again first. + + Attributes + ---------- + path : pathlib.Path + The structure file it was read from. + supercell : tuple of int or None + Number of unit cells along a, b and c, or None for a ``.stru`` file + read as it is. + natoms : int + Number of atoms in the whole crystal. + lattice : tuple of float + ``(a, b, c, alpha, beta, gamma)`` in Å and degrees. """ path: Path @@ -33,6 +45,7 @@ class Crystal: @property def a(self) -> float: + """Lattice parameter a in Å.""" return self.lattice[0] @property @@ -43,9 +56,19 @@ def volume(self) -> float: return float(a * b * c * np.sqrt(1 - ca**2 - cb**2 - cg**2 + 2 * ca * cb * cg)) def atoms(self) -> tuple[np.ndarray, np.ndarray]: - """Atom names and fractional coordinates, shape (natoms,) and (natoms, 3). - - DISCUS saves the crystal to a ``.stru`` file, which is read back here. + """Atom names and fractional coordinates. + + Returns + ------- + names : numpy.ndarray of str, shape (natoms,) + Atom names as DISCUS uses them, for example ``"TI4+"``. + xyz : numpy.ndarray of float, shape (natoms, 3) + Fractional coordinates in units of the unit cell. + + Notes + ----- + DISCUS saves the crystal to a ``.stru`` file, which is read back. + The result is cached on the ``Crystal``. """ if self._atoms is None: _ensure_loaded(self) @@ -65,7 +88,7 @@ def atoms(self) -> tuple[np.ndarray, np.ndarray]: return self._atoms def positions(self) -> np.ndarray: - """Fractional coordinates, shape (natoms, 3).""" + """Fractional coordinates, shape (natoms, 3). See :meth:`atoms`.""" return self.atoms()[1] def __repr__(self) -> str: @@ -78,10 +101,36 @@ def read_structure(path: str | os.PathLike, supercell: tuple[int, int, int] | int | None = None) -> Crystal: """Read a structure file into DISCUS. - ``.cell`` and ``.cif`` files hold an asymmetric unit: DISCUS applies the - space group and builds ``supercell`` unit cells (default 1 x 1 x 1). - ``.stru`` files hold a whole crystal and are read as they are, unless a - ``supercell`` is given. + Parameters + ---------- + path : str or os.PathLike + A ``.cif`` or ``.cell`` file (an asymmetric unit: DISCUS applies the + space group) or a ``.stru`` file (a whole crystal). + supercell : int or tuple of 3 int, optional + Number of unit cells along a, b and c; an int means the same along + all three. Default: 1 x 1 x 1 for ``.cif``/``.cell``, and a ``.stru`` + file is read as it is. + + Returns + ------- + Crystal + The structure, now held by DISCUS. + + Raises + ------ + FileNotFoundError + If ``path`` does not exist. + DiffuseError + If the file type is not supported. + MacroError + If DISCUS cannot read the file. + + Examples + -------- + >>> import diffuse as dc + >>> cr = dc.read_structure("anatase.cif", supercell=(10, 10, 4)) # doctest: +SKIP + >>> cr.natoms # doctest: +SKIP + 4800 """ path = Path(path).expanduser().resolve() if not path.is_file(): diff --git a/python/diffuse/powder.py b/python/diffuse/powder.py index 7f074d16..7a903bce 100644 --- a/python/diffuse/powder.py +++ b/python/diffuse/powder.py @@ -15,7 +15,19 @@ @dataclass class PowderPattern: - """A calculated powder pattern on an evenly spaced Q grid.""" + """A calculated powder pattern on an evenly spaced Q grid. See :func:`powder`. + + Attributes + ---------- + q : numpy.ndarray + Momentum transfer Q in Å⁻¹. + intensity : numpy.ndarray + Intensity at each Q, arbitrary units. + settings : dict + The arguments the pattern was calculated with. + crystal : Crystal or None + The structure it was calculated for. + """ q: np.ndarray # Å^-1 intensity: np.ndarray @@ -23,12 +35,32 @@ class PowderPattern: crystal: Crystal | None = None def two_theta(self, wavelength: float | None = None) -> np.ndarray: - """2θ in degrees for ``wavelength`` (default: the one used).""" + """Scattering angle 2θ in degrees. + + Parameters + ---------- + wavelength : float, optional + Wavelength in Å. Default: the one the pattern was calculated with. + """ lam = wavelength or self.settings["wavelength"] return np.degrees(2 * np.arcsin(np.clip(self.q * lam / (4 * np.pi), -1, 1))) def plot(self, ax=None, *, x: str = "q", **kwargs): - """Plot with matplotlib; ``x`` is ``"q"`` or ``"tth"``. Returns the Axes.""" + """Plot the pattern with matplotlib. + + Parameters + ---------- + ax : matplotlib.axes.Axes, optional + Axes to draw into. Default: a new figure. + x : {"q", "tth"} + Plot against Q or against 2θ. + **kwargs + Passed on to :meth:`matplotlib.axes.Axes.plot`. + + Returns + ------- + matplotlib.axes.Axes + """ import matplotlib.pyplot as plt if ax is None: @@ -51,17 +83,43 @@ def plot(self, ax=None, *, x: str = "q", **kwargs): def powder(crystal: Crystal, *, qmin: float = 0.5, qmax: float = 10.0, dq: float = 0.005, radiation: str = "xray", wavelength: float = 0.2, method: str = "debye", temperature: bool = True, lp_correction: str = "none") -> PowderPattern: - """Calculate the powder pattern of ``crystal`` with DISCUS. + """Calculate the powder pattern of a crystal with DISCUS. Parameters ---------- - qmin, qmax, dq : Q range and step in Å^-1. - radiation : "xray", "neutron" or "electron". - wavelength : in Å (used for the Q limit, Lorentz-polarisation and 2θ). - method : "debye" (Debye equation, any structure) or "complete" - (Fourier on a reciprocal-space grid, for periodic crystals). - temperature : apply the atomic displacement parameters. - lp_correction : "none", "bragg" or "neutron" Lorentz-polarisation factor. + crystal : Crystal + The structure, from :func:`read_structure`. + qmin, qmax, dq : float + Q range and step in Å⁻¹. + radiation : {"xray", "neutron", "electron"} + Radiation type; selects the atomic form factors or scattering lengths. + wavelength : float + Wavelength in Å, used for the Lorentz-polarisation factor and for + :meth:`PowderPattern.two_theta`. + method : {"debye", "complete"} + ``"debye"``: Debye equation, for any structure, including finite + particles. ``"complete"``: Fourier transform on a reciprocal-space + grid, for periodic crystals. + temperature : bool + Apply the atomic displacement parameters. + lp_correction : {"none", "bragg", "neutron"} + Lorentz-polarisation correction. + + Returns + ------- + PowderPattern + + Raises + ------ + ValueError + For an unknown ``radiation`` or ``method``, or an invalid Q range. + MacroError + If the calculation fails inside DISCUS. + + Examples + -------- + >>> p = dc.powder(cr, qmin=0.5, qmax=10, dq=0.005, radiation="neutron") # doctest: +SKIP + >>> p.plot() # doctest: +SKIP """ try: rad = _RADIATION[radiation.lower()] diff --git a/python/examples/README.rst b/python/examples/README.rst new file mode 100644 index 00000000..541c5d8c --- /dev/null +++ b/python/examples/README.rst @@ -0,0 +1,5 @@ +Examples +======== + +Short scripts that use the ``diffuse`` package. Each one runs DISCUS when the +documentation is built, so the output and plots here are real results. diff --git a/python/examples/powder_demo.png b/python/examples/powder_demo.png deleted file mode 100644 index ef92e8bf81c6f53447a2086fc13ff7fddcbaa239..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 178008 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

gR92DHUUAf-epuv~2c?s!0%5DyaZ%m7_>1E?4 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 z%0D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%0AoIcsAWW*ojwu}N|5|9cS&$7 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 diff --git a/python/examples/powder_demo.py b/python/examples/powder_demo.py index 050004f5..063ebc76 100644 --- a/python/examples/powder_demo.py +++ b/python/examples/powder_demo.py @@ -1,66 +1,78 @@ -"""Demo: read a CIF, calculate powder patterns with DISCUS, plot with matplotlib. +""" +Powder patterns of anatase +========================== + +Read a CIF file, let DISCUS build a supercell, calculate X-ray and neutron +powder patterns with the Debye equation, and plot them with matplotlib. + +The structure is anatase (TiO\\ :sub:`2`), COD entry 1010942 +(``python/examples/anatase.cif``). - DIFFUSE_PYTHON_PATH=/python PYTHONPATH=python \\ - python3 python/examples/powder_demo.py [--show] [--out powder_demo.png] +To run it yourself, from the repository root:: -The structure is anatase (TiO2), COD entry 1010942 (anatase.cif here). + DIFFUSE_PYTHON_PATH=build/python PYTHONPATH=python python3 python/examples/powder_demo.py """ -import argparse -import time from pathlib import Path import matplotlib.pyplot as plt import diffuse as dc -HERE = Path(__file__).resolve().parent - - -def main(): - parser = argparse.ArgumentParser(description=__doc__.splitlines()[0]) - parser.add_argument("--cif", default=HERE / "anatase.cif", type=Path) - parser.add_argument("--out", default="powder_demo.png", type=Path) - parser.add_argument("--show", action="store_true", help="open a plot window") - args = parser.parse_args() - - # 1. Read the structure: DISCUS applies the space group and builds a supercell - crystal = dc.read_structure(args.cif, supercell=(10, 10, 4)) - print(crystal) - - # 2. Powder patterns: X-rays and neutrons, Debye equation - t0 = time.perf_counter() - xray = dc.powder(crystal, qmin=0.5, qmax=10, dq=0.005, radiation="xray") - neutron = dc.powder(crystal, qmin=0.5, qmax=10, dq=0.005, radiation="neutron") - print(f"two patterns of {len(xray.q)} points in {time.perf_counter() - t0:.2f} s") - - # 3. Finite-size broadening: the same structure as a much smaller crystal - small = dc.read_structure(args.cif, supercell=(3, 3, 1)) - xray_small = dc.powder(small, qmin=0.5, qmax=10, dq=0.005, radiation="xray") - - # 4. Plot: these are plain NumPy arrays, so any plotting library works - fig, (top, bottom) = plt.subplots(2, 1, figsize=(9, 7), sharex=True, - constrained_layout=True) - top.plot(xray.q, xray.intensity / xray.intensity.max(), lw=1, label="X-ray") - top.plot(neutron.q, neutron.intensity / neutron.intensity.max(), lw=1, label="neutron") - top.set_title(f"Anatase, {crystal.supercell[0]}×{crystal.supercell[1]}×" - f"{crystal.supercell[2]} unit cells ({crystal.natoms} atoms)") - top.set_ylabel("Intensity (normalised)") - top.legend() - - for p, label in ((xray, f"{crystal.natoms} atoms"), (xray_small, f"{small.natoms} atoms")): - bottom.plot(p.q, p.intensity / p.intensity.max(), lw=1, label=label) - bottom.set_title("X-ray: crystal size broadens the peaks") - bottom.set_xlabel(r"$Q$ (Å$^{-1}$)") - bottom.set_ylabel("Intensity (normalised)") - bottom.set_xlim(xray.q[0], xray.q[-1]) - bottom.legend() - - fig.savefig(args.out, dpi=150) - print(f"plot written to {args.out}") - if args.show: - plt.show() - - -if __name__ == "__main__": - main() +# sphinx_gallery_start_ignore +try: + HERE = Path(__file__).resolve().parent +except NameError: # the docs gallery runs examples from their folder + HERE = Path.cwd() +# sphinx_gallery_end_ignore +CIF = HERE / "anatase.cif" + +# %% +# Read the structure +# ------------------ +# A CIF file holds the asymmetric unit. DISCUS applies the space group +# (I4\ :sub:`1`/amd) and builds 10 x 10 x 4 unit cells. + +crystal = dc.read_structure(CIF, supercell=(10, 10, 4)) +print(crystal) + +# %% +# Calculate powder patterns +# ------------------------- +# The results are NumPy arrays (``q`` and ``intensity``), so any plotting or +# analysis library can use them. + +xray = dc.powder(crystal, qmin=0.5, qmax=10, dq=0.005, radiation="xray") +neutron = dc.powder(crystal, qmin=0.5, qmax=10, dq=0.005, radiation="neutron") +print(f"{len(xray.q)} points from Q = {xray.q[0]} to {xray.q[-1]} Å⁻¹") + +# %% +# A much smaller crystal of the same structure shows how the crystal size +# broadens the peaks. + +small = dc.read_structure(CIF, supercell=(3, 3, 1)) +xray_small = dc.powder(small, qmin=0.5, qmax=10, dq=0.005, radiation="xray") + +# %% +# Plot +# ---- +# X-rays see mostly titanium; neutrons see oxygen much more strongly, so the +# relative peak heights change. + +fig, (top, bottom) = plt.subplots(2, 1, figsize=(9, 7), sharex=True, + constrained_layout=True) +top.plot(xray.q, xray.intensity / xray.intensity.max(), lw=1, label="X-ray") +top.plot(neutron.q, neutron.intensity / neutron.intensity.max(), lw=1, label="neutron") +top.set_title(f"Anatase, 10×10×4 unit cells ({crystal.natoms} atoms)") +top.set_ylabel("Intensity (normalised)") +top.legend() + +for p, label in ((xray, f"{crystal.natoms} atoms"), (xray_small, f"{small.natoms} atoms")): + bottom.plot(p.q, p.intensity / p.intensity.max(), lw=1, label=label) +bottom.set_title("X-ray: crystal size broadens the peaks") +bottom.set_xlabel(r"$Q$ (Å$^{-1}$)") +bottom.set_ylabel("Intensity (normalised)") +bottom.set_xlim(xray.q[0], xray.q[-1]) +bottom.legend() + +plt.show() diff --git a/tests/python/test_diffuse_api.py b/tests/python/test_diffuse_api.py index cac4746d..1628b947 100644 --- a/tests/python/test_diffuse_api.py +++ b/tests/python/test_diffuse_api.py @@ -134,14 +134,13 @@ def test_plot(dc): plt.close("all") -def test_demo_script(tmp_path): - """python/examples/powder_demo.py runs and writes its plot (own process).""" +@pytest.mark.parametrize("script", sorted(p.name for p in EXAMPLES.glob("*.py"))) +def test_example_script(script, tmp_path): + """Each script in python/examples/ runs on its own (own process, no display).""" pytest.importorskip("matplotlib") if not os.environ.get("DIFFUSE_PYTHON_PATH"): pytest.skip("DIFFUSE_PYTHON_PATH not set") env = os.environ | {"PYTHONPATH": str(REPO / "python"), "MPLBACKEND": "Agg"} - out = tmp_path / "demo.png" - r = subprocess.run([sys.executable, str(EXAMPLES / "powder_demo.py"), "--out", str(out)], + r = subprocess.run([sys.executable, str(EXAMPLES / script)], cwd=tmp_path, env=env, capture_output=True, text=True, timeout=300) assert r.returncode == 0, r.stdout + r.stderr - assert out.stat().st_size > 10_000 From d374c6b37dfa8b55ec93cbb0ec5e1428a795fbb6 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 17:10:46 +0000 Subject: [PATCH 10/11] Docs: record decision to keep the docs unpublished until the first release Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_018Yw8KkfPLawp8Po4f5Bc9v --- CLAUDE.md | 7 +++++-- python/README.md | 5 +++-- 2 files changed, 8 insertions(+), 4 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index dc1dc0d8..3947d104 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -32,6 +32,9 @@ Sphinx in `docs/` (MyST Markdown, autodoc + napoleon, sphinx-gallery over `DIFFUSE_PYTHON_PATH=build/python python3 -m sphinx -W -b html docs docs/_build/html` (`DIFFUSE_DOCS_OFFLINE=1` without network). New public API needs a NumPy-style docstring, an entry in `docs/api.md`, and an example in `python/examples/`. -CI uploads the HTML as the `docs-html` artifact. Do not publish to the -`gh-pages` branch: it holds the DISCUS homepage. +CI uploads the HTML as the `docs-html` artifact. Decision (Nov 2026): the +docs are **not published** until the first release; the artifact is the way +to read them. Do not publish to the `gh-pages` branch: it holds the DISCUS +homepage. When publishing is wanted, the preferred route is a separate docs +repository with its own GitHub Pages site. diff --git a/python/README.md b/python/README.md index 526fff9d..96374711 100644 --- a/python/README.md +++ b/python/README.md @@ -101,8 +101,9 @@ DIFFUSE_PYTHON_PATH=build/python python3 -m sphinx -W -b html docs docs/_build/h `DIFFUSE_DOCS_NO_GALLERY=1` skips the gallery (no compiled module needed); `DIFFUSE_DOCS_OFFLINE=1` skips the links into the NumPy/matplotlib docs. CI builds the docs on every push and keeps the HTML as the `docs-html` -artifact of the run. They are not published yet (GitHub Pages of this -repository serves the DISCUS homepage). +artifact of the run (open the run on GitHub, download `docs-html`, open +`index.html`). They are not published until the first release; GitHub +Pages of this repository serves the DISCUS homepage. When adding to the API: give every public function a NumPy-style docstring (Parameters, Returns, Raises, Examples), list it in `docs/api.md`, and add an From 74bc3cb988f340a51f6abd4b939cc1befb5b0d78 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 17:17:18 +0000 Subject: [PATCH 11/11] Publish the docs to gh-pages/python-docs from claude-python-app New CI job publish-docs, after a successful build and test job, for pushes to claude-python-app only. tools/publish_docs.sh replaces the python-docs/ folder of the gh-pages branch and adds an empty .nojekyll at the root (Jekyll would drop Sphinx's _static/, _images/; the homepage is plain HTML and unaffected). It refuses to publish if anything else would change, so the DISCUS homepage is never touched. Tested against a copy of gh-pages: first publish adds python-docs/ and .nojekyll only; a repeat is a no-op; an edited homepage file makes it refuse. Docs URL: https://tproffen.github.io/DiffuseCode/python-docs/ Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_018Yw8KkfPLawp8Po4f5Bc9v --- .github/workflows/tests.yml | 42 ++++++++++++++++++++++++++++++++ CLAUDE.md | 13 +++++----- python/README.md | 9 ++++--- tools/publish_docs.sh | 48 +++++++++++++++++++++++++++++++++++++ 4 files changed, 103 insertions(+), 9 deletions(-) create mode 100755 tools/publish_docs.sh diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index 6fd52f8a..21a321f3 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -98,3 +98,45 @@ jobs: legacy-results.xml legacy-work/**/*.log if-no-files-found: ignore + + # Publish the docs to https://tproffen.github.io/DiffuseCode/python-docs/ + # The gh-pages branch is the DISCUS homepage: tools/publish_docs.sh only + # replaces python-docs/ (plus an empty .nojekyll at the root) and refuses + # to publish if anything else would change. + publish-docs: + needs: linux + if: github.event_name == 'push' && github.ref == 'refs/heads/claude-python-app' + runs-on: ubuntu-24.04 + timeout-minutes: 10 + permissions: + contents: write + concurrency: + group: publish-docs + cancel-in-progress: false + steps: + - uses: actions/checkout@v4 + + - uses: actions/download-artifact@v4 + with: + name: docs-html + path: docs-html + + - uses: actions/checkout@v4 + with: + ref: gh-pages + path: gh-pages + + - name: Put the docs into gh-pages/python-docs + run: tools/publish_docs.sh docs-html gh-pages + + - name: Commit and push + working-directory: gh-pages + run: | + if git diff --cached --quiet; then + echo "Docs unchanged." + exit 0 + fi + git config user.name "github-actions[bot]" + git config user.email "41898282+github-actions[bot]@users.noreply.github.com" + git commit -m "Python docs from ${GITHUB_SHA::7} (claude-python-app)" + git push origin HEAD:gh-pages diff --git a/CLAUDE.md b/CLAUDE.md index 3947d104..55a7f332 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -32,9 +32,10 @@ Sphinx in `docs/` (MyST Markdown, autodoc + napoleon, sphinx-gallery over `DIFFUSE_PYTHON_PATH=build/python python3 -m sphinx -W -b html docs docs/_build/html` (`DIFFUSE_DOCS_OFFLINE=1` without network). New public API needs a NumPy-style docstring, an entry in `docs/api.md`, and an example in `python/examples/`. -CI uploads the HTML as the `docs-html` artifact. Decision (Nov 2026): the -docs are **not published** until the first release; the artifact is the way -to read them. Do not publish to the `gh-pages` branch: it holds the DISCUS -homepage. When publishing is wanted, the preferred route is a separate docs -repository with its own GitHub Pages site. - +CI uploads the HTML as the `docs-html` artifact, and pushes to +`claude-python-app` publish it to +https://tproffen.github.io/DiffuseCode/python-docs/ (job `publish-docs`). +The `gh-pages` branch holds the DISCUS homepage: publishing may only change +`python-docs/` and the empty root `.nojekyll` (agreed with the owner, Nov +2026). `tools/publish_docs.sh` enforces this; keep it that way, and do not +link the docs from the homepage. diff --git a/python/README.md b/python/README.md index 96374711..b17de2d1 100644 --- a/python/README.md +++ b/python/README.md @@ -101,9 +101,12 @@ DIFFUSE_PYTHON_PATH=build/python python3 -m sphinx -W -b html docs docs/_build/h `DIFFUSE_DOCS_NO_GALLERY=1` skips the gallery (no compiled module needed); `DIFFUSE_DOCS_OFFLINE=1` skips the links into the NumPy/matplotlib docs. CI builds the docs on every push and keeps the HTML as the `docs-html` -artifact of the run (open the run on GitHub, download `docs-html`, open -`index.html`). They are not published until the first release; GitHub -Pages of this repository serves the DISCUS homepage. +artifact of the run. Pushes to `claude-python-app` also publish them at +https://tproffen.github.io/DiffuseCode/python-docs/. The `gh-pages` branch +is the DISCUS homepage, so `tools/publish_docs.sh` only replaces the +`python-docs/` folder (plus an empty `.nojekyll` at the root, which Sphinx +output needs) and refuses to publish if anything else would change. The +docs are not linked from the homepage. When adding to the API: give every public function a NumPy-style docstring (Parameters, Returns, Raises, Examples), list it in `docs/api.md`, and add an diff --git a/tools/publish_docs.sh b/tools/publish_docs.sh new file mode 100755 index 00000000..434d59b9 --- /dev/null +++ b/tools/publish_docs.sh @@ -0,0 +1,48 @@ +#!/usr/bin/env bash +# Put the built Sphinx HTML into a gh-pages checkout, under python-docs/ only. +# +# tools/publish_docs.sh +# +# The gh-pages branch holds the DISCUS homepage. This script replaces the +# python-docs/ folder and makes sure an empty .nojekyll exists at the root +# (GitHub Pages' Jekyll would otherwise drop Sphinx's _static/, _images/, ...; +# the homepage is plain HTML and is not affected). It then checks that +# nothing else in the checkout changed, and stages the change. Committing and +# pushing are left to the caller (CI). +# +# Exit codes: 0 = staged (or nothing to do), 1 = usage error, +# 2 = something outside python-docs/ and .nojekyll would change. +set -euo pipefail + +DEST=python-docs + +if [ $# -ne 2 ] || [ ! -f "$1/index.html" ] || ! git -C "$2" rev-parse --is-inside-work-tree >/dev/null 2>&1; then + echo "usage: $0 " >&2 + exit 1 +fi +html=$(cd "$1" && pwd) +site=$(cd "$2" && pwd) + +cd "$site" +rm -rf -- "$DEST" +mkdir -p -- "$DEST" +cp -a -- "$html"/. "$DEST"/ +rm -f -- "$DEST/.buildinfo" # Sphinx build cache, not needed online +[ -e .nojekyll ] || : > .nojekyll + +git add -A -- "$DEST" .nojekyll + +# Guard: only python-docs/ and .nojekyll may differ from the last commit. +outside=$(git status --porcelain | awk '{print $NF}' \ + | grep -v -e "^$DEST/" -e "^$DEST\$" -e '^\.nojekyll$' || true) +if [ -n "$outside" ]; then + echo "refusing to publish: these paths outside $DEST/ would change:" >&2 + echo "$outside" >&2 + exit 2 +fi + +if git diff --cached --quiet; then + echo "docs unchanged; nothing to publish" +else + git diff --cached --stat | tail -1 +fi