[us-commits] [ehb54/ultrascan3] bedc12: perceiver: dedicated help page for the non-coded r...

[emre brookes]

  Branch: refs/heads/ehb54-issue-980
  Home:   https://github.com/ehb54/ultrascan3
  Commit: bedc1297eac86c7650eceade2d50fc94bfee7bb4
      https://github.com/ehb54/ultrascan3/commit/bedc1297eac86c7650eceade2d50fc94bfee7bb4
  Author: ehb54 <brookes at uthscsa.edu>
  Date:   2026-08-09 (Sun, 09 Aug 2026)

  Changed paths:
    A us_somo/develop/perceiver/GUI_TESTING.md
    M us_somo/develop/src/us_hydrodyn_perceive_dialog.cpp
    M us_somo/somo/doc/manual/somo/somo.html
    A us_somo/somo/doc/manual/somo/somo_perceive.html

  Log Message:
  -----------
  perceiver: dedicated help page for the non-coded residue dialog

The review dialog's Help button pointed at somo_residue.html, which documents
the residue table editor and says nothing about perception. Point it at a new
somo_perceive.html and link that from the Lookup Tables list in somo.html,
beside Add/Edit Residue.

The page follows the manual's conventions and uses the dialog's actual
labels -- Skip this residue, Also append this entry to somo.residue, Flagged
for review -- rather than paraphrases. It reserves an <img> slot for
somo-perceive.png next to the HTML.

Its substance is what a GUI tester cannot get from the interface itself:

- perceive BEFORE building, or the Automatic Bead Builder's _NC placeholders
  are already in the model
- what Accept actually does. An accepted entry goes to somo.residue.perceived
  and becomes the active table IMMEDIATELY, but only for this session:
  residue_filename is reset to somo.residue at every start and is not stored
  in the config, and the next session's first Accept REBUILDS that file from
  somo.residue, discarding what an earlier session accepted. Tick the
  checkbox, or re-select the file by hand before accepting anything new
- what each computed number is worth, and that hydration is the weakest --
  which is why vdW models are where a weak proposal becomes a real problem
- that ASA is a placeholder which nonetheless may not be zero

Also adds perceiver/GUI_TESTING.md, the same ground as a cheat sheet for
someone testing only through the GUI, with the four test structures and what
to be sceptical of in a proposed entry.

Note US_Help::show_help() falls back to underconstruction.html when the file
is missing, so "under construction" means help_dir points at an installed
release rather than at this tree.



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