recip-slice 0.4.1__tar.gz

recip_slice-0.4.1/AGENTS.md

@@ -0,0 +1,178 @@
+# Agent starting guide
+
+This file is the starting point for coding agents working in this repository.
+Read it before changing code, then read the documentation relevant to the
+requested feature.
+
+## Start here
+
+1. Read `README.md` for the product and scientific scope.
+2. Read `docs/architecture.md` before moving responsibilities between modules.
+3. Read `docs/algorithm.md` before changing geometry, sampling, accumulation,
+   coverage, or detector processing.
+4. Read `docs/gui.md` before changing Qt behaviour or terminology.
+5. Read `docs/roadmap.md` for feature order and acceptance criteria.
+6. Read `docs/reproducibility.md` before changing manifests, reports, or saved
+   numerical products.
+
+## Canonical source and repository map
+
+- `src/recip_slice/core/`: dataset discovery, settings, geometry, calibration,
+  validation, preflight, and workflow requests.
+- `src/recip_slice/reconstruction/`: numerical reconstruction, native/fallback
+  accumulation, result manifests, and result loading.
+- `src/recip_slice/gui/`: Qt layout, state, interactions, process management,
+  comparison, display, and canvas code.
+- `src/recip_slice/compat/`: legacy import compatibility only.
+- `tests/`: unit, integration, packaging, and optional headless GUI tests.
+- `tools/project_cycle.py`: canonical compile/test/lint/type-check/build cycle.
+
+Only edit the canonical files under `src/`, `tests/`, `docs/`, and repository
+root. Never implement changes in generated `build/lib.*`, `dist/`,
+`*.egg-info`, caches, wheelhouse output, or compiled `.pyd`/`.so` files.
+
+## Scientific invariants
+
+- Detector images and XDS inputs are read-only.
+- Display controls never mutate or rewrite saved arrays.
+- `mean` is `sum / signal_coverage`; do not redefine coverage semantics.
+- `geometry_coverage` is independent of intensity thresholding;
+  `signal_coverage` represents retained samples. The legacy `coverage` name is
+  a readable compatibility alias, not a new product.
+- XDS frame exclusions, region/pixel masks, and detector distortion remain
+  explicit opt-ins and must be recorded in the manifest.
+- Do not silently resample, register, normalize, interpolate, fill, mask, or
+  correct scientific data. Such operations require an explicit user choice and
+  provenance in a derived result.
+- CLI and GUI reconstruction must use the same core settings and output-path
+  resolution.
+- The GUI launches reconstruction through the installed module and keeps
+  numerical work outside the Qt event loop.
+- Manifest paths stay within the result directory. NumPy loading uses
+  `allow_pickle=False`; axes, shapes, units, and manifest versions are
+  validated.
+- Existing manifests and legacy three-axis results remain readable unless a
+  compatibility change is explicitly approved and documented.
+- Geometry or accumulation changes require focused numerical tests. Preserve
+  deterministic frame order and verify native and NumPy-fallback semantics.
+
+## Cross-platform contract
+
+The required interactive targets are native Linux, native Windows, and WSL.
+WSL is a separate integration target because the Python process is Linux while
+the visible desktop, clipboard, and file manager may belong to Windows.
+
+### General rules
+
+- Use `pathlib.Path` for filesystem paths and `os.pathsep` for path lists.
+- Do not parse paths by splitting on `/` or `\\`, and do not assume drive
+  letters, a home-directory layout, case sensitivity, or a particular mount
+  point.
+- Paths with spaces and Unicode must work in dialogs, manifests, subprocesses,
+  exports, drag-and-drop, and project files.
+- Use `sys.executable` for child Python processes.
+- Pass subprocess arguments as a list. Do not build shell command strings or
+  rely on Bash, PowerShell, `cmd.exe`, `xdg-open`, or `explorer.exe` in shared
+  code.
+- Prefer Qt abstractions such as `QFileDialog`, `QUrl.fromLocalFile`,
+  `QDesktopServices`, `QClipboard`, and `QStandardPaths` for desktop behaviour.
+- When Qt does not cover a WSL host integration, isolate it in a small helper,
+  detect the required executable/capability, bound subprocess timeouts, and
+  retain a Linux-side fallback.
+- Extend the existing WSL detection and clipboard bridge rather than creating
+  duplicate platform checks in unrelated widgets.
+- Use explicit UTF-8 for project, report, manifest, and settings text files.
+- Never write into the installed package directory at runtime. Use a selected
+  project/result directory, Qt standard writable location, or a temporary
+  directory as appropriate.
+
+### GUI rules
+
+- Keep long work in a `QProcess`, worker thread, or pure background task; never
+  block the Qt event loop.
+- Any platform-specific dialog or integration failure must leave scientific
+  reconstruction and saved results usable.
+- Verify layouts at the current minimum window size and with normal Linux and
+  Windows font metrics.
+- Important actions must have a visible entry point. Context menus and
+  shortcuts may duplicate an action but must not be its only discovery path.
+- Cross-platform feature code should expose pure helpers so platform branches
+  can be tested without launching a real desktop session.
+
+### Native extension rules
+
+- `RECIP_SLICE_NATIVE=auto` may fall back to NumPy for source installs.
+- Release/performance validation uses `RECIP_SLICE_NATIVE=require`.
+- Never make the compiled backend scientifically different from the fallback.
+- Do not commit locally generated binaries. Change the `.pyx`, generated C
+  source when required by the project workflow, and Python fallback together.
+
+## Implementation workflow
+
+1. Inspect the working tree and preserve unrelated user changes.
+2. Identify the owning module; avoid adding more responsibility to
+   `gui/window.py`, which is the constructor/style facade over focused mixins.
+3. Put scientific and serialization logic in pure core/reconstruction helpers;
+   keep Qt code responsible for interaction and presentation.
+4. Write or update focused tests with the implementation.
+5. Update user documentation, the roadmap status, and `CHANGELOG.md` when
+   behaviour changes.
+6. Run the smallest relevant tests, then the repository check before handoff.
+
+Do not add a second implementation merely to handle another operating system.
+Prefer one shared path plus a narrow capability adapter when host integration
+really differs.
+
+## Verification
+
+Install development dependencies into the configured project environment, not
+the system Python:
+
+```text
+python -m pip install -e ".[dev]"
+```
+
+Run focused tests during development. For GUI work, run the optional GUI module
+headlessly with `QT_QPA_PLATFORM=offscreen`; use shell-appropriate environment
+syntax rather than embedding it in application code.
+
+Linux/WSL example:
+
+```bash
+QT_QPA_PLATFORM=offscreen MPLBACKEND=Qt5Agg \
+  python -m pytest -q tests/test_gui_optional.py
+```
+
+Windows PowerShell example:
+
+```powershell
+$env:QT_QPA_PLATFORM = "offscreen"
+$env:MPLBACKEND = "Qt5Agg"
+python -m pytest -q tests/test_gui_optional.py
+```
+
+Before handoff, run:
+
+```text
+python tools/project_cycle.py check
+```
+
+Platform-specific behaviour also requires unit tests that simulate each branch
+and a manual smoke check on native Linux, native Windows, and WSL. The smoke
+check should cover clean launch, a path containing spaces/Unicode, dataset
+selection, process start/cancel, result opening, clipboard/export, comparison,
+and any new host integration.
+
+## Roadmap feature checklist
+
+Before marking a roadmap item complete, confirm:
+
+- the user-facing entry point is discoverable;
+- cancellation and error recovery are defined;
+- source data and existing results cannot be modified accidentally;
+- provenance and versioning are defined for new derived data;
+- tests cover normal, invalid, empty, and backward-compatible cases;
+- Linux, Windows, and WSL behaviour satisfies `docs/roadmap.md`;
+- relevant docs and `CHANGELOG.md` are updated;
+- the full project check passes.
+

