Skip to content

UI fixes#23

Merged
NCCU-Schultz-Lab merged 2 commits into
mainfrom
UI-fixes
Jul 18, 2026
Merged

UI fixes#23
NCCU-Schultz-Lab merged 2 commits into
mainfrom
UI-fixes

Conversation

@NCCU-Schultz-Lab

Copy link
Copy Markdown
Collaborator

This pull request makes several improvements to the QuantUI application, focusing on user guidance and interface clarity. The most significant updates are the addition of a dedicated help button for calculation types, restoration of open-shell guidance, and simplification of the UI by removing a redundant "Reorganization Energy" auto-run button. The changes also include corresponding tests to ensure these features work as intended.

User guidance enhancements:

  • Added a "?" help button next to the calculation type dropdown (calc_type_dd) that opens a new help topic explaining all calculation types, their purposes, and typical workflows. The help content is provided in help_content.py under the "calc_type" topic. [1] [2] [3] [4] [5] [6] [7] [8]

  • Restored the open-shell (multiplicity > 1) guidance hint, which dynamically appears below the calculation type selector. It warns users when RHF is selected for open-shell systems and provides informational messages for UHF/DFT methods. [1] [2] [3] [4] [5] [6] [7]

UI simplification and cleanup:

  • Removed the dedicated "Calc. Reorganization Energy" auto-run button (_reorg_auto_btn). The reorganization energy calculation is now initiated solely through the calculation type dropdown and the shared "Run Calculation" button, reducing redundancy and streamlining the workflow. [1] [2] [3] [4] [5] [6] [7] [8]

Testing improvements:

  • Added tests to verify that the calculation type help button opens the correct help topic, and that the open-shell guidance hint appears or hides appropriately based on multiplicity and method. Tests also confirm the updated UI flow for reorganization energy calculations. [1] [2] [3]

Layout and visual updates:

  • Changed the descriptor cards container from a vertical stack (VBox) to a horizontal row (HBox) for a more compact and visually appealing layout, and added a gap for better spacing.

These changes collectively improve the clarity, usability, and maintainability of the QuantUI interface.

Simplified the Reorganization Energy flow by removing the dedicated "Calc. Reorganization Energy" button and relying on the existing calc-type selector + shared Run Calculation path. Cleaned up related app wiring/state toggles and updated tests/docs to match the single-path behavior. Also adjusted method/basis descriptor cards to a horizontal, wrapping layout and streamlined the run-controls row to keep the setup UI more compact.
Adds a new `calc_type` help topic, wires a new `?` button beside the Calc. Type dropdown, and routes it through `app_runflow`/`app.py` so the Help overlay opens directly to calculation-type guidance. Also restores open-shell guidance in setup notes with a dynamic hint that appears only when multiplicity > 1, warning RHF users to switch to UHF (or DFT) and showing informational text for unrestricted methods. Includes new app tests covering the help topic/button behavior and open-shell hint visibility/content.
@NCCU-Schultz-Lab
NCCU-Schultz-Lab merged commit c6752fa into main Jul 18, 2026
5 checks passed
@NCCU-Schultz-Lab
NCCU-Schultz-Lab deleted the UI-fixes branch July 18, 2026 12:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant