[us-commits] [ehb54/ultrascan3] cda2c9: extrap_c0 doc: document the common_crop and fill_s...

[emre brookes]

  Branch: refs/heads/ehb54-issue-920
  Home:   https://github.com/ehb54/ultrascan3
  Commit: cda2c97bd74c2a801631809e0513eaffb5bb0f2c
      https://github.com/ehb54/ultrascan3/commit/cda2c97bd74c2a801631809e0513eaffb5bb0f2c
  Author: ehb54 <brookes at uthscsa.edu>
  Date:   2026-07-21 (Tue, 21 Jul 2026)

  Changed paths:
    M us_somo/somo/doc/manual/somo/somo_saxs_extrap_c0.html

  Log Message:
  -----------
  extrap_c0 doc: document the common_crop and fill_sd directives

Found by auditing every key the control-file parser accepts against the manual rather
than assuming: 18 of 20 directives were documented, and these two never had been. They
were described in the driver's header comment when the SD-repair work landed but never
reached the user-facing manual.

fill_sd is the one that matters. It defaults to ON and changes whether the fit is
weighted at all: SOMO's error handling is all-or-nothing, so a single non-positive SD --
typically one zero at a grid edge in deposited data -- disables that curve's errors
entirely and silently forces an unweighted fit. A user reading the manual had no way to
know either that this repair happens by default or how to turn it off.

common_crop (also default ON) documents why grid-aligned inputs are cropped to their
shared q-overlap first: otherwise the loader resamples mismatched grids and
spline-extrapolates the higher-starting curves below their own data.

Audit now reports 20/20; the pre-existing bare-<p> imbalance is unchanged (delta 5).

Co-Authored-By: Claude Fable 5 <noreply at anthropic.com>



To unsubscribe from these emails, change your notification settings at https://github.com/ehb54/ultrascan3/settings/notifications