recip_slice-0.4.1/CHANGELOG.md

@@ -0,0 +1,212 @@
+# Changelog
+
+## 0.4.1 - 2026-08-25
+
+- Replace the point-only placeholder with the quiet, optional **Tools →
+  Analysis…** utility. Drawing now creates an editable draft with draggable
+  handles, whole-shape movement, four-corner rectangle resizing, live results,
+  saved-grid Arrow-key nudging, explicit Apply/Cancel, and temporary guides only
+  while the utility is open.
+- Add **Edit selected** and row double-click editing so applied points, profiles,
+  and regions can be corrected and replaced in place without duplicate records.
+- Add saved-grid line profiles, rectangle/circle region integration, optional
+  explicit local-median background, coverage-aware raw/net/mean/max summaries,
+  a distance-versus-net-signal profile plot, exact-grid A/B results, project
+  persistence, and unified CSV/JSON export.
+- Keep 0.4.0 point-record JSON readable and explicitly defer full 3D reflection
+  integration, shoebox modelling, and rocking-curve/profile fitting across
+  frames.
+- Add a cross-platform ASCII welcome banner to interactive GUI command-window
+  launches without adding output to reconstruction, preflight, or JSON reports.
+- Housekeep generated checkout artefacts through recoverable quarantine,
+  include `wheelhouse/` in that inventory, and enforce Ruff formatting in the
+  project maintenance cycle.
+
+## 0.4.0 - 2026-08-21
+
+- Keep the dataset browser responsive by avoiding path resolution and full
+  result-manifest validation while building its saved-result hints, removing
+  unnecessary WSL-mounted-drive metadata I/O.
+- Fix detector preview's undefined status-text callback; make frame and plane
+  selectors and brightness/contrast values directly editable; default the
+  black point to Auto; preserve the selected zoom/ROI when Grid or Axes is
+  toggled; hide the empty measurement count until a pin exists; and add a
+  visible frame-position slider. Compact saved-result entries now show the
+  run subfolder and plane count.
+- Fix detector-frame preview startup by importing its popup combo widget. Make
+  measurement capture explicit: the Measurements window is modeless, and pins
+  and canvas markers are enabled only while that window is open.
+- Simplify the Qt workspace around the frequent dataset, reconstruction,
+  run/open, and viewer actions. Move projects, preflight, result management,
+  batch/queue commands, comparison utilities, process-log controls, and help
+  into synchronized File/Tools/View/Help menus while retaining every existing
+  workflow and cancellation path.
+- Shorten visible guidance and tooltips to compact action-oriented text; detailed
+  diagnostics remain available in the log, status bar, and Help.
+- Restore the existing-result choice between rewriting and saving a new version;
+  rewrites validate the new run before deleting the selected old run, and the
+  result browser now shows informative run-folder names and planes.
+- Begin Milestone 4.1 persistent local job queue: add versioned atomic queue
+  storage with immutable settings snapshots for single, batch, comparison, and
+  export jobs; visible queue/run/retry/cancel/remove actions; and restart
+  recovery that requires a validated checkpoint before resuming, otherwise
+  allocating a clean timestamped reconstruction run.
+- Begin Milestone 3.4 raw-frame preview and richer preflight: add a visible
+  read-only detector-frame preview with deterministic XDS-policy selection,
+  display-only scaling, source/frame statistics, and the shared structured
+  preflight report used by the CLI.
+- Begin Milestone 3.3 result management: add versioned sidecar metadata for
+  display names, tags, notes, favourites, archive state, and version labels;
+  add collision-safe result duplication and exact-target moves to recoverable
+  hidden trash without renaming scientific manifest members.
+- Begin Milestone 3.2 project/session persistence: add a versioned JSON format
+  with portable dataset/result path references, explicit Open project… and
+  Save project… actions, restoration of reconstruction/comparison/display/zoom
+  state, validated measurement round-tripping, and missing-dataset relinking.
+- Begin Milestone 3.1 explicit comparison alignment: add a pure derived
+  comparison workflow with nearest/linear interpolation, A-grid targeting,
+  finite-overlap masks, mean/median normalization, optional q translation,
+  collision-safe persistence, source manifest identities, and a visible GUI
+  Regrid… action for mismatched grids.
+- Add a prioritized development roadmap and an agent starting guide with
+  scientific invariants and a native Linux, native Windows, and WSL definition
+  of done for future features. Milestone 0 records the GUI control audit and
+  makes result identity, drop-down validity, comparison export, process state,
+  and cross-platform integration hardening the first development work.
+- Implement Milestone 0 GUI hardening: exact timestamped-run identity, truthful
+  product/result/preset selectors, provenance-safe quality details, guarded
+  comparison export and modes, dataset reset state, and accurate batch-cancel
+  wording. Add headless GUI regressions for legacy/modern/incomplete results,
+  WSL detection, and clipboard fallback discovery.
+- Implement the Milestone 1 interaction tier: visible offline Help and a
+  clearly labelled in-memory synthetic demo, XDS-aware folder guidance,
+  drag-and-drop loading through normal recursive discovery, Qt-native result
+  folder/manifest actions with WSL fallback, and viewer-header Export/Image
+  actions plus a visible batch-run action. Add headless tests for first-run
+  discoverability, Unicode/space-safe drop paths, and result path actions.
+- Begin Milestone 2 analysis tooling: click-to-pin reciprocal-space
+  measurements with provenance and optional A/B intensity, labelled marker
+  management, CSV/JSON export, two-pin geometry, and pure deterministic
+  profile/rectangle/circle ROI summaries with headless GUI and numerical tests.
+- Add the first Milestone 2.3 custom-plane slice: validated Miller-index
+  normals, optional hkl offsets and in-plane bases/references, shared CLI and
+  workflow arguments, and manifest/result-loader provenance for the resolved
+  Cartesian plane definition and sampling units. The guided GUI layer builder
+  is still pending.
+
+## 0.3.3 - 2026-08-20
+
+### Cold one-shot GUI workload refinement
+
+- Optimise fresh-process reconstruction for the GUI's three recommended plane
+  presets: Principal 3, Layers 0–3 (12 planes), and All (20 planes).
+- Add a native four-layer parallel-family accumulator so hk0–hk3, h0l–h3l,
+  and 0kl–3kl share reciprocal screening/projection work while retaining
+  independent per-plane outputs and frame-order accumulation.
+- Pipeline next-frame screening against GIL-free native plane-family work and
+  keep the CMOS cleanup/plane worker split bounded by the effective CPU quota.
+- Read standard uncompressed SMV detector frames directly after validating the
+  first header, retaining the existing Fabio path for unsupported formats.
+- Add exact native radius-3 uint16 CMOS halo opening, grouped/row float32
+  quantiles, sparse zero-quantile proofs, and an in-place uint16 mixed-mode
+  blend. Keep NumPy/SciPy fallbacks for compiler-free and unusual-input paths.
+- Preserve float32 CMOS residuals when the radial background is proved exactly
+  zero and perform the regular column correction in place to avoid unnecessary
+  detector-sized copies.
+- Reject a cache-unfriendly strided native column-quantile experiment after it
+  slowed the real-data benchmark despite exact numerical agreement.
+
+## 0.3.2 - 2026-08-20
+
+### Twelve-plane reconstruction performance
+
+- Fuse sparse hard-slab testing, reciprocal projection, bilinear indexing, and
+  accumulation into the optional native kernel while retaining the NumPy
+  implementation as a source-install fallback.
+- Run independent reciprocal-plane families concurrently only when the fused
+  native kernel is available; preserve serial ordering within every plane.
+- Enable the exact temporal reciprocal-distance guard by default for four or
+  more hard planes, use an automatic refresh cadence of 20 frames with the
+  fused kernel (8 for the NumPy fallback), use up to eight ordered
+  prefetch/cleanup workers based on detected CPUs, and default
+  BLAS libraries to one thread to avoid oversubscription.
+- Reuse radial sampling-diagnostic geometry across parallel translated planes
+  and defer plotting imports when plots are disabled.
+- Route CMOS robust/mixed noise cancellation through sparse plane selection,
+  pipeline detector cleanup through ordered frame-prefetch workers, and use
+  direct partition-based linear quantiles for finite radial detector shells.
+- Record fused-kernel, family-parallel, temporal-guard, and parallel-CMOS usage
+  in reconstruction manifests.
+
+## 0.3.1 - 2026-08-19
+
+### Native sparse accumulator and release alignment
+
+- Keep the real-data validated serial sparse plane architecture; do not use the
+  rejected asynchronous per-plane accumulation executors.
+- Integrate the exact-order generated-C bilinear accumulator into normal
+  setuptools builds while retaining the scientifically equivalent NumPy-serial
+  fallback.
+- Add explicit `RECIP_SLICE_NATIVE=auto|require|disable` build policy. Release
+  wheel jobs require the native extension so a slow fallback wheel cannot be
+  published accidentally.
+- Add cross-platform wheel CI for Linux, Windows, and macOS from one source
+  tree; binary wheels are platform-specific but the source distribution is
+  shared.
+- Record/report the active sparse accumulator backend in verbose output and
+  manifests.
+- Preserve temporal plane candidate caching as opt-in and disabled by default.
+- Reject the later family/phi screening experiment from the release baseline: it
+  was numerically exact but measured 14.07 s on the real 12-plane WSL workload
+  versus 14.01 s for native serial, with higher peak RSS.
+
+
+- Raw-pixel reconstruction is now the default: XDS excluded frames, XDS
+  region/pixel masks, and detector distortion correction require explicit
+  opt-in flags or GUI controls.
+- Added a single version source, an XDS-template/DATA_RANGE dataset plan,
+  structured scientific preflight, explicit geometry/signal coverage products,
+  shared reconstruction defaults, supported XDS spatial/trusted-pixel
+  calibration, and independent `SPOT.XDS` validation infrastructure.
+- Modern physical manifests are schema v2 with input hashes, frame-selection
+  provenance, calibration/mask records, and an explicit deprecated alias for
+  the historical signal `coverage` product. Added isolated wheel/sdist smoke
+  tests and the `preflight` CLI audit command.
+- Preflight now compares XDS QX/QY against the parser's refined pixel-size
+  fields, manual globs use template-first frame numbering and reject ambiguous
+  filenames, completeness is explicit for raw versus exclusion-enabled modes,
+  and manifests include detector-rejection and per-plane sampling diagnostics.
+- The optional SPOT.XDS checker now reports total/indexed/unindexed counts and
+  excludes `(0, 0, 0)` unindexed records from residual statistics.
+- Hardened the production cycle so checks always exercise the current checkout
+  even when an older globally installed package is present. CI now builds and
+  smoke-tests isolated wheel and source-distribution artefacts, including the
+  packaged stylesheet and icons.
+- Added recent-project reopening, a searchable indexed-dataset browser, explicit named reconstruction presets, and persistent display/workspace state.
+- Added safe result versioning so existing reconstructions are never replaced silently, plus a saved-run selector, provenance and quality summaries, and Markdown/JSON run-report export.
+- Added an A/B comparison workspace that selects a separate indexed XDS dataset (with optional folder browsing), auto-loads the newest compatible result, offers current-settings slicing when B has no saved slice, and reports cancellable B progress. Added independent plane/product selection, synchronized pan and zoom, blink, exact-grid difference and ratio modes, direct hover intensity comparison, and comparison export.
+- Extended v1 manifests with backward-compatible run provenance and per-plane quality statistics; legacy manifests and arrays remain supported.
+- Redesigned the Qt workspace around numbered Data, Planes, and Settings steps with a direct expert path. Added recursive folder-mode indexing, instant dataset switching (including keyboard navigation), and collapsed optional Appearance controls so the reciprocal-space image receives most of the window.
+- Expanded the two-line image hover readout with raw intensity and unit-cell-aware real `d` spacing, including the selected plane offset; suppressed Matplotlib's duplicate third value line.
+- Added a right-click image context menu with rendered-image clipboard copying, nearest hkl-coordinate copying, direct 600 dpi export, view-range shortcuts, overlay toggles, and display reset. Added unit-cell context-menu copying, explicit PNG clipboard data for broader application compatibility, and a Windows clipboard bridge for WSL launches.
+- Added polished contrast-aware RGB arrows with an independent GUI **Axes** toggle. Arrow heads, shafts, labels, and endpoint markers now scale with the on-screen reciprocal-grid interval; heavier fifth grid lines, fractional hkl cursor coordinates, and a GUI summary of the unit-cell lengths and angles are included.
+- Added a **Custom / Axes RGB** grid-colour mode; Axes RGB colours the two lattice-line families to match their reciprocal-axis arrows.
+- Restored the independent **Axes** a*/b*/c* arrow/marker overlay; it no longer turns on automatically with the lattice grid.
+- Added six per-pane colour-map choices (Black on white, White on black, Viridis, Inferno, Cividis, and Coolwarm). q-axis labels/ticks are hidden by default and are available only from the canvas context menu.
+- Reduced viewer lag by avoiding redundant A-pane redraws for B-only appearance changes, disconnecting stale A/B limit callbacks before figure rebuilds, and throttling high-frequency comparison hover status updates.
+- Made saved-result opening lazy with NumPy memory mapping; non-finite edge padding is trimmed only when a plane is first displayed, and the optional quality scan runs only when **Quality** is opened.
+- Reconstruction outputs now discard zero-coverage outer q-grid margins before saving, including matching q axes and compact per-plane shapes, while retaining the requested full q-range in the manifest.
+- Stabilised combo-box popups so menus remain attached to their controls and stay fully visible near screen edges, and reorganised image adjustment controls into clear level, overlay, and export sections.
+- Changed the GUI q-pixel control to a human-readable reciprocal-pixel ratio, defaulting to `1.0 ×`; reconstruction still receives the converted physical Å⁻¹ spacing.
+
+## 0.1.0
+
+- Converted the loose script collection into an installable `src`-layout package.
+- Separated dataset discovery, result validation, workflow configuration, CLI, viewers, and numerical reconstruction.
+- Added stable `recip-slice reconstruct`, `view`, and `gui` entry points.
+- Replaced GUI source-file execution with module-based subprocess execution.
+- Redesigned the Qt workspace around dataset/run and plane-selection tabs with a larger dedicated viewer.
+- Added reconstruction grid and memory estimates, explicit status states, keyboard shortcuts, and improved process error handling.
+- Added strict manifest path, shape, axis, and format validation.
+- Made Qt tests optional rather than failing test discovery when PyQt5 is absent.
+- Added scientific-scope, algorithm, architecture, and reproducibility documentation.

