seqeyes-python 0.2.12__tar.gz → 0.2.13__tar.gz

{seqeyes_python-0.2.12 → seqeyes_python-0.2.13}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: seqeyes-python
-Version: 0.2.12
+Version: 0.2.13
 Summary: Interactive Pulseq MRI sequence viewer for Jupyter — lightweight, beautiful, replaces seq.plot() in pypulseq.
 Project-URL: Homepage, https://github.com/bughht/seqeyes_plugin
 Project-URL: Repository, https://github.com/bughht/seqeyes_plugin

{seqeyes_python-0.2.12 → seqeyes_python-0.2.13}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "seqeyes-python"
-version = "0.2.12"
+version = "0.2.13"
 description = "Interactive Pulseq MRI sequence viewer for Jupyter — lightweight, beautiful, replaces seq.plot() in pypulseq."
 readme = "README.md"
 license = {text = "MIT"}

{seqeyes_python-0.2.12 → seqeyes_python-0.2.13}/src/seqeyes/__init__.py

@@ -29,4 +29,4 @@ from seqeyes._plot import set, reset
 from seqeyes._renderer import SeqEyesViewer
 
 __all__ = ["set", "reset", "SeqEyesViewer"]
-__version__ = "0.2.12"
+__version__ = "0.2.13"

{seqeyes_python-0.2.12 → seqeyes_python-0.2.13}/src/seqeyes/resources/pulseq-bundle.js

@@ -54,7 +54,7 @@ var Pulseq = (() => {
   });
 
   // package.json
