Commit 72cdba18 authored by Vacaliuc, Bogdan's avatar Vacaliuc, Bogdan
Browse files

slides: 2026-04-22 content adjustments on slides 2, 3, 3d 



Slide 2 (api-mapping): tightened the lr_reduction cells.  Where the
LR function calls a named Mantid algorithm, the cell now says so
(Rebin, SingleReadoutDeadTimeCorrection, Fit) rather than "numpy/scipy".
Where the LR function extracts arrays from a Mantid workspace and
operates on them, the cell is phrased accordingly (e.g. "extracts
events from Mantid workspace → numpy histograms in Q").  Bottom
insight line no longer claims "numpy/scipy in-module" — both
libraries use Mantid as the engine.

Slide 3 (silent-defaults): the ErrorWeightedBackground icon caption
"bright off-spec contaminates background → weighted mean biases
R(Q)" no longer sits on the TOF axis; moved up into the icon's
header area; icon container expanded slightly.

Slide 3d (accept-null-reflectivity): reworded the observable bullet
"Polarized experiments with a symmetric sample frequently have one
cross-section near zero" → "Polarized experiments in only 1 state
have one cross-section near zero" per user.

Co-Authored-By: default avatarClaude Opus 4.7 (1M context) <noreply@anthropic.com>
parent 27fd6e61

plan/quicknxsv2-modularization/slides/slide-2-api-mapping.png

+1.46 KiB (290 KiB)
Loading image diff...

plan/quicknxsv2-modularization/slides/slide-2-api-mapping.svg

+4 −4
Original line number Diff line number Diff line
@@ -90,7 +90,7 @@ 


    <rect x="1120" y="352" width="740" height="68" rx="6" fill="url(#lrCol)" stroke="#6DA64F" stroke-width="1"/>

    <text x="1140" y="384" font-size="15" fill="#1F3A1F" font-family="monospace" font-weight="700">peak_finding.process_data(ws) + fit_signal_flat_bck(x, y)</text>

    <text x="1140" y="408" font-size="12" fill="#1F5B1F">function-form; same Gaussian-plus-background shape</text>

    <text x="1140" y="408" font-size="12" fill="#1F5B1F">Mantid Rebin → extractY → lmfit GaussianModel</text>



    <!-- Row 4: Dead-time correction -->

    <rect x="40" y="428" width="300" height="68" rx="6" fill="url(#phaseCol)" stroke="#D2A000" stroke-width="1"/>
@@ -118,7 +118,7 @@ 


    <rect x="1120" y="504" width="740" height="76" rx="6" fill="url(#lrCol)" stroke="#6DA64F" stroke-width="2"/>

    <text x="1140" y="536" font-size="15" fill="#1F3A1F" font-family="monospace" font-weight="700">event_reduction.EventReflectivity(ws, …).specular()</text>

    <text x="1140" y="558" font-size="12" fill="#1F5B1F">class · in-module numpy/scipy over Mantid workspaces</text>

    <text x="1140" y="558" font-size="12" fill="#1F5B1F">extracts events from Mantid workspace → numpy histograms in Q</text>

    <text x="1140" y="575" font-size="12" fill="#1F5B1F" font-style="italic">weighted / unweighted / q-summing branches</text>



    <!-- Row 6: Resolution -->
@@ -145,7 +145,7 @@ 


    <rect x="1120" y="656" width="740" height="60" rx="6" fill="url(#lrCol)" stroke="#6DA64F" stroke-width="1"/>

    <text x="1140" y="686" font-size="15" fill="#1F3A1F" font-family="monospace" font-weight="700">output.RunCollection(…).calculate_scale_factors() + merge()</text>

    <text x="1140" y="708" font-size="12" fill="#1F5B1F">class; in-memory stitching with stitching_configuration</text>

    <text x="1140" y="708" font-size="12" fill="#1F5B1F">numpy arrays; scale factors via Mantid Fit (stitching.py)</text>



    <!-- Row 8: Output ASCII -->

    <rect x="40" y="724" width="300" height="60" rx="6" fill="url(#phaseCol)" stroke="#D2A000" stroke-width="1"/>
@@ -190,7 +190,7 @@ 
  <!-- Footer insight box -->

  <rect x="40" y="940" width="1820" height="95" rx="10" fill="#002E5D" stroke="#001A35" stroke-width="2"/>

  <text x="60" y="970" font-size="18" font-weight="700" fill="#F5C13A">Key insight for the hack-a-thon</text>

  <text x="60" y="998" font-size="15" fill="#E0ECF5">Every reduction phase has a <tspan font-weight="700" fill="white">functional counterpart</tspan> in both libraries.  Implementations differ (Mantid algorithm vs numpy/scipy in-module; kwargs vs template-dataclass),</text>

  <text x="60" y="998" font-size="15" fill="#E0ECF5">Every reduction phase has a <tspan font-weight="700" fill="white">functional counterpart</tspan> in both libraries — both use Mantid as the I/O / algorithm engine; the shapes differ only in orchestration and kwargs vs template-dataclass,</text>

  <text x="60" y="1018" font-size="15" fill="#E0ECF5">but the <tspan font-weight="700" fill="white">public-API shape already converges</tspan>.  A unified <tspan font-weight="700" fill="#F5C13A">ref_core</tspan> can expose <tspan font-family="monospace" font-weight="700" fill="#F5C13A">reduce / inspect / stitch / write / report</tspan>; each instrument plugs in its own reduction algorithm below.</text>



  <!-- Footer -->

plan/quicknxsv2-modularization/slides/slide-3-silent-defaults.png

−653 B (203 KiB)
Loading image diff...

plan/quicknxsv2-modularization/slides/slide-3-silent-defaults.svg

+15 −16
Original line number Diff line number Diff line
@@ -56,28 +56,27 @@ 


    <!-- Icon: a diagram showing off-specular contamination biasing background -->

    <g transform="translate(1210, 230)">

      <rect x="0" y="0" width="660" height="130" rx="6" fill="white" stroke="#E87722" stroke-width="1"/>

      <rect x="0" y="0" width="660" height="145" rx="6" fill="white" stroke="#E87722" stroke-width="1"/>

      <!-- Caption at top (moved up so it does not cross the axis) -->

      <text x="330" y="15" font-size="11" fill="#8C3A00" text-anchor="middle" font-style="italic">bright off-spec contaminates background → weighted mean biases R(Q)</text>

      <!-- X-f (pixels) axis vertical -->

      <line x1="30" y1="20" x2="30" y2="115" stroke="#444" stroke-width="1.5"/>

      <text x="20" y="25" font-size="10" fill="#444" text-anchor="end">pixel</text>

      <line x1="30" y1="30" x2="30" y2="125" stroke="#444" stroke-width="1.5"/>

      <text x="20" y="35" font-size="10" fill="#444" text-anchor="end">pixel</text>

      <!-- TOF axis horizontal -->

      <line x1="30" y1="115" x2="620" y2="115" stroke="#444" stroke-width="1.5"/>

      <text x="620" y="128" font-size="10" fill="#444" text-anchor="end">TOF</text>

      <line x1="30" y1="125" x2="620" y2="125" stroke="#444" stroke-width="1.5"/>

      <text x="620" y="140" font-size="10" fill="#444" text-anchor="end">TOF</text>

      <!-- Peak ROI band -->

      <rect x="35" y="50" width="580" height="18" fill="#C8E0F2" stroke="#4A90C2" stroke-width="0.8" opacity="0.65"/>

      <text x="325" y="64" font-size="11" fill="#002E5D" text-anchor="middle" font-weight="700">specular peak</text>

      <rect x="35" y="60" width="580" height="18" fill="#C8E0F2" stroke="#4A90C2" stroke-width="0.8" opacity="0.65"/>

      <text x="325" y="74" font-size="11" fill="#002E5D" text-anchor="middle" font-weight="700">specular peak</text>

      <!-- Background band (below peak) -->

      <rect x="35" y="80" width="580" height="12" fill="#F2F2F2" stroke="#888" stroke-width="0.6"/>

      <text x="325" y="90" font-size="10" fill="#606060" text-anchor="middle" font-style="italic">background pixels</text>

      <rect x="35" y="90" width="580" height="12" fill="#F2F2F2" stroke="#888" stroke-width="0.6"/>

      <text x="325" y="100" font-size="10" fill="#606060" text-anchor="middle" font-style="italic">background pixels</text>

      <!-- Off-specular intrusion (bright ovals bleeding into the background band) -->

      <ellipse cx="180" cy="88" rx="28" ry="8" fill="#E87722" opacity="0.8"/>

      <ellipse cx="380" cy="86" rx="22" ry="7" fill="#E87722" opacity="0.8"/>

      <ellipse cx="180" cy="98" rx="28" ry="8" fill="#E87722" opacity="0.8"/>

      <ellipse cx="380" cy="96" rx="22" ry="7" fill="#E87722" opacity="0.8"/>

      <!-- Arrow pointing to one of the intrusions -->

      <line x1="180" y1="40" x2="180" y2="78" stroke="#C8102E" stroke-width="1.5" marker-end="url(#arrowDark)"/>

      <text x="180" y="30" font-size="10" fill="#C8102E" text-anchor="middle" font-weight="700">off-specular intensity</text>

      <text x="180" y="18" font-size="10" fill="#C8102E" text-anchor="middle" font-weight="700">in "background"</text>

      <!-- Caption -->

      <text x="330" y="120" font-size="11" fill="#8C3A00" text-anchor="middle" font-style="italic">bright off-spec contaminates background → weighted mean biases R(Q)</text>

      <line x1="180" y1="50" x2="180" y2="88" stroke="#C8102E" stroke-width="1.5" marker-end="url(#arrowDark)"/>

      <text x="180" y="42" font-size="10" fill="#C8102E" text-anchor="middle" font-weight="700">off-specular intensity in "background"</text>

    </g>

  </g>

plan/quicknxsv2-modularization/slides/slide-3d-accept-null-reflectivity.png

−896 B (152 KiB)
Loading image diff...