recip_slice-0.4.1/CONTRIBUTING.md

@@ -0,0 +1,65 @@
+# Contributing
+
+Start with [AGENTS.md](AGENTS.md) for repository invariants and the
+Linux/Windows/WSL development contract. Planned product work and its acceptance
+criteria are tracked in [docs/roadmap.md](docs/roadmap.md).
+
+Use Python 3.10 or newer. Install the development environment with:
+
+```bash
+python -m pip install -e '.[gui,dev]'
+```
+
+Before submitting changes, run:
+
+```bash
+python tools/project_cycle.py check
+```
+
+For a local release-candidate source check, run:
+
+```bash
+python tools/project_cycle.py check
+python tools/project_cycle.py clean --apply
+```
+
+The local check validates the source layout, compiles the project, runs the test
+suite, and checks Ruff and mypy across every Python file. Generated checkout
+artefacts can be removed with `clean --apply`; the move is recoverable from the
+timestamped `.project_housekeeping_trash` directory.
+
+GitLab CI is a validation gate only; it runs the full source test cycle and
+does not build or upload release artefacts. Release wheels are built locally
+with `cibuildwheel`. The `cp310` through `cp314` selection in `pyproject.toml`
+produces one tested wheel per supported Python ABI.
+
+On Windows, use a native MSVC developer shell and run:
+
+```powershell
+conda create -n recip-wheel-win python=3.12 pip -y
+conda activate recip-wheel-win
+python -m pip install --upgrade pip build twine cibuildwheel==4.2.0
+$env:RECIP_SLICE_NATIVE = "require"
+$env:CIBW_ARCHS_WINDOWS = "AMD64"
+python -m cibuildwheel --platform windows --output-dir wheelhouse/windows .
+```
+
+In WSL, install and start [Docker Desktop with WSL 2 integration](https://docs.docker.com/desktop/features/wsl/)
+or install Podman before running the Linux build. Then run:
+
+```bash
+conda create -n recip-wheel-linux python=3.12 pip -y
+conda activate recip-wheel-linux
+python -m pip install --upgrade pip build twine cibuildwheel==4.2.0
+export RECIP_SLICE_NATIVE=require
+export CIBW_ARCHS_LINUX=x86_64
+python -m cibuildwheel --platform linux --output-dir wheelhouse/linux .
+```
+
+Build the single source distribution once with `python -m build --sdist --outdir wheelhouse`, then
+run `python -m twine check` over the complete `wheelhouse` before uploading.
+
+The optional macOS job remains available as a validation job. It is disabled by
+default with `ENABLE_MACOS_CI=false`.
+
+Changes to reciprocal-space geometry should include a focused numerical test. Changes to result files must preserve backward loading of legacy three-axis arrays unless the compatibility policy is changed explicitly.

recip_slice-0.4.1/MANIFEST.in

@@ -0,0 +1,7 @@
+include README.md CHANGELOG.md CONTRIBUTING.md AGENTS.md pyproject.toml setup.py run.py
+recursive-include docs *.md *.png
+recursive-include tools *.py
+recursive-include src/recip_slice *.qss *.svg
+
+include src/recip_slice/reconstruction/_accum_ext.c
+include src/recip_slice/reconstruction/_accum_ext.pyx