-  var version = "0.2.12";
+  var version = "0.2.13";
 
   // src/pulseq/decompressor.ts
   function decompressShape(compressed, numSamples) {
@@ -3342,7 +3342,16 @@ var Pulseq = (() => {
     kspaceRasterSamples: 12e6,
     kspaceAdcSamples: 8e6,
     kspaceGridCandidates: 18e6,
-    derivedRasterSamples: 2e6
+    derivedRasterSamples: 2e6,
+    /**
+     * Ceiling on the display samples one sequence load may carry to the VS Code
+     * webview, counted as (time, amplitude) pairs across every RF and gradient
+     * waveform. At 12 bytes per pair this bounds the shared binary buffers at
+     * roughly 137 MiB in the extension host and again in the renderer.
+     * Per-waveform detail is reduced uniformly once a sequence would exceed it,
+     * because the alternative is an allocation neither process can satisfy.
+     */
+    displayTransportSamples: 12e6
   });
   function derivedDetailViewLimitSec(gradientRaster, trTimeSec, maxRasterSamples = INTERACTIVE_COMPUTE_LIMITS.derivedRasterSamples) {
     if (!(gradientRaster > 0) || !(maxRasterSamples > 0)) return 0;

{seqeyes_python-0.2.12 → seqeyes_python-0.2.13}/src/seqeyes/resources/webview-bundle.js

@@ -1,5 +1,69 @@
 /* SeqEyes WebView Bundle — auto-generated, do not edit */
 "use strict";
+/* ══ block-transport.js ══ */
+/* ══════════════════════════════════════════════════════════════════════════
+   block-transport.js — rehydrate the packed block payload from the extension.
+
+   The standalone web app builds BL in this same heap, so its waveform arrays
+   cost one copy and nothing more.  The VS Code extension has to cross a process
+   boundary, and VS Code serialises webview messages with JSON.stringify: every
+   sample becomes ~19 characters of text, the extension host and the renderer
+   each hold that string alongside the object graph, and V8 refuses to build a
+   string longer than 512 MiB at all.  Dense arbitrary waveforms reach ~18 KB of
+   JSON per block, so a few tens of thousands of them cannot be delivered as
+   JSON at any amount of memory.
+
+   src/editor/blockTransport.ts therefore sends the samples as two shared binary
+   buffers — Float64 times, Float32 amplitudes — plus an envelope carrying each
+   waveform's offset and count.  Restoring the arrays as typed-array views over
+   those buffers reproduces the exact block shape the renderer reads, without
+   copying a single sample: the renderer only ever indexes these arrays and asks
+   for their length, which a typed array answers identically.
+   ══════════════════════════════════════════════════════════════════════════ */
+
+/** Interpret a transferred buffer as `Ctor`, or null if it did not arrive. */
+function asTypedView(buffer,Ctor){
+  if(buffer instanceof Ctor)return buffer;
+  if(buffer instanceof ArrayBuffer)return new Ctor(buffer);
+  // Some hosts hand the transfer back as a byte view rather than the buffer.
+  if(buffer&&buffer.buffer instanceof ArrayBuffer&&typeof buffer.byteLength==='number')
+    return new Ctor(buffer.buffer,buffer.byteOffset||0,Math.floor(buffer.byteLength/Ctor.BYTES_PER_ELEMENT));
+  return null;
+}
+
+/**
+ * Attach typed-array views to the envelope in place and return it as BL.
+ * Throws rather than returning partial blocks: a viewer that silently draws
+ * half a sequence is worse than one that says why it cannot.
+ */
+function unpackSequenceBlocks(envelope,timeBuffer,valueBuffer,sampleCount){
+  if(!envelope||!envelope.length)return [];
+  var times=asTypedView(timeBuffer,Float64Array),values=asTypedView(valueBuffer,Float32Array);
+  if(!times||!values)throw new Error('the waveform sample buffers did not arrive as binary data');
+  var available=Math.min(times.length,values.length);
+  if(sampleCount>available)
+    throw new Error('the waveform sample buffers are short by '+(sampleCount-available)+' samples');
+  for(var i=0;i<envelope.length;i++){
+    var b=envelope[i];
+    if(b.rf){
+      b.rf.t=times.subarray(b.rf.o,b.rf.o+b.rf.n);
+      b.rf.m=values.subarray(b.rf.o,b.rf.o+b.rf.n);
+      b.rf.pt=times.subarray(b.rf.qo,b.rf.qo+b.rf.qn);
+      b.rf.p=values.subarray(b.rf.qo,b.rf.qo+b.rf.qn);
+    }
+    if(b.gx)attachGradientSamples(b.gx,times,values);
+    if(b.gy)attachGradientSamples(b.gy,times,values);
+    if(b.gz)attachGradientSamples(b.gz,times,values);
+  }
+  return envelope;
+}
+
+function attachGradientSamples(gradient,times,values){
+  gradient.t=times.subarray(gradient.o,gradient.o+gradient.n);
+  gradient.w=values.subarray(gradient.o,gradient.o+gradient.n);
+}
+
+
 /* ══ state.js ══ */
 /* ═══════════════════════════════════════════════════════════════════════
    Application state & configuration
@@ -248,6 +312,16 @@ function applySerializedKspace(payload){
   }
 }
 
+/* Report a load that did not arrive. Clearing the previous sequence matters as
+   much as the message: the progress overlay reaches "Ready" either way, so
+   leaving stale blocks on screen would read as a successful load. */
+function showSequenceLoadFailure(message){
+  BL=[];waveformOverview=null;blockPos=[];mmCache=null;
+  setViewerNotice('sequence',message);
+  setExportButtonEnabled(false);
+  draw();drawMinimap();
+}
+
 /* ── Data reception ───────────────────────────────────────────────────── */
 window.addEventListener('message',function(e){
   var m=e.data;
@@ -270,7 +344,13 @@ window.addEventListener('message',function(e){
     return;
   }
   if(m.type==='sequenceData'){
-    BL=m.blocks||[];TD=m.totalDuration||0;GR=m.gradRaster||1e-5;
+    try{
+      BL=unpackSequenceBlocks(m.blocks,m.sampleTimes,m.sampleValues,m.sampleCount||0);
+    }catch(err){
+      showSequenceLoadFailure('Failed to load the sequence waveforms: '+(err&&err.message||err)+'.');
+      return;
+    }
+    TD=m.totalDuration||0;GR=m.gradRaster||1e-5;
     setViewerNotice('sequence',m.notices&&m.notices.length?m.notices.join(' '):null);
     setViewerNotice('kspaceOverrideFailure',null);setKspaceSafetyWarning(m.kspaceSafety||null);
     setViewerNotice('m1',null);setViewerNotice('pns',null);setViewerNotice('pnsThreshold',null);
@@ -288,6 +368,8 @@ window.addEventListener('message',function(e){
     if(seqTiming&&seqTiming.trTimeSec>0){fitToFirstTR();}else{fit();}
     draw();drawKs();drawMinimap();
     setExportButtonEnabled(true);
+  }else if(m.type==='loadError'){
+    showSequenceLoadFailure(m.message||'The sequence could not be loaded.');
   }else if(m.type==='kspaceData'){
     applySerializedKspace(m.kspace);finishDangerousKspaceCalculation(null);drawKs();
     if(typeof kOpen!=='undefined'&&!kOpen)document.getElementById('kbtn